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

3.8 KiB

Raw Permalink Blame History

Быстрый старт из VS Code

Требования

Windows 10/11;
Godot 4.7.x с поддержкой .NET (проект не компилирует C#, но использует ту же версию, что host);
PowerShell 7 или Windows PowerShell 5.1;
VS Code и рекомендованное расширение geequlim.godot-tools.

Скрипты находят Godot в таком порядке: параметр -GodotExecutable, переменная процесса GODOT4_EXECUTABLE/GODOT_EXECUTABLE, запущенный Godot Editor, команда godot или godot4 в PATH. Машинно-зависимый путь в .vscode/settings.json не хранится.

Первое открытие

Откройте именно папку ExchangerThemeDlcBuilder в VS Code.
Для ИИ-агента первым сообщением попросите прочитать AGENTS.md и docs/PROJECT_CONTEXT.md. Агент сам обязан восстановить память проекта.
Разрешите установку рекомендованного расширения.
Откройте проект в Godot Editor. Аддон Exchanger Theme Manager включён по умолчанию.
В меню Редактор нажмите Выбрать тему, выберите space-pixel и подтвердите выбор.

Команда запишет выбранный package в build/active-theme.json и откроет главную preview-сцену прямо из него. Создать тему в том же меню создаёт готовую копию example, проверяет ID и сразу выбирает новую тему. После проверки закройте Exchanger и выберите Редактор → Применить тему к Exchanger: аддон соберёт активную тему в фоне и установит PCK. Если нужен только переносимый файл без установки, выберите Редактор → Экспортировать тему и сначала укажите нужный ID темы (он не обязан быть активным в preview), затем задайте имя .pck в стандартном диалоге сохранения. Все длительные команды показывают этап и процент выполнения.

Happy path новой темы

Предпочтительный интерактивный путь: Редактор → Создать тему. Для скриптовой автоматизации:

Copy-Item -LiteralPath .\themes\example -Destination .\themes\my-theme -Recurse
# Отредактируйте ThemeId/DisplayName в themes/my-theme/package/manifest.json
.\activate-theme.ps1 -ThemeId my-theme
.\preview-theme.ps1 -ThemeId my-theme
.\test-theme.ps1 -ThemeId my-theme
.\build-theme.ps1 -ThemeId my-theme

Каталог themes/my-theme/package/ сразу виден в Godot FileSystem — редактируйте сцены и ресурсы там напрямую. Каждая созданная из example сцена уже содержит Theme, фон и decoration и при прямом открытии выглядит так же, как в preview. Preview читает эти же файлы и автоматически перезагрузит текущую вкладку после их сохранения.

Следующее чтение

перед изменением сцены — BINDING_CONTRACT.md;
перед сборкой и установкой — WORKFLOW.md;
при ошибке — QA_AND_TROUBLESHOOTING.md.

3.8 KiB Raw Permalink Blame History Unescape Escape