Compatibility
Minecraft: Java Edition
Platforms
Supported environments
Tags
Creators
Details
BetaMoon - A Lua Scripting Engine for Beta 1.7.3
BetaMoon needs a bit more setup during installation than most mods, so please follow the
Installation Instructions!
BetaMoon is a Lua scripting engine on top of Risugami's ModLoader and MinecraftForge for MC b1.7.3.
The goal is to provide an easy-to-use scripting layer for MC b1.7.3 to create custom content or functionalities for the game, similar to KubeJS with Lua instead of JS.
For simpler modifications, it extremely simplifies the modding process:
Setting up a modding environment, tackling with obfuscation and compile errors, etc.
Is simplified to just writing your Lua script and then starting Minecraft!
If something fails BetaMoon will report it to you while trying to prevent Minecraft from crashing.
But be aware for now: BetaMoon is still in very early development and can't offer everything you may want to add to Minecraft. Furthermore, multiplayer support is currently very limited and it's not adviced to install BetaMoon on a server!
This mod is designed with easy expandibility and backwards compatibility in mind, but breaking changes can still happen during pre-release phase and between major versions.
You can find a list of awesome BetaMoon Mods here (It's probably very empty at the moment)
Please Note
This is only a scripting engine. This mod itself does not add any content. Content has to be added using Lua scripts that use the provided Lua API of BetaMoon as explained in the Wiki.
Pre-Release Disclaimer
Even though the promise of being fully backwards compatible, while BetaMoon is in it's Pre-Release stage (Versions <1.0.0), breaking changes are sometimes not avoidable.
Please be aware of that and always look at the changelogs when you update to a new Pre-Release version!
Features
Currently BetaMoon offers following features:
- Custom Blocks
- Custom Items
- Custom Tools, Armor and their Materials
- Custom Recipes and Recipe Types
- Interactable Items and Blocks
- Custom Biomes
- Ore Generation for Blocks
- Overriding existing Blocks, Items, etc.
- Custom TileEntities, Containers and Block GUIs
- Creating EventHandlers
- Sending chat messages
- Custom Entities
- Custom animated Models using MC:BE json format
For a full overview and documentation visit the Wiki!
Installation
Requirements and Installation
- Java 8
- Minecraft Beta 1.7.3 (Recommended to be installed via MultiMC or similar client)
- Risugami's ModLoader
- MinecraftForge (1.0.6 is recommended if you have to use ModLoaderMP)
For installation instructions please refer to the Readme sections
Installing Scripts
Since BetaMoon automatically creates a lua_scripts directory in your .minecraft folder or minecraft instance folder if you use MultiMC/Prism, you can easily add new scripts by just dropping them in there.
BetaMoon logs every error it encounters when trying to load a mod and gives you a pop-up in the main menu that lists which scripts failed to load.
Unless a faulty script leads to a severe internal error, Minecraft won't crash! The script that caused the error just doesn't load.
Look at the GitHub page and Wiki to get further information on how to install and/or develop using BetaMoon!
Having Problems?
If you have any problem during installation and have followed all the installation steps correctly and just want to use the mod and not develop, feel free to contact me directly or using the GitHub Discussions
If you encounter any deeper problems that are not fixable by any given instruction or tip in the "Troubleshooting" section in the GitHub repository, please use the GitHub Issues!
If possible include your log files and a list of other mods you installed!
Please use the GitHub Issues if you want to propose future features, etc.


