Envelope - Changelog

Envelope - 0.6.0

by mortuusars on Apr 16, 2026

by mortuusars on Apr 16, 2026

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.

by mortuusars on Feb 6, 2026

by mortuusars on Feb 6, 2026

Paper Box is now used to create a package; Packing Box has been removed
Recipe of Paper Box has been changed to 4 paper + 1 honeycomb -> 3 boxes
Package can no longer be repacked several times. If any item inside the opened Package changes - it will break and drop remaining items
When the Package is broken - it has a chance to drop a Paper Box
Payback Packages also follow this new system
Behavior of Package block breaking is now inverted:
- Just breaking will drop the intact Package
- Sneaking will destroy the Package and drop its contents
Smaller improvements and fixes

doMobSpawning game rule no longer prevents delivering pigeons from spawning. Configurable.
Fixed crash in Letter view screen
Fixed error with C2ME