ADQ调整 - 战斗模式

ADQ 调整

ADQ 调整是《航空交付任务》(ADQ / TNM 任务) 的一个 NeoForge 1.21.1 附加组件。

它保留了 ADQ 的任务板、货物蓝图、奖励、已保存任务、冷却时间、指南针以及基于 Sable 的货物玩法，同时替换了不安全的任务生成，并增加了货物、交付、PvP、可见性和任务板的改进。

 无卡顿任务生成

ADQ 调整会在 ADQ 的原生生成器运行之前，拦截所有公开的 ADQ/TNM 任务生成入口点。这包括自动任务生成以及调用上游生成器的 ADQ/TNM 界面或命令路径。

原生的 ADQ/TNM 生成会被取消，并转而通过 ADQ 调整来处理。

无卡顿生成器：

- 从不使用 ADQ 原生的 `findNearestMapStructure` 搜索。
- 从不使用阻塞性的 `getChunkAt` 调用来创建路线。
- 从不为了寻找任务地点而生成地形。
- 从现有区块中读取持久化的结构数据以用于基于结构的路线，并将这些数据缓存以供将来使用。
- 使用有界的扫描工作和共享的生成冷却时间。
- 在找不到已验证的有效路线时安全地跳过生成，而不是冻结服务器。
- 跟踪有多少原生的 ADQ/TNM 请求被重新路由。

这意味着失败的路线搜索会给出安全的跳过消息，而不是强制生成远处的区块并导致严重的 TPS 下降或集成服务器冻结。

ADQ 配置兼容性

ADQ 调整尊重 ADQ 的正常配置和任务数据。服务器所有者可以继续通过以下方式配置 ADQ：

`config/aeronautics_delivery_quests.toml`

该附加组件遵循：

- 最小和最大交付距离。
- 任务板上最大进行中任务数量。
- ADQ 任务地点模式。
- 自定义任务模板。
- 自定义奖励字符串和物品组件。
- 货物蓝图。
- 重量等级和已配置的货物重量。
- 当 ADQ 模板提供时，固定的取货/交货坐标。
- ADQ 正常的任务板、奖励、冷却时间、存档文件和接受流程。

任务地点模式

ADQ 地点模式	ADQ 调整行为
`VILLAGE`	仅使用 ADQ 注册的 Minecraft 村庄标签中的结构。
`ANY_STRUCTURE`	使用符合条件的地表结构，同时排除已知的地下、水下、下界和末地目的地。
`RANDOM`	使用已加载区块中安全的干燥陆地位置，而不生成地形。

结构端点缓存会根据 ADQ 地点模式进行分离。例如，从 `ANY_STRUCTURE` 切换到 `VILLAGE`，不能重用旧的通用结构端点。

地表安全目标和交付点

ADQ 调整改进了地形繁重整合包中的端点放置。

- 结构路线使用检测到的结构足迹内的点，而不是任意的区块中心坐标。
- 地下结构（如远古城市、废弃矿井、要塞、试炼密室、海底神殿、沉船、下界结构和末地城）会从正常的结构交付路线中排除（当修改为包含它们时）。
- 地表放置使用感知地形的高度数据，而不是假设一个固定的 Y 轴高度。
- 当目的地区块加载时，取货和交付标记会解析到地表。
- 支持高地形和模组化的山地世界。
- 默认拒绝液体和水下端点。
- 取货货物和交付端点会获得可见的垂直粒子信标。
- 交付半径、目标粒子半径和货物激活距离是可配置的。

任务板改进

大型自定义奖励列表可能导致上游任务板重叠并难以阅读。

ADQ 调整更改了任务板布局，使合同每页仅显示一个，从而保持大型奖励列表的可读性。

该附加组件还会在生成后重新同步任务板，确保新创建的合同能够可靠地显示。

 货物可靠性与奖励完整性

ADQ 调整围绕 Sable 货物子关卡增加了多项保护和恢复改进。

- 定位活跃货物时使用真正的 Sable 子关卡身份。
- 跨关卡搜索 Sable 容器，以减少传送或切换维度后出现虚假的“货物物理子关卡缺失”错误。
- 跟踪货物方块破坏、责任人玩家以及附近的玩家，以供未来的钩子或集成使用。
- 在组装后记录测量的 Sable 货物质量，以实现更准确的重量/奖励行为。
- 当一个目标分裂成四个或更多子关卡时，移除孤立货物。
- 当任务取消或完成时，清理货物后代。
- 支持 ADQ 的按比例计算缺失货物奖励的行为。
- 避免因损坏的货物方块而导致货物物品重复。
- 抑制重复的上游交付距离提醒聊天消息。

 可选的货物 PvP 模式

货物 PvP 默认禁用，可在以下位置启用：

`config/adq_tweaks-common.toml`

启用后：

- 服务器会在玩家接受合同时进行公告。
- 玩家会被告知，摧毁已接受合同的目标可以获得奖励份额。
- 符合条件的敌对玩家对货物造成伤害后，会获得从合同所有者奖励中扣除的相应价值。
- 奖励分配使用 ADQ 的缺失货物奖励逻辑，包括在支持的情况下使用自定义奖励字符串/组件。
- 友好玩家和合同所有者的 FTB 团队成员将被排除在外。
- 如果货物完整性降至 20% 或以下，合同将自动取消。
- 当 PvP 启用时，剩余奖励将分配给符合条件的货物破坏者。
- 当 PvP 禁用时，完整性在 20% 或以下的货物将被移除，合同将被取消。
- 玩家可以使用 `/adq_tweaks compass <player>` 来接收和刷新一个追踪所选玩家活跃目标的指南针。
- 指南针追踪会按可配置的间隔刷新。

 命令

- `/adq_tweaks generate`  
  请求一次正常的无卡顿任务生成。需要权限级别 2。

- `/adq_tweaks config`  
  显示当前的无卡顿生成安全限制。需要权限级别 2。

- `/adq_tweaks debug`  
  创建一个单独的本地测试合同，用于取货、运输、交付、信标和货物测试。这是唯一使用调试路线的命令；正常的任务生成永远不会使用它。需要权限级别 2。 

- `/adq_tweaks compass <player>`  
  当货物 PvP 启用时，为该玩家的活跃货物目标提供并刷新指南针。

## 配置

ADQ 调整的配置文件生成于：

`config/adq_tweaks-common.toml`

重要选项包括：

- 仅限已加载区块的生成安全设置。
- 候选扫描限制。
- 共享生成冷却时间。
- 请求者通知行为。
- 路线范围：请求玩家、所有玩家或世界出生点。
- 干燥陆地要求。
- 持久化结构扫描。
- 货物激活距离。
- 目标信标可见半径。
- 交付点到达半径。
- 货物 PvP 模式。
- 货物破坏通知。
- 指南针命令和刷新间隔。
- 货物保护行为。

安装

1. 将 ADQ 调整与《航空交付任务》一起安装。
2. 将其安装在服务器和使用 ADQ 的每个客户端上。
3. 保持 ADQ 已安装；ADQ 调整是附加组件，不是 ADQ 内容或界面的替代品。
4. 添加或更新模组后重启。
5. 在 `aeronautics_delivery_quests.toml` 中正常配置 ADQ。
6. 在 `adq_tweaks-common.toml` 中配置附加组件特定选项。

 要求

- Minecraft 1.21.1
- NeoForge
- 航空交付任务 1.1.0
- ADQ 正常的 Create Aeronautics 和 Sable 依赖项

 备注

ADQ 调整有意选择安全的跳过生成请求，而不是强制生成地形。在请求基于结构的任务之前，请先探索或预生成目标区域。

调试合同仅用于测试，与正常的生成合同是分开的。

Sable 将组装好的货物视为一个物理子关卡。被合并到货物中的方块，包括绳索、贴纸和连接器，在该子关卡被召回时仍可能被移除。ADQ 调整不会尝试不安全的方块实体退款，因为这可能导致库存重复或损坏玩家的装置。

ADQ 调整是一个独立的 MIT 许可附加组件。它不捆绑、修改或重新分发《航空交付任务》的 jar 文件。

感谢 Sandemon 创建了《航空交付任务》模组。