AdventurePack: Mailbox & Postal Logistics

📬 AdventurePack: Mailbox & Postal Logistics

**Discord: AP - AdventurePack

AdventurePack: Mailbox** introduces a complete, immersive, physical postal delivery network to Minecraft! Send handwritten letters, package rare items into parcels, slap on postal stamps, and dispatch animated Courier Birds that physically fly across the world to deliver mail directly to recipient mailboxes.

---

✨ Core Features

📮 1. Themed Mailbox Blocks

Decorate your house, village, or kingdom with functional postal boxes:

• 🪵 11 Timber & Metal Variants: Crafted from Oak, Spruce, Birch, Jungle, Acacia, Dark Oak, Mangrove, Cherry, Crimson, Warped, Iron, and Gilded Mailboxes.
• 🚩 Animated Notification Flags: Mailbox flags automatically raise when new unread letters or packages arrive!
• 🔔 Audio Arrival Chimes: Rings a gentle chime whenever a courier bird drops off a delivery.
• 🔒 Secure Ownership: Mailboxes register to their owner and broadcast their coordinates to your Address Book.

---

✉️ 2. Letters & Sealed Correspondence

Communicate with friends and faction allies without relying on instant global chat:

• 📜 Rich Stationery GUI: Write multi-line messages, letters of trade, or royal proclamations.
• 🕯️ Wax Seals & Stamps: Seal letters with wax and postal stamps before dispatching.
• 📖 Reading & Preservation: Recipients can open, read, and save letters as permanent in-game books.

---

📦 3. Parcel Boxes (Physical Item Trading)

Need to send diamonds, potions, or enchanted gear across thousands of blocks?

• 🎁 4-Slot Parcel Container: Place any items, weapons, or armor inside a Parcel Box.
• 🏷️ Stamped Parcel Shipping: Seal the parcel with an address and postage to send physical items safely through the postal network.

---

🕊️ 4. Physical 3D Courier Birds

No instant magic teleportation—watch deliveries happen in real time:

• 🦅 In-World Delivery Flights: When mail is sent, a 3D animated Courier Bird entity spawns and takes flight toward the target coordinates. (Start and landing animation, no consistent entity)
• 📏 Euclidean Distance Simulation: Delivery times realistically scale with spatial distance (25 blocks/second travel speed).
• 📯 Courier Whistle: Blow the Courier Whistle while exploring in the wild to summon your carrier bird directly to your location!

---

🏷️ 5. Tiered Postal Stamps

Upgrade your postal tier to speed up transit times:

• ✉️ Standard Postal Stamp: Reliable baseline postal delivery across the dimension (1.0× transit time).
• ⚡ Express Postal Stamp: Swift priority shipping cutting delivery transit time in half (0.5× transit time).
• 🔮 Ender Warp Stamp: Inter-dimensional void routing providing instant zero-tick delivery across Nether, Overworld, or End!

---

📒 6. Address Books & Postal Directory

Never lose track of your friends' base coordinates:

• 📍 One-Click Stamping: Shift-right-click any mailbox with an Address Book to record its exact name, dimension, and XYZ coordinates.
• 🧭 Instant Destination Selection: Select any saved address from your address book UI when mailing letters or parcels.

---

⚙️ Configuration & Server Settings

• 🧩 100% Standalone: Zero external dependencies beyond Fabric API.
• ⚙️ Fully Configurable: Tune flight speeds, transit times, dimension penalties, and concurrent delivery limits in config/adventurepack_mailbox.json.
• 🛡️ Fail-Safe Returns: If a destination mailbox is destroyed while mail is in transit, the delivery safely returns to the sender after a timeout.