Перейти к основному содержимому

Файловая структура уровня

Not (yet) implemented feature

Некоторые функции, описанные в настоящем документе, более не поддерживаются, либо начнут поддерживаться в будущем.

Управление структурой уровня осуществляется редактором уровней, желательно все сделать при помощи редактора. Необходимость ручного вмешательства описана в разделе Примечания.

Все уровни хранятся в директории levels относительно директории ресурсов gamesource.

Каждый уровень имеет свою собственную директорию, при этом имя директории является идентификатором уровня и все внутренние файлы (желательно) должны иметь такое же имя.

Конфигурационный файл уровня

Ключевым файлом является файл конфигурации с расширением .lvl. В нем есть одна единственная секция, имя которой аналогично идентификатору уровня.

Ключи (все имена файлов должны быть указаны с расширением):

  • local_name - название локации, произвольная форма, будет отражено в пользовательском игровом интерфейсе;
  • geometry - бинарный файл статической геометрии уровня, расширение .geom;
  • green - бинарный файл растительности уровня, расширение .green;
  • type - тип уровня indoor(закрытый - уровень где нет глобального источника света)/outdoor (открытый - уровень где есть глобальный источник света);
  • entity - конфигурационный файл игровых объектов уровня, расширение .ent;
  • physic - бинарный файл физики уровня, расширение /phy;
  • aigrid - бинарный файл AI сетки уровня, расширение .aigrid;
  • weather - конфигурационный файл погоды, будет взят из директории gamesource/config;
  • ambient_sounds - звуковые файлы для фонового звучания на уровне, разделяются символами , или |, будут взяты из директории gamesource/sounds.

По умолчанию, файлы уровня (geometry, green, entity, physic, aigrid) сохраняются редактором уровней в директорию уровня, имена файлов имеют название уровня. При ручной сборке уровня, рекомендуется не нарушать это правило.

Конфигурационный файл игровых объектов уровня

Файл содержит информацию об игровых объектах уровня, представлен в виде файла конфигураций.

Обязательной секцией файла является секция с именем meta, которая содержит единственный ключ count - количество игровых объектов.

Описание одного игрового объекта осуществляется в одной секции. Секции именуются как ent_N где N - порядковый номер объекта в пределах [0, количество объектов).

Имена и значения ключей зависят от класса игрового объекта.

Превью уровня

Директория уровня может содержать изображение для предпросмотра содержимого уровня, с целью определения уровня. Это может быть любой скриншот уровня, который позволяет четко идентифицировать уровень.

Параметры:

  • формат bmp, так как диалог выбора уровня поддерживает вывод изображения только в этом формате
  • максимальные (они же оптимальные) размеры 400 пикселей по ширине, 250 пикселей по высоте

Примечания

В версии движка 0.10.0 необходимо самостоятельно дописать:

  • local_name;
  • weather;
  • ambient_sounds.

Для удаления уровня необходимо ручное удаление директории уровня.