Редактор и подсказки API

Папочный модуль можно редактировать в любом текстовом редакторе. Наиболее удобный вариант — Visual Studio Code с расширением для Lua: игра создаёт готовые настройки проекта и подключает определения KILLSCRIPT API.

Открытие проекта

В меню модулей доступны два полезных действия:

Folder открывает каталог модуля;
VS Code открывает этот каталог как рабочую папку редактора.

Всегда открывайте корень конкретного модуля, а не только файл main.lua:

Modules/
└── MyModule/       ← открыть эту папку
    ├── module.json
    ├── scripts/
    └── .vscode/

Так редактор видит .vscode/settings.json, ресурсы и все точки входа проекта.

Откуда берутся подсказки

Игра хранит Lua-описания API в каталоге ModuleAPI рядом с исполняемым файлом. Настройки, созданные для модуля, добавляют подходящую языковую папку в библиотеку Lua workspace.

После открытия проекта редактор должен подсказывать глобальные объекты вроде Agents, Scheduler, ImGui и их методы.

Если подсказок нет:

убедитесь, что установлена поддержка Lua;
откройте корень модуля, где находится .vscode;
проверьте, что папка ModuleAPI существует в текущей установке игры;
перезапустите Lua language server или окно редактора.

Диагностика не равна выполнению

Подсказка редактора показывает известную сигнатуру, но не меняет контекст выполнения. Например, Scheduler:OnTick() остаётся серверным методом Reflex, даже если редактор предлагает его в main.lua.

Источником истины для контекста, get/set и ограничений служит справочник API.

Полезные настройки проекта

сохраняйте файлы в UTF-8;
используйте пробелы или табы последовательно;
исключите автоматические форматтеры, которые переписывают JSON в неправильную форму;
при работе через сетевую папку избегайте расширений, долго удерживающих файл открытым.

Дальше: цикл разработки и отладки и организация Lua-кода.