Back to mods
Box3JS project artwork

CurseForge · Minecraft mod

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.

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which Box3JS release should I use?

Updated 6 months ago
beta file box3js-0.1.0-neoforge-mc1.21.1-beta.jar
Game version 1.21.1
Loader NeoForge

box3js-0.1.0-neoforge-mc1.21.1-beta.jar targets 1.21.1 with NeoForge. The project page does not say whether this file belongs on the client, dedicated server, or both. No extra mods listed for this file.

Where it goes

Is Box3JS required on the client, server, or both?

The project page does not say whether this file belongs on the client, dedicated server, or both.

Client Source doesn’t say
Dedicated server Source doesn’t say
Loader for this release NeoForge
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

The source does not explicitly classify this release as client-only or server-only.

What else does box3js-0.1.0-neoforge-mc1.21.1-beta.jar need?

box3js-0.1.0-neoforge-mc1.21.1-beta.jar. Change the file and its required mods may change too.

No extra mods listed for this file

This file does not list any required mods. Do not add a library just because a different file uses it.

This file does not list any required or optional mods.

Before you install it

Add Box3JS without breaking your instance.

Built for box3js-0.1.0-neoforge-mc1.21.1-beta.jar. Pick another file and the loader, install side or required mods may change.

  1. 01

    Stick to this file

    Use box3js-0.1.0-neoforge-mc1.21.1-beta.jar. It targets 1.21.1 with NeoForge; another release may have different loader, side or dependency requirements.

  2. 02

    Bring the mods it needs

    This file does not list any required mods. Do not add a library just because a different file uses it.

  3. 03

    Put it on the correct side

    The project page does not say whether this file belongs on the client, dedicated server, or both.

  4. 04

    Pick the file you checked

    Use the “Get this file” button beside box3js-0.1.0-neoforge-mc1.21.1-beta.jar. It opens that exact file at the source.

About this project

What does Box3JS add?

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 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 即写即跑。

特性

  • 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

Project description from CurseForge.

Pick your setup

Box3JS by Minecraft version and loader

Choose the version and loader you play, then open the matching release.

1 available setups

Check the dependencies, then try the file in a copied instance before changing a world you care about.

Recent files

Box3JS versions and loaders

1 of 1 releases match

Looking for an older file? The official CurseForge project page is in Resources.