Animal Pens

🐾 Animal Pens 模组

✅ 优化你的农场，减少卡顿！

厌倦了大型动物农场造成的卡顿？Animal Pens 可以让你将动物存放在专用的围栏、水族箱和鸟舍中，同时保留完整功能！
告别拥挤的牲口棚——让动物整齐地待在里面，同时照常繁殖、剪毛、挤奶和收集掉落物。

🎮 工作原理：

✔️ 动物笼与容器 – 使用动物笼捕捉陆地动物，使用动物容器捕捉水生生物。
✔️ 喂食动物即可繁殖 – 不需要让动物在外自由活动，只要在围栏里喂食即可！
✔️ 支持大多数原版互动(1)，包括：
    🗡️ _养殖动物_以获取战利品
    ✂️ _为羊剪毛_
    🥛 _给牛、哞菇和山羊挤奶_
    🍄 _从哞菇身上收集蘑菇煲_
    🐝 _蜜蜂花粉再生_
    🐢 _根据设置掉落海龟鳞甲_
    🖌️ _用刷子刷取犰狳鳞甲_
    🧺 _使用水桶捞起鱼或美西螈_

✔️ 自定义互动：
🔹 鸡、海龟和嗅探兽 – 使用桶收集蛋。
🔹 海龟 – 喂食后会掉落鳞甲（掉落时间可配置）。
🔹 嗅探兽 – 需要用碗收集掉落的种子。
🔹 喂鱼 – 鱼吃海带和海草，其他水生生物吃鱼。
🔹 青蛙 – 喂食岩浆怪后会掉落蛙明灯。

✔️ 变种存储与选择
    • 收起动物时，会将其变种存储在笼子中。
    • 空手右键点击围栏即可查看已存储的变种。
    • 如果启用了_动物外观成长_，可以调整动物的显示大小。
    • 可以调整受到保护、不会被击杀的动物最小数量。
    • 可以设置动物围栏/水族箱是否仅允许你进行互动。

✔️ 潜行时点击地面即可释放动物。
✔️ 动物围栏、水族箱和鸟舍可以通过比较器输出红石信号。
✔️ 可以对动物围栏、水族箱和鸟舍使用发射器及特定工具。

(1) 未添加的功能：
     任何动物变形
     动物与其他实体之间的任何互动

🔧 可自定义设置：

通过模组配置文件 _\[config/animal\_pen\_config.json\]_轻松调整游戏玩法，包括：

🗡️ 攻击冷却时间 – 可以调整玩家在围栏中击杀动物的速度。

📏 动物成长系统（可选）：
    • 启用后，动物越多，围栏中的显示尺寸越大。
    • 可调整成长倍率。

🎨 已存储的变种 – 可以调整每个围栏可存储的变种数量。

🔧 数据驱动设置：

新增三个物品标签：

这些标签用于指定哪些物品可以攻击相应的方块：

• animal_pen:can_attack_aquarium – 此标签中的物品可以攻击水族箱方块。
• animal_pen:can_attack_pen – 此标签中的物品可以攻击动物围栏方块。
• animal_pen:can_attack_aviary – 此标签中的物品可以攻击鸟舍方块。

示例：添加自定义武器

若要允许custom\_knife和modded\_dagger攻击围栏，请在你的数据包中创建以下文件：

📂 适用于 Minecraft 1.20.6 及更早版本：

路径：your_custom_datapack/data/animal_pen/tags/items/can_attack_pen.json

📂 适用于 Minecraft 1.21 及更高版本：

路径：your_custom_datapack/data/animal_pen/tags/item/can_attack_pen.json

{
  "replace": false,
  "values": [
    "mod1_id:custom_knife",
    "mod2_id:modded_dagger"
  ]
}

这样就可以使用自定义武器攻击动物围栏和水族箱。

新增三个实体标签：

这些标签用于定义哪些物品可以攻击对应的方块：

• animal_pen:animal_cage_pickable – 可用动物笼捕捉的生物。
• animal_pen:bird_catcher_pickable – 可用捕鸟器捕捉的生物。
• animal_pen:water_mob_container_pickable – 可用水生动物容器捕捉的生物。

📂 适用于 Minecraft 1.20.6 及更低版本：

路径：<your_custom_datapack>/data/animal_pen/tags/entity_types/animal_cage_pickable.json

📂 适用于 Minecraft 1.21 及更高版本：

路径：<your_custom_datapack>/data/animal_pen/tags/entity_type/animal_cage_pickable.json

可自定义的互动

你也可以使用数据包为每种动物添加或更改互动。
要添加动物互动，请创建文件：<your_custom_datapack>/data/<your_data_pack_id>/animal_interactions/<your_interaction>.json
要更改动物互动，请修改动物文件：<your_custom_datapack>/data/minecraft/animal_interactions/<entity_id>.json

互动定义详见：[维基] (https://github.com/BONNePlayground/AnimalPen/wiki/Animal-Interaction)

📜 命令：

服务器管理员可以使用以下命令管理模组：

💾 /animal_pen reset – 将配置文件重置为默认值。
🔄 /animal_pen reload – 无需重启游戏即可重新加载配置文件。

🛠️ 前置要求：

📌 Architectury API（必需）。
📖 Patchouli（可选，添加游戏内指南书）。
📖 ClothConfigAPI（可选，添加配置编辑界面）。

🎨 模组美术：

感谢 Breadcrumb5550 为本模组制作方块和物品！

使用 Animal Pens，你可以减少卡顿、保持农场井然有序，同时完整保留互动功能！