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.
37 lines
2.2 KiB
Markdown
37 lines
2.2 KiB
Markdown
# Участие в разработке
|
||
|
||
## Перед началом
|
||
|
||
1. Прочитайте [быстрый старт](docs/QUICK_START.md) и
|
||
[контракт биндингов](docs/BINDING_CONTRACT.md).
|
||
2. Убедитесь, что установлен Godot 4.7.x и доступен PowerShell 7 или Windows PowerShell 5.1.
|
||
3. Выберите тему через `Редактор → Выбрать тему` и редактируйте только её
|
||
`themes/<id>/package/`.
|
||
4. Если работает ИИ-агент, он обязан следовать [AGENTS.md](AGENTS.md).
|
||
|
||
## Внесение изменений
|
||
|
||
- Одна задача должна менять один понятный аспект темы или tooling.
|
||
- Не меняйте binding-id, канонические имена сцен и package-копию контракта вручную.
|
||
- Скрипты и runtime-узлы темы разрешены. Не переносите в тему код оплаты, COM-контроллер и
|
||
остальные app-owned подсистемы без отдельного изменения host-контракта.
|
||
- Исходные материалы, лицензии и референсы храните в `source/`; оптимизированные runtime-копии —
|
||
только в `package/`.
|
||
- Новый видимый текст пишите по-русски, понятно для владельца автомата. Используйте «промо» и
|
||
«промо-ролик».
|
||
|
||
## Проверка изменения
|
||
|
||
```powershell
|
||
.\tools\Test-PackagedBindingContract.ps1
|
||
.\test-theme.ps1 -ThemeId space-pixel
|
||
.\build-theme.ps1 -ThemeId space-pixel
|
||
```
|
||
|
||
После автоматических проверок просмотрите все девять вкладок preview при `720×1280`, сначала без
|
||
overlay, затем с `BINDINGS: ON`. Полный checklist находится в
|
||
[документе QA](docs/QA_AND_TROUBLESHOOTING.md).
|
||
|
||
Команда сборки с `-InstallToDefaultUserPath` заменяет установленный PCK Exchanger. Запускайте её
|
||
только осознанно.
|