RuaRua

在开发此模组的过程中大量使用了 AI。不同的模组组合和运行环境仍可能出现问题。如果你不信任 AI 辅助开发的项目，请在下载和使用前慎重考虑。

概览

抱起、抚摸、投掷并接住你的伙伴。

Minecraft 1.20.1 中以第三人称抚摸狼。

用法

• 在 2×2 合成格中用四个羊毛方块制作可重复使用的抚摸手套。羊毛颜色可以混搭。
• 主手拿着手套时，左键点击附近的伙伴即可摸摸它的头；右键点击可以抱起它，或在空中接住它。
• 抱着伙伴时，左键点击可抚摸；按住右键蓄力投掷，松开即可投出。潜行并右键点击可轻轻放下伙伴。
• 按 V 打开抱持姿势轮盘：身前、怀中、肩上或头上。用鼠标或数字键 1–4 选择；右键或按 Esc 取消。
• 滚动鼠标滚轮可调整距离；潜行并滚动可调整高度。按 R 重置位置。按住 Alt 查看额外控制说明。
• 被抱起的玩家可以潜行挣脱。切换到其他物品会放下伙伴。

被投出的伙伴不会受到摔落伤害。撞到其他生物时会播放视觉和音效效果，但不会造成伤害。

安装

在客户端和服务器上都安装对应加载器的版本。

配置

配置文件位于世界文件夹中：serverconfig/ruarua-server.json（Fabric）或 serverconfig/ruarua-server.toml（Forge / NeoForge）。Forge 和 NeoForge 的设置位于 [interaction]。编辑后请重新打开世界或重启服务器。

• reach：抱起和接住的距离。
• chargeTicks：投掷蓄满所需时间，单位为刻。
• throwSpeed：最大投掷速度。
• tumbleTicks：落地恢复动画的持续时间，单位为刻。
• playerInteractions：是否允许与其他玩家互动。
• heldDistanceReference：用于计算抱持距离的参考尺寸。
• heldDistanceFactors：针对特定实体 ID 设置的抱持距离倍率。
• excludedEntities：禁止互动的实体 ID。

互动规则

可以与自己的宠物、无主生物互动；启用玩家互动后，也可以与玩家互动。不能借用其他玩家拥有的宠物。被拴住的实体、乘客以及载着乘客的实体都无法被抱起。互动期间会暂停 AI，结束后恢复。

部分模组的自定义模型和宠物归属系统可能需要单独提供兼容支持。

源码与许可证

项目代码采用 MIT 许可证。美术资源适用单独条款，见 LICENSE-ASSETS.md；源码声明见 SOURCES.md。源码和问题反馈：GitHub。

如果遇到问题，请留言或加入我们的 QQ 群。请尽可能提供 Minecraft 版本、模组版本、模组加载器和日志，方便我们排查。

也欢迎提出建议！你的反馈将帮助我们规划后续更新。

QQ群：1095622706 · 支持作者：Afdian