Box3JS
Box3JS is a Minecraft server-side mod inspired by Box3 coding style. You don’t need to write Java — just use TypeScript to build scripts.
Screenshots
About this Mod
Box3JS — Minecraft Scripting Engine
Beta — APIs may change during early development. Feedback is welcome.
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.
Features
- TypeScript-first — Full type declarations (
.d.ts) with bilingual JSDoc, auto-complete in any editor - Box3-compatible API — World, Entity, Player, Voxels, Storage, Database, HTTP, remoteChannel
- 110+ Minecraft extensions — Scoreboards, BossBars, teams, world border, particles, fireworks, potions, custom blocks/items/sounds registration, and more
- Client-side scripting — Custom HUD, keyboard input, audio playback, client-side SQLite & HTTP
- Project isolation — Run multiple script projects independently, each with its own scope and callbacks
- Sandbox mode — Test safely; roll back all script-made changes on stop
- Standalone compilation —
/box3script compilepackages your script into a distributable JAR
Quick Start
/box3script create mygame
npm install && npm run build
/box3script sandbox mygame
/box3script start mygame
Full guide: https://docs.box3lab.com/box3js-mc
License
Apache License 2.0
Box3JS（神岛代码）— Minecraft 脚本引擎
Beta — 早期测试阶段，API 可能变动，欢迎反馈。
不写 Java，只用 TypeScript。 在 Minecraft 里用脚本开发小游戏、RPG 玩法、世界机制，热重载秒级生效。
Box3JS 基于 Mozilla Rhino 引擎，延续了神奇代码岛的 API 风格。无需 JDK、无需 Gradle、无需重启服务器，写 TypeScript 即写即跑。
特性
- TypeScript 优先 — 完整类型声明（
.d.ts），双语 JSDoc，任意编辑器均有自动补全 - Box3 兼容 API — World / Entity / Player / Voxels / Storage / Database / HTTP / remoteChannel
- 110+ MC 扩展 — 记分板、Bossbar、队伍、世界边界、粒子、烟花、药水、自定义方块/物品/音效注册等
- 客户端脚本 — 自定义 HUD、键盘输入、音效播放、客户端 SQLite & HTTP
- 项目隔离 — 多脚本项目独立运行，各自拥有独立作用域和回调
- 沙盒模式 — 放心测试，停止后回滚一切脚本改动
- 独立编译 —
/box3script compile一键打包为可分发 JAR
快速开始
/box3script create mygame
npm install && npm run build
/box3script sandbox mygame
/box3script start mygame
完整教程：https://docs.box3lab.com/box3js-mc
许可证
Apache License 2.0
Available Versions
How to Install Box3JS on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set neoforge Loader
In the panel under "Egg", select the neoforge loader and matching Minecraft version (1.21.1).
Install Mod
Open the mod browser in the dashboard and search for "Box3JS". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
1.21.1
Server-side
~ OptionalRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
Box3JS server crashes on startup – what to do?
Most common cause: wrong neoforge version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (1.21.1). You can switch loaders with one click in the panel.
Is Box3JS compatible with neoforge?
Box3JS officially supports neoforge for Minecraft 1.21.1. The Mado dashboard automatically detects incompatible loader combinations.
Server lagging with Box3JS – how to optimize performance?
Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if Box3JS consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.
Similar Mods
Rent Modded Server
Install Box3JS with just one click on your server.