Aeronautics Delivery Quests

# 🗺️ Aeronautics Delivery Quests (ADQ) **A high-stakes trade expansion for Create: Aeronautics & Sable** **Aeronautics Delivery Quests (ADQ)** is a lightweight, high-performance NeoForge 1.21.1 mod that adds procedural hauling contracts to your Aeronautics worlds. Players can accept quests, travel to remote locations to secure physical cargo, and pilot their custom-built airships to transport these heavy rigid bodies to destination settlements for massive rewards. **ADQ must be installed on both the client and server** (or just the client for singleplayer) to handle custom UI rendering, block assets, and packet synchronization. --- ## 🚀 Key Features * **📦 Dynamic & Custom Quests:** Accessible to players via the **Delivery Quests Table** block (and `/adq` for administrators), players browse available contracts with dynamically calculated routes and tailored rewards. Creators can design custom quest entries in `custom_quests.json` using custom NBT templates! * **⚖️ Sable Physics Integration:** Dynamically loads schematic templates (such as crates, pallets, and secure containers) and compiles them into **Sable dynamic physics rigid bodies** when secured. * **🧭 Virtual Calibration Compasses:** Issues vanilla Quest Compasses that point dynamically to cargo pickups or destination locations. Lost your compass? Retrieve a replacement instantly using the board's GUI control panel inside the table's menu. * **🔒 Damage Penalties & Shielding:** Configurable invulnerability (`enableCargoInvulnerability`). When off (default), cargo blocks can break, and any missing mass proportionally reduces your reward payout! When on, cargo is fully shielded from breakages, explosions, and mob griefing. * **⏳ Board Expirations & Player Cooldowns:** Unaccepted contracts on the board cycle out after 60 minutes. A 1-hour player cooldown prevents quest-spamming (automatically bypassed for admins/operators). --- ## 🔍 For the Skeptics (FAQ) ### 💻 Does this require client-side installs? **Yes.** Because the mod introduces the physical **Delivery Quests Table** block, custom clipboard menus, client-side screen UI rendering, and network synchronization packets, it must be installed on both the server and the client (or just the client for singleplayer). ### 📉 Will this cause tick lag or TPS spikes during generation? **No.** To prevent the classic "structure-lookup tick spikes," all village searches and pathfinding calculations are run on **fully asynchronous background threads** (`ForkJoinPool`). Only the final block placement is scheduled on the main thread, keeping your world running at a solid 20 TPS. ### 🛡️ Will this block players from modifying their own airships? **No.** The block protection is highly targeted. It strictly intercepts block-breaking inside matching Sable SubLevel UUIDs or Overworld pickup coordinates corresponding to an *active delivery quest*, and only triggers if `enableCargoInvulnerability` is enabled in the config. Normal airships, blocks, and structures remain 100% destructible. ### 🌀 What happens if cargo spawns outside the world border, underground, or inside buildings? * **Safe Air-Column Spawning**: The mod scans a horizontal $33\times33$ area around the start coordinates to find a solid, flat footprint. It checks that the entire spawn space (and the air blocks below it) is 100% empty air, spawning the cargo 3 blocks in the air so it falls cleanly under gravity without clipping or breaking blocks. * **Vertical Safety Fallback**: If no flat terrain is found nearby, the mod safely spawns the cargo 4 blocks above the highest solid block in the original target coordinates, guaranteeing it never clips inside ground structures or houses. * **Border Buffer**: The engine enforces a strict **150-block safety buffer** from your world border. If a potential spawn is too close to or outside the border, it is aborted instantly. ### 💾 Does it survive server restarts? **Yes.** All active quests, accepted states, cargo positions, and player cooldowns are persisted in GSON JSON registries (`adq_quests.json` and `adq_cooldowns.json`) inside the server's world save folder. Stale compasses are also automatically purged on player login to handle offline quest expirations. --- ## 🛠️ Command Reference > [!NOTE] > All `/adq` commands require operator permissions (Level 2+). Regular players must use the physical **Delivery Quests Table** block to open the board, cancel contracts, or reissue compasses. * `/adq` - `[Admin]` Open the virtual Aeronautics Quest Board & command control panel. * `/adq cancel` - `[Admin]` Abandon your current contract (recalls physical cargo and clears compasses). * `/adq compass` - `[Admin]` Re-issue your Quest Delivery Compass (only if on an active quest and you don't already have one). * `/adq generate` - `[Admin]` Force-triggers a background procedural quest generation. * `/adq complete` - `[Admin]` Force-completes your active delivery contract. * `/adq delete ` - `[Admin]` Cleanly force-deletes a specific board quest. * `/adq deleteall` - `[Admin]` Purge all quests from the board. * `/adq reload` - `[Admin]` Reload quests, player cooldowns, and custom quest templates from disk.