CarryBabyAnimals

携带幼年动物

携带幼年动物是一款Minecraft模组，让玩家可以拾取、携带、抚摸并安全放下幼年动物。

这是Tyler和Jasmine的父女合作项目，围绕那种应当感觉温柔、实用且带有一丝魔幻色彩的微小Minecraft时刻而构建。

该模组基于一个简单的理念：幼年动物作为真实世界实体存在，而非物品栏物品。被携带的幼崽会保持附着在服务器上的玩家身上，因此其行为可见、支持多人游戏，且能兼容未安装该模组的客户端。

亮点

• 空手潜行右键点击即可一次拾取一只幼年动物。
• 在行走、奔跑、跳跃和游泳时携带幼崽。
• 空手潜行右键点击即可放下正在携带的幼崽。
• 左键点击以抚摸被携带的幼崽，会产生爱心粒子并给予温馨反馈。
• 育儿模式会拒绝在熔岩、火焰、伤害性方块、狭窄空间和危险落差附近进行危险的放下操作。
• 亲子团聚功能会在安全放下的幼崽靠近匹配的成年动物时，添加装饰性的爱心和一条温馨的动作栏消息。
• 安装模组的客户端会获得更好的被携带幼崽视觉效果，包括大型幼崽的夹持放置和小型幼崽的困倦携带姿势。
• 服务器管理员可在配置中通过完整实体ID，选择兼容其他模组的幼年动物实体类型。
• 原版客户端仍可加入服务器，并通过Minecraft的乘客后备机制使用服务器端的携带行为。
• Fabric客户端可使用ModMenu，NeoForge客户端可使用NeoForge内置的模组界面，在游戏中编辑携带幼年动物的视觉设置。

服务器和客户端设置

在服务器上安装携带幼年动物以启用该游戏玩法。

对于玩家和服务器管理员而言，携带幼年动物是服务器必需模组，且强烈建议安装客户端模组。

市场环境元数据可能将客户端列为可选，因为原版客户端仍可加入并使用服务器端的携带行为。

玩家也可以在其客户端上安装此模组，以获得更好的怀抱渲染、第一人称抚摸反馈、被携带幼崽的反应、困倦视觉效果以及可选游戏内视觉配置。未安装该模组的玩家仍可加入模组服务器并使用携带行为，但他们将通过Minecraft的普通乘客渲染看到幼年动物。

携带幼年动物本身并不能让其他模组的自定义实体与原版客户端兼容。如果另一个动物模组需要匹配的客户端模组，则该要求仍属于该模组和服务器设置。

需求

• Minecraft 26.2
• Fabric Loader 0.19.3 或更新版本，或 NeoForge 26.2.0.6-beta 或更新版本
• Java 25 或更新版本
• 在 Fabric 上运行时需 Fabric API 0.152.2+26.2 或更新版本

可选：

• 权限提供者为可选，非必需。在 Fabric 上，提供者通过 Fabric API 的权限 API 集成。在 NeoForge 上，提供者通过 NeoForge 内置的权限 API 集成。
• Fabric 客户端上的 ModMenu 为可选。仅在您希望为携带幼年动物客户端视觉设置提供游戏内 Fabric 界面时安装。

使用方法

1. 清空双手。
2. 潜行右键点击一只支持的幼年动物以拾取它。
3. 携带时左键点击以抚摸幼崽。
4. 再次空手潜行右键点击以放下幼崽。

拾取和放下消息会在动物有自定义名称时使用该名称，例如“携带 KittyKat”和“放下 KittyKat”。无名称的动物会使用幼年动物类型，例如“携带幼年猪”和“放下幼年猪”。

携带幼年动物时仍可使用门和活板门。

育儿模式

育儿模式由服务器拥有，并兼容原版客户端。它在幼崽被分离前验证服务器计划的放下位置。

启用时，育儿模式会拒绝在熔岩、火焰、伤害性方块、窒息空间和危险落差附近进行不安全的放下。如果位置不安全，幼崽会保持被携带状态，且在启用育儿模式消息时，玩家会看到一条俏皮的动作栏消息。

服务器管理员可以配置每项安全检查、危险坠落距离，以及是否显示育儿模式消息。还保留了一个权限节点，用于在服务器需要仅限工作人员覆盖行为时绕过育儿模式。

亲子团聚

亲子团聚功能由服务器拥有，为装饰性质，并兼容原版客户端。它仅在育儿模式允许有意的放下后运行，且永远不会移动幼崽或成年动物。

启用时，安全放下的幼崽靠近相容的成年动物时，成年动物周围会出现爱心粒子，且玩家会看到一条简短的团聚消息。相容的成年动物需为相同动物类型、成年、存活、在附近，并位于同一加载的服务器维度中。已驯服的动物只会与具有相同主人身份的成年动物团聚。

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

客户端视觉效果

服务器拥有游戏状态。客户端视觉效果为装饰性质。

安装模组的玩家会获得更好的客户端呈现：普通乘客渲染被隐藏，幼崽会被绘制在携带者手部附近。

安装模组的客户端还会为被携带的幼崽提供可选生物修饰。高大且笨重的幼崽，如马、骆驼、羊驼、熊猫和海龟，会使用更安全的夹持侧放位置，以保持第一人称游戏的可读性。抚摸可触发仅限客户端的小型反应，例如鸡、兔子、狐狸、熊猫和海龟。

在客户端观察被携带的小型幼崽一段时间后，困倦携带视觉效果会从蜷缩的困倦姿势，进展到更清晰的睡眠呈现，伴有更平静的动作，并且在渲染器支持的情况下，会有微妙的呼吸式提示。

客户端视觉设置存储在：

config/carrybabyanimals-client.json

Fabric 客户端可在安装了 ModMenu 的情况下，通过 ModMenu 的“携带幼年动物”配置界面更改这些相同的客户端视觉设置。NeoForge 客户端可通过 NeoForge 内置的模组界面进行更改。即使没有游戏内配置界面，携带幼年动物仍会使用 config/carrybabyanimals-client.json。

客户端视觉选项包括被携带幼崽反应、大型幼崽夹持放置、第一人称大型幼崽可见性、困倦携带视觉效果、反应强度，以及禁用的反应动物ID。

这些客户端设置不会添加权限，不会影响拾取或放下规则，原版客户端也永远不需要它们。

配置

携带幼年动物会在服务器首次启动时创建此文件：

config/carrybabyanimals.json

主要服务器选项包括：

• allowedAnimals：允许被携带的动物名称或完整实体ID列表。留空以允许完整的默认支持集。
• blockedAnimals：要阻止的动物名称或完整实体ID列表。
• allowCarryingOtherPlayersTamedAnimals：当权限节点也允许时，允许玩家携带其他玩家已驯服的幼年动物。
• pettingCooldownTicks：成功抚摸效果之间的冷却时间，以服务器刻为单位。
• cozyFeedbackEnabled：装饰性被携带幼崽反馈的总开关。
• carriedIdleSoundsEnabled：允许偶尔发出的被携带幼崽环境音效。
• pettingMessagesEnabled：启用多种抚摸和困倦动作栏消息。
• nameAwareMessagesEnabled：在温馨反馈消息中使用幼崽的自定义名称（如果有）。
• cozyParticlesEnabled：启用柔和的装饰性被携带幼崽反馈粒子。
• sleepyBabiesEnabled：幼崽被抱持一段时间后，启用困倦的被携带幼崽时刻。
• nurseryModeEnabled：拒绝玩家不安全放下操作的总开关。
• nurseryBlockLava：拒绝在熔岩内部或旁边放下。
• nurseryBlockFire：拒绝在火焰、营火、灵魂营火、岩浆块等类似燃烧危险上放下。
• nurseryBlockCactusAndDamage：拒绝在仙人掌和其他明显的伤害性方块上放下。
• nurseryBlockSuffocation：拒绝在幼崽会发生碰撞或窒息的狭窄空间中放下。
• nurseryBlockDangerousFalls：拒绝在危险落差上方放下。
• nurseryDangerousFallDistanceBlocks：对育儿模式而言被视为不安全的坠落距离。
• nurseryMessagesEnabled：启用俏皮的育儿模式拒绝动作栏消息。
• parentReunionEnabled：安全放下后装饰性亲子团聚反馈的总开关。
• parentReunionRadiusBlocks：在放下的幼崽附近搜索相容成年动物的半径。
• parentReunionCooldownTicks：同一幼崽或携带者的团聚反馈之间的最小间隔。
• parentReunionMessagesEnabled：启用温馨的亲子团聚动作栏消息。
• parentReunionParticlesEnabled：启用幼崽和成年动物周围的爱心粒子。

温馨反馈是装饰性且由服务器拥有的。它使用普通的Minecraft音效、粒子和动作栏消息，因此原版客户端无需安装模组即可看到或听到该反馈。

支持的动物

默认情况下，携带幼年动物支持合理可携带的普通被动型幼年动物，包括牛、猪、羊、鸡、山羊、兔子、猫、狐狸、马、驴、羊驼、骆驼、熊猫、海龟和狼等动物。

支持的动物名称：

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 中，并且现有的携带权限节点仍然适用。
• 携带时占用玩家的双手是模组设计的一部分，不可配置。

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

权限

携带幼年动物可与加载器的权限提供者集成，但权限提供者并非必需。Fabric 服务器使用 Fabric API 的权限 API。NeoForge 服务器使用 NeoForge 内置的权限 API。

如果加载器权限提供者处于活动状态：

• carrybabyanimals.nursery.bypass 默认为禁用，除非权限提供者明确授予。
• 所有其他携带幼年动物的权限将委托给您的权限提供者，并使用下表列出的默认值（当提供者没有明确规则时）。

如果没有加载器权限提供者处于活动状态：

• 所有玩家都可以携带未驯服的幼年动物。
• 玩家可以携带自己已驯服的幼年动物。
• 玩家不能携带其他玩家已驯服的幼年动物。
• 保留的重载权限在暴露时会回退到原版的游戏管理员命令权限。
• 在 Fabric 上，育儿模式绕过权限会回退到原版的游戏管理员命令权限。在 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：为重载支持保留，并在暴露时默认为原版的游戏管理员命令权限。