Envelope

0.6 - 2026-04-16

Mail Recipes

Added a new way to craft items by sending a Package with ingredients to the service address.

• Works similarly to the shapeless crafting.
• Results are returned using the same courier, or with a service courier, if some of the ingredients were unprocessed.
• Data-driven.
• Can give experience. Applied to the resulting package.
• Shown in JEI
  • Clicking on an arrow in the Mailbox menu, or on a box in the Paper Box menu will show available recipes.

Included recipes:

• Payback Tag
  • no longer craftable in the Crafting Table
• Seal Stamps with custom impressions
• Rotten Flesh -> Leather
• Saddle
• Name Tag
• Tuff, Dripstone, Calcite
• Glow Ink Sac
• Book and Quill and Letter and Quill
• Lost Mail
  • Has random loot inside
• Letter Broadcasting
  • Sends copies of the letter to all existing player-default mailboxes.

Package

• Added envelope:package_experience item component. Awarded when package is opened.
• Using the package while holding [Sneak] will unpack it without opening the menu.
• Fixed overlays not rendering over package slots.
• Fixed being able to insert items into opened package, if items were the same.

Payback Tag

• Added drag and drop from JEI support.
• Added request duration selector.
  • Controls how much time buyer will have to pay for the mail.
  • Item texture changes slightly based on duration defined.
• Using the tag while holding [Sneak] will clear the data from it.
• Menu UI/UX improvements.
• Changed envelope:payback_tag_contents item component: its structure is now the same as envelope:mail_payback_request.
• delivery.payback_timeout_minutes config option was replaced by three payback.request_duration_<duration> options.

Address

• Player address type definition has been changed. Field id is now name: { type:"player", name:"mortuusars" }
• Service addresses are now data-driven
  • Address component now references registered definition by its key: { type:"service", definition:"envelope:mail_service" }
• Added "custom" address type: { type:"custom", name:{translate:"display.name"} }
  • Can be used for display purposes (commands, scripts, etc.). Cannot receive mail.
• Unknown address is now a separate type: { type:"unknown" }

Service Addresses

• Definition is data-driven.
• For use in recipes or custom handlers.
• #envelope:hidden service address tag can be used to hide the address from suggestions and its recipes from JEI.
• Addresses that have recipes will show up in JEI as an ingredient.
  • Querying their uses (R-Click or [U]) will show available recipes associated with that address.
• Added Equine Assurance Bureau sending "spam" letters.

Delivery

• Added support for Service address "drop-off" handlers.
  • They can be defined in code (for addons) or through KubeJS.
  • Drop-off handler is responsible for actually deciding what happens with delivered mail (consume/return/reply).

KubeJS

• Added EnvelopeEvents.registerServiceDropOffHandlers event.
• Added EnvelopeEvents.handleMailDropOff event.
  • Called before most of the regular logic is processed.
  • Can be used to modify drop-off of any address type.
• No documentation yet.

Misc:

• Slightly improved Pigeon pathfinding around blocks, should get stuck a bit less now .
• Added Address Tag and Payback Tag application recipes.
• Applying Address Tag and Payback Tag in GUI now consumes 1 tag per mail, instead of 1 per stack.
• Payback Box and Payback Package now show full time remaining when [Shift] is held.
• Updated some address type icons (little flags)
• Moved seal textures from textures/gui/seal to textures/seal folder.
• Moved letters and numbers seal impressions into their respective subfolders. Example: envelope:c -> envelope:letter/c
• Fixed total delivery distance calculation in debug-mode overlay.
• Rewrote some parts of Delivery Log, mostly internal work, but there are some minor user-facing changes as well.
• Small updates of Address Tag, Payback Box and Payback Package menu textures.
• Small change to how envelope:payback_subject component is defined.
• Renamed mail_service_payback_department.dat to envelope_mail_service_payback_department.dat in level/data.
• Fixed couriers spawned after delivery is finished (when ended in unloaded chunk) not being tired.
• Fixed leashed pigeons being able to enter a Pigeonhole.
• Fixed error in Pigeon saved NBT data.