Компиляция и кэш
Фоновый пул, 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: исполнение использует снимок, полученный при его разборе.