**Wizards of Lua** brings Lua programming to Minecraft, allowing server operators to run Lua scripts directly within the game. This **Fabric**-based rewrite of the original but outdated Forge mod provides enhanced control and flexibility for modders, server administrators, and advanced users.<\/p>\n
## Applications
\n* Implement custom commands, rules, and behaviors.
\n* Develop engaging mini-games within the Minecraft environment.
\n* Customize game mechanics to suit your server\u2019s needs.<\/p>\n
## Examples
\nYou can transform your Minecraft server with custom Lua scripts. Here are some possibilities:
\n* **Mini-Games:** Construct games such as King of the Hill, Capture the Flag, or Journey.
\n* **Land Claiming:** Implement a system allowing players to claim specific areas for personal building.
\n* **Aggressive Bees:** Create a new breed of bees that attack players on sight.
\n* **Safe Zones:** Establish areas where player-versus-player combat is disabled.
\n* **Magic Wand:** Develop a wand that summons lightning bolts targeting hostile mobs.
\n* **Vertical Minecart:** Design a minecart capable of ascending and descending vertically using ladders.<\/p>\n
## Key Features
\n– **Run Lua Scripts In-Game:** Use the `\/lua` command followed by your script to execute Lua code directly in Minecraft.
\n– **Modify Minecraft:** Place blocks, summon mobs, handle player events, and create new mechanics using an extensive Lua API.
\n– **Start Scripting Instantly:** Jump straight into coding with Lua. No knowledge of Java or modding frameworks required.
\n– **Use External Script Files:** Include Lua files stored in the `config\/wizards-of-lua` folder and its subdirectories.
\n– **Code with Autocompletion:** Edit scripts in Visual Studio Code with IntelliSense and full type support.
\n– **Live Script Updates:** Modify your scripts while Minecraft is running. They\u2019re recompiled automatically when used. No server restart necessary.
\n– **Create Instant or Long-Lasting Effects:** Write quick scripts for immediate changes, or develop long-running programs that influence the Minecraft world over hours or days.
\n– **Define Dynamic Commands:** Create custom Brigadier commands at runtime that invoke Lua code and support auto-completion. Define placeholders (e.g. `%i`, `%player`) to pass arguments to your Lua script.
\n– **Trigger Scripts on Events:** Automatically react to in-game events, such as players joining, breaking blocks, or swinging tools, using event-based scripting.
\n– **Monitor and Manage Scripts:** Use `\/wol spell list` to view your running scripts and `\/wol spell break` to stop them when needed.
\n– **Debug Easily in Real Time:** Use `print()` or `log()` to send output directly to the console, chat, or log files. This makes it easy to debug your scripts while playing.
\n– **Access Dynamic Server Data (Optional):** Use Placeholder API values in your scripts for advanced integration with other server plugins.
\n– **Use It Anywhere:** Create and run scripts in both singleplayer and multiplayer modes.
\n– **No Client Mods Needed:** Everything runs on the server. Players do not need to install anything.<\/p>\n
—<\/p>\n
## Command Permissions<\/p>\n
Wizards of Lua includes support for permission plugins like LuckPerms.
\nYou can grant access to specific commands using defined permission nodes.<\/p>\n
For a full list of permission nodes and required levels, see the Commands documentation.<\/p>\n
## Versioning<\/p>\n
This project uses Semantic Versioning. A version number follows the format:<\/p>\n
“`
\nMAJOR.MINOR.PATCH-MCVERSION
\n“`<\/p>\n
For example:
\n“`
\n4.0.2-1.21.11
\n“`<\/p>\n
The part before the `-` follows Semantic Versioning and determines compatibility with your Lua scripts. The part after the `-` indicates the Minecraft version the mod was built for.<\/p>\n
– You can safely update the mod if the **MINOR** or **PATCH** number increases.
\n– If the **MAJOR** version number increases, consult the changelog because breaking changes may have been introduced, and your Lua scripts might need to be updated manually.<\/p>\n
## Documentation<\/p>\n
For detailed documentation and ready-to-use examples, please refer to the documentation pages.<\/p>\n
## Quick Start Video<\/p>\n
To get started quickly, watch the quick start guide on YouTube.<\/p>\n","protected":false},"excerpt":{"rendered":"
Wizards of Lua brings the power of Lua scripting to Minecraft.
\nIt adds the \/lua command, allowing you to cast spells and interact with the game using Lua scripts.<\/p>\n","protected":false},"featured_media":170900,"template":"","meta":{"_minecraft_slug":"wizards-of-lua","_minecraft_project_id":"HW3198Ve","_minecraft_author":"mickkay","_minecraft_license":"LGPL-3.0-or-later","_minecraft_downloads":2563,"_minecraft_follows":15,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"wizards-of-lua.zip","_minecraft_size_bytes":103720072,"_minecraft_version_count":126,"_minecraft_updated_at":"2026-05-15T18:42:11.790701Z","_minecraft_date_created":"2025-03-29T03:28:41.250832Z","_minecraft_date_modified":"2026-04-14T11:08:46.052841Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/wizards-of-lua","_minecraft_icon_attachment_id":170900,"_minecraft_imported_at":"2026-06-09T21:07:02+00:00","_minecraft_import_hash":"b165f678a6d855fd7e5f154d80bdbdd1","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[97,89,873,122,92],"mod_loader":[99],"minecraft_version":[37,40,41,73,38,81,82],"class_list":["post-170899","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-fabric","mod_category-game-mechanics","mod_category-library","mod_category-magic","mod_category-utility","mod_loader-fabric","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-4","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n