Aeronautics Delivery Quests

A delivery quest expansion for Create: Aeronautics and Sable.

Aeronautics Delivery Quests adds procedural hauling contracts to your Minecraft server. Players accept delivery jobs, travel to remote pickup locations, secure physical cargo, and use their custom-built airships to transport it to destination settlements for rewards.

The goal is simple: give airships a real purpose.

ADQ turns long-distance flight into a server activity with risk, planning, teamwork, and payoff.

Best of all, ADQ is server-side optional. Players do not need to install the mod on their client to join the server, open the quest board, use quest compasses, or complete deliveries.

✈️ Features

Procedural Delivery Contracts

Players can open the Aeronautics Delivery Board with:

/adq

Contracts are generated with different weight classes:

• Light
• Medium
• Heavy

Each contract includes a pickup location, delivery destination, travel route, time limit, and reward. Rewards can include emeralds, Create machinery, diamonds, and other configurable high-value items.

📦 Physical Cargo for Airship Hauling

Accepted quests spawn a physical 3x3x3 cargo cage  at the pickup site.

The cargo cage is designed with a hollow vertical center, making it easier to integrate into airship builds using balloon shafts, anchors, bearings, or other Create: Aeronautics systems.

When secured, the cargo is compiled into a Sable dynamic rigid body, allowing players to physically move it with their aircraft instead of simply carrying an item in an inventory.

🧭 Quest Compass Navigation

Each active delivery issues a custom Quest Compass.

The compass dynamically points players toward:

• The cargo pickup location
• The delivery destination

If a player loses their compass, they can use:

/adq compass

Only one active quest compass is allowed per player to prevent spam.

🔒 Cargo Protection

Active cargo is protected from griefing and accidental destruction.

ADQ blocks breaking only in very specific quest-related areas:

• The Overworld pickup site
• The matching Sable dynamic subworld for that active cargo

This means delivery cargo is protected, but normal player airships, bases, contraptions, and structures remain untouched.

⏳ Cooldowns and Time Limits

Contracts are time-sensitive.

By default:

• Delivery quests expire after 1 real-time hour
• Cargo is recalled when a quest expires
• Players have a 1-hour cooldown before accepting another contract

This helps prevent quest spam and keeps the server economy under control.

🖥️ Server-Side Optional

ADQ does not require players to install the mod on their client.

The quest board, tooltips, compass behavior, and quest information are handled using server-side systems, vanilla components, styled lore, and standard packets.

Players can join and participate without downloading anything extra.

⚙️ Performance Friendly

ADQ is designed for multiplayer servers.

Village searches, route calculations, and other expensive lookup work are handled asynchronously to avoid tick lag. Final block placement is scheduled safely on the main server thread.

This helps prevent large TPS spikes during quest generation.

🗺️ World Border and Spawn Safety

ADQ includes safeguards to prevent broken or unfair cargo spawns.

Cargo placement uses surface height checks to avoid underground spawns, and pickup or destination locations are checked against the world border.

A 150-block world border safety buffer is enforced. If a potential location is too close to the border or outside of it, that location is rejected.

💾 Persistence

ADQ survives server restarts.

Active quests, accepted states, cargo positions, and player cooldowns are saved inside the world save folder using JSON files:

• adq_quests.json
• adq_cooldowns.json

Expired or stale quest compasses are also cleaned up when players log in.

🛠️ Commands

Player Commands

/adq
Open the Aeronautics Delivery Quest Board.

/adq cancel
Abandon your current contract, recall the cargo, and clear quest compasses.

/adq compass
Re-issue your Quest Delivery Compass if you have an active quest and do not already have one.

Admin Commands

/adq admin generate
Force a new procedural quest generation cycle.

/adq admin delete <quest_id>
Delete a specific quest from the board.

/adq admin deleteall
Remove all quests from the board.

FAQ

Does this require a client-side install?

No. ADQ is server-side optional. Players can join, accept quests, use the quest board, follow compasses, and claim rewards without installing the mod locally.

Will this lag the server?

ADQ is designed to avoid heavy main-thread work. Expensive location searches and route calculations are handled asynchronously, while world changes are safely scheduled back onto the server thread.

Can players still modify their own airships?

Yes. ADQ only protects active quest cargo and its matching quest area. It does not globally protect airships or interfere with normal building and breaking.

What happens if cargo would spawn underground or outside the world border?

The quest generation system checks surface heightmaps and world border limits before spawning cargo. Invalid locations are rejected before the quest is placed.

Does it survive restarts?

Yes. Quest data and cooldowns are saved to the world folder and restored after server restart.