Перейти к содержимому
Mineforgian

Aeronautics Delivery Quests

A trade expansion for Create: Aeronautics & Sable. Periodically auto-generates hauling contracts, NBT-based cargo spawning, and virtual Quest Compasses. Safe air-column spawning and 100% custom quests in custom_quests.json!

1K загрузок10 подписчиковLicenseRef-All-Rights-Reservedneoforge

Обновлён 10 июня 2026 г. · опубликован 29 мая 2026 г.

Скачать 1.0.3(101 КБ)

🗺️ 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 <index> - [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.

Центр версий

4 версий
Стабильная1.0.31.21.1 · 101 КБ
  • Релиз101 КБ
  • Релиз101 КБ
  • Релиз101 КБ
  • Релиз64 КБ

Ченджлог

1.0.3Релиз1.21.1 · 10 июня 2026 г.

Aeronautics Delivery Quests (ADQ) - v1.0.3 Changelog

GUI Polish & Interface Polish

  • Ledger Cooldown Rename: Changed the clipboard label "Cooldown" to "Next Quest In" to make cooldown status clearer.
  • Route & Mass Line Splitting: Formatted the quest card text so that Mass and Route are on separate lines per quest card, removing the vertical pipe (|) character.
  • Flight Manual Simplification: Simplified the Flight Manual screen to show a unified description help section instead of the multi-step gameplay rules.

Predefined Coordinate Support (custom_quests.json)

  • pickupPos and dropoffPos Parameter: Added optional pickupPos and dropoffPos string parameters (blank by default on all default quests).
  • Coordinate Formats: Supports x,y,z or x,z formats (queries the surface heightmap when Y is omitted or 0). If valid coordinates are specified, quest generation skips the async structure search and generates the quest at the exact location.

Aeronautics Recipe Integration & Bug Fixes

  • Table Crafting Recipe: Updated the crafting recipe for the delivery quests table to require a Contraption Diagram (simulated:contraption_diagram) at the top, a Compass (minecraft:compass) in the middle, and any wood slab (#minecraft:wooden_slabs tag) at the bottom.
  • Occlusion Fix: Added .noOcclusion() properties to the delivery quests table block, fixing the see-through ground bug beneath it.

Aeronautics Delivery Quests (ADQ) - v1.0.2 Changelog

Quest & Location Generation Configuration Toggles

  • Generation Mode Toggle: Replaced the sliding scale customQuestsChance with an enum-based questGenerationMode config toggle (CUSTOM or PROCEDURAL).
    • CUSTOM: Spawns structured quests exactly as defined in custom_quests.json.
    • PROCEDURAL: Dynamically mixes names, descriptions, mass classes, schematics, and rewards from across the pool of valid templates in custom_quests.json.
  • Location Mode Selector: Replaced randomQuestGen with an enum-based questLocationMode config toggle (VILLAGE, ANY_STRUCTURE, or RANDOM).
    • ANY_STRUCTURE: Performs an Overworld-wide search using the registries to locate any valid registered structure (top level only) for cargo pickup and delivery.

Expanded Default Assets & Balanced Economy

  • 6 Default Cargo Schematics: Expanded the programmatically generated cargo NBT schematics list to 6, adding light_food_crate, medium_ore_crate, and heavy_industrial_boiler.
  • 6 Default Packaged Quests: Expanded example templates to 6 default quests in custom_quests.json.
  • Balanced Emerald Economy: Reduced default emerald payouts for all 6 example quests to a balanced range of 10–50 emeralds. Scaled default config payouts for procedural generation to 15 (Light), 30 (Medium), and 50 (Heavy).

Command Cooldowns & Concurrency Safety

  • 5-Second Command Cooldown: Enforces a 5-second cooldown on all player /adq command executions.
  • Quest Generation Lock: Implemented an execution lock (AtomicBoolean) to prevent starting quest generation twice concurrently, with dynamic play button greying out on the client UI.

Config Auto-Healing

  • Auto-Healing Configuration: If an outdated version of custom_quests.json is detected (with old legacy emerald payouts of 300 or 640), it is automatically upgraded and rewritten with the balanced 1.0.2 rewards on server startup.

Quest Board Clipboard UI Polish

  • Multi-Reward Display: Enhanced the Quest Board clipboard to display all reward items. Details are parsed into a clean comma-separated list and wrapped dynamically to fit within ledger slots and the active quest details view.
  • Ledger Spacing Refactor: Reduced quest items displayed per page from 3 to 2, scaling card heights to 68px (originally 48px) to cleanly prevent reward text from spilling over.
  • Dynamic State Updates: Accept buttons refresh active states dynamically when a player's quest cooldown ticks down to zero.

C2ME Concurrency & Thread Safety

  • Asynchronous Random Safety: Replaced thread-bound level.getRandom() with isolated RandomSource.create() inside the background quest generation thread. This completely resolves threading crashes and ConcurrentModificationException conflicts when running alongside the C2ME (Concurrent Chunk Management Engine) mod.

Aeronautics Delivery Quests (ADQ) - v1.0.1 Changelog

Core Mechanics & Standalone Architecture

  • Standalone Mod: Stripped all FTB Chunks, Teams, and Library requirements from compilation, config, and runtime scripts, making ADQ 100% independent.
  • Safe Air Spawning: Re-engineered physical spawning to check solid surface footprints and ensure 100% empty air columns. Cargo spawns 3 blocks in the air and drops cleanly under gravity.
  • Vertical Spawning Safety Fallback: Added a sky fallback (spawns cargo 4 blocks above solid ground) if flat ground is unavailable, preventing clipping into village structures/ground. Removed legacy floating grass block placements.

Custom Quest JSON Configurations

  • Admins JSON Pool (custom_quests.json): Added a dedicated GSON database at config/aeronautics_delivery_quests/custom_quests.json (auto-generates example templates on startup) allowing custom names, descriptions, mass classes, NBT templates, and rewards.
  • Mix Ratio Tuning: Added customQuestsChance (default 0.5) double config parameter under ADQConfig to set the percentage ratio of custom JSON quests versus procedural generation.
  • Instant Hot-Reloads: Integrated JSON reloader directly into the /adq reload command and chest-GUI reload button for real-time refreshes without a server restart.

Exploit Protection & Chest-GUI Command Panel

  • Anti-Loot Balance: Swapped minecraft:netherite_block in the Heavy schematic with minecraft:polished_deepslate and programmed the manager to overwrite legacy/OP config files on startup. Guaranteed all default schematics use exactly simulated:rope_connector.
  • Chest-GUI Redesign: Restructured the board to limit quest maps to slots 0–17 (respecting maxActiveQuestsPerBoard). Converted the bottom row (slots 18–25) into a command dashboard for Reissuing Compass, Cancelling Contract, and OP-level 2 Admin Commands (Generate, Delete All, Reload).
1.0.2Релиз1.21.1 · 8 июня 2026 г.

Aeronautics Delivery Quests (ADQ) - v1.0.2 Changelog

Quest & Location Generation Configuration Toggles

  • Generation Mode Toggle: Replaced the sliding scale customQuestsChance with an enum-based questGenerationMode config toggle (CUSTOM or PROCEDURAL).
    • CUSTOM: Spawns structured quests exactly as defined in custom_quests.json.
    • PROCEDURAL: Dynamically mixes names, descriptions, mass classes, schematics, and rewards from across the pool of valid templates in custom_quests.json.
  • Location Mode Selector: Replaced randomQuestGen with an enum-based questLocationMode config toggle (VILLAGE, ANY_STRUCTURE, or RANDOM).
    • ANY_STRUCTURE: Performs an Overworld-wide search using the registries to locate any valid registered structure (top level only) for cargo pickup and delivery.

Expanded Default Assets & Balanced Economy

  • 6 Default Cargo Schematics: Expanded the programmatically generated cargo NBT schematics list to 6, adding light_food_crate, medium_ore_crate, and heavy_industrial_boiler.
  • 6 Default Packaged Quests: Expanded example templates to 6 default quests in custom_quests.json.
  • Balanced Emerald Economy: Reduced default emerald payouts for all 6 example quests to a balanced range of 10–50 emeralds. Scaled default config payouts for procedural generation to 15 (Light), 30 (Medium), and 50 (Heavy).

Command Cooldowns & Concurrency Safety

  • 5-Second Command Cooldown: Enforces a 5-second cooldown on all player /adq command executions.
  • Quest Generation Lock: Implemented an execution lock (AtomicBoolean) to prevent starting quest generation twice concurrently, with dynamic play button greying out on the client UI.

Config Auto-Healing

  • Auto-Healing Configuration: If an outdated version of custom_quests.json is detected (with old legacy emerald payouts of 300 or 640), it is automatically upgraded and rewritten with the balanced 1.0.2 rewards on server startup.

Quest Board Clipboard UI Polish

  • Multi-Reward Display: Enhanced the Quest Board clipboard to display all reward items. Details are parsed into a clean comma-separated list and wrapped dynamically to fit within ledger slots and the active quest details view.
  • Ledger Spacing Refactor: Reduced quest items displayed per page from 3 to 2, scaling card heights to 68px (originally 48px) to cleanly prevent reward text from spilling over.
  • Dynamic State Updates: Accept buttons refresh active states dynamically when a player's quest cooldown ticks down to zero.

C2ME Concurrency & Thread Safety

  • Asynchronous Random Safety: Replaced thread-bound level.getRandom() with isolated RandomSource.create() inside the background quest generation thread. This completely resolves threading crashes and ConcurrentModificationException conflicts when running alongside the C2ME (Concurrent Chunk Management Engine) mod.

Aeronautics Delivery Quests (ADQ) - v1.0.1 Changelog

Core Mechanics & Standalone Architecture

  • Standalone Mod: Stripped all FTB Chunks, Teams, and Library requirements from compilation, config, and runtime scripts, making ADQ 100% independent.
  • Safe Air Spawning: Re-engineered physical spawning to check solid surface footprints and ensure 100% empty air columns. Cargo spawns 3 blocks in the air and drops cleanly under gravity.
  • Vertical Spawning Safety Fallback: Added a sky fallback (spawns cargo 4 blocks above solid ground) if flat ground is unavailable, preventing clipping into village structures/ground. Removed legacy floating grass block placements.

Custom Quest JSON Configurations

  • Admins JSON Pool (custom_quests.json): Added a dedicated GSON database at config/aeronautics_delivery_quests/custom_quests.json (auto-generates example templates on startup) allowing custom names, descriptions, mass classes, NBT templates, and rewards.
  • Mix Ratio Tuning: Added customQuestsChance (default 0.5) double config parameter under ADQConfig to set the percentage ratio of custom JSON quests versus procedural generation.
  • Instant Hot-Reloads: Integrated JSON reloader directly into the /adq reload command and chest-GUI reload button for real-time refreshes without a server restart.

Exploit Protection & Chest-GUI Command Panel

  • Anti-Loot Balance: Swapped minecraft:netherite_block in the Heavy schematic with minecraft:polished_deepslate and programmed the manager to overwrite legacy/OP config files on startup. Guaranteed all default schematics use exactly simulated:rope_connector.
  • Chest-GUI Redesign: Restructured the board to limit quest maps to slots 0–17 (respecting maxActiveQuestsPerBoard). Converted the bottom row (slots 18–25) into a command dashboard for Reissuing Compass, Cancelling Contract, and OP-level 2 Admin Commands (Generate, Delete All, Reload).
1.0.2Релиз1.21.1 · 5 июня 2026 г.

Aeronautics Delivery Quests (ADQ) - v1.0.2 Changelog

Quest & Location Generation Configuration Toggles

  • Generation Mode Toggle: Replaced the sliding scale customQuestsChance with an enum-based questGenerationMode config toggle (CUSTOM or PROCEDURAL).
    • CUSTOM: Spawns structured quests exactly as defined in custom_quests.json.
    • PROCEDURAL: Dynamically mixes names, descriptions, mass classes, schematics, and rewards from across the pool of valid templates in custom_quests.json.
  • Location Mode Selector: Replaced randomQuestGen with an enum-based questLocationMode config toggle (VILLAGE, ANY_STRUCTURE, or RANDOM).
    • ANY_STRUCTURE: Performs an Overworld-wide search using the registries to locate any valid registered structure (top level only) for cargo pickup and delivery.

Expanded Default Assets & Balanced Economy

  • 6 Default Cargo Schematics: Expanded the programmatically generated cargo NBT schematics list to 6, adding light_food_crate, medium_ore_crate, and heavy_industrial_boiler.
  • 6 Default Packaged Quests: Expanded example templates to 6 default quests in custom_quests.json.
  • Balanced Emerald Economy: Reduced default emerald payouts for all 6 example quests to a balanced range of 10–50 emeralds. Scaled default config payouts for procedural generation to 15 (Light), 30 (Medium), and 50 (Heavy).

Command Cooldowns & Concurrency Safety

  • 5-Second Command Cooldown: Enforces a 5-second cooldown on all player /adq command executions.
  • Quest Generation Lock: Implemented an execution lock (AtomicBoolean) to prevent starting quest generation twice concurrently, with dynamic play button greying out on the client UI.

Config Auto-Healing

  • Auto-Healing Configuration: If an outdated version of custom_quests.json is detected (with old legacy emerald payouts of 300 or 640), it is automatically upgraded and rewritten with the balanced 1.0.2 rewards on server startup.

Quest Board Clipboard UI Polish

  • Multi-Reward Display: Enhanced the Quest Board clipboard to display all reward items. Details are parsed into a clean comma-separated list and wrapped dynamically to fit within ledger slots and the active quest details view.
  • Ledger Spacing Refactor: Reduced quest items displayed per page from 3 to 2, scaling card heights to 68px (originally 48px) to cleanly prevent reward text from spilling over.
  • Dynamic State Updates: Accept buttons refresh active states dynamically when a player's quest cooldown ticks down to zero.

C2ME Concurrency & Thread Safety

  • Asynchronous Random Safety: Replaced thread-bound level.getRandom() with isolated RandomSource.create() inside the background quest generation thread. This completely resolves threading crashes and ConcurrentModificationException conflicts when running alongside the C2ME (Concurrent Chunk Management Engine) mod.

Aeronautics Delivery Quests (ADQ) - v1.0.1 Changelog

Core Mechanics & Standalone Architecture

  • Standalone Mod: Stripped all FTB Chunks, Teams, and Library requirements from compilation, config, and runtime scripts, making ADQ 100% independent.
  • Safe Air Spawning: Re-engineered physical spawning to check solid surface footprints and ensure 100% empty air columns. Cargo spawns 3 blocks in the air and drops cleanly under gravity.
  • Vertical Spawning Safety Fallback: Added a sky fallback (spawns cargo 4 blocks above solid ground) if flat ground is unavailable, preventing clipping into village structures/ground. Removed legacy floating grass block placements.

Custom Quest JSON Configurations

  • Admins JSON Pool (custom_quests.json): Added a dedicated GSON database at config/aeronautics_delivery_quests/custom_quests.json (auto-generates example templates on startup) allowing custom names, descriptions, mass classes, NBT templates, and rewards.
  • Mix Ratio Tuning: Added customQuestsChance (default 0.5) double config parameter under ADQConfig to set the percentage ratio of custom JSON quests versus procedural generation.
  • Instant Hot-Reloads: Integrated JSON reloader directly into the /adq reload command and chest-GUI reload button for real-time refreshes without a server restart.

Exploit Protection & Chest-GUI Command Panel

  • Anti-Loot Balance: Swapped minecraft:netherite_block in the Heavy schematic with minecraft:polished_deepslate and programmed the manager to overwrite legacy/OP config files on startup. Guaranteed all default schematics use exactly simulated:rope_connector.
  • Chest-GUI Redesign: Restructured the board to limit quest maps to slots 0–17 (respecting maxActiveQuestsPerBoard). Converted the bottom row (slots 18–25) into a command dashboard for Reissuing Compass, Cancelling Contract, and OP-level 2 Admin Commands (Generate, Delete All, Reload).
1.0.1Релиз1.21.1 · 29 мая 2026 г.

Aeronautics Delivery Quests (ADQ) - v1.0.1 Changelog

Core Mechanics & Standalone Architecture Standalone Mod: Stripped all FTB Chunks, Teams, and Library requirements from compilation, config, and runtime scripts, making ADQ 100% independent.

Safe Air Spawning: Re-engineered physical spawning to check solid surface footprints and ensure 100% empty air columns. Cargo spawns 3 blocks in the air and drops cleanly under gravity.

Vertical Spawning Safety Fallback: Added a sky fallback (spawns cargo 4 blocks above solid ground) if flat ground is unavailable, preventing clipping into village structures/ground. Removed legacy floating grass block placements.

Custom Quest JSON Configurations Admins JSON Pool (custom_quests.json): Added a dedicated GSON database at config/aeronautics_delivery_quests/custom_quests.json (auto-generates example templates on startup) allowing custom names, descriptions, mass classes, NBT templates, and rewards.

Mix Ratio Tuning: Added customQuestsChance (default 0.5) double config parameter under ADQConfig to set the percentage ratio of custom JSON quests versus procedural generation. Instant Hot-Reloads: Integrated JSON reloader directly into the /adq reload command and chest-GUI reload button for real-time refreshes without a server restart.

Exploit Protection & Chest-GUI Command Panel Anti-Loot Balance: Swapped minecraft:netherite_block in the Heavy schematic with minecraft:polished_deepslate and programmed the manager to overwrite legacy/OP config files on startup. Guaranteed all default schematics use exactly simulated:rope_connector.

Chest-GUI Redesign: Restructured the board to limit quest maps to slots 0–17 (respecting maxActiveQuestsPerBoard). Converted the bottom row (slots 18–25) into a command dashboard for Reissuing Compass, Cancelling Contract, and OP-level 2 Admin Commands (Generate, Delete All, Reload).

Комментарии

Загружаем…