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.
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
TypeScript-first scripting
Scripts are written in TypeScript and built with build scripts, so no Java code is needed to create content.
Type declarations and JSDoc
Full .d.ts declarations with bilingual JSDoc give editors auto-completion for the whole API.
110+ Minecraft extensions
Scoreboards, boss bars, teams, world border, particles, fireworks, potions and custom content are reachable from scripts.
Hot reload and project isolation
Scripts reload in seconds, and each project runs independently in its own scope with its own callbacks.
Sandbox mode and rollback
Scripts can be tested in a sandbox, and changes a script made to the world can be rolled back.
Gallery
Compatibility
Latest build for each game version and loader.
Only full game releases are shown. This mod publishes no snapshot builds.
How it compares
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.
| Mod | Loaders | Game versions | Environment | Updated |
|---|---|---|---|---|
| Box3JS | NeoForge | 1.21.1 | Client or server, optional | 2026-05-22 |
| NetworkJS-Reloaded | NeoForge | 1.21.1 | Server-side only | 2026-05-23 |
| KubeX | NeoForge | 1.21.1 | Client required, server optional | 2026-10-09 |
| Rhino | Fabric, Forge, NeoForge and Quilt | 1.18.2 – 26.1.2 | Client or server, optional | 2026-07-19 |
Questions
Does Box3JS need to be installed on the client?
Which Minecraft version does Box3JS support?
Do scripts need Java knowledge?
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
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.
Official listing
- Modrinth page
- modrinth.com/mod/box3js
- Owner
- ifishcool
- Published
- 2026-05-06
- Updated on Modrinth
- 2026-05-22
- Facts verified
- 2026-10-15
