القائمة
Required for Minecraft Bedrock Script API projects using sapi-pro. Use when creating, modifying, or debugging sapi-pro projects.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | sapi-pro-dev |
| description | Required for Minecraft Bedrock Script API projects using sapi-pro. Use when creating, modifying, or debugging sapi-pro projects. |
sapi-pro 是一个用于 Minecraft Bedrock Script API (简称：SAPI) 开发的npm框架。包含命令系统、表单导航、数据存储、多包通信与国际化等功能。
sapi-pro 分为 beta版和stable版。
常用模块：
@minecraft/server：核心 API@minecraft/server-ui：表单 API@minecraft/server-net：网络 API（服务器）@minecraft/server-admin：服务器管理 API（服务器）@minecraft/server-gametest：测试相关 APIsapi-pro 项目通常使用：
@minecraft/server@minecraft/server-uiScriptAPI 分为 stable 和 beta。
beta：
stable：
规则：
@minecraft/* 模块必须使用同一版本类型。如果出现 npm 依赖冲突，可尝试：
{
"overrides": {
"@minecraft/server": "xxx"
}
}
使用 ScriptAPI 模块时必须声明依赖。
beta：
{
"module_name": "@minecraft/server",
"version": "beta"
}
stable：
{
"module_name": "@minecraft/server",
"version": "2.x.x"
}
MC API 以项目 node_modules 中实际安装的类型定义为准。
禁止：
.d.ts 文件允许：
查询时：
常用搜索：
World:
export class World
Entity:
export class Entity
Player:
export class Player extends Entity
Dimension:
export class Dimension
ItemStack:
export class ItemStack
System:
export class System
事件：
WorldBeforeEvents
WorldAfterEvents
StartupEvent
ScriptAPI 根据执行环境限制 API。
常见：
beforeEvents限制：
需要修改时：
system.run(() => {
// 修改操作
});
常见：
system.beforeEvents.startup限制：
不要在此阶段访问：
sapi-pro 可使用 deferred 延迟初始化依赖运行时的数据。
常见：
afterEventssystem.run正常执行环境，可使用大部分 API。
耗时操作不要阻塞 tick。
长时间任务使用：
system.runJob(generator);
结合：
function* generator() {}
分批执行。
需要支持成就：
{
"metadata": {
"product_type": "addon"
}
}
Minecraft 游戏内文本不支持大部分 Emoji（如：✅ ❌ 🤣 🎉等）。
可以使用 Unicode 符号替代，例如：✔ ✘ ㄨ ▪ ⚫ ◤ ▸ ✖ ✕ ✣ 等普通符号。
生成玩家可见文本时，优先使用 Minecraft 支持的符号和颜色代码。
禁止使用 Emoji 作为按钮、提示、标题中的状态图标。
基岩版可以使用 § 来进行文本上色 可用范围为：
颜色使用: