唤潮 v2.0 — 2026年1月9日

---

钓鱼战利品

• 钓鱼战利品现由一套自定义的数据驱动系统控制，具体包含以下部分：

鱼类数据

• 鱼类的捕获条件、稀有度、稀有度修正值、百鱼全书数据、小游戏统计信息、显示数据等，现均通过各鱼类专属的 JSON 文件进行管理，文件位于 data/tide/fishing/fish

板条箱数据

• 板条箱的捕获条件、稀有度、稀有度修正值等，现均通过各板条箱专属的 JSON 文件进行管理，文件位于 data/tide/fishing/crates

钓鱼战利品数据

• 外部钓鱼战利品表（例如原版的垃圾与宝藏战利品表）现可通过位于 data/tide/fishing/loot 的 JSON 文件进行配置或新增

待完整版本发布后，将提供上述新型数据驱动格式的更详尽文档。

---

鱼类

• 鱼类阵容已发生重大调整，主要包括：
  • 移除了若干与模组主题不符、或最初仅为填充内容而加入的鱼类。
  • 新增大量可在世界中探索发现的鱼类，使总数达到约 100 种。
• 绝大多数现有鱼类物品均已重制贴图（终于完成！）。
• 每种鱼类现在均可烹饪并食用，无论其外观看起来多么“健康”。
• 本模组中的每一种鱼类，如今均拥有与其对应的实体版本。
• 重构了实体生成系统，使其部分基于鱼类的“鱼类数据”，自动判定生成条件。
• 为每种鱼类实体添加了自然生成机制（少数特例除外）。
• 默认情况下，鱼类物品不再能像以往那样堆叠至 64 个（详见下文，或查看标题为“物品”的配置选项卡以获取更多信息）。

鱼类体长

• 每条捕获的鱼现会根据其“鱼类数据”中可配置的参数，被赋予一个以厘米为单位的体长数值。
• 已新增配置选项，允许用户完全禁用该机制，或仅在百鱼全书中显示极端体长记录，而不影响物品堆叠数量。
• 鱼类体长将成为一项额外的收集要素，未来也可能影响其他游戏内容。

可装桶鱼类

• 每条捕获的鱼类物品现会被赋予一个时间戳，用于判断该鱼是否仍处于“存活”状态。
• 若鱼类物品为“存活”状态，你可在物品栏界面中，手持水桶（或岩浆桶）点击该鱼，将其转化为对应鱼类的装桶物品，从而获得该鱼的实体形态。
• 若鱼类为“存活”且可装桶，其名称下方将显示“可装桶”提示文字。
• 已新增配置选项，供用户选择：永久禁用可装桶鱼类、始终启用可装桶功能，或自定义鱼类被捕获后保持“存活”状态的持续时间。

---

百鱼全书

• 百鱼全书的机制与视觉表现均已重构，主要变化如下：
• 百鱼全书现已深度整合进前述“鱼类数据”系统，可依据任意具备完整数据文件的鱼类，动态生成其档案。只要定义了鱼类数据文件，开发者便无需再单独创建百鱼全书条目数据文件。
• 鱼类“档案”界面也已全面重做，采用全新布局设计。
• 移除了旧有的“分页”系统，转而采用更宽松的分类方式。这意味着所有鱼类——无论是否已解锁——在百鱼全书界面中始终可见。
• 此外，原先被拆分至多个小类别的鱼类，现已合并至相应更大的类别中。
• 鱼类的稀有度、档案描述及栖息地概要，均可通过“鱼类数据”系统进行设定。
• 仅收集鱼类物品将不再解锁其在百鱼全书中的档案！ 每种鱼类的档案，必须通过实际垂钓行为捕获该鱼才能解锁。

---

机制

• 捕获鱼类所需时间，现亦随垂钓所处液体类型而变化（例如：水为 ×1.0，岩浆为 ×1.6，虚空为 ×1.8）。该倍率在施加诱饵或鱼竿附魔等垂钓速度修正前即已生效。
• 在特定生物群系中捕获的鱼类，对其可捕获区域的限制更为宽松。例如，在穿越沙漠生物群系的河流中垂钓时，你仍可捕获沙漠主题的鱼类。
• 鱼类对温度的偏好不再依赖于具体生物群系，而是基于世界生成噪声路由器中的内部温度值。这意味着在沙漠中心垂钓，将比在沙漠与温带生物群系交界处垂钓，更倾向于捕获喜暖鱼类。
• 还新增或修改了若干核心机制：

小游戏

• 垂钓小游戏已进行多项优化，包括：
• 小游戏不再采用基于概率的捕获机制，转而采用具有两个明确区域的进度条。
• 点击进度条中较亮区域即可成功捕获鱼类；若点击较暗区域，则捕获失败，小游戏随即结束。
• 每种鱼类在其“鱼类数据”中均设有可配置的“力量”与“速度”参数，分别影响暗区所占比例及垂直进度条的移动速率。
• 并非所有鱼类的垂直进度条都再沿“正弦波”轨迹运动，部分鱼类将展现出更加奇特的运动模式——请时刻保持警惕！
• 鱼类的运动模式同样定义于其“鱼类数据”中，可设为以下任一类型：
  • sine（正弦）
  • plateau（平台）
  • jitter（抖动）
  • darts（突刺）
  • linear（线性）
  • linear_wrap（循环线性）
• 此外，较亮区域的颜色将随垂钓液体种类而变化（例如：水为蓝色，岩浆为橙色，虚空为紫色）。

虚空垂钓

• 若要在虚空中垂钓，你须先合成“深渊之钩”，再通过渔夫工坊将其附魔至任意鱼竿上。
• 附魔后，整个虚空即被视为可垂钓液体。需注意：可垂钓的虚空范围并不与死亡屏障对齐，可能大幅向上延伸（例如终界维度）。
• 已为终界虚空及主世界基岩层下的虚空新增多种鱼类。
• 还新增若干粒子效果，将在可垂钓的虚空表面呈现。

---

物品

• 新增若干“探查类”物品，如温度计与怀表，配合百鱼全书或热带鱼笔记使用，可协助玩家精准定位目标鱼类。
• 大多数传奇级鱼类均拥有后期可合成的专属物品，各自在玩家成长进程中承担不同职能。
• 其他实用物品亦有新增：

鱼篓

• 新增“鱼篓”，本质上是一种可存储鱼类的捆包。
• 手持鱼篓右键可打开或关闭鱼篓。开启状态下，你捕获或从地面拾取的任何鱼类将自动存入鱼篓。
• 此物品对处理新引入的不可堆叠鱼类尤为实用。

热带鱼笔记

• 2.0 版本前的“撕裂笔记”已被全新物品“热带鱼笔记”取代。
• 热带鱼笔记可于板条箱中获取，掉落几率与前述“撕裂笔记”相近。
• 特定鱼类的热带鱼笔记，亦可通过该鱼与一张纸合成获得。
• 每张热带鱼笔记将显示单一鱼类的捕获条件、稀有度及相对体型，通常指向尚未被发现的鱼类。
• 其条件显示方式与百鱼全书中一致，唯独不显示鱼类名称与图示。
• 若热带鱼笔记所指鱼类已被发现，其界面中将显示勾选标记。

鱼类展示架

• 鱼类展示架是一种可放置方块，供玩家将鱼类物品挂于墙面作装饰之用。
• 放置展示架后，手持具备展示数据的任意鱼类物品对其右键，即可将该鱼的实体形态悬挂于墙面；再次右键则可取回物品堆叠。
• 展示数据（如旋转角度与偏移量）均定义于“鱼类数据”文件中。

---

其他杂项

• 鱼竿现可在铁砧上使用线进行修复，方式与原版工具及护甲的升级相同。
• 大部分旧成就已重命名，并新增大量成就。
• 新增两条实用指令：/journal 与 /fishing。
• 移除了旧版钓鱼船结构——我认为它实无必要。
• 许多物品与方块 ID 已更新，以匹配英文名称的最新翻译。例如，“渔夫工坊”（此前 ID 为 tide:angler_workshop）现已更名为 tide:angling_table。若在曾加载过唤潮 1.x 的世界中直接加载唤潮 2.0，可能导致兼容性问题！

此处未单独列出 Bug 修复清单，因本次重构涉及面极广，许多旧有 Bug 很可能已被一并修复。