VO: Better Bats

Better Bats

“从毫无用处、惹人烦的洞穴生物，变成不可或缺的生态伙伴。”

[!NOTE]

1 个 JAR 对应 1 个版本的政策：我为每个 Minecraft 版本分别构建专用 JAR（例如 MC 1.20.1、MC 1.21.1、MC 1.21.11、MC 26.2、MC 26.3）。请下载与你的 Minecraft 安装版本完全匹配的构建文件。

依赖要求：所有受支持的版本都需要安装Fabric API和Dasik Library。

在原版 Minecraft 中，蝙蝠只是纯装饰性的环境生物，行动飘忽不定，没有任何机制用途或互动价值。它们漫无目的地飞进熔岩坑，在漆黑中生成，不掉落物品或经验值，反复发出单调的叫声，然后凭空消失。

Better Bats将蝙蝠变成活生生、聪明且能与环境共生的洞穴动物。借助真正的 3D Boids 集群算法，蝙蝠会组成流畅、无首领的空中群体。它们会倒挂在滴水石、锁链和灯笼上栖息，向下方作物施放天然鸟粪肥料，以致命的俯冲攻击猎杀烦人的害虫（蠹鱼、末影螨），通过声呐回波在漆黑的洞穴中导航，夜间像飞蛾一样聚向灯笼，并会对巨响爆炸或悄悄靠近的猫科捕食者做出动态应激反应。

本模组属于Vanilla Outsider Collection——以现代工程标准改进原版机制的模组合集。

---

核心机制与功能

群飞：Boids 空中集群

蝙蝠不再独自沿着飘忽混乱的路线飞行：

• 无首领的群体：由真正的 3D Boids 集群算法（凝聚、对齐和分离）组织。每只蝙蝠都会根据附近的同伴动态调整飞行路线。
• 可配置的群体上限：群体招募人数会平稳限制在bat_swarm_size（默认：5 只），避免过度拥挤，同时保持自然的集群飞行。
• 黄昏聚群：在黄昏时分（12,000–14,000 刻）和黎明时分（22,000–24,000 刻），凝聚力和对齐度会提升至 2.5 倍，同时缩小个体间距，使群体在进出洞口时显著聚拢。

鸟粪肥力与可再生骨粉

蝙蝠会积极滋养地下农场和地表作物：

• 栖息时积攒鸟粪：蝙蝠倒挂休息时会悄悄积攒鸟粪。达到阈值后（bat_guano_threshold，默认 12,000 刻 / 约 10 分钟），蝙蝠会触发一次鸟粪施肥周期。
• 深层作物滋养：蝙蝠会向下扫描最多20 格。如果检测到种有作物的耕地，就会触发骨粉催长效果，并伴有绿色村民开心粒子和飘落的菌丝提示。
• 实体鸟粪收集：开启better-bats:bat_drop_guano_item true后，栖息的蝙蝠在非耕地上方休息，或下方作物已完全成熟时，会掉落实体骨粉物品实体。

害虫防治：蠹鱼与末影螨防御

蝙蝠会成为对抗地下虫害的得力盟友：

• 凶猛俯冲攻击：蝙蝠在蠹鱼或末影螨进入10 格范围内时，会脱离群体队形并发动高速俯冲攻击。
• 致命打击：蝙蝠会造成可成长的攻击伤害（1.0 至 4.0 点伤害），其数值由遗传特征决定，能在潜伏的石中害虫聚集攻击玩家前迅速将其消灭。

洞穴声呐回波与导航

在光照等级降至零的地下深处，蝙蝠会利用生物声呐：

• 声波脉冲：在漆黑环境（天空光照等级为 0，方块光照等级 < 4）中飞行时，蝙蝠会周期性发出高频回声定位声。
• 声波环粒子：每次鸣叫都会产生细微的幽匿灵魂粒子，为探索者提供可见线索，指示远处洞穴顶部和蝙蝠栖息处的位置。

趋光性：被光吸引

夜间，蝙蝠会自然地被明亮的人造光源吸引：

• 绕灯盘旋：蝙蝠会离开群体，前往查看亮度 > 8 的光源（火把、灯笼、篝火）。
• 平滑倾斜飞行：蝙蝠会以平滑的弧线倾斜飞向灯笼，并以轻柔的垂直正弦波轨迹盘旋。
• 冷却后散去：在光源周围捕食环境中的昆虫 10-30 秒后，蝙蝠会散开并恢复正常群飞。

声波惊扰与躲避捕食者

拥有灵敏听觉和天然求生本能的生物：

• 声波干扰：在 16 格 范围内发生的巨大声响（玩家疾跑、挖掘方块、爆炸）会立即惊醒栖息中的蝙蝠，使其惊慌地高速四散飞逃，并重置鸟粪计时器。
• 躲避猫科动物与幻翼：蝙蝠会持续扫描 10 格范围内的天敌（猫、豹猫、幻翼）。休息中的蝙蝠会立即惊醒，飞行中的蝙蝠则会受到强力的定向逃逸推力，远离危险。

通用栖息锚点

蝙蝠现在可以倒挂在符合环境的栖息处：

• 尖锐滴水石：悬挂在洞穴顶部的钟乳石。
• 铁链与悬挂式灯笼：工业设施和地牢装饰。
• 栅栏、石墙与树叶：地表森林和村庄中的栖息处。
• 台阶与楼梯：任何坚固的底面。

动物遗传学集成

由 DasikLibrary Animal Genetics API 提供支持：

• 翼展 / 体型：体型自然变化范围为 0.75x 到 1.30x。
• 移动速度：飞行速度会根据遗传结果在 -4% 到 +8% 之间变化。
• 攻击力：俯冲攻击害虫造成的伤害会自然缩放至 1.0 到 4.0。

兼容性与架构

• 服务端兼容：完全在服务端运行。原版客户端无需下载任何内容，即可加入安装了模组的服务器。
• ModMenu + YACL 界面：单人游戏中可选的客户端配置界面，可视化调整蝙蝠群规模和鸟粪生成速率。
• 存档零膨胀：状态访问器可在内存中稳定运行，并支持可靠的世界存档升级。

---

快速参考与机制矩阵

| 游戏玩法方面 | 原版 Minecraft | Better Bats |
| :— | :— | :— |
| 飞行模式 | 单只蝙蝠漂移，轨迹飘忽混乱 | 有序的 Boids 群飞（凝聚 + 对齐） |
| 群体机制 | 无（仅有单只生物） | 5只蝙蝠组成群落，在黄昏和黎明时聚集 |
| 休息 / 栖息 | 仅限固体天花板方块 | 滴水石、锁链、灯笼、树叶、墙壁、台阶 |
| 农田互动 | 无 | 蝙蝠粪肥施肥，向下扫描20格范围内的作物 |
| 实体骨粉掉落 | 无 | 可配置的物品掉落（bat_drop_guano_item） |
| 害虫防治 | 被动，不理会生物 | 俯冲攻击蠹虫和末影螨（造成1-4点伤害） |
| 洞穴导航 | 静默地随机漂移 | 回声定位声响和幽匿之魂粒子 |
| 对灯笼的反应 | 无视光线 | 趋光性飞蛾效果（夜间绕灯飞行） |
| 受惊与噪音 | 仅在被直接撞到时醒来 | 16格范围内的声音会引发惊慌，包括挖掘、疾跑和爆炸 |
| 对捕食者的反应 | 无视猫和豹猫 | 受到10格范围内猫科动物的影响时，会朝远离它们的方向逃跑 |

---

游戏内命令

Better Bats 提供专用的 Brigadier 命令集，可通过 /betterbats 或别名 /bb 使用：

| 命令语法 | 权限等级 | 描述 |
| :— | :—: | :— |
| /betterbats help (或 /bb help) | 所有玩家 | 显示交互式命令语法和子命令。 |
| /betterbats status (或 /bb status) | 所有玩家 | 汇总当前活跃蝙蝠群的规模、蝙蝠粪肥计时器和害虫防治状态。 |
| /betterbats get <rule> | 所有玩家 | 查询指定 Better Bats 规则的当前值。 |
| /betterbats set <rule> <val> | 管理员（等级 2） | 在游戏中实时修改 GameRule，并同步到配置文件。 |
| /betterbats reset | 管理员（等级 2） | 将所有 Better Bats GameRule 重置为出厂默认值。 |
| /betterbats reload | 管理员（等级 2） | 从磁盘重新加载 JSON 配置，并同步当前世界状态。 |
| /betterbats debug on|off | 管理员（等级 2） | 开启或关闭实时诊断日志。 |
| /betterbats debug inspect | 管理员（等级 2） | 检查最近蝙蝠的遗传特征、体型和蝙蝠粪肥计时刻数。 |
| /betterbats debug spawn_swarm [count] | 管理员（等级 2） | 生成一群协同行动的测试蝙蝠（默认：5只，最多30只）。 |

---

配置与 GameRules

[!重要]

配置文件与游戏内 GameRules：全局配置文件（config/better-bats.json）仅为新创建的世界定义默认值。在已有世界中，请通过游戏内的编辑游戏规则界面、/betterbats set 命令或 /gamerule 命令更改设置。

| 游戏规则名称 | 类型 | 默认值 | 有效范围 | 描述 |
| :— | :—: | :—: | :—: | :— |
| better-bats:bat_swarm_size | Integer | 5 | 0 至 50 | 蝙蝠群的最大规模。设为 0 可完全禁用群聚行为。 |
| better-bats:bat_guano_threshold | Integer | 12000 | 100 至 72000 | 栖息中的蝙蝠产出鸟粪所需的刻数（约 10 分钟）。数值越低，产出越快。 |
| better-bats:bat_pest_control | Boolean | true | true / false | 切换是否俯冲猎杀蠹虫和末影螨。 |
| better-bats:bat_alignment | Integer | 5 | 0 至 100 | 蝙蝠的飞行方向与群体方向保持一致的程度。 |
| better-bats:bat_cohesion | Integer | 5 | 0 至 100 | 蝙蝠被群体中心吸引的程度。 |
| better-bats:bat_separation | Integer | 10 | 0 至 100 | 蝙蝠避开与相邻同伴碰撞的程度。 |
| better-bats:bat_spawn_weight | Integer | 30 | 0 至 100 | 黑暗洞穴及夜间地表的蝙蝠生成权重（原版为 10）。 |
| better-bats:bat_drop_guano_item | Boolean | false | true / false | 为 true 时，栖息的蝙蝠会掉落实体骨粉物品。 |
| better-bats:debug_mode | Boolean | false | true / false | 启用蝙蝠 AI 的详细诊断日志。重启后会重置为 false。 |

---

实用指南与养殖攻略

1. 在作物温室中设计自然蝙蝠栖息地

• 建造一座天花板较高（8 至 15 格）的地下温室。
• 在农田上方的天花板上悬挂尖锐滴水石、铁链或灯笼。
• 进入温室的蝙蝠会自然选择这些栖息点休息。休息时，它们每隔约 10 分钟就会为下方至多 20 格内的作物施肥。

2. 建造自动化可再生骨粉塔

1. 启用实体鸟粪物品掉落功能：/bb set bat_drop_guano_item true。
2. 建造一间封闭的黑暗房间，并从天花板上垂下铁链。
3. 在栖息点正下方（垂直距离不超过 20 格）铺设漏斗地板。
4. 蝙蝠在漏斗上方休息时，鸟粪会以实体骨粉物品的形式掉落，并直接汇入储物箱，无需杀死任何生物！

3. 防御蠹虫与要塞侵扰

• 在山地生物群系中冒险或探索地下要塞时，蝙蝠可以充当预警防御系统。
• 如果石头怪物蛋被破坏，附近的蝙蝠会立刻俯冲攻击蠹虫，吸引其仇恨并将其消灭，阻止它们增殖。

4. 利用猫科动物引导蝙蝠群离开

• 如果蝙蝠群聚集在你想保持安静的区域，就在房间里放一只驯服的猫或豹猫。
• 蝙蝠会在 10 格内察觉到猫科掠食者，离开栖息地，并转向较暗、没有掠食者的通道。

5. 夜间门廊照明与趋光性

• 沿着小路或室外门廊悬挂灯笼。夜间，地表蝙蝠会沿弧线飞向灯笼，优雅地盘旋 10–30 秒，然后飞回夜空。

---

推荐搭配模组

如果你喜欢Better Bats，这些来自Vanilla Outsider Collection的配套模组可以无缝搭配：

• Agrarian Reform：离线作物生长模拟、智能防踩踏保护和深层灌溉，让蝙蝠粪便施肥更有价值。
• True Sleep：实时加速夜晚；你休息时，蝙蝠群会苏醒并开始狩猎。
• Better Dogs：丰富的犬类伙伴行为、岗哨巡逻模式、遗传特征以及乘坐载具功能。

探索完整的 Vanilla Outsider Collection，了解更多原版风格增强内容。

---

社区与支持

需要帮助、想测试早期测试版，或讨论即将推出的功能？欢迎加入官方 Discord 社区：

---

支持

如果你喜欢 Better Bats 和 Vanilla Outsider Collection，欢迎支持后续更新！

[!NOTE]

印度尼西亚用户：如果你想支持我，但不想使用 PayPal/Ko-fi，SocioBuzz 和 Saweria 支持当地支付方式（Gopay、OVO、Dana 等）！

---

鸣谢与整合包权限

| 项目 | 信息 |
| :— | :— |
| 创作者 / 作者 | Dasik（Rifaditya） |
| 社区 | 官方 Discord |
| 系列 | Vanilla Outsider |
| 许可证 | GNU General Public License v3.0 (GPLv3) |
| 源代码 | GitHub – Rifaditya/Better-Bats-26.2 |
| 问题追踪 | GitHub Issues |
| 文档 / Wiki | 文档门户 |

[!IMPORTANT]

整合包权限与分发：

欢迎在任何平台的任何整合包中加入此模组！但模组文件必须通过官方分发渠道直接下载（Modrinth 或 CurseForge）。严禁将原版模组 JAR 文件重新上传、镜像或分发至第三方镜像网站、爬虫门户网站或未经授权的启动器。

许可证与分支指南：

本项目采用 GNU GPLv3 开源许可。欢迎查看代码、学习代码，并分叉此仓库以创建真正的修改、实质性的功能扩展或社区移植版本——前提是你的项目继续采用 GPLv3 开源许可并注明出处。

但是，完全一比一重新上传、没有实质性功能改动的克隆分支，或以不同项目名称重新发布完全相同的构建版本（例如为了刷下载量或奖励）都严格禁止。

---