PxIgnis

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.

by
20 Downloads
fabricsocialutility
Rent Server with this Mod

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 reload completely 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

  1. Install PxIgnis on your Fabric server.
  2. The first boot generates a config/ignis/demo.lua configuration file containing basic usage examples.
  3. Edit your scripts and use /ignis reload to 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

0.10.0release
MC 1.21.11fabric
June 15, 2026
0.8.0release
MC 1.21.11fabric
June 12, 2026
0.6.0release
MC 1.21.11fabric
May 28, 2026
PxRP 0.5.0release
MC 1.21.11fabric
May 26, 2026

How to Install PxIgnis on Your Server

1

Order Server

Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).

2

Set fabric Loader

In the panel under "Egg", select the fabric loader and matching Minecraft version (1.21.11).

3

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

fabric

Minecraft Versions

1.21.11

Server-side

Required

Recommended 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.

Rent Modded Server

Install PxIgnis with just one click on your server.

Recommended RAM
4 GBab €8/mo
Min. 3 GB | +1 GB pro 8 Spieler
Create Server Now
1-Click Mod Install
NVMe SSD Storage
DDoS Protection included

Details

License
GNU Lesser General Public License v3.0 only
Server-side
Required

Supported Versions

1.21.11