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.

34

Quick challenge

How far can you run before the mobs catch you?

Box3JS

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

- Standalone compilation — Full type declarations (`.d.ts`) with bilingual JSDoc, auto-complete in any editor - Standalone compilation — World, Entity, Player, Voxels, Storage, Database, HTTP, remoteChannel - Standalone compilation — Scoreboards, BossBars, teams, world border, particles, fireworks, potions, custom blocks/items/sounds registration, and more - Standalone compilation — Custom HUD, keyboard input, audio playback, client-side SQLite & HTTP - Standalone compilation — Run multiple script projects independently, each with its own scope and callbacks - Standalone compilation — Test safely; roll back all script-made changes on stop - Standalone compilation — `/box3script compile` packages 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 即写即跑。

特性

- 独立编译 — 完整类型声明（`.d.ts`），双语 JSDoc，任意编辑器均有自动补全 - 独立编译 — World / Entity / Player / Voxels / Storage / Database / HTTP / remoteChannel - 独立编译 — 记分板、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

ADS