Danil Iarosh
ca52efbedc
Godot 4.7 project for authoring, previewing, validating, and building Exchanger PCK themes. Includes the example and space-pixel themes, binding contracts, editor tooling, validation/build scripts, and project documentation.
Шаблон темы
Создавайте новую тему через Редактор → Создать тему: EditorPlugin скопирует этот каталог,
обновит ThemeId/DisplayName и активирует результат. Для автоматизации допустимо скопировать
example в themes/<theme-id> вручную и изменить те же поля manifest. Не переименовывайте файлы экранов,
корневые узлы и значения exchanger_binding_id: они являются контрактом приложения.
Тема example сама является валидным минимальным пакетом manifest v2: в ней находятся все
девять production-сцен, 481 immutable и 17 supplemental обязательных биндингов, включая готовые
экранные клавиатуры SETTINGS. Её можно активировать, проверить и
собрать до начала оформления новой темы.
Если теме нужен интерактивный питомец, добавьте его production-сцену в package/components/,
скрипты и ресурсы — внутрь package/, затем задайте InteractivePetScene в manifest. Базовый и
необязательный составной runtime-контракты описаны в
docs/SCRIPTING.md, а дизайнерский workflow — в
docs/COMPOSITE_PET_ANIMATIONS.md; памятка для автора лежит в
source/interactive_pet/README.md.
Оригиналы, рабочие файлы графического редактора и локальные референсы храните в source/.
В PCK экспортируется только содержимое package/. Скрипт сборки временно копирует его в
изолированный проект под канонический runtime-путь res://exchanger_theme_dlc/ и удаляет
workspace после export.
Каталог темы всегда виден в Godot FileSystem. .gdignore не добавляйте: package использует
относительные ссылки, поэтому сцены можно открывать и редактировать непосредственно в
res://themes/<theme-id>/package/scenes/.