# Box3JS \u2014 Minecraft Scripting Engine<\/p>\n
> **Beta** \u2014 APIs may change during early development. Feedback is welcome.<\/p>\n
**No Java, just TypeScript.** Build Minecraft minigames, RPG systems, and world mechanics with scripts that hot-reload in seconds.<\/p>\n
Built on Mozilla Rhino, Box3JS brings the Box3 coding style to Minecraft servers. Write TypeScript, run it instantly \u2014 no JDK, no Gradle, no server restarts.<\/p>\n
## Features<\/p>\n
– **TypeScript-first** \u2014 Full type declarations (`.d.ts`) with bilingual JSDoc, auto-complete in any editor
\n– **Box3-compatible API** \u2014 World, Entity, Player, Voxels, Storage, Database, HTTP, remoteChannel
\n– **110+ Minecraft extensions** \u2014 Scoreboards, BossBars, teams, world border, particles, fireworks, potions, custom blocks\/items\/sounds registration, and more
\n– **Client-side scripting** \u2014 Custom HUD, keyboard input, audio playback, client-side SQLite & HTTP
\n– **Project isolation** \u2014 Run multiple script projects independently, each with its own scope and callbacks
\n– **Sandbox mode** \u2014 Test safely; roll back all script-made changes on stop
\n– **Standalone compilation** \u2014 `\/box3script compile` packages your script into a distributable JAR<\/p>\n
## Quick Start<\/p>\n
“`
\n\/box3script create mygame
\n“`<\/p>\n
“`
\nnpm install && npm run build
\n“`<\/p>\n
“`
\n\/box3script sandbox mygame
\n\/box3script start mygame
\n“`<\/p>\n
Full guide: https:\/\/docs.box3lab.com\/box3js-mc<\/p>\n
## License<\/p>\n
Apache License 2.0<\/p>\n
—<\/p>\n
# Box3JS\uff08\u795e\u5c9b\u4ee3\u7801\uff09\u2014 Minecraft \u811a\u672c\u5f15\u64ce<\/p>\n
> **Beta** \u2014 \u65e9\u671f\u6d4b\u8bd5\u9636\u6bb5\uff0cAPI \u53ef\u80fd\u53d8\u52a8\uff0c\u6b22\u8fce\u53cd\u9988\u3002<\/p>\n
**\u4e0d\u5199 Java\uff0c\u53ea\u7528 TypeScript\u3002** \u5728 Minecraft \u91cc\u7528\u811a\u672c\u5f00\u53d1\u5c0f\u6e38\u620f\u3001RPG \u73a9\u6cd5\u3001\u4e16\u754c\u673a\u5236\uff0c\u70ed\u91cd\u8f7d\u79d2\u7ea7\u751f\u6548\u3002<\/p>\n
Box3JS \u57fa\u4e8e Mozilla Rhino \u5f15\u64ce\uff0c\u5ef6\u7eed\u4e86\u795e\u5947\u4ee3\u7801\u5c9b\u7684 API \u98ce\u683c\u3002\u65e0\u9700 JDK\u3001\u65e0\u9700 Gradle\u3001\u65e0\u9700\u91cd\u542f\u670d\u52a1\u5668\uff0c\u5199 TypeScript \u5373\u5199\u5373\u8dd1\u3002<\/p>\n
## \u7279\u6027<\/p>\n
– **TypeScript \u4f18\u5148** \u2014 \u5b8c\u6574\u7c7b\u578b\u58f0\u660e\uff08`.d.ts`\uff09\uff0c\u53cc\u8bed JSDoc\uff0c\u4efb\u610f\u7f16\u8f91\u5668\u5747\u6709\u81ea\u52a8\u8865\u5168
\n– **Box3 \u517c\u5bb9 API** \u2014 World \/ Entity \/ Player \/ Voxels \/ Storage \/ Database \/ HTTP \/ remoteChannel
\n– **110+ MC \u6269\u5c55** \u2014 \u8bb0\u5206\u677f\u3001Bossbar\u3001\u961f\u4f0d\u3001\u4e16\u754c\u8fb9\u754c\u3001\u7c92\u5b50\u3001\u70df\u82b1\u3001\u836f\u6c34\u3001\u81ea\u5b9a\u4e49\u65b9\u5757\/\u7269\u54c1\/\u97f3\u6548\u6ce8\u518c\u7b49
\n– **\u5ba2\u6237\u7aef\u811a\u672c** \u2014 \u81ea\u5b9a\u4e49 HUD\u3001\u952e\u76d8\u8f93\u5165\u3001\u97f3\u6548\u64ad\u653e\u3001\u5ba2\u6237\u7aef SQLite & HTTP
\n– **\u9879\u76ee\u9694\u79bb** \u2014 \u591a\u811a\u672c\u9879\u76ee\u72ec\u7acb\u8fd0\u884c\uff0c\u5404\u81ea\u62e5\u6709\u72ec\u7acb\u4f5c\u7528\u57df\u548c\u56de\u8c03
\n– **\u6c99\u76d2\u6a21\u5f0f** \u2014 \u653e\u5fc3\u6d4b\u8bd5\uff0c\u505c\u6b62\u540e\u56de\u6eda\u4e00\u5207\u811a\u672c\u6539\u52a8
\n– **\u72ec\u7acb\u7f16\u8bd1** \u2014 `\/box3script compile` \u4e00\u952e\u6253\u5305\u4e3a\u53ef\u5206\u53d1 JAR<\/p>\n
## \u5feb\u901f\u5f00\u59cb<\/p>\n
“`
\n\/box3script create mygame
\n“`<\/p>\n
“`
\nnpm install && npm run build
\n“`<\/p>\n
“`
\n\/box3script sandbox mygame
\n\/box3script start mygame
\n“`<\/p>\n
\u5b8c\u6574\u6559\u7a0b\uff1ahttps:\/\/docs.box3lab.com\/box3js-mc<\/p>\n
## \u8bb8\u53ef\u8bc1<\/p>\n
Apache License 2.0<\/p>\n","protected":false},"excerpt":{"rendered":"
Box3JS is a Minecraft server-side mod inspired by Box3 coding style. You don\u2019t need to write Java \u2014 just use TypeScript to build scripts.<\/p>\n","protected":false},"featured_media":34352,"template":"","meta":{"_minecraft_slug":"box3js","_minecraft_project_id":"Wwdsb6Pg","_minecraft_author":"ifishcool","_minecraft_license":"Apache-2.0","_minecraft_downloads":34,"_minecraft_follows":2,"_minecraft_client_side":"optional","_minecraft_server_side":"optional","_minecraft_storage_type":"zip","_minecraft_archive_name":"box3js.zip","_minecraft_size_bytes":1940581,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-16T12:58:10.329733Z","_minecraft_date_created":"2026-05-07T23:29:55.882158Z","_minecraft_date_modified":"2026-05-15T08:38:31.003766Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/box3js","_minecraft_icon_attachment_id":34352,"_minecraft_imported_at":"2026-06-01T16:22:13+00:00","_minecraft_import_hash":"9e3d5135145c8293eca0375d52143e41","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[873,158,92],"mod_loader":[160],"minecraft_version":[37],"class_list":["post-34351","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-library","mod_category-neoforge","mod_category-utility","mod_loader-neoforge","minecraft_version-1-21-1"],"yoast_head":"\n