中国版ModAPI接口域索引

使用边界

中国版ModAPI接口文档与国际版脚本API、国际版数据驱动JSON架构是两套独立体系。维护文档时，应分别落到中国版模组SDK参考页或国际版附加包参考页，不应混写。

目录覆盖统计

来源目录	知识文件数	主要覆盖范围
接口根目录	13	物理、控制、模型、物品、渲染、原生UI、音效、游戏设置、联机大厅、成就、商城、山头服务器与总索引
接口\通用	9	系统、组件、事件通信、工具、本地设备、本地存储、数学、调试
接口\世界	16	地图、实体管理、方块管理、生物生成、配方、方块组合、渲染、时间、天气、游戏规则、消息、指令等
接口\实体	17	实体类型、属性、行为、状态效果、渲染、背包、标签、自定义数据等
接口\玩家	10	玩家属性、行为、渲染、背包、摄像机、权限、导航、动画、游戏模式
接口\方块	11	方块状态与附加值、方块实体、方块几何体模型、容器、红石、告示牌、床
接口\特效	7	粒子、微软粒子、序列帧、模型特效、文字面板
接口\自定义UI	7	通用、通用设置、UI界面、UI控件、自定义成就系统、自定义书本
接口\后处理	6	渐晕、模糊、色彩、镜头效果、自定义
接口\虚拟世界	5	虚拟世界的世界、相机、模型与其他对象接口

根目录接口域

接口域	对应知识文件	说明
物理	接口\物理.md	自定义刚体、碰撞体、射线检测、力与约束接口。
控制	接口\控制.md	输入事件、按键注册、触屏与手柄控制相关接口。
模型	接口\模型.md	模型切换、动作控制、骨骼与表现层接口。
物品	接口\物品.md	物品属性、耐久、冷却、使用行为与附加值相关接口。
渲染	接口\渲染.md	画面表现、材质、后处理与可视化控制接口。
原生UI	接口\原生UI.md	原生界面显示、界面状态与层级相关接口。
音效	接口\音效.md	音乐与音效播放控制接口。
游戏设置	接口\游戏设置.md	自定义按键、手柄映射与设置项相关接口。
联机大厅	接口\联机大厅.md	联机大厅流程中的基础接口。
成就	接口\成就.md	自定义成就触发与查询接口。
商城	接口\商城.md	内购与商品状态相关接口。
山头服务器	接口\山头服务器.md	特定网络服场景的专用接口。
总索引	接口\Api索引表.md	全域接口条目索引入口。

与本站参考页映射

主题	本站页面
世界时间、天气、游戏规则、消息、指令	世界控制接口
自定义书本格式、页面与组件类	自定义书本格式与接口
通用接口：系统、组件、事件通信、定时器、工具、数学、本地设备与存储	通用接口
实体接口：属性、位置、旋转、缩放、AI意向、运动器、状态效果与实体生命周期	实体接口
玩家接口：经验等级、饥饿、玩家行为、运动器与摄像机	玩家接口
方块与世界接口：方块读写、方块状态、方块实体、容器、红石、记分板与配方	方块与世界接口
特效接口：粒子特效、序列帧特效、文字面板与后处理效果	特效接口
UI与交互接口：自定义UI、原生HUD控制、按键控制、音效与游戏设置	UI与交互接口
特化接口：虚拟世界、物理、自由模型、联机大厅与商城	中国版ModAPI特化接口
事件域清单	中国版ModAPI事件域索引
枚举值清单	中国版ModAPI枚举值索引
预设架构接口	中国版PresetAPI参考
Apollo网络服事件与服务接口	Apollo网络服事件及Apollo系列页面

维护建议

• 先按接口域定位，再进入对应细分页面补全字段和示例。
• 世界控制类接口优先维护在世界控制接口，避免分散重复。
• 书本与UI扩展接口优先维护在自定义书本格式与接口。
• 涉及国际版维度、脚本API、数据驱动格式时，应回到附加包与文档品类页面维护，不在中国版ModAPI页混写。