Импорт и пакеты

Формат .KillScript предназначен для готового однофайлового пакета. Он содержит метаданные, Lua-код и ресурсы модуля внутри одного файла.

Это не Lua-файл

Файл Module.KillScript не является одиночным текстовым скриптом с таким расширением. Это упакованный модуль с той же внутренней структурой, что и папочный проект.

Папка или пакет

	Папочный модуль	.KillScript
Назначение	Разработка и редактирование	Установка и распространение
Расположение	Modules/MyModule/	Modules/MyModule.KillScript
Hot reload исходников	Да	Нет
Открытие обычным редактором	Да	Нет
Требует module.json	Да	Да, внутри пакета

Импорт .KillScript

1. Откройте меню модулей.
2. Нажмите Import.
3. Выберите файл с расширением .KillScript.
4. Включите появившийся модуль.
5. Войдите в игровую сессию и проверьте консоль на наличие ошибок.

Игра копирует импортированный пакет в свою папку Modules. Если файл с таким именем уже существует, новому импорту назначается свободное имя с числовым суффиксом.

Если у вас папка с исходниками

Кнопка Import ожидает .KillScript, поэтому папку через диалог выбрать нельзя. Скопируйте весь каталог проекта непосредственно в папку игры:

KILLSCRIPT Pre-Alpha/
└── Modules/
    └── MyModule/
        ├── module.json
        └── scripts/
            └── main.lua

После копирования вернитесь в меню модулей. Игра сканирует непосредственные подпапки Modules как папочные проекты.

Fork готового модуля

Если нужно изменить установленный или встроенный модуль, используйте Fork. Игра создаст отдельную редактируемую папочную копию с собственными метаданными. Работайте с этой копией, не изменяя исходный пакет.

После Fork:

1. задайте понятное имя и автора;
2. проверьте новый Id;
3. откройте копию через Folder или VS Code;
4. отключите оригинал, если оба модуля выполняют одну функцию.

Что должно быть внутри пакета

В корне пакета обязательно находится module.json. Остальные пути совпадают с папочной структурой:

module.json
scripts/main.lua
scripts/server.lua      # для Reflex
config.json             # необязательно
inputs.json             # необязательно
images/...
sounds/...
ui/...

Простое переименование .zip или .lua в .KillScript не гарантирует корректный пакет: игра проверяет структуру и метаданные при импорте.

Перед распространением

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