ModsFinder

KubeJS

by KubeJS

KubeJS lets scripts written in JavaScript change recipes, register new items and blocks, and react to world events on a Minecraft server or client.

FabricForgeNeoForgeQuiltClient or server, optionalGNU Lesser General Public License v3.0 onlyOpen source1.18.2 – 26.1.2

What it does

KubeJS lets scripts in the JavaScript language manage a server, register custom blocks and items, edit recipes and tags, add handlers for quest mods and adjust world generation. Scripts live in a kubejs folder that is created the first time the game runs with the mod installed, and the folder comes with example scripts to start from.

Scripts fall into two groups. Startup scripts run once when the game loads and are used for registering items and setting up configuration. Server and data scripts load when a player joins a world and suit tasks such as clearing lag entities, showing custom login messages or handling player-related logic. The /reload command re-runs scripts, but some changes need a full game restart and some need a world reload.

Required dependencies are Architectury API, Better Advanced Tooltips, Fabric API and Rhino. Fabric, Forge, NeoForge and Quilt builds span eight release versions, 1.18.2 – 26.1.2. KubeJS is open source under the GNU Lesser General Public License v3.0 only, and works on either side, and neither needs it.

Key features

  1. Custom items and blocks

    Scripts can register new items and blocks at startup, along with their properties and textures.

  2. Recipe and tag editing

    Recipes can be added, removed or changed, and item tags can be edited from scripts without touching data packs.

  3. Event scripts

    Server and data scripts respond to world and player events when a world loads or a player joins.

  4. Live reloading

    The /reload command applies many script changes without restarting, though some changes still need a restart.

  5. Example scripts

    The generated kubejs folder includes example scripts, and the KubeJS wiki collects pre-made scripts for common tasks.

Compatibility

Latest build for each game version and loader.

26.1.2Not availableNot available26.1.2-8.0.7+neoforgeNot available
1.21.1Not availableNot available2101.7.2-build.377Not available
1.21Not availableNot available2101.7.2-build.377Not available
1.20.4Not availableNot available2004.7.0-build.26+KubeJS-1.20.4Not available
1.20.12001.6.5-build.26+fabric2001.6.5-build.26+forge2001.6.5-build.14+forge2001.6.5-build.26+fabric
1.19.21902.6.2-build.73+fabric1902.6.2-build.73+forgeNot available1902.6.2-build.73+fabric
1.191900.5.5-build.27+fabric1900.5.5-build.27+forgeNot available1900.5.5-build.27+fabric
1.18.21802.5.5-build.569+fabric1802.5.5-build.569+forgeNot available1802.5.5-build.569+fabric
ReleaseBetaAlphaNot available

Only full game releases are shown. This mod publishes no snapshot builds.

Requirements

Dependencies declared by the latest file for each loader.

Required 3

RhinoA fork of Mozilla's Rhino library, modified for use in mods
Required
Fabric APILightweight and modular API providing common hooks and intercompatibility measures utilized by mods using the Fabric toolchain.
Required
Architectury APIAn intermediary api aimed to ease developing multiplatform mods.
Required

Required by 171 mods

LootJS: KubeJS Addon1.18.2 – 26.1.2KubeJS Additions1.18.2 – 1.21.1KubeJS Create1.16.2 – 1.21.1Re-FTBQLocalizationKeys1.16.4 – 1.20.2Ponder for KubeJS1.18.2 – 1.21.1EntityJS1.19.2 – 1.21.1

Use cases

Server maintenance

Server owners can clear lag entities, send custom login messages and run player-related logic from data scripts.

Modpack tweaks

Pack authors can change recipes and tags across a modpack from one set of scripts instead of a data pack.

Who it’s for: Modpack authors and server owners who want to script changes in JavaScript. Players with no scripting experience can use the examples and pre-made scripts on the KubeJS wiki.

How it compares

Full comparison

Palladium is a Fabric, Forge, NeoForge and Quilt mod for 1.20.1 that runs client and server and is under All rights reserved, so it is not open source. RecipeDisabler is server-side only and open source under the MIT License, for 1.18.2 – 1.19 on Fabric and Quilt. CraftTweaker is open source under the MIT License, runs client and server, and covers 1.3.2 – 1.21.1 on Fabric, Forge and NeoForge.

ModLoadersGame versionsEnvironmentUpdated
KubeJSFabric, Forge, NeoForge and Quilt1.18.2 – 26.1.2Client or server, optional2026-10-15
PalladiumFabric, Forge, NeoForge and Quilt1.20.1Client and server2026-08-23
RecipeDisablerFabric and Quilt1.18.2 – 1.19Server-side only2022-09-13
CraftTweakerFabric, Forge and NeoForge1.3.2 – 1.21.1Client and server2026-03-17

Questions

Does KubeJS need Fabric API on Forge?

No. Required only on Fabric, the API is not needed on Forge. Architectury API, Better Advanced Tooltips and Rhino are required on every loader.

Does a server need KubeJS installed?

A server can run it without every player installing it, since the mod works on either side, and neither needs it, but startup and data scripts only take effect where the mod is present.

Why does a script change not apply after /reload?

Not every change is reloadable. Some need a game restart and some need a world reload, as noted in the mod's documentation.

Where can the example scripts be found?

The generated kubejs folder contains examples, and the KubeJS wiki has pre-made scripts for common tasks.

In the catalog

KubeJS is one of 3,514 Library mods on ModsFinder, and one of 2,348 Library mods for Fabric. 15,189 mods support Minecraft 26.1.2.

Library mods3,514Fabric modsMods for 26.1.215,189

More from KubeJS

All projects
Rhino1.18.2 – 26.1.2KubeJS Create1.16.2 – 1.21.1KubeJS Thermal1.16.2 – 1.20.1KubeJS Mekanism1.16.2 – 1.21.1KubeJS Immersive Engineering1.16.2 – 1.19.2

Similar mods

Fabric API1.14 – 26.3Cloth Config API1.14 – 26.3YetAnotherConfigLib (YACL)1.19 – 26.3Architectury API1.16.5 – 26.3Just Enough Items (JEI)1.8 – 26.3Geckolib1.12.2 – 26.3

What the author says

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! Run the game with mod installed once. It should generate kubejs folder in your minecraft directory with example scripts…
KubeJS, on the Modrinth page

Official listing

Owner
KubeJS
Published
2022-05-24
Updated on Modrinth
2026-10-15
Facts verified
2026-10-15

Tags

LibraryUtility
Open on ModrinthCompare