ModsFinder

Box3JS

by ifishcool

Box3JS is a NeoForge scripting library for Minecraft 1.21.1 that lets scripts written in TypeScript drive gameplay, in a coding style inspired by Box3.

NeoForgeClient or server, optionalApache License 2.0Open source1.21.1

What it does

Creators can use Box3JS to make minigames, RPG-style progression and changes to how the world behaves, all driven by scripts instead of Java. Scripts are written in TypeScript, and the mod ships full .d.ts type declarations with bilingual JSDoc, so an editor can offer auto-completion. Scripts reload within seconds while the server runs, and the Box3-compatible API covers the world, entities, players, voxels, storage, a database, HTTP and a remote channel. More than 110 Minecraft extensions are exposed as well, including scoreboards, boss bars, teams, world border control, particles, fireworks and potions, along with registration of blocks, items and sounds.

The mod has a server-side part and a client-side part. On the client, scripts can draw a custom HUD, read keyboard input, play audio, and use a local SQLite database and HTTP access. Each script project runs in its own isolated scope with its own callbacks, so several projects can run together without interfering. A sandbox mode lets a script be tested safely, and changes a script made to the world can be rolled back. Finished scripts are packaged into a distributable JAR with the box3script compile command.

Box3JS is open source under the Apache License 2.0 and is published for NeoForge on 1.21.1 only, with 0.1.0-neoforge-mc1.21.1-beta as the latest file in the beta channel. It is classed as a library and utility mod. Either side can run it, and neither side needs it.

Key features

  1. TypeScript-first scripting

    Scripts are written in TypeScript and built with build scripts, so no Java code is needed to create content.

  2. Type declarations and JSDoc

    Full .d.ts declarations with bilingual JSDoc give editors auto-completion for the whole API.

  3. 110+ Minecraft extensions

    Scoreboards, boss bars, teams, world border, particles, fireworks, potions and custom content are reachable from scripts.

  4. Hot reload and project isolation

    Scripts reload in seconds, and each project runs independently in its own scope with its own callbacks.

  5. Sandbox mode and rollback

    Scripts can be tested in a sandbox, and changes a script made to the world can be rolled back.

Compatibility

Latest build for each game version and loader.

No stable releases
Every published file is a beta or alpha build.
1.21.10.1.0-neoforge-mc1.21.1-beta
ReleaseBetaAlphaNot available

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

How it compares

Full comparison

NetworkJS-Reloaded is open source under the MIT License, server-side only and published for NeoForge 1.21.1, so clients need nothing. KubeX is open source under the MIT License and published for NeoForge 1.21.1. Players must run it, while the server may skip it. Rhino is open source under the Mozilla Public License 2.0, works on either side and neither side needs it, and is published for Fabric, Forge, NeoForge and Quilt across 1.18.2 – 26.1.2.

ModLoadersGame versionsEnvironmentUpdated
Box3JSNeoForge1.21.1Client or server, optional2026-05-22
NetworkJS-ReloadedNeoForge1.21.1Server-side only2026-05-23
KubeXNeoForge1.21.1Client required, server optional2026-10-09
RhinoFabric, Forge, NeoForge and Quilt1.18.2 – 26.1.2Client or server, optional2026-07-19

Questions

Does Box3JS need to be installed on the client?

No. Either side can run it, and neither side needs it, so it can run on a server alone, on a client alone or on both.

Which Minecraft version does Box3JS support?

Box3JS is published for 1.21.1 only, for NeoForge. Files for other versions are not listed.

Do scripts need Java knowledge?

No. Scripts are written in TypeScript and compiled with build scripts, and the box3script command packages them into a JAR.

In the catalog

Box3JS is one of 3,514 Library mods on ModsFinder, and one of 1,449 Library mods for NeoForge. 32,366 mods support Minecraft 1.21.1.

More from ifishcool

All projects

Similar mods

What the author says

No Java, just TypeScript. Build Minecraft minigames, RPG systems, and world mechanics with scripts that hot-reload in seconds. Built on Mozilla Rhino, Box3JS brings the Box3 coding style to Minecraft servers. Write TypeScript, run it instantly — no JDK, no Gradle, no server restarts.
ifishcool, on the Modrinth page

Official listing

Owner
ifishcool
Published
2026-05-06
Updated on Modrinth
2026-05-22
Facts verified
2026-10-15

Tags