更新日志

[0.17.2-beta] - 2025-11-27

变更：

• #368 生成训练师所需的 maxLevelDiff 现在会根据玩家等级相对于 100 的值进行线性缩放。该值不会低于 4（除非显式设置为更低值）。一个例外是关键训练师，他们的等级差始终可达 maxLevelDiff（基本上与之前所有训练师的机制相同）。

修复：

• #367 训练师的生成几率未随与玩家等级差距增大而正确降低的问题

更新日志

[0.17.2-beta] - 2025-11-27

更改：

• #368 生成训练师所需的 maxLevelDiff 现在会根据玩家等级相对于 100 的数值线性缩放。该值不会低于 4（除非明确设置为更低的值）。一个例外是关键训练师，他们始终可以以最高达 maxLevelDiff 的等级差生成（基本上与之前所有训练师的行为一致）。

修复：

• #367 训练师的生成几率在与玩家等级差距较大时未被正确降低的问题

更新日志

[0.17.1-beta] - 2025-11-24

变更：

• #366 略微提高了持有训练家卡片跟随玩家的训练师移动速度
• #365 微调了训练师NPC在战斗中的实体行为

修复：

• #364 修正部分超级对战物品过时的物品ID
• #363 修正部分训练师仅携带1只宝可梦却使用双打对战模式的问题（同时调整了此类训练师的显示名称）
• #362 修正当（更强的）可选训练师跟随主训练师时，奖励等级上限显示错误的问题
• #361 修正训练师无法跟随持有训练家卡片且可与其战斗的玩家的问题（若玩家直接注视训练师则会停止跟随，以保留强制战斗机制）
• #360 修正训练师对无法与之战斗的玩家持续注视的问题

移除：

• #359 移除了训练师实体ID变更时的日志消息
• #358 移除了因玩家等级低于限制而拒绝战斗的提示语（因为这可能不再作为拒绝战斗的理由）

更新日志

[0.17.1-beta] - 2025-11-24

变更：

• #366 略微提高了持有训练家卡并跟随玩家的训练家移动速度
• #365 微调了训练家实体在战斗中的行为

修复：

• #364 修复了一些超级对战物品过时的物品ID
• #363 修复了部分训练家仅携带1只宝可梦却采用双打对战模式的问题（同时调整了此类训练家的显示名称）
• #362 修复了当（更强的）可选训练家跟随主训练家时，奖励等级上限显示错误的问题
• #361 修复了训练家无法跟随手持训练家卡且可与其对战的玩家的问题（若玩家直接注视训练家，他们将停止跟随，以允许强制对战）
• #360 修复了训练家对无法对战的玩家持续注视的问题

移除：

• #359 移除了训练家实体ID变更时的日志消息
• #358 移除了因玩家等级上限过低而拒绝战斗的训练家回应（因为这可能不再是对战拒绝的理由）

更新日志

[0.17.0-beta] - 2025-11-22

新增：

• #357 新增配置项 forceBattleLookTicks：玩家需要注视训练师多长时间（以游戏刻为单位）才会被强制进入战斗
• #356 新增配置项 forceBattleMaxDistance：训练师可强制玩家进入战斗的最大距离
• #355 新增配置项 forceBattleMaxLevelDiff：训练师与玩家之间允许强制战斗的最大等级差
• #354 新增配置项 forceBattleOnSight：决定训练师是否可以在发现玩家时强制其进入战斗
• #353 为数据包中的训练师生物新增属性 forceBattleOnSight、forceBattleMaxDistance、forceBattleLookTicks 和 forceBattleMaxLevelDiff（若为特定训练师设置了这些属性，将优先于全局配置值）

变更：

• #352 现在，如果玩家持续直视训练师达到一定时间，训练师可强制其进入战斗（参见新增的配置选项）
• #351 将 Cobblemon 的最低依赖版本更新至 1.7.0
• #350 将 RCTApi 的最低依赖版本更新至 0.14.0-beta

修复：

• #349 修复了从数据包 JSON 对象解析训练师生物属性时缺少部分验证的问题（相关问题通常会作为警告打印到日志中）

更新日志

[0.17.0-beta] - 2025-11-22

新增：

• #357 新增配置项 forceBattleLookTicks：玩家需要盯着训练家多长时间（以游戏刻为单位）才会被强制进入战斗
• #356 新增配置项 forceBattleMaxDistance：训练家可强制玩家进入战斗的最大距离
• #355 新增配置项 forceBattleMaxLevelDiff：训练家与玩家之间允许强制战斗的最大等级差
• #354 新增配置项 forceBattleOnSight：决定训练家是否能在看到玩家时强制其进入战斗
• #353 为数据包中的训练家生物新增属性 forceBattleOnSight、forceBattleMaxDistance、forceBattleLookTicks 和 forceBattleMaxLevelDiff（若为特定训练家设置了这些属性，则优先于全局配置值）

变更：

• #352 现在，如果玩家被训练家直接注视达到一定时间，可能会被强制进入战斗（参见新增的配置选项）
• #351 将方块宝可梦 (Cobblemon) 的最低依赖版本更新至 1.7.0
• #350 将 RCTApi 的最低依赖版本更新至 0.14.0-beta

修复：

• #349 修复了从数据包 JSON 对象解析训练家生物属性时部分属性缺少验证的问题（相关问题通常会作为警告打印到日志中）

更新日志

请注意，最新的 0.16 版本仅支持 方块宝可梦 (Cobblemon) 1.6。版本 0.17 即将发布。

[0.16.11-beta] - 2025-11-22

新增：

• #348 数据包属性 initialLevelCap 和 relativeLevelCap 用于系列：若设置，则覆盖该系列的全局配置值
• #347 数据包属性 relativeLevelCap 用于训练家怪物：若设置，则覆盖全局配置值及系列属性中对该训练家的设定

变更：

• #346 命令 trainer get required/reward_level_cap 现在需要一个玩家选择器参数
• #345 重命名服务端配置 additiveLevelCapRequirement → relativeLevelCap （该选项将重置为其默认值 0）
• #344 将部分日志错误替换为警告
• #343 训练家（拥有相应战利品表的）现在仅可在首次被击败后掉落 起源球，且仅当其宝可梦等级达到或超过 50 级时才可能掉落（此物品原计划被移除）
• #342 训练家不再因玩家的等级上限低于训练家等级而拒绝战斗（但仍会因其他原因拒绝，例如携带超出等级上限的宝可梦，或未击败前置训练家）

修复：

• #341 调整了多个位置显示的等级上限（如训练家卡片），以更准确反映玩家的实际熟练度进度
• #340 修复了当训练家依赖于其他系列的训练家时产生的不一致问题（这些跨系列依赖现将被忽略，并在日志中输出警告）
• #339 修复了在系列元数据中省略（可选的）title 或 description 字段导致崩溃的问题
• #338 修复了生成的系列熟练度图表（plantuml）图例中的视觉错误

更新日志

请注意，最新的 0.16 版本仅支持 方块宝可梦 (Cobblemon) 1.6。版本 0.17 即将发布。

[0.16.11-beta] - 2025-11-22

新增：

• #348 系列数据包属性 initialLevelCap 和 relativeLevelCap：若设置，将覆盖该系列的全局配置值
• #347 训练家怪物数据包属性 relativeLevelCap：若设置，将覆盖全局配置值和系列属性中的设定

变更：

• #346 命令 trainer get required/reward_level_cap 现在需要一个玩家选择器参数
• #345 重命名服务端配置 additiveLevelCapRequirement → relativeLevelCap （该选项将重置为其默认值 0）
• #344 将部分日志错误改为警告
• #343 现在只有在首次被击败后，训练家（拥有对应战利品表）才可能掉落 起源球，且仅适用于拥有等级在 50 或以上的宝可梦的训练家（此物品原计划被移除）
• #342 当玩家的等级上限低于训练家等级时，训练家不再拒绝战斗（但仍会因其他原因拒绝，例如携带超过等级上限的宝可梦，或未击败过其他指定训练家）

修复：

• #341 调整了多个位置显示的等级上限（例如训练家卡片），以更准确地反映玩家的实际熟练度进度
• #340 修复了当训练家依赖来自不同系列的其他训练家时出现的不一致问题（现在忽略此类依赖关系，并在日志中打印警告）
• #339 修复了在系列元数据中省略（可选的）title 或 description 导致崩溃的问题
• #338 修复了生成的系列熟练度图表（plantuml）图例中的视觉错误

更新日志

[0.16.10-beta] - 2025-10-16

修复：

• #337 修复了作为玩家代理的方块（例如部署器）在玩家处于不同维度时与训练师交互可能导致的崩溃问题
• #336 修复了包含持久性训练师的现有维度被移除时可能引发的崩溃问题

更新日志

[0.16.10-beta] - 2025-10-16

修复：

• #337 修复了作为玩家代理的方块（例如部署器）在玩家处于不同维度时与训练师交互可能导致的游戏崩溃问题
• #336 修复了移除包含持久性训练师的已有维度时可能引发的游戏崩溃问题

更新日志

[0.16.8-beta] - 2025-09-15

新增：

• #331 添加配置项 ticksToDespawnIfUnseen（默认值 6000，即5分钟）：若训练师在指定的tick数内未被任何玩家看到，则会自动消失

变更：

• #330 （非持久性）训练师若在超过5分钟内未被任何玩家看到，将会自动消失（可配置）
• #329 配置项 uniqueTrainerRadius 的默认值由 -1 改为 500
• #328 略微调整了训练师NPC的行为（有较小几率在某个位置停留数秒）
• #327 训练师驱逐棒现在可通过红石信号禁用
• #326 训练师驱逐棒现在会进一步改变其作用范围内训练师的行为，使其远离该物品（真正实现了“驱逐”的功能）

修复：

• #325 修复了训练师驱逐棒在区块注册方面的一些问题（此前已放置的驱逐棒应会自动受到此修复影响；如果你发现某个驱逐棒仍不工作，可尝试破坏后重新放置）

更新日志

[0.16.9-beta] - 2025-10-06

更改：

• #335 略微降低了训练家卡箭头的透明度

修复：

• #334 修复了与从训练家驱逐钓竿加载状态相关的潜在崩溃问题
• #333 修复了在持有训练家卡时，跨多个维度与训练家关联及关键训练家NPC相关的潜在崩溃问题
• #332 修复了与训练家卡箭头相关的渲染问题
  • 修复了箭头几何形状的轻微问题
  • 当主手和副手同时持有训练家卡时，箭头渲染不一致的问题
  • 修复了箭头渲染干扰旅程地图标记显示的问题

更新日志

[0.16.7-beta] - 2025-09-11

修复：

• #324 修复了自动点击器及类似方块实体作为玩家代理（例如 Create 的部署器）能够与训练家发起战斗的问题
• #323 修复了在所有训练家尚未完全加载前即可开始战斗的问题（该问题曾导致游戏崩溃）
• #322 重构了持久化训练家的注册机制，解决了在拥有大量维度的世界中出现的性能问题（初始加载可能无法立即受益于该优化）
• #321 修复了即使将 maxTrainersTotal 设置为 0 时，训练家仍可能在极少数情况下生成的问题

更新日志

[0.16.8-beta] - 2025-09-15

新增：

• #331 添加配置项 ticksToDespawnIfUnseen（默认值 6000，即5分钟）：若训练师在指定的tick数内未被任何玩家看到，则会自动消失

变更：

• #330 （非持久性）训练师若在超过5分钟内未被任何玩家看到，将会自动消失（可配置）
• #329 配置项 uniqueTrainerRadius 的默认值由 -1 改为 500
• #328 略微调整了训练师NPC的行为（有较小几率在某个位置停留几秒钟）
• #327 训练师驱逐棒现在可通过红石信号禁用
• #326 训练师驱逐棒现在会进一步影响其作用范围内的训练师行为，使其远离该装置（真正实现了“驱逐”的功能）

修复：

• #325 修复了训练师驱逐棒在区块注册方面的一些问题（此前已放置的驱逐棒应会自动受到此修复的影响；如果你发现某个驱逐棒仍无法正常工作，可尝试破坏后重新放置）

更新日志

[0.16.7-beta] - 2025-09-11

修复：

• #324 修复了自动点击器及类似方块实体（例如 Create 模组的部署器）作为玩家代理时可触发与训练家对战的问题
• #323 修复了在所有训练家尚未完全加载前即可开始战斗的问题（该问题曾导致游戏崩溃）
• #322 重构了持久化训练家的注册机制，解决了在拥有大量维度的世界中出现的性能问题（初始加载可能无法立即受益于此项优化）
• #321 修复了即使将 maxTrainersTotal 设置为 0 时，训练家仍可能在极少数情况下生成的问题

变更日志

[0.16.6-beta] - 2025-07-07

添加：

• #320 配置选项 uniqueTrainerRadius：指定一个半径，用于在尝试生成训练员时检查其他具有相同身份的训练员的存在（默认值为 -1 = 整个世界）

修复：

• #319 玩家登录时的卡顿峰值（实验性，在我这边测试/确认更高玩家数量的情况有点困难）
• #318 训练员驱赶棒不可破坏且不会掉落其物品
• #317 训练员驱赶棒浸水导致崩溃

变更日志

[0.16.6-beta] - 2025-07-07

添加：

• #320 配置选项 uniqueTrainerRadius：指定一个半径，当尝试生成训练员时，训练员会检查是否存在具有相同身份的其他训练员（默认值为 -1 = 整个世界）

修复：

• #319 玩家登录时的卡顿峰值（实验性，在我这边测试/确认有更多玩家数量的情况有点困难）
• #318 训练员击退棒不可破坏且不会掉落其物品
• #317 使训练员击退棒浸水导致崩溃

变更日志

[0.16.5-beta] - 2025 年 6 月 24 日

修复：

• #316 训练员卡箭头渲染出现故障（感谢 f0kx 协助测试）

变更日志

[0.16.5-beta] - 2025-06-24

修复：

• #316 训练师卡箭头的渲染错误（感谢 f0kx 帮助测试）