CarryBabyAnimals

Carry Baby Animals

Carry Baby Animals 是一款 Minecraft 模组，允许玩家抱起、携带、抚摸并安全放下幼年动物。

这是 Tyler 和 Jasmine 父女共同制作的项目，围绕着 Minecraft 中那些细小的瞬间展开——它们本该温柔、实用，还带着一点点魔法般的感觉。

这款模组基于一个简单的理念：幼年动物始终是世界中的实体，而不是物品栏里的物品。被抱起的幼年动物会在服务器上保持与玩家的连接，因此其他玩家也能看到这一行为，适用于多人游戏，并且兼容未安装此模组的客户端。

特色

• 空手时潜行并右键点击幼年动物，一次抱起一只。
• 携带幼年动物时，可以行走、疾跑、跳跃和游泳。
• 携带幼年动物时，空手潜行并右键点击即可将其放下。
• 左键点击抚摸怀中的幼年动物，触发爱心粒子效果和温馨反馈。
• 育幼模式会阻止玩家在熔岩、火焰、伤害性方块、狭窄空间以及不安全的高处附近放下幼年动物。
• 亲子团聚会在幼年动物被安全放下并回到同种成年动物附近时，显示装饰性爱心和温馨的快捷栏消息。
• 安装了模组的客户端可获得更好的幼年动物携带视觉效果，包括为较大的幼年动物调整贴身位置，以及为较小的幼年动物添加困倦的携带姿势。
• 服务器所有者可在配置中填写完整实体 ID，将其他模组的兼容幼年动物实体类型加入支持列表。
• 原版客户端仍可通过 Minecraft 的乘客回退机制加入服务器并使用服务端的携带功能。
• Fabric 客户端可通过 ModMenu，NeoForge 客户端可通过 NeoForge 内置的 Mods 界面，在游戏中调整 Carry Baby Animals 的视觉设置。

服务器与客户端设置

在服务器上安装 Carry Baby Animals 即可启用游戏玩法。

对于玩家和服务器管理员，Carry Baby Animals 是服务器必需模组，并强烈建议在客户端安装此模组。

Marketplace 环境元数据可能会将客户端标记为可选，因为原版客户端仍可加入服务器并使用服务端的携带功能。

玩家也可以在客户端安装此模组，以获得更精致的怀抱渲染效果、第一人称抚摸反馈、幼年动物被携带时的反应、困倦视觉效果，以及可选的游戏内视觉设置。未安装此模组的玩家仍可加入安装了模组的服务器并使用携带功能，但看到的幼年动物会采用 Minecraft 默认的乘客渲染效果。

Carry Baby Animals 本身无法让其他模组的自定义实体兼容原版客户端。如果其他动物模组要求客户端安装对应模组，这项要求仍由该模组及服务器配置决定。

运行要求

所有版本都需要 Java 25 或更高版本。请根据你的 Minecraft 版本和加载器选择对应文件。

| Carry Baby Animals | Minecraft 版本 | Fabric 加载器最低版本 | Fabric API 基准版本 | NeoForge 最低版本 |
| — | — | — | — | — |
| 0.3.3 | 26.3 | 0.19.5 | 0.161.0+26.3 | 26.3.0.8-beta |
| 0.3.1–0.3.2 | 26.2 | 0.19.3 | 0.152.2+26.2 | 26.2.0.6-beta |
| 0.3.0 | 26.1.2 | 0.19.2 | 0.149.0+26.1.2 | 26.1.2.74 |
| 0.1.0–0.2.0 | 26.1.2 | 0.19.2 | 0.149.0+26.1.2 | 不提供 |

Fabric API 仅在 Fabric 版本中需要。表中列出的 API 版本是各版本构建时使用的版本；对于相同的 Minecraft 版本，可使用这些版本或更高的兼容版本。较新的加载器版本也必须支持该行对应的 Minecraft 版本。

仅适用于 0.1.0 版本：还需要 Fabric Permissions API 0.7.0 或更高版本。自 0.1.1 起，该 API 不再是必需项。

可选：

• 权限提供器是可选的，并非必需。在 Fabric 上，权限提供器通过 Fabric API 的权限 API 集成。在 NeoForge 上，权限提供器通过 NeoForge 内置的权限 API 集成。
• ModMenu 对 Fabric 客户端而言是可选的。只有想在游戏内通过 Fabric 界面调整 Carry Baby Animals 的客户端视觉设置时，才需要安装它。

使用方法

1. 双手都不要拿东西。
2. 潜行并右键点击受支持的幼年动物，即可将其抱起。
3. 抱着幼年动物时左键点击即可抚摸它。
4. 空手再次潜行并右键点击，即可放下幼年动物。

如果动物有自定义名称，抱起和放下时的提示会使用该名称，例如Carrying KittyKat和Set down KittyKat。没有名称的动物则会显示幼年动物类型，例如Carrying baby Pig和Set down baby Pig。

抱着幼年动物时，仍可使用门和活板门。

育婴模式

育婴模式由服务器控制，并兼容原版客户端。在幼年动物脱离玩家之前，它会验证服务器计划的放下位置。

启用后，育婴模式会阻止玩家在熔岩、火焰、伤害性方块、会导致窒息的空间以及危险落差附近放下幼年动物。如果位置不安全，幼年动物会继续被抱着；启用了育婴模式提示时，玩家还会看到一条俏皮的快捷栏提示。

服务器管理员可以配置各项安全检查、危险坠落距离，以及是否显示育婴模式提示。另预留了一个权限节点，供服务器在需要仅限管理人员绕过育婴模式时使用。

亲子团聚

亲子团聚由服务器控制，仅提供装饰效果，并兼容原版客户端。只有在育婴模式允许玩家主动放下幼年动物后，它才会触发，并且绝不会移动幼年动物或成年动物。

启用后，安全放下且回到适配成年动物附近的幼年动物，会与成年动物一起出现爱心粒子，玩家也会看到一条简短的团聚提示。适配的成年动物必须与幼年动物属于同一动物类型、已成年、存活、位于附近且处于同一已加载的服务器世界中。已驯服的动物只会与主人身份相同的成年动物团聚。

服务器管理员可以配置团聚半径、冷却时间、提示和粒子效果。

客户端视觉效果

游戏状态由服务器控制。客户端视觉效果仅为装饰。

安装了该模组的玩家可以获得更精致的客户端显示效果：隐藏普通的乘客渲染，并将幼年动物显示在抱着它的玩家手边。

模组客户端还可为被抱着的幼年动物启用可选的生物表现优化。对于马、骆驼、羊驼、熊猫和海龟等高大或体型较大的幼年动物，会将它们更稳妥地收拢到玩家身侧，让第一人称视角保持清晰。抚摸鸡、兔子、狐狸、熊猫和海龟等动物时，还可能触发仅限客户端的小动作。

客户端持续观察到玩家抱着小型幼年动物一段时间后，抱睡视觉效果会从蜷缩的困倦姿势逐渐过渡为更明显的睡着状态，动作也会变得更平静；如果渲染器支持，还会显示轻微的呼吸效果。

客户端视觉设置保存在：

config/carrybabyanimals-client.json

安装了 ModMenu 时，Fabric 客户端可在 ModMenu 的 Carry Baby Animals 配置界面中调整这些客户端视觉设置。NeoForge 客户端可在 NeoForge 内置的“模组”界面中调整。若没有游戏内配置界面，Carry Baby Animals 仍会使用config/carrybabyanimals-client.json。

客户端视觉选项包括抱着幼年动物时的反应、大型幼年动物的收拢位置、第一人称视角下大型幼年动物的可见性、抱睡视觉效果、反应强度，以及禁用反应的动物 ID。

这些客户端设置不会添加权限、不影响抱起或放下规则，而且原版客户端完全不需要这些设置。

配置

Carry Baby Animals 会在服务器首次启动时创建此文件：

config/carrybabyanimals.json

服务器的主要选项包括：

• allowedAnimals允许被抱起的动物名称或完整实体 ID 列表。留空则允许默认支持的全部动物。
• blockedAnimals禁止被抱起的动物名称或完整实体 ID 列表。
• allowCarryingOtherPlayersTamedAnimals允许玩家抱起其他玩家驯服的幼年动物，但前提是权限节点也允许此操作。
• pettingCooldownTicks成功触发抚摸效果后的冷却时间，以服务器刻为单位。
• cozyFeedbackEnabled幼年动物被抱起时的外观反馈总开关。
• carriedIdleSoundsEnabled允许偶尔播放幼年动物被抱起时的环境音效。
• pettingMessagesEnabled启用多样化的抚摸及睡意快捷栏消息。
• nameAwareMessagesEnabled如果幼年动物有自定义名称，则在温馨反馈消息中使用该名称。
• cozyParticlesEnabled启用轻柔的幼年动物被抱起时的外观粒子效果。
• sleepyBabiesEnabled幼年动物被抱起一段时间后，启用犯困的互动效果。
• nurseryModeEnabled拒绝不安全放下操作的总开关。
• nurseryBlockLava拒绝在熔岩中或熔岩旁放下幼年动物。
• nurseryBlockFire拒绝在火焰、营火、灵魂营火、岩浆块及其他类似燃烧危险物上放下幼年动物。
• nurseryBlockCactusAndDamage拒绝在仙人掌和其他明显会造成伤害的方块上放下幼年动物。
• nurseryBlockSuffocation拒绝在狭窄处放下幼年动物，以免其发生碰撞或窒息。
• nurseryBlockDangerousFalls拒绝在危险落差上方放下幼年动物。
• nurseryDangerousFallDistanceBlocksNursery Mode 判定为危险的落差距离。
• nurseryMessagesEnabled启用俏皮的 Nursery Mode 拒绝操作快捷栏消息。
• parentReunionEnabled玩家安全放下幼年动物后的外观反馈总开关。
• parentReunionRadiusBlocks搜索被放下幼年动物附近合适成年动物的半径。
• parentReunionCooldownTicks同一只幼年动物或携带者再次触发重聚反馈所需的最短间隔。
• parentReunionMessagesEnabled启用温馨的 Parent Reunion 快捷栏消息。
• parentReunionParticlesEnabled启用环绕幼年动物和成年动物的爱心粒子效果。

温馨反馈仅为外观效果，由服务器控制。它使用 Minecraft 原版音效、粒子效果和快捷栏消息，因此原版客户端无需安装此模组，也能看到或听到这些反馈。

支持的动物

默认情况下，Carry Baby Animals 支持适合被抱起的常见被动型幼年动物，例如牛、猪、绵羊、鸡、山羊、兔子、猫、狐狸、马、驴、羊驼、骆驼、熊猫、海龟和狼。

支持的动物名称：

cow, pig, sheep, chicken, goat, rabbit, cat, fox, horse, donkey, mule, llama, trader_llama, camel, panda, turtle, wolf, dog

动物名称说明：

• dog表示仅限驯服的狼。
• wolf表示通常适用于狼，但仍遵循常规的驯服所有权规则。
• 在 allowedAnimals 和 blockedAnimals 中也可使用完整实体 ID，例如 examplemod:duck。
• 未知名称、格式错误的 ID，以及服务器上不存在的实体类型 ID，都会记录日志并忽略。
• 默认情况下不允许模组添加的实体。必须将其明确列入 allowedAnimals，且现有的携带权限节点仍然有效。
• 携带动物会占用玩家的双手，这是模组设计的一部分，无法配置。

驯服动物遵循所有权规则。默认情况下，玩家可以抱起自己驯服的幼年动物。除非服务器明确允许，否则玩家不能抱起其他玩家驯服的幼年动物。

权限

Carry Baby Animals 可与加载器权限提供程序集成，但不要求必须安装权限提供程序。Fabric 服务器使用 Fabric API 的权限 API。NeoForge 服务器使用 NeoForge 内置的权限 API。

如果已启用加载器权限提供程序：

• carrybabyanimals.nursery.bypass默认处于禁用状态，除非权限提供程序明确授予该权限。
• Carry Baby Animals 的所有其他权限均交由你的权限提供程序处理；如果提供程序没有明确规则，则使用下方列出的默认行为。

如果未启用加载器权限提供程序：

• 所有玩家都可以抱起未驯服的幼年动物。
• 玩家可以抱起自己驯服的幼年动物。
• 玩家不能抱起其他玩家驯服的幼年动物。
• 保留的重载权限在可用时回退为原版管理员命令权限。
• 在 Fabric 上，Nursery Mode 绕过权限回退为原版管理员命令权限。在 NeoForge 上，该权限仅可通过加载器权限提供程序授予。

权限节点：

carrybabyanimals.carry
carrybabyanimals.carry.tamed
carrybabyanimals.carry.others_tamed
carrybabyanimals.nursery.bypass
carrybabyanimals.reload

默认行为：

• carrybabyanimals.carry：默认允许。
• carrybabyanimals.carry.tamed：默认允许玩家抱起自己驯服的幼年动物。
• carrybabyanimals.carry.others_tamed：默认拒绝。
• carrybabyanimals.nursery.bypass：启用加载器权限提供程序时，默认处于禁用状态。未启用提供程序时，Fabric 回退为原版管理员命令权限，而 NeoForge 则要求提供程序明确授予。
• carrybabyanimals.reload：保留用于重载支持，在可用时默认使用原版管理员命令权限。