exchanger-themes/CONTRIBUTING.md
Danil Iarosh ca52efbedc Initial commit: Exchanger Theme DLC Builder
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.
2026-09-22 11:43:13 +03:00

2.2 KiB
Raw Permalink Blame History

Участие в разработке

Перед началом

  1. Прочитайте быстрый старт и контракт биндингов.
  2. Убедитесь, что установлен Godot 4.7.x и доступен PowerShell 7 или Windows PowerShell 5.1.
  3. Выберите тему через Редактор → Выбрать тему и редактируйте только её themes/<id>/package/.
  4. Если работает ИИ-агент, он обязан следовать AGENTS.md.

Внесение изменений

  • Одна задача должна менять один понятный аспект темы или tooling.
  • Не меняйте binding-id, канонические имена сцен и package-копию контракта вручную.
  • Скрипты и runtime-узлы темы разрешены. Не переносите в тему код оплаты, COM-контроллер и остальные app-owned подсистемы без отдельного изменения host-контракта.
  • Исходные материалы, лицензии и референсы храните в source/; оптимизированные runtime-копии — только в package/.
  • Новый видимый текст пишите по-русски, понятно для владельца автомата. Используйте «промо» и «промо-ролик».

Проверка изменения

.\tools\Test-PackagedBindingContract.ps1
.\test-theme.ps1 -ThemeId space-pixel
.\build-theme.ps1 -ThemeId space-pixel

После автоматических проверок просмотрите все девять вкладок preview при 720×1280, сначала без overlay, затем с BINDINGS: ON. Полный checklist находится в документе QA.

Команда сборки с -InstallToDefaultUserPath заменяет установленный PCK Exchanger. Запускайте её только осознанно.