用途:为 Minecraft 基岩版 Script API 的 @minecraft/server 模块提供编写指导,适用于回答服务端脚本、世界与系统事件、实体组件、自定义命令、调度与权限模式相关问题。默认使用最新稳定版,除非明确要求 beta/preview。
主要能力:梳理事件订阅与退订、维度获取、组件存在性检查与类型化 ID、调度方法(system.run、runTimeout、runInterval、runJob)、标识符规范(必须使用 @minecraft/vanilla-data 枚举,如 MinecraftBlockTypes、MinecraftEntityTypes、MinecraftDimensionTypes 等;自定义 ID 需带命名空间前缀且每个附加包保持一致)。还涵盖自定义命令注册(CustomCommand、CustomCommandParameter、CustomCommandRegistry.registerEnum/registerCommand)、脚本事件收发(system.sendScriptEvent、scriptEventReceive)以及性能与类型安全建议。
使用方式:以 Microsoft Learn 为事实来源,从模块索引导航到具体类、接口或事件;细节缺失时通过 MCP 搜索(端点 https://learn.microsoft.com/api/mcp,工具 microsoft_docs_search 与 microsoft_docs_fetch)。输出时引用准确 API 名称,提供含必要 import 的最小可运行示例,并在创建自定义辅助函数前确认官方无等价实现。对 CustomCommandParamType 等枚举须查 Microsoft Learn 确认可用性;@minecraft/vanilla-data 不在 Microsoft Learn 上,跳过其 MCP 搜索。
限制与注意:只读模式(模拟/事件/刻开始前)不得修改世界,需延迟到 system.run/runTimeout/runJob;早期执行阶段许多 API 不可用,需延迟到 world.afterEvents.worldLoad 或 system.run,并在根级订阅事件以免遗漏。使用任何方法或属性前须查文档确认是否只读安全或早期执行安全,并留意受限执行说明;自定义命令回调以受限执行权限运行,不能直接调用只读受限方法。访问组件前先检查存在性,避免空组件;重事件用 system.runJob 分摊到多个刻;避免裸 ID,使用类型化枚举。
适用场景:编写或审查基岩版服务端脚本、排查权限与执行时机问题、设计自定义命令与脚本事件通信。资料未提供具体版本号、安装命令或收费信息。