跳到主要内容

客户端与集成

客户端展示与第三方集成有各自的生命周期。本节按你准备实现的功能提供入口,公共比赛规则仍通过地图、队伍和回合系统组织。

客户端开发​

HUD 与客户端状态介绍如何注册 Forge 覆盖层、接收快照和清理旧状态。资源与本地化介绍地图贴图路径、资源命名空间和语言键。

第一次实现展示时,可以直接沿着比分 HUD 教程完成从服务端到屏幕的整条链路,再替换为自己的布局。

按功能扩展时,以下系统可以独立接入:

功能入口
玩法 HUD 与 TabHUD 管理器 · 玩家列表
客户端快照数据与重置
开场、预览和死亡镜头相机与演出
队友附着和环绕视角客户端旁观
音乐和 MVP 默认曲目音乐播放
地图工具的世界提示区域与点位预览

枪械、脚本与插件​

入口适合的工作前置环境
枪械 Provider识别第三方武器、读写弹药、提供 HUD 数据相应枪械模组
TaCZ 客户端适配动画、旁观物品镜像和表现同步TaCZ,物理客户端
KubeJS 事件为已有地图追加脚本限制、通知和小型扩展KubeJS 及其依赖
Bukkit 桥接向插件发布地图事件提供 Bukkit API 的混合服务端

这些入口不是可互换的同一套 API。Provider 适配物品,脚本消费包装事件,Bukkit 桥接只覆盖当前已实现的通知。

类加载边界​

包含 Minecraft 或渲染类的入口只在 Dist.CLIENT 加载。引用可选模组类型的代码放入独立兼容类,并在确认模组存在之后实例化。仅在方法体中判断一次模组是否安装,不能保护公共字段和方法签名中的缺失类型。

完整的线程与宿主生命周期说明见线程与资源生命周期。