BetaMoon

BetaMoon - A Lua Scripting Engine for Beta 1.7.3

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.

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 functionalities:

• Blocks
• Items
• Tools, Armor and their Materials
• Recipes and Recipe Types
• Interactable Items and Blocks
• Custom Biomes
• Ore Generation for Blocks
• Overriding existing Blocks, Items, etc.
• TileEntities, Containers and Block GUIs
• EventHandlers
• Sending chat messages

You can also use custom Textures for any Block, Item (includes Tools and Armor) or GUI.



Because BetaMoon uses IDs for Blocks and Items like any other Mod, there should be no problem to expand on existing Mods and use their Blocks and Items in your scripts.
BetaMoon also includes a query-API which can make finding Blocks, Items, etc. easier.



A simple Dependency system let's you access content that other scripts export, because BetaMoon makes sure to load all scripts in the correct order.



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.