PxRP
ModA 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.
Type
Mod
Modrinth Downloads
12
Modrinth ID
SYYlZZEi
Last Updated
May 28, 2026
Description
PxRP 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 PxRP 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 /pxrp 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, "pxrp.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 PxRP on your Fabric server.
- The first boot generates a config/pxrp/demo.lua configuration file containing basic usage examples.
- Edit your scripts and use /pxrp 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
Compatibility
Mod Loaders
Game Versions
Similar Mods
Backrooms: The Complex
A survival friendly, lore accurate backrooms mod with high quality visuals.
Paintball Mod Revival
Paintball Mod Revival is a full revival and modern port of the original Paintball mod
Researcher
A data-driven research system inspired by Factorio.
Middle-earth Adventures
This mod adds items, biomes, mob and also, structures!
GPU Land
My attempt at worldgen on the gpu
Hoglin Cavalry│疣豬獸騎兵
Piglins and Hoglins are now allies, and Piglins have a chance to spawn riding Hoglins.│豬布林和疣豬獸現在是盟友,豬布林...