自行车是痛苦的

🚲 Bikes Are Pain

此模组允许你在连接到健身自行车时，通过现实中的踩踏来控制游戏内的自行车，将 gameplay 与锻炼相结合。若不集成健身自行车，它的功能与普通自行车模组相同。

⚠️ 重要提示

1. 服务器兼容性：目前，不建议在服务器上使用 BikesArePain，因为使用现实健身自行车集成时会产生大量数据包流量（由于缺乏优化）。这可能导致性能问题或不稳定的游戏体验。
2. 无服务器自动检查：如果服务器未安装此模组，模组不会自动禁用。
3. Alpha 阶段：此模组目前处于 alpha 阶段。核心功能已实现，但仍需进一步打磨、优化和添加功能。

📕 功能特性

• 功能完整的游戏内自行车
• 用于记录骑行数据的计步器
• 可染色的自行车部件
• 可选与现实健身自行车集成（通过 Arduino）

📌 快速开始

1. 下载最新的 .jar 文件。
2. 将 .jar 放入你的 Minecraft mods 文件夹。
3. 安装依赖：
   • Geckolib
   • YetAnotherConfigLib
   • ArchitecturyAPI
4. 要使用健身自行车集成功能，请修改 Arduino 草图以适配你的设备（指南即将推出）。
   • Arduino 草图
   • 运行命令 /bikes open <COM PORT>

🚩 已知问题

• 无服务器自动检查：加入未安装模组的服务器不会自动禁用功能。
• 服务器流量问题：使用健身自行车集成或某些功能时会产生过多的数据包流量。
• 俯仰同步问题：自行车俯仰同步是单向的，从客户端到服务器。
• 无障碍性差：目前未使用 Narrator 来传达信息。
• 串口连接错误：健身自行车连接不稳定。自动连接经常失败，或连接在会话中途断开。
• 模型不一致：游戏内自行车模型的部件命名不一致。
• Geckolib 使用不当：模型动画和移动依赖于一种临时性的实现方式，需要重写。

🌿 计划功能

• 代码库的单元测试
• 为提升性能而进行的代码重构
• 锻炼会话可视化 UI
• 可配置的锻炼目标
• 基于锻炼成就的进度系统
• 新的自行车类型（例如，山地自行车、摩托车）
• 服务器端配置选项

👓 依赖项

此模组需要以下库：

• Geckolib – 用于动画
• YetAnotherConfigLib – 用于配置
• ArchitecturyAPI – 用于跨模组加载器支持

📝 许可证

BikesArePain 采用 MIT 许可证 授权。详情请参阅 LICENSE。

此模组使用 jSerialComm 进行串口通信，遵循 Apache 2.0 许可证。其他第三方软件许可证，请查看 THIRD_PARTY_LICENSES。

⚙️ 支持

发现了 bug 或有建议？请在 GitHub 仓库 上提交 issue。

享受骑行，保持健康！