
PxIgnis
A Lua framework for Minecraft Fabric servers with instant hot reload. Define chat commands, events, and server logic in Lua, no Java/Kotlin required using API made for humans.
About this Mod
PxIgnis embeds a hot-swappable Lua runtime directly into the Fabric server lifecycle. No need to compile Java mods just to handle server-side logic, custom commands, or basic event manipulation.
Write your logic in Lua, save the file, reload instantly, and see the changes live.
Right now, I am using PxIgnis to develop a complex, fully Vanilla custom Roguelike server.
If an action felt clunky or required too much boilerplate during my own design phases, I changed the core engine to fix it.
The result is a development loop explicitly streamlined for rapid, practical deployment.
Key Features
- Simple command registration: They hook straight into Minecraft's native Brigadier system. You get tab completion, type validation (
block_pos,player,int, etc.) with a simple API. - Fast Hot-Reloading: Running
/ignis reloadcompletely reloads the Lua state in memory within milliseconds. Registered commands are hot-patched into the live dispatcher without restarting the server. - Simple API:
Some Snippets
1. Commands
-- Simple registration
register("pay <amount:int> <target:player>", function(ctx, amount, target)
local bal = ctx.player.data.balance or 100
if bal < amount then
mc.broadcast(ctx.player.name .. " has insufficient funds.", true)
return
end
ctx.player.data.balance = bal - amount
target.data.balance = (target.data.balance or 0) + amount
mc.broadcast(target.name .. " transferred " .. amount .. " coins to " .. target.name)
end, "ignis.economy")
2. Events & cancellation
mc.on("player_block_break", function(player, pos, blockId)
if blockId ~= "minecraft:white_wool" then
return false -- Cancels the block break if it's not a wool block
end
end)
3. Structure Placement
register("paste <id:text>", function(ctx, id)
local s = mc.loadStructure(id) or mc.loadStructureFile(id .. ".nbt")
if not s then return mc.broadcast("Structure not found!", true) end
s:place(ctx.player.world, ctx.player.pos, {
rotation = "CLOCKWISE_90",
mirror = "LEFT_RIGHT",
-- Iterate structure entities
on_entity = function(entity, pos)
entity.customName = "Summoned " .. entity.type
entity.health = 50
end
})
end)
Installation & Requirements
- Install PxIgnis on your Fabric server.
- The first boot generates a
config/ignis/demo.luaconfiguration file containing basic usage examples. - Edit your scripts and use
/ignis reloadto apply changes instantly.
- Minecraft:
1.21.x - Fabric Loader:
≥0.19.2 - Fabric API:
≥0.141.4 - Fabric Language Kotlin
≥1.10.8
See the full documentation on GitHub for the complete API reference and more examples.
License
GNU Lesser General Public License v3.0
Available Versions
How to Install PxIgnis on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set fabric Loader
In the panel under "Egg", select the fabric loader and matching Minecraft version (1.21.11).
Install Mod
Open the mod browser in the dashboard and search for "PxIgnis". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
1.21.11
Server-side
✓ RequiredRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
PxIgnis server crashes on startup – what to do?
Most common cause: wrong fabric version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (1.21.11). You can switch loaders with one click in the panel.
Is PxIgnis compatible with fabric?
PxIgnis officially supports fabric for Minecraft 1.21.11. The Mado dashboard automatically detects incompatible loader combinations.
Server lagging with PxIgnis – how to optimize performance?
Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if PxIgnis consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.
Similar Mods
Rent Modded Server
Install PxIgnis with just one click on your server.