Руководство QuestScript
QuestScript добавляет серверные JavaScript- и Python-скрипты в Minecraft. Scripts получают контролируемые Host Objects и могут реагировать на игровые события, планировать работу и взаимодействовать с миром через публичные фасады.
С чего начать
- Установите QuestScript на Fabric-сервер.
- Создайте первый Script Bundle в
config/questscript/scripts/. - Загрузите его операторской командой QuestScript.
Перед загрузкой стороннего кода прочитайте раздел «Безопасность». Proxy-only sandbox закрывает прямой доступ к JVM и процессу сервера, а игровые операции проверяют operator-granted capabilities и typed scopes текущего Script Run. Командное выполнение пока остаётся fail-closed.
Изучите runtime
- Настройка редактора включает автодополнение JavaScript и Python.
- Пошаговое изменение мира показывает распределение работы по нескольким тикам.
- Жизненный цикл Script описывает загрузку, выгрузку, reload, cleanup, imports и exports.
- События и планирование объясняют Before Events, After Events, Script Events, очереди и бюджеты server thread.
- Host Objects и публичные фасады задают границу между Scripts и Minecraft.
Операторам сервера также нужны команды оператора, руководство по развёртыванию QuestPack и Trace Viewer. Сгенерированный API Reference описывает контракты JavaScript и Python.
Состояние alpha. QuestScript находится в alpha. До первого публичного релиза API может меняться без сохранения обратной совместимости.