Aeronautics Delivery Quests

🗺️ Aeronautics Delivery Quests (ADQ)

为 Create: Aeronautics & Sable 带来高风险贸易扩展

Aeronautics Delivery Quests (ADQ)是一款轻量、高性能的 NeoForge 1.21.1 模组，为你的 Aeronautics 世界添加程序生成的货运合约。玩家可以接受任务，前往偏远地点领取实体货物，再驾驶自定义建造的飞艇，将这些沉重的刚体运送至目的地聚落，赢取丰厚奖励。

ADQ 必须同时安装在客户端和服务器端（单人游戏仅需安装在客户端），以支持自定义界面渲染、方块资源和数据包同步。

🚀 主要特色

• 📦 动态自定义任务：玩家可通过交付任务桌方块访问任务（管理员也可使用/adq），浏览可用合约及动态计算的路线和定制奖励。创建者还可以在custom_quests.json中使用自定义 NBT 模板设计任务条目！
• ⚖️ Sable 物理集成：动态加载结构模板（例如箱子、托盘和安全集装箱），并在固定后将其编译为Sable 动态物理刚体。
• 🧭 虚拟校准罗盘：发放原版任务罗盘，动态指向货物领取点或目的地。罗盘丢了？可在任务桌菜单中通过 GUI 控制面板立即领取替代品。
• 🔒 损坏惩罚与防护：可配置无敌模式（enableCargoInvulnerability）。关闭时（默认设置），货物方块可能被破坏，缺失的货物质量会按比例减少奖励！开启后，货物将受到全面保护，不会被破坏、爆炸或生物破坏方块。
• ⏳ 任务板过期与玩家冷却：任务板上未接受的合约会在 60 分钟后轮换。玩家每次接任务后有 1 小时冷却时间，防止刷任务（管理员/操作员会自动跳过冷却）。

🔍 怀疑者指南（常见问题）

💻 是否需要在客户端安装？

是。由于本模组添加了实体交付任务桌方块、自定义剪贴板菜单、客户端屏幕 UI 渲染和网络同步数据包，因此必须同时安装在服务器端和客户端（单人游戏仅需安装在客户端）。

📉 生成过程中会导致刻顿或 TPS 飙升吗？

不会。为防止经典的“结构查找导致刻顿”，所有村庄搜索和寻路计算都在完全异步的后台线程中运行（ForkJoinPool）。只有最终放置方块的操作会安排在主线程执行，确保世界稳定运行在 20 TPS。

🛡️ 这会阻止玩家改造自己的飞艇吗？

不会。方块保护的目标范围非常明确：只会拦截匹配的 Sable 子层 UUID 内，或与活跃交付任务对应的主世界领取坐标处发生的破坏方块操作，并且仅在配置中启用enableCargoInvulnerability时生效。普通飞艇、方块和建筑仍可被完全破坏。

🌀 如果货物生成在世界边界之外、地下或建筑内部，会发生什么？

• 安全的空中柱状生成：模组会扫描起始坐标周围水平范围为 $33\times33$ 的区域，寻找坚实、平坦的落点。它会检查整个生成空间（以及其下方的空气方块）是否完全为空气，并将货物生成在空中 3 格处，使其能在重力作用下顺利落下，不会与方块重叠或破坏方块。
• 垂直安全回退：如果附近找不到平坦地形，模组会在原目标坐标处最高的实心方块上方 4 格安全生成货物，确保货物不会嵌入地面结构或房屋中。
• 边界缓冲：引擎会严格保持与世界边界至少150 格的安全距离。如果预定生成位置过于接近或位于边界之外，生成会立即取消。

💾 服务器重启后还能保留吗？

可以。所有进行中的任务、已接取状态、货物位置和玩家冷却时间都会保存到服务器世界存档文件夹中的 GSON JSON 注册表（adq_quests.json 和 adq_cooldowns.json）里。玩家登录时还会自动清理过期的指南针，以处理玩家离线期间任务过期的情况。

🛠️ 命令参考

[!NOTE]

所有/adq命令都需要管理员权限（等级 2 及以上）。普通玩家必须使用实体交付任务桌方块来打开任务面板、取消合同或重新发放指南针。

• /adq – [Admin]打开虚拟航空任务面板和命令控制面板。
• /adq cancel – [Admin]放弃当前合同（召回实体货物并清除指南针）。
• /adq compass – [Admin]重新发放任务交付指南针（仅限正在进行任务且尚未持有指南针时）。
• /adq generate – [Admin]强制触发一次后台程序化任务生成。
• /adq complete – [Admin]强制完成当前的交付合同。
• /adq delete <index> – [Admin]彻底强制删除指定的任务面板任务。
• /adq deleteall – [Admin]清空任务面板上的所有任务。
• /adq reload – [Admin]从磁盘重新加载任务、玩家冷却时间和自定义任务模板。