Ballance Mod Loader Plus (BML+)

English | 简体中文

BML+ is a mod loader for BallancePlayer. It loads native and AngelScript mods and supplies the lifecycle, configuration, commands, UI, engine access, and inter-mod communication used by those mods.

BML+ supports BallancePlayer only. It does not support the original Ballance player.

Start here

I want to...	Read
Install BML+, install mods, or solve a loading problem	Use BML+
Create a native or script mod	Create mods
Build or change the BML+ loader	Contribute to BML+

Mod authors should use a released BML+ SDK. Building this repository is only required when changing BML+ itself.

Install and verify

1. Download BMLPlus-<version>.zip from Releases.
2. Extract the complete archive into the Ballance installation directory.
3. Confirm that BuildingBlocks/BMLPlus.dll exists. A script-capable release also contains BuildingBlocks/AngelScript.dll.
4. Start Bin/Player.exe.
5. Confirm that the BML+ version appears at the top of the game window, then check ModLoader/ModLoader.log for load errors.

BMLPlus-Update-<version>.zip is an updater payload, not a manual installation package. Use the full BMLPlus-<version>.zip archive for manual installation and recovery.

Press / in game to open the command bar. The bml command prints the loader version and loaded mods.

Project links

• Documentation
• Simplified Chinese documentation
• Releases
• Issues
• BallancePlayer

BML+ is licensed under the MIT License. It is based on Gamepiaynmo's original BallanceModLoader and work from the Ballance modding community.