MCJS是基于JavaScript语言的我的世界（Minecraft）开发框架，适用于基岩版（Bedrock Edition）的模组、插件与脚本开发。它让开发者能够利用JavaScript快速创建游戏功能、自定义实体、管理事件等。

MCJS与Mod SDK有什么区别？

MCJS使用JavaScript作为开发语言，门槛较低，开发效率高，适合快速迭代和中小型项目。Mod SDK通常使用C++或Java，功能更底层，性能更强，适合大型核心模组。MCJS更适合快速开发和轻量级模组。

MCJS - 我的世界JavaScript开发指南 | 高效开发·智能拓展

Q: 学习MCJS需要哪些基础？

学习MCJS需要掌握JavaScript基础语法（变量、函数、对象、事件），了解Minecraft基岩版的基本游戏机制。如果有其他编程语言经验会更容易上手，但零基础也可以从入门教程开始学习。

MCJS 是什么？ Overview

MCJS 是一套基于 JavaScript 的 Minecraft（我的世界）基岩版 开发框架。它让开发者能够使用轻量、灵活的 JS 语言快速构建游戏模组、自定义实体、物品、事件监听以及 UI 交互，大幅降低模组开发门槛。

无论你是经验丰富的 MC 模组作者，还是刚刚接触编程的玩家，MCJS 都能帮助你以更高效的方式实现创意。搭配现代 JavaScript 特性（箭头函数、Promise、模块化），让游戏开发变得像写网页一样流畅。

▲ MCJS 连接 JavaScript 与 Minecraft 基岩版，开启高效开发

⚡ 核心特性 Features

🚀

零配置启动

无需复杂环境，安装即可编写脚本，秒级热更新。

🧩

丰富 API

覆盖实体、物品、维度、事件、计分板等核心模块。

📦

模块化开发

支持 ES Module 规范，代码复用更简单。

⚙️

热重载

修改代码后无需重启游戏，即时生效，迭代飞快。

🌐

跨平台

兼容 Windows、Android、iOS 基岩版，一次编写多端运行。

📚

中文文档

完善的简体中文教程与示例，新手友好。

MCJS 的设计哲学是 「简单、高效、有趣」，让开发者专注于创意本身，而非繁琐的配置。

💻 代码示例 Code

以下是一个简单的 MCJS 脚本，当玩家进入游戏时发送欢迎消息，并创建一个自定义物品：

                // ===== MCJS 入门示例 =====
                import { World, Player, ItemStack } from '@mcjs/core';

                // 监听玩家加入事件
                World.events.on('playerJoin', (event) => {
                const player = event.player;
                player.sendMessage('§a欢迎来到 MCJS 世界！');
                player.sendMessage('§7使用 /js help 查看帮助');

                // 给予玩家一个自定义物品
                const customSword = new ItemStack('mcjs:guide_sword', 1);
                player.giveItem(customSword);
                });

                // 自定义物品注册
                World.items.register('guide_sword', {
                displayName: '§b✦ 引导之剑 ✦',
                damage: 7,
                lore: ['§7MCJS 入门信物', '§7右键查看教程']
                });
            

只需几行代码，就能实现物品注册、事件监听、玩家交互等强大功能。MCJS 的 API 设计贴近直觉，配合完整的类型定义，编码体验丝滑。

❓ 常见问题 FAQ

汇集开发者最关心的问题，快速解决你的疑惑。

MCJS 是否免费使用？ ▼

✅ 完全免费！MCJS 采用 MIT 开源协议，你可以自由使用、修改、分发。社区版已包含全部核心功能，无需付费。

学习 MCJS 需要哪些基础？ ▼

📖 建议掌握 JavaScript 基础语法（变量、函数、对象、数组）。如果完全零基础，可以先花 1-2 周学习 JS 入门教程，然后跟着 MCJS 官方文档实战，很快就能上手。

MCJS 与 Mod SDK 如何选择？ ▼

🛠️ 如果你追求快速开发、轻量模组、快速迭代，选 MCJS。如果你需要深度修改游戏核心机制、高性能计算或大型模组，Mod SDK（C++）更合适。MCJS 也支持混合开发，两者可以共存。

MCJS 支持哪些 Minecraft 版本？ ▼

📌 目前 MCJS 全面支持 Minecraft 基岩版 1.20+，并持续跟进最新版本。建议使用最新稳定版以获得最佳体验。

如何调试 MCJS 脚本？ ▼

🔧 MCJS 内置了调试工具：使用 /js debug 打开调试面板，支持日志输出、断点调试、变量监视。也可以配合浏览器 DevTools 进行远程调试，非常方便。

📦 资源与工具 Resources

官方推荐的开发工具、学习资源与社区项目，助你加速开发。

📘 官方文档

完整的 API 参考与入门指南，中文翻译持续更新。

🎮 示例模组

30+ 官方示例模组，从简单到复杂，开箱即用。

🛠️ VS Code 插件

语法高亮、自动补全、代码片段，开发效率翻倍。

🌍 开发者社区

Discord 与论坛，数千开发者在线交流答疑。

📦 模市场

分享与下载开源模组，互相学习，快速启动项目。

🎓 视频教程

从入门到进阶，系统性视频课程免费观看。

🚀 快速开始 Getting Started

只需三步，开启你的 MCJS 开发之旅：

安装 MCJS 加载器 — 从官网下载对应平台的安装包，一键安装。
创建项目文件夹 — 在 mcjs_projects 目录下新建 hello_mcjs 文件夹。
编写第一个脚本 — 创建 main.js，写入上面示例代码，保存后游戏内输入 /js load hello_mcjs 即可。

🎉 完成！你已经成功运行了第一个 MCJS 模组。更多教程请查阅官方文档。

📥 立即下载 MCJS