Welcome to the Hangar Open Beta. Please report any issue you encounter on GitHub!
Avatar for DarkWhite

A lightweight Lua scripting engine

Report MineLua?

Unstable
0.1-PRE-ALPHA

DarkWhite released MineLua version 0.1-PRE-ALPHA on December 5, 2025

**🎉 First public release of MineLua! This is a Proof-of-Concept build introducing the core Lua engine and modular API.

🚀 New Features**:

  • LuaJ Engine: Full integration of Lua 5.2 environment within Minecraft. Script Loading: Automatically loads all .lua files from /plugins/MineLua/scripts/.
  • Hot Reload: Added /minelua reload command to update scripts instantly without restarting the server. Example Generation: Automatically creates example.lua on first launch to help you get started.

🛠 Lua API (The mc object): General: mc.log(text), mc.getVersion() Chat: mc.broadcast(text), mc.color(text) Player Interaction: mc.getName(player) — Safely retrieves player name. mc.sendMessage(player, text) mc.kick(player, reason) Visuals: mc.title(player, title, subtitle), mc.sound(player, soundName) Scheduler: mc.wait(ticks, callback) — Create delays and timers!

⚡ Events Implemented: onPlayerJoin(player) onBlockBreak(player, block) onChat(player, message) — Return "cancel" string to block the message.

🐛 Bug Fixes & Technical: Implemented CoerceLuaToJava logic in PlayerModule to prevent userdata expected, got table errors when interacting with Player objects. Added null-checks for global Lua environment to prevent crashes during reload.

⚠️ Note: This is an UNSTABLE build. The Player API has been updated to fix LuaJ conversion issues but hasn't been fully stress-tested on live servers yet. Please report any bugs!

Information

Published onDecember 5, 2025
Downloads1

Platforms

Paper Paper (1.21.10)