Packages Mod Wiki

Packages is an opinionated storage mod designed to provide a balanced, early-to-mid-game alternative to Shulker Boxes. Unlike traditional "barrel" or "drawer" mods, Packages focuses on portability and customization. Each Package can hold up to 8 stacks (512 items) of a single item type.

The mod's standout features include the ability to build Packages out of almost any solid block in the game, the ability to nest Packages inside one another for massive storage density, and a "sticky" mechanic that allows empty containers to remember their assigned item.

Package Crafter

The Package Crafter is the central workstation of the mod. It is used to assemble customized Packages using raw materials. The block features a unique 3D model and a dedicated GUI for assembly.

• Function: Combines a frame block, a core block, a dye, and a copper ingot into a finished Package.
• Automation: The Package Crafter can be triggered by a redstone pulse to automate the assembly process.

Package (Block)

When placed in the world, a Package acts as a single-slot storage container.

• Capacity: 8 stacks (512 items for standard 64-stack items).
• Visuals: The front face of the Package displays a large icon of the item stored inside, making it superior to Item Frames for organization.
• Redstone: Packages are compatible with Comparators, outputting a signal based on how full they are. They can also be broken by Pistons and placed by Dispensers, just like Shulker Boxes.

Package (Item)

In item form, Packages retain their inventory. They can be stacked if they contain the same item and have the same customization style.

Sticky Syrup

Sticky Syrup is a utility item introduced in later versions (Season 2) to replace the old proximity-based stickiness mechanic.

• Usage: Right-click a placed Package with Sticky Syrup to make it "Sticky."
• Effect: A sticky package will remember its assigned item even when it is completely empty (0 items). This prevents other items from being accidentally inserted into the slot.
• Removal: To remove stickiness, left-click the package when it is empty, or simply break the block.

Creating a Package

To create a Package, you must use the Package Crafter. The GUI contains four specific slots that determine the Package's appearance and construction:

Once the items are placed, click the button in the GUI or apply a redstone signal to the block to produce the Package.

The mod features "Smart Insertion," which scans your entire inventory for matching items, removing the need to have the item in your active hand.

World Interactions (Placed Block)

Note: If you Ctrl+Right-Click an empty package with an empty hand, it will automatically pull the item you have the most of from your inventory.

Inventory Interactions (Item Form)

Packages behave similarly to Bundles while in the inventory:

• Add Items: Pick up a Package with the mouse and right-click on other items in your inventory to pull them into the Package.
• Remove Items: Right-click the Package while it is being held by the mouse over an empty inventory slot to drop items out.

Recursion & Storage Density

Packages can be nested inside other Packages. Because each Package can hold 8 stacks, and those stacks can themselves be Packages, the storage density grows exponentially.

• Recursion Limit: The mod enforces a recursion limit to prevent NBT overflow and "Zip Bomb" crashes.
• Maximum Capacity: At the maximum recursion limit, a single Package can effectively store approximately 262,144 items (roughly a quarter million).

Stickiness (Legacy vs. Modern)

• Modern (Season 2+): Stickiness is applied via Sticky Syrup. It is a property of the block; if you break the package, you must reapply the syrup after replacing it.
• Legacy: Prior to the Season 2 update, Packages became sticky automatically if placed adjacent to a Slime Block or Honey Block. This mechanic can still be re-enabled in the configuration file.

Data Components (1.21.1+)

In version 1.21.1, the mod utilizes the following data components:

• packages:style: Stores the frame, core, and dye color data.
• packages:cont: Stores the inventory contents.

Item & Block Tags

Modpack authors can customize the mod using the following tags:

• packages:banned_from_package_maker: Prevents specific blocks from being used as frames or cores.
• packages:things_you_need_for_package_crafting: Defines valid items for the lower-right slot of the Crafter (default: Copper Ingot).
• packages:banned_from_package: Prevents specific items from being stored inside Packages (default includes non-empty Shulker Boxes and Bundles).
• packages:sticky: Controls which blocks trigger the legacy stickiness mechanic.

Configuration

• Package Maker Allowlist: Can be enabled to restrict the Package Crafter to only use items defined in packages:allowlist_package_maker_frame and packages:allowlist_package_maker_inner.
• Locking: A Package can be "locked" by setting the NBT tag {bcLocked:1b} on the block entity, preventing all player interaction.