LuaInMineBukkit

LuaInMineBukkit II позволяет использовать язык Lua для взаимодействия с Bukkit-сервером, обеспечивая высокую скорость выполнения и простоту разработки.

LuaInMineBukkit II — это серверный плагин для Bukkit, предназначенный для интеграции скриптов на языке Lua в логику сервера. Использование Lua позволяет разработчикам создавать функционал плагинов с простым синтаксисом, который не требует предварительной компиляции. Изменения вносятся непосредственно в файлы скриптов с возможностью их мгновенной перезагрузки.

В отличие от предыдущих поколений, текущая версия ориентирована на использование нативной виртуальной машины Lua. Проект базируется на модифицированном репозитории luajava, где были полностью переписаны части функционала отражения (reflection). Это упростило процесс вызова методов Java из Lua и обеспечило более информативные сообщения об ошибках на стороне языка C.

Плагин предоставляет инструменты для создания полноценных расширений сервера, позволяя работать с основными механиками Bukkit напрямую из скриптов.

Основные возможности проекта включают:

• Регистрация команд: создание любых команд с автоматической генерацией иерархии и справочной информации.
• Слушатели событий: поддержка любых событий Bukkit, включая кастомные события из других установленных плагинов.
• Быстрое отражение (Fast Reflection): использование MethodHandle обеспечивает значительно более высокую производительность по сравнению со стандартным Java-отражением.
• Автоматическая перезагрузка: плагин отслеживает изменения в файлах Lua-скриптов и обновляет их в реальном времени.
• Поддержка Java-типов: благодаря динамическим прокси и отражению, скрипты могут наследовать интерфейсы Java и вызывать публичные методы или атрибуты типов Java.

Хотя плагин предоставляет широкий доступ к функционалу Java, отражение не является универсальным решением. В случаях, где возможности Lua ограничены, плагину требуется Java-мост для заполнения пробелов в логике.

🚀 Lua Pooling и многопоточность

Для обеспечения производительности при параллельных задачах реализована система пулинга (pooling). В стандартном режиме выполнение Lua-кода в разных потоках (например, при обработке событий или асинхронных задач) блокирует основную виртуальную машину (VM). Если один поток выполняет длительную операцию, остальные задачи вынуждены ждать освобождения ресурсов.

С включенным Lua Pooling при поступлении задачи из другого потока, она немедленно передается в свободную виртуальную машину из пула. Это позволяет основному потоку мгновенно освобождаться и отвечать на другие вызовы, обеспечивая истинно параллельное выполнение кода.

Пример использования асинхронных вызовов с пулингом:

local import = require "import"
local Thread = import "java.lang.Thread"

for i = 1, 2 do
    luaBukkit.helper:asyncCall(luaBukkit.env:pooledCallable(
        function ()
            while true do
                luaBukkit.log:info(Thread:currentThread():getName() .. " async call " .. i .. "!")
                Thread:sleep(1000)
            end
        end
    ))
end

При включенном пулинге (с емкостью 2) сервер сможет одновременно выводить сообщения из двух разных потоков. Если пулинг отключен, выполнение бесконечного цикла в одном потоке заблокирует основную VM, и сервер не сможет корректно завершить работу по команде stop, так как не сможет освободить ресурсы.

🔗 Интеграция с динамическими библиотеками (JNIBridge)

Благодаря поддержке cffi, в плагин интегрирован JNIBridge, позволяющий взаимодействовать с динамическими библиотеками (DLL/SO). Это открывает возможности для использования кода, написанного на C/C++.

На текущем этапе функционал JNIBridge включает:

• Вызов методов Java
• Базовая конвертация типов

В планах разработки добавлены доступ к полям (Field access) и работа с массивами (Array access).