PxIgnis

Среда выполнения Lua для серверов на Fabric с горячей перезагрузкой. Редактируйте скрипты в config/ignis/, выполните /ignis reload — и изменения применятся мгновенно. Полная документация на ignis.pyxiion.ru.

О моде

PxIgnis разрабатывается в связке с полностью ванильным кастомным Roguelike-сервером. API отражает то, что было нужно самому проекту.

Ключевые возможности

• Среда выполнения Lua с горячей перезагрузкой — /ignis reload перезапускает скрипты за миллисекунды. Команды заново регистрируются в живом диспетчере Brigadier без перезапуска сервера.
• Регистрация команд — register("cmd <name:type> [<name:type>]", handler, permission?). Встроенные типы аргументов: int, double, float, bool, text, word, player, block_pos, choice=.... Автодополнение по Tab и права (admin.cmd) — часть API.
• События с возможностью отмены — более 15 хуков: player_block_break, player_chat, player_attack_entity, entity_hurt, entity_death и другие. Возврат false отменяет событие.
• Регионы и скриптовый ИИ мобов — пространственные зоны с событиями входа/выхода/перемещения/смерти и API для кастомного ИИ мобов.
• Корутины, сохранение состояния, интерфейс — mc.fetch / mc.sleep для последовательного асинхронного кода, player.data / mc.data / хранилища для постоянного состояния, а также голограммы, сайдбары и библиотека chestgui для кастомных контейнеров. И это далеко не всё.

Примеры

1. Регион + асинхронность

local arena = world:createRegion(vec(-50, 64, -50), vec(50, 80, 50))

arena:on("entity_enter", function(entity)
    if entity:isPlayer() then
        mc.broadcast(entity.name .. " entered the arena")
        
        coroutine.wrap(function()
            local res = mc.fetch("https://api.example.com/arena/log")
            if not res.ok then
                mc.broadcast("log failed: " .. res.error, true)
            end
        end)()
    end
end)

2. ИИ моба

--# nova syntax
-- enabling cool custom syntax for trailing lambdas (just like Kotlin)
mc.registerBehaviour("zombie_chase") \{ self, mob ->
    local p = mc.players[1]
    if p then
        local pos = p.pos
        mob:navigateTo(pos.x, pos.y, pos.z, 1.0)
    end
}

mc.on("entity_spawn", function(entity)
    if entity:isMob() and entity.type == "minecraft:zombie" then
        entity:setAI("zombie_chase")
    end
end)

3. Команда с правами

register("pay <amount:int> <target:player>", function(ctx, amount, target)
    ctx.player.data.balance = (ctx.player.data.balance or 0) - amount
    target.data.balance     = (target.data.balance or 0) + amount
    
    target:sendMessage("Received " .. amount .. " from " .. ctx.player.name)
end, "pxrp.economy")

Установка и требования

1. Установите Fabric Loader ≥0.19.2, Fabric API ≥0.141.4+1.21.11 и Fabric Language Kotlin ≥1.10.8.
2. Поместите pxignis-*.jar в папку mods/ вашего сервера.
3. Запустите сервер. При первом запуске создаётся config/ignis/demo.lua.
4. Редактируйте скрипты в config/ignis/, затем выполните /ignis reload.

Лицензия

GNU Lesser General Public License v3.0