Boss 的独特攻击归你，通用战斗系统交给框架。

Boss Framework API 是面向 Minecraft 模组开发者的 Boss 制作基础库。把框架绑定到现有的服务端 LivingEntity，注册 Boss 定义，再写出你的专属攻击，即可复用整套战斗系统。

首版功能

• 血量、时间、事件和自定义条件驱动的阶段。
• 技能的预警、前摇、释放、执行、冷却和中断。
• 圆形、扇形、直线危险区域显示。
• 支持名称、血量、阶段和自定义颜色的 Boss 血条。
• 不依赖具体模型的动画事件、登场和死亡演出时间线。
• 可选战斗区域、多人参与奖励、首杀记录和离线奖励补发。
• 服务端权威状态、玩家中途加入同步和已保存战斗恢复。
• 可重载的数据包 JSON，以及便于学习的 ExampleBoss。

服务器掌管阶段、技能、伤害和奖励，客户端负责预警、界面、粒子与演出。实体、模型和动画库由使用本 API 的模组自行选择，无需其他前置模组。

亲手体验

进入允许命令的世界，管理员输入 /bossframework example，即可生成演示守卫：原版铁傀儡、三个阶段、紫色血条、范围预警、登场/死亡效果和奖励。框架不会自动向已有世界生成 Boss。

安装要求

请在版本页选择与你的 Minecraft 与 Forge 完全对应的文件，每个 Minecraft 版本都是独立编译和测试的适配包。客户端与服务器两端都需安装。

已提供：1.20.1、1.20.2、1.20.3、1.20.4、1.20.6、1.21、1.21.1、1.21.3、1.21.4、1.21.5、1.21.6、1.21.7、1.21.8、1.21.9、1.21.10、1.21.11、26.1、26.1.1、26.1.2、26.2、26.3。

Java：1.20.1–1.20.4 使用 17，1.20.6–1.21.11 使用 21，26.x 使用 25。仅支持 Forge，不支持 Fabric 或 NeoForge。采用 MIT 许可证。

开发接入

使用 BossDefinition、Phase、SkillDefinition、RewardDefinition 和 BossRegistry，再通过 BossManager 绑定实体。源码项目包含示例和 API 文档。定义在 common setup 中注册，战斗操作在服务端线程执行。

Alpha 版本与验证

每个已发布适配包均通过 12 项单元测试、22 项框架 GameTests、真实专用服务器跨进程保存重启、独立使用方项目编译，以及 Fancy/Fabulous 两轮真实客户端验证。多人奖励和中途加入同步有自动化覆盖，尚未进行大型真实多人服务器长期测试。

支持正常保存后的重启恢复；第三方奖励回调无法保证突然断电时的事务原子性。排行榜、随机词缀、挑战模式和战斗录制留待后续版本。