Box3JS

Box3JS

Box3JS 是一个受 Box3 编程风格启发的 Minecraft 服务端模组。你无需编写 Java——只需使用 TypeScript 来构建脚本。

基础库

Box3JS — Minecraft 脚本引擎

Beta — 早期开发阶段 API 可能变动,欢迎反馈。

不写 Java,只用 TypeScript。 用几秒内即可热重载的脚本构建 Minecraft 小游戏、RPG 系统和世界机制。

Box3JS 基于 Mozilla Rhino 构建,将 Box3 编程风格带到 Minecraft 服务器。编写 TypeScript,即时运行——无需 JDK、无需 Gradle、无需重启服务器。

特性

  • TypeScript 优先 — 完整类型声明(.d.ts)与双语 JSDoc,任意编辑器均可自动补全
  • Box3 兼容 API — World、Entity、Player、Voxels、Storage、Database、HTTP、remoteChannel
  • 110+ Minecraft 扩展 — 记分板、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