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 without letting Minecraft crash!

But be aware for now. BetaMoon is still in very early development and therefore only offers basic functionality.
But this mod is designed with easy expandibility and backwards compatibility in mind, so you can already start to develope scripts and don't have to worry about it breaking in the future!

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) there might come breaking changes!
I try to avoid those as much as possible, but sometimes it's not avoidable so please be aware and always look at the changelogs when you update to a new Pre-Release version!

Features

Currently BetaMoon offers you the ability to add:

• Blocks
• Items
• Tools
• Armor
• Recipes
• Biomes
• Ore Generation for Blocks

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

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!

Because of a simple Dependency system you can access content that other scripts export, because BetaMoon makes sure to load your script after the ones you depend on.

For a full overview and documentation visit the Wiki!

Installation

Requirements

• 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)
• LuaJ (luaj-jse-3.0.1.jar)
  

**For all download links and further information for all requirements please visit the [GitHub Repo](https://github.com/OWeinert/BetaMoon/tree/main).**

Installation with MultiMC/Prism

MultiMC is the easiest and safest way to install legacy mods because it keeps everything in one instance without the need to modify the minecraft.jar and global Java path yourself. Of course you can use other similar clients like Prism, but the setup process might be different there. For Prism specifically, the setup may be the same since it's a direct fork of MultiMC.

1. Download and install Java 8
   • Download and install Java 8 using the link in Requirements.
     
     
2. Create a new instance in MultiMC
   • Instance version: Minecraft Beta 1.7.3
   • Right-click the instance -> Edit Instance -> Settings
   • Click on "Java installation" and "Browse..."
   • Select the javaw.exe from your Java 8 installation (for Adoptium it's defaulted to "C:/Program Files/Eclipse Adoptium/jre-W.X.YYY.Z-hotspot/bin/javaw.exe" on Windows, where W/X/Y/Z are numbers for the version you downloaded).
     For other OS' it will vary.
     
     
3. Install ModLoader and MinecraftForge
   • Download Risugami's ModLoader and MinecraftForge from the links in Requirements.
   • Right-click the instance -> Edit Instance -> Version tab
   • Click "Add to Minecraft.jar"
   • Add ModLoader first, then add MinecraftForge second
   • Order matters: ModLoader must be applied before Forge
     
     
4. Add BetaMoon and LuaJ
   • In the same Edit Instance window, open the "Loader mods" section
   • Add betamoon-X.Y.Z.jar (X.Y.Z is the version, e.g. "0.1.0") and luaj-jse-3.0.1.jar using the "Add" button on the top right.
   • If MultiMC lists them, make sure both are enabled
     
     
5. Run the instance
   • Start the instance and verify no ModLoader/MinecraftForge or BetaMoon errors appear on launch in the console.
     
     
6. Install BetaMoon scripts or start developing your own!
   

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.
The best thing: Minecraft doesn'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 develope 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.