Modrinth · Fabric, Forge, NeoForge, Quilt

KubeJS on your Minecraft server

KubeJS runs on Minecraft servers with Fabric or Forge or NeoForge or Quilt. Order your server, set the loader in the panel and install the mod with one click in the mod browser.

Edit recipes, add new custom items, script world events, all in JavaScript!

Downloads
23.1M
Author
Lat
Loader
Fabric, Forge, NeoForge, Quilt
Minecraft
1.18.2 – 26.1.2
Updated
–

Setup

Install KubeJS on your server

The server and players need the same loader and Minecraft version. Back up the world before adding or updating mods.

  1. 01

    Configure

    4 GB of RAM is preselected. You choose the term and add-ons and pay by credit card or PayPal.

  2. 02

    Set the loader

    In the panel, set the server software to Fabric or Forge or NeoForge or Quilt and choose the matching Minecraft version, for example 26.1.2.

  3. 03

    Install the mod

    Search the mod browser for “KubeJS” and install the release for your loader. Alternatively, upload the .jar to the mods folder via SFTP. Required dependencies are listed on the project page.

  4. 04

    Connect

    KubeJS is optional on the client. Players connect using the server address from the panel.

On the server
Optional
On the client
Optional
Loader
Fabric, Forge, NeoForge, Quilt
Minecraft
26.1.2, 1.21.1, 1.21 +5 more
License
GNU Lesser General Public License v3.0 only

The panel

Install mods, find errors.

Real screenshots from the Mado panel. Both come with every Minecraft server.

Mod browser

Modrinth and CurseForge, right in the panel.

The browser filters by your Minecraft version. Install mods with one click, without uploading .jar files.

Browser in the Mado panel with search, a CurseForge or Modrinth source switch and install buttons.

AI crash analysis

When a mod crashes, the analyzer reads the log.

Mods often fail on a wrong loader version, Java version or missing dependency. The analyzer names a likely cause and suggests a fix.

Optimization page in the Mado panel with the AI Log Analyzer enabled and a “Server Crashed” notice with an “Analyze Now” button.

Releases

Published releases

Pick the file that matches your server’s loader and Minecraft version. The server and players need the same release.

KubeJS · Modrinth
Original description by the project author

KubeJS


What does this mod do?

This mod lets you create scripts in JavaScript language to manage your server, add new blocks and items, change recipes and tags, add custom handlers for quest mods, change worldgen and more!

How to use it?

Run the game with mod installed once. It should generate kubejs folder in your minecraft directory with example scripts. startup scripts only get run once when the game loads. Those are for registering items, setting up configs etc. Server/data scripts are loaded when you join a world, those are better for things like clearlag, displaying custom login messages and world/player related things in general.

Video tutorial for 1.19.2

Can I reload scripts?

Yes, use /reload. Note: Not everything is reloadable. Some things require you to restart game, some only world, some work on fly.

I don't know JavaScript / I need help with this mod!

There's examples and pre-made scripts on KubeJS Wiki.

I have a question / suggestion / bug report!

If wiki didn't have the answer for what you were looking for, you can ask questions, make feature suggestions and report bugs here: KubeJS Support

FAQ

KubeJS questions

Question not listed? Ask our team.

KubeJS server crashes on startup – what to do?

Common causes: the loader or Minecraft version does not match the mod file, a dependency is missing, or RAM is too low. Check the log (latest.log) for “OutOfMemoryError”, “Mixin” or missing mods. At Mado, the AI crash analysis reads the log and suggests a cause. You can change the loader and version in the panel.

Which loader does KubeJS run on?

According to Modrinth, KubeJS supports Fabric, Forge, NeoForge, Quilt for Minecraft 26.1.2, 1.21.1, 1.21. Forge and Fabric files are not interchangeable: pick one loader for the server and clients.

How much RAM does a server with KubeJS need?

As guidance, 3–4 GB for a server with this mod. This is an estimate, not a measured minimum. More mods, many players and long view distances need more. The spark profiler shows whether a mod is costing tick time.

Ready for your server with KubeJS?

4 GB of RAM from €8.00 per month. 35% off your first month with MADO35.

Order server