Home

欢迎来到 匆☆忙☆撰☆写 的RideBattleLib Wiki！

RideBattleLib Wiki

面向 NeoForge 的假面骑士变身系统 API
当前文档适配：RideBattleLib 1.3.3
主目标：让其它假面骑士模组作者在 MC 高版本上快速实现“驱动器、形态、动态形态、技能、事件、网络同步”。

RideBattleLib（RBL）对标“电子 CSM”的定义：它不是单一骑士模组，而是一套可复用的骑士系统 API。你可以通过 RiderBuilder、FormBuilder、DynamicMappingBuilder、IRiderPack、服务端/客户端分发系统，快速构建属于自己的骑士模组。

前言

此文档预设你已理解：

• Java 语言基础
• Minecraft 基础概念
• NeoForge 事件系统与模组开发基础

若你尚未掌握以上内容，建议先了解 NeoForge 1.21.1 的开发方式。

---

支持版本

Minecraft	NeoForge	RideBattleLib
1.21.1	21.1.xx	1.3.3
其他版本	以实际发布页为准	以实际发布页为准

本文档主要针对 MC 1.21.1 + NeoForge 21.1.xx + RideBattleLib 1.3.3 编写。

1.3.3 文档重构要点

相比旧版文档，1.3.3 推荐优先使用以下系统：

• RideBattleAPI 统一静态入口：自动处理客户端/服务端路由。
• RiderBuilder / FormBuilder：链式构建骑士与形态。
• DynamicMappingBuilder：注册动态形态的“物品 → 盔甲 / 效果 / 授予物品”映射。
• IRiderPack + RiderPackRegistry：打包注册骑士。
• IRiderServerHandler / IRiderClientHandler：服务端与客户端分发系统。
• ClientTransformedCache / ClientDriverDataCache：客户端只读缓存。
• SkillSystem：技能元数据注册、冷却管理、轮转与事件分发。
• DynamicFormCache：动态形态自动生成、缓存与 10 分钟未使用清理。
• IHenshinStrategy / IPenaltyStrategy：自定义变身与吃瘪策略。

旧文档中部分示例已不适用于 1.3.3，例如：

• RideBattleAPI.completeIn(player, 40) 应改为 RideBattleAPI.completeIn(40, player)。
• FormBuilder.attribute(Attributes.MAX_HEALTH.location(), ...) 应改为 FormBuilder.attribute(Attributes.MAX_HEALTH, ...)。
• 客户端事件不再推荐依赖旧式 ClientRiderEvents，请优先使用 IRiderClientHandler 分发系统。
• IRiderClientHandler 的驱动器变化方法为 onDriverItemInserted / onDriverItemExtracted。

推荐阅读顺序

如果你第一次使用 RideBattleLib：

安装与配置
↓
快速开始
↓
核心概念速览
↓
构建器模式深入
↓
API 基础操作
↓
技能系统 / 动态形态
↓
事件系统入门 / 分发系统
↓
自定义策略

如果你已经熟悉旧版 RideBattleLib：

1.3.3 更新要点
↓
RiderBuilder / FormBuilder
↓
IRiderPack 注册
↓
服务端 / 客户端分发系统
↓
动态形态与技能 pending 注册
↓
自定义策略

相关链接

• 🎬 B站系列教程
• 💬 示例代码
• ℹ GitHub Issues
• 💬 B站评论区 / 私信
• 👾 Discord

开源协议

RideBattleLib 使用 MIT License。

虽然 MIT 许可证不强制要求，但希望你在以下位置提及 RideBattleLib：

模组的 README.md 或 Credits 页面

模组的 发布页/视频介绍中

十分感谢！

版权声明

项目	版权方
RideBattleLib	JThePigeon (MIT License)
Minecraft	© Mojang Studios
NeoForge	© NeoForge Team
假面骑士系列	© 东映株式会社

本模组及其延申模组因版权原因不应以任何方式通过模组本身盈利，如有违反，后果自负