MC JS 标识

⚡ MC JS · 开发实战

Minecraft 基岩版 · 现代JavaScript模组指南

MC JS 开发概览

🎯 什么是 MC JS?

MC JS 是 Minecraft 基岩版(Bedrock Edition)的官方脚本框架,基于 JavaScript 快速创建行为包、自定义物品、实体AI与交互事件。无需Java基础,前端开发者也能轻松上手!

⛏️ 适用版本 1.20+
📘 基础入门
快速开始

🚀 快速开始

新建行为包,配置 manifest.json 与 scripts/main.js。使用 system.afterEvents 监听玩家动作,10行代码实现自定义反馈。

脚本核心

🧩 核心API

掌握 @minecraft/server 模块:Entity、Player、Dimension、ItemStack…… 一切皆对象,链式调用更高效。

⚙️ 进阶技巧
自定义物品

🪄 自定义物品与方块

通过 ItemComponentBlockComponent 注册独特功能:右击触发、耐久机制、自定义渲染。

事件系统

⏱️ 事件驱动架构

利用 world.afterEventsworld.beforeEvents 控制游戏逻辑,实现玩家聊天监控、实体生成干预等。

🧠 常见问题与解答
MC JS 与 Java 版模组有什么区别?
MC JS 基于 JavaScript,无需编译、热加载,适合快速迭代;Java版模组使用Java,性能更强但开发门槛高。JS更偏向逻辑与事件,适合轻量玩法扩展。
如何调试 MC JS 脚本?
推荐使用 Visual Studio Code + 官方 Minecraft 调试器,或直接在游戏内使用 console.log 输出至日志窗口。也可配合 @minecraft/server-ui 制作调试面板。
脚本能否操作玩家背包与方块?
可以。通过 player.getComponent('inventory').container 访问背包,使用 dimension.getBlock 获取方块实例并修改状态。
MC JS 是否支持UI界面?
支持!使用 @minecraft/server-ui 模块创建表单、消息框、模态框,实现与玩家的图形交互。
如何提高脚本执行效率?
避免高频 tick 循环,优先使用事件驱动;善用 system.runInterval 控制频率,及时释放不需要的监听器。
🔧 推荐工具
📦 Bridge Editor
🧪 Minecraft Test
📘 官方脚本文档
💬 社区 Discord