# Руководство QuestScript

QuestScript добавляет серверные JavaScript- и Python-скрипты в Minecraft.
Scripts получают контролируемые Host Objects и могут реагировать на игровые
события, планировать работу и взаимодействовать с миром через публичные фасады.

## С чего начать

1. [Установите QuestScript](/ru/minecraft/preview/guide/installation.md) на Fabric-сервер.
2. [Создайте первый Script Bundle](/ru/minecraft/preview/guide/first-script.md) в
   `config/questscript/scripts/`.
3. Загрузите его операторской командой QuestScript.

Перед загрузкой стороннего кода прочитайте раздел
[«Безопасность»](/ru/minecraft/preview/guide/security.md). Proxy-only sandbox закрывает прямой доступ к
JVM и процессу сервера, а игровые операции проверяют operator-granted
capabilities и typed scopes текущего Script Run. Командное выполнение пока
остаётся fail-closed.

## Изучите runtime

- [Настройка редактора](/ru/minecraft/preview/guide/editor-setup.md) включает автодополнение JavaScript и
  Python.
- [Пошаговое изменение мира](/ru/minecraft/preview/guide/scheduled-pyramid.md) показывает распределение
  работы по нескольким тикам.
- [Жизненный цикл Script](/ru/minecraft/preview/guide/script-lifecycle.md) описывает загрузку, выгрузку,
  reload, cleanup, imports и exports.
- [События и планирование](/ru/minecraft/preview/guide/events.md) объясняют Before Events, After Events,
  Script Events, очереди и бюджеты server thread.
- [Host Objects и публичные фасады](/ru/minecraft/preview/guide/host-objects.md) задают границу между
  Scripts и Minecraft.

Операторам сервера также нужны [команды оператора](/ru/minecraft/preview/guide/commands.md), руководство
по [развёртыванию QuestPack](/ru/minecraft/preview/guide/questpack-deployment.md) и
[Trace Viewer](/ru/minecraft/preview/guide/threading-trace-viewer.md). Сгенерированный
[API Reference](/ru/minecraft/preview/api/index.md) описывает контракты JavaScript и Python.

> **Состояние alpha.** QuestScript находится в alpha. До первого публичного
> релиза API может меняться без сохранения обратной совместимости.