Компиляция и кэш

Фоновый пул, SHA-256, reload и готовность блоков.

Что выполняется в фоне

Компиляция Java и получение Maven-зависимостей используют ограниченный пул. compiler.threads задаёт число потоков от 1 до 4. Одинаковые одновременно поступившие запросы используют одну задачу компиляции.

Выполнение кода не переносится в этот пул: блок работает в потоке своего события. Скрипт не должен рассчитывать, что Bukkit-вызовы стали безопасны из любого потока.

Ключ кэша

Полный SHA-256 вычисляется для развёрнутого исходника, включая содержимое include. Неизменившийся код может разделять класс между скриптами, сохраняя собственный маппинг ошибок для каждого места вызова.

Кэш ограничен compiler.cache-size - по умолчанию 256, минимум 16. При заполнении вытесняется завершённая наименее недавно использованная запись. Если все записи ещё выполняются, новый запрос может быть отклонён с ошибкой заполнения очереди/кэша.

Перезагрузка

  • /sk reload сохраняет успешные классы и позволяет повторить неудачные компиляции или загрузки.
  • Изменение исходника создаёт другой ключ.
  • При перезапуске сервера кэш классов исчезает: дискового кэша байт-кода нет.
  • JAR зависимостей отдельно сохраняются на диске по SHA-256.

Готовность и ошибки

Java block ready означает готовность блока. Пока компиляция не закончилась или завершилась ошибкой, текущий запуск триггера останавливается. Это касается и on load. Ожидания в серверном тике и автоматического повтора события нет.

Перезагрузите вызывающий скрипт после правки .jv или include: исполнение использует снимок, полученный при его разборе.

Введите запрос для поиска по руководству.