ADQ Tweaks - Combat Mode

ADQ Tweaks

ADQ Tweaks is a NeoForge 1.21.1 addon for Aeronautics Delivery Quests (ADQ / TNM Quests).

It keeps ADQ’s quest board, cargo schematics, rewards, saved quests, cooldowns, compasses, and Sable-based cargo gameplay, while replacing unsafe quest generation and adding cargo, delivery, PvP, visibility, and board improvements.

 Lagless quest generation

ADQ Tweaks intercepts both public ADQ/TNM quest-generation entry points before ADQ’s native generator runs. This includes automatic quest generation and ADQ/TNM UI or command paths that call the upstream generator.

Native ADQ/TNM generation is cancelled and routed through ADQ Tweaks instead.

The lagless generator:

- Never uses ADQ’s native `findNearestMapStructure` search.
- Never uses blocking `getChunkAt` calls to create a route.
- Never generates terrain merely to find a quest location.
- Reads persisted structure data from existing chunks for structure-based routes, caching them for future use.
- Uses bounded scan work and a shared generation cooldown.
- Safely skips generation when it cannot find a proven valid route, instead of freezing the server.
- Tracks how many native ADQ/TNM requests were rerouted

This means a failed route search gives a safe skip message instead of forcing distant chunk generation and causing major TPS loss or an integrated-server freeze.

ADQ configuration compatibility

ADQ Tweaks respects ADQ’s normal configuration and quest data. Server owners can continue configuring ADQ through:

`config/aeronautics_delivery_quests.toml`

The addon honors:

- Minimum and maximum delivery distance.
- Maximum active quests on the board.
- ADQ quest location mode.
- Custom quest templates.
- Custom reward strings and item components.
- Cargo schematics.
- Weight classes and configured cargo weights.
- Fixed pickup/dropoff coordinates when supplied by an ADQ template.
- ADQ’s normal quest board, rewards, cooldowns, save files, and acceptance flow.

Quest location modes

| ADQ location mode | ADQ Tweaks behavior |
| --- | --- |
| `VILLAGE` | Only uses structures in ADQ’s registered Minecraft village tag. |
| `ANY_STRUCTURE` | Uses eligible surface structures while excluding known underground, underwater, Nether, and End destinations. |
| `RANDOM` | Uses safe dry-land positions in already loaded chunks without generating terrain. |

Structure endpoint caches are separated by ADQ location mode. Changing from `ANY_STRUCTURE` to `VILLAGE`, for example, cannot reuse old generic structure endpoints.

Surface-safe objectives and delivery points

ADQ Tweaks improves endpoint placement for terrain-heavy modpacks.

- Structure routes use points inside the detected structure footprint rather than arbitrary chunk-center coordinates.
- Underground structures such as ancient cities, mineshafts, strongholds, trial chambers, ocean monuments, shipwrecks, Nether structures, and End cities are excluded from normal structure delivery routes (when altered to include them)
- Surface placement uses terrain-aware height data rather than assuming a fixed Y level.
- Pickup and turn-in markers are resolved to the surface when their destination chunk is loaded.
- Tall terrain and modded mountain worlds are supported.
- Fluid and underwater endpoints are rejected by default.
- Pickup cargo and delivery endpoints receive visible vertical particle beacons.
- Turn-in radius, objective-particle radius, and cargo activation distance are configurable.

Quest board improvements

Large custom reward lists can make the upstream quest board overlap and become unreadable.

ADQ Tweaks changes the board layout so contracts are shown one per page, keeping large reward lists readable.

The addon also resynchronizes the quest board after generation so newly created contracts reliably appear.

 Cargo reliability and reward integrity

ADQ Tweaks adds several protections and recovery improvements around Sable cargo sublevels.

- Uses real Sable sublevel identity when locating active cargo.
- Searches Sable containers across levels to reduce false “cargo physics sublevel missing” failures after teleporting or changing dimensions.
- Tracks cargo block breaks, the player responsible, and nearby players for future hooks or integrations.
- Records measured Sable cargo mass after assembly for more accurate weight/reward behavior.
- Removes orphaned cargo when an objective splits into four or more sublevels.
- Cleans up cargo descendants when a quest is cancelled or completed.
- Supports ADQ’s proportional missing-cargo reward behavior.
- Avoids cargo-item duplication from broken cargo blocks.
- Suppresses repetitive upstream delivery-distance reminder chat messages.

 Optional cargo PvP mode

Cargo PvP is disabled by default and can be enabled in:

`config/adq_tweaks-common.toml`

When enabled:

- The server announces when a player accepts a contract.
- Players are told that destroying the accepted contract’s objective can earn reward shares.
- Eligible hostile players who damage cargo receive the proportional value removed from the contract owner’s reward.
- The reward split uses ADQ’s missing-cargo reward logic, including custom reward strings/components where supported.
- Friendly players and members of the contract owner’s FTB team are excluded.
- If cargo falls to 20% integrity or less, the contract is automatically cancelled.
- When PvP is enabled, the remaining reward is distributed to eligible cargo destroyers.
- When PvP is disabled, cargo at 20% integrity or less is removed and the contract is cancelled.
- Players can use `/adq_tweaks compass <player>` to receive and refresh a compass that tracks the chosen player’s active objective.
- Compass tracking refreshes at a configurable interval.

 Commands

- `/adq_tweaks generate`  
  Requests a normal lagless quest-generation pass. Requires permission level 2.

- `/adq_tweaks config`  
  Shows active lagless-generation safety limits. Requires permission level 2.

- `/adq_tweaks debug`  
  Creates a separate local test contract for pickup, transport, turn-in, beacon, and cargo testing. This is the only command that uses the debug route; normal quest generation never uses it. Requires permission level 2. 

- `/adq_tweaks compass <player>`  
  When cargo PvP is enabled, gives and refreshes a compass to that player’s active cargo objective.

## Configuration

ADQ Tweaks configuration is generated at:

`config/adq_tweaks-common.toml`

Important options include:

- Loaded-chunk-only generation safety.
- Candidate scan limit.
- Shared generation cooldown.
- Requester notification behavior.
- Route scope: requesting player, all players, or world spawn.
- Dry-land requirement.
- Persisted structure scanning.
- Cargo activation distance.
- Objective beacon visibility radius.
- Delivery turn-in radius.
- Cargo PvP mode.
- Cargo destruction notifications.
- Compass command and refresh interval.
- Cargo protection behavior.

Installation

1. Install ADQ Tweaks alongside Aeronautics Delivery Quests.
2. Install it on both the server and every client using ADQ.
3. Keep ADQ installed; ADQ Tweaks is an addon, not a replacement for ADQ’s content or UI.
4. Restart after adding or updating the mod.
5. Configure ADQ normally in `aeronautics_delivery_quests.toml`.
6. Configure addon-specific options in `adq_tweaks-common.toml`.

 Requirements

- Minecraft 1.21.1
- NeoForge
- Aeronautics Delivery Quests 1.1.0
- ADQ’s normal Create Aeronautics and Sable dependencies

 Notes

ADQ Tweaks intentionally prefers a safe skipped generation request over forced terrain generation. Explore or pre-generate the intended region before requesting structure-based quests.

Debug contracts are only for testing and are separate from normal generated contracts.

Sable treats assembled cargo as a physics sublevel. Blocks merged into cargo, including ropes, stickers, and connectors, can still be removed when that sublevel is recalled. ADQ Tweaks does not attempt unsafe block-entity refunds because that could duplicate inventories or damage player contraptions.

ADQ Tweaks is an independent MIT-licensed addon. It does not bundle, modify, or redistribute the Aeronautics Delivery Quests jar.

Thank you to Sandemon for creating the Aeornautics Delivery Quests mod.