Publishing your Mod

You’ve developed a mod and want to share it with the community?
Here’s how to prepare and publish your mod using the official aiostool-cli.

🔧 Step 1: Build Your Mod

Make sure your mod contains a valid mod.json, including at least:

{"identifier": "yourModName","entryFile": "main.js","entryFunction": "main"}

If you have additional configuration files your mod needs (e.g., config.json), you can include them via the configs array:

"configs": ["config.json"]

Once everything is set up, open a terminal inside your mod folder and run:

aiostool build 

This command will:

• Bundle your mod using esbuild

• Validate structure and required functions

• Package everything into a .zip file (e.g. yourModName.zip)

☁️ Step 2: Upload the ZIP

Once your ZIP file is created, you can upload it via our Mod Upload Section.

Make sure your ZIP contains:

• mod.json

• the bundled main.js

• all config files listed in configs (if any)

📦 Done!

After uploading, your mod will be available for others to install, test, and use via the aiostool mod loader.
We highly recommend testing your mod via aiostool run or in development mode (-dev) before uploading.

If you have any questions, feel free to ask in the Modding Support section.
Happy modding!