Grims Chests — Player Wiki

Version 0.4.10 · Paper 26.3 · Java and Bedrock

Grims Chests lets you keep several double-chest inventories inside one placed chest. Each upgraded storage chest also has a separate 27-slot physical inventory for hoppers.

A Grims Chest holds up to six shulker boxes. One shulker box carries a whole inventory inside a single stack, so a chest full of them holds thousands of items at once and becomes slow and risky to save. Six is the default limit for a whole placed chest: keep them all in one sub-chest or spread them out, whichever you like. The seventh is refused and handed straight back to you. Your server can change that number.

A Void Chest holds none at all. It is far too big for boxes of boxes. Any that are already inside stay there and can be taken out as usual.

Shulker boxes that are already inside any chest are never taken away from you: you can see them, open them and take them out as normal. The chest's 27 physical slots are a normal chest and accept anything.

Wiki home · New Chests Wiki · Admin Wiki

On this page: Getting started · Recipes and capacity · Opening storage · Filters and names · Auto Sort Chest · Glass displays · Moving and carrying · Commands · Help

Getting started

1. Craft an ordinary vanilla chest.
2. Put it in the center of a crafting table and surround it with eight planks to make a Double Chest.
3. Place it and interact to open its 54-slot storage. Crouch-interact to open its separate 27 physical slots.

A Grims Double Chest occupies one block. Ordinary vanilla chests and vanilla two-block double chests keep their normal behavior.

Recipes and capacity

Each storage upgrade uses the previous chest item in the center of a crafting table. If it is already placed, move it with an issued Chest Wrench first.

Every upgraded storage chest adds 27 physical slots to the capacity above. Void is the highest tier: 45 double chests, one single chest, and the physical inventory.

The Void Heart uses this arrangement. Your server may swap the Dragon's Breath for End Crystals.

Shulker Shell    Nether Star   Shulker Shell
Dragon's Breath  Glass Chest   Dragon's Breath
Shulker Shell    Nether Star   Shulker Shell

For recipes with eight surrounding ingredients, fill the outer ring. Netherite uses one ingot in any outer slot and leaves the other outer slots empty. Glass uses two ingots anywhere in the ring, with glass blocks in the other six positions.

Copper requires this arrangement:

Plank     Plank          Plank
Copper    Double Chest  Copper
Copper    Copper        Copper

Mixed vanilla plank types work. Glass accepts clear and stained glass blocks, including mixed colors; panes and tinted glass do not work.

Use a normal crafting click with an empty cursor. Craft one chest at a time; shift-click and automated Crafter production are disabled. Upgrading keeps your existing stored items, sub-chest names and icons, and the chest's shared filter. Newly unlocked sub-chests use that filter too.

Opening storage

All 54 slots inside a sub-chest are usable storage. Close it and interact again to select another sub-chest. Higher tiers also have a Physical inventory (27) button.

Hoppers use only the physical inventory. Putting items there does not automatically send them into that chest's sub-chests. Use the separate Auto Sort Chest for sorting.

Phone and tablet players get touch menus automatically when the server runs Grims Client Checker. Java and Bedrock controller/keyboard players keep standard menus. Pick for yourself with /gcc menu chests mobile, classic or auto. Touch menus use explicit page buttons; storage capacity stays the same.

The Void Chest's menu shows only its 46 chests. Standard players see them all on one page. Touch players see a seven-column grid: chests 1–35 with Next page on the bottom row, then chests 36–46 with Back below them. Crouch-interact still opens its physical inventory. Look at it and use /gch settings to configure it.

Jack-in-the-Box Chest

A Halloween chest that only administrators can give. It starts as a Double Chest, upgrades through every tier like any other chest, and always keeps its Jack-in-the-Box look. When anyone opens it, everyone nearby sees the crank turn, the lid flaps burst open and the pumpkin-headed jack spring up and sway until it's closed. Powering it with redstone (a lever, button, pressure plate or dust) makes it pop without opening it. After the power goes off it waits a short cooldown (2.5 seconds by default) before redstone can pop it again, so flicking a lever can't spam the animation.

Christmas Toy Chest

A Christmas chest that only administrators can give, with the same rules as the Jack-in-the-Box: it starts as a Double Chest and keeps its look through every upgrade. It's a red toy chest with a green lid and bow, wrapped in garland with twinkling string lights. When anyone opens it, nearby players see the lid swing up and a decorated tree spring out, its star lit, swaying until it's closed. Redstone opens it the same way without opening the chest, with the same cooldown.

Vouchers

Administrators may hand out vouchers instead of the command-only items, for example as loot-crate prizes. Hold a voucher and right-click in the air or on a block: it turns into its item in your hand (a Jack-in-the-Box Chest, Christmas Toy Chest, Chest Wrench, Display Remote or Sorting Core). Vouchers don't stack, and they can't be used as paper in any recipe.

Every chest makes the vanilla chest open and close sounds. Redstone pops are silent.

If a chest says it's locked

The plugin locks chests rather than risk your items. Two messages mean an administrator needs to look:

• "Chest storage is locked after an error." The database itself failed. Every chest is locked until an administrator clears it, and nothing is lost.
• "This chest is held for inspection after an error." That one chest stopped — every other chest still works normally. Its contents are safe, and an administrator can release it.

Tell your server staff either way. They have the details in the console.

Filters and names

Owners and trusted managers can configure a chest. Server protection rules still apply.

Each upgraded storage chest has one auto-sort filter for all its sub-chests. A Glass Chest's one filter can fill all nine 54-slot inventories. Copper uses the same rule across two, and other tiers use all the sub-chests they have unlocked. The physical 27-slot inventory is excluded.

1. Look at the chest and use /gch settings, or choose Configure from its selector.
2. Choose Auto-sort filter.
3. Select and save the rule for the whole chest.

For categories, select your choices and press Save categories. Several selected categories form one shared rule. Exact-item, catch-all, and disabled input are alternative modes. Exact-item, catch-all, and filter-clearing menu changes use confirmation buttons. Your sample item is kept.

New storage chests have sorting input disabled until you choose a rule. Filters control automatic transfers; you can still put items into any sub-chest manually. Changing a filter does not remove stored items. Select an individual sub-chest in settings to change its name or decorative icon; neither changes the shared filter.

Default categories are Building Blocks, Colored Blocks, Natural Blocks, Functional Blocks, Redstone, Tools and Utilities, Combat, Food and Drinks, Ingredients, and Spawn Eggs. Servers may customize them. Categories match vanilla items; use exact-item filters for custom items.

Example: look at a Glass Chest and run /gch filter building,colored. All nine sub-chests can now receive those categories from a linked sorter. Use /gch rename 1 Building supplies to name the first sub-chest separately.

If an older chest reports that its filter needs review after updating, choose and save a shared rule here. Its items stay safe and manually accessible while automatic input is paused.

Auto Sort Chest

The Auto Sort Chest is separate from the storage tier ladder. It has a 27-slot input and no sub-chests of its own.

Craft it

Ask an administrator for a Sorting Core. The core is admin-issued only and has no crafting recipe.

Combine these three items anywhere in either your personal crafting grid or a crafting table:

1 Sorting Core + 1 finished Crafter block + 1 vanilla Chest

Craft the Crafter first using its vanilla recipe; the finished block is the ingredient. Ordinary or renamed paper cannot replace the core. Use a normal click with an empty cursor to make one sorter.

Link it

1. Place the sorter and configure one shared filter in each destination storage chest.
2. Crouch-interact with the sorter, or look at it and use /gch link.
3. Interact with a destination chest and choose Confirm link.
4. Repeat for more destinations.
5. Crouch-interact with the same sorter again, or use /gch link cancel, to finish.

You must be allowed to manage the sorter and its destinations. Selecting an already linked chest offers Confirm unlink.

By default, a sorter supports 16 destinations inside a 64×64×64 area centered on it: up to 32 blocks away on each axis, in the same world. Link mode expires after 60 seconds without a successful link change. Your server may change these limits.

Sort items

Open the sorter, deposit items, and close it. Sorting starts after the final viewer closes, provided that player can manage the sorter and the destinations.

The sorter tries exact-item matches first, categories second, and catch-all last. Within a matching storage chest it fills sub-chest 1, then 2, and continues through every unlocked sub-chest. If that chest fills, it tries another matching linked chest. Destinations must be placed, loaded, in range, and available. Their physical 27 slots never receive sorted items.

Only successfully transferred items leave the sorter. If sub-chest 1 has room for 40 of your 64 logs, the other 24 continue into sub-chest 2. If only 40 fit across all matching destinations, 24 remain in the input. Unmatched items also stay there.

Hoppers can fill the sorter, but do not trigger sorting. An authorized player must open and close it afterward. A guest's close does not trigger a batch.

Glass displays

Glass Chests can show items from one selected sub-chest, cycling through them one at a time.

1. Open the Glass Chest's selector and choose Choose display source.
2. Select the sub-chest to display.
3. Hold an administrator-issued Display Remote in your main hand.
4. Interact with the Glass Chest, or left-click it, to switch the display on. Use the remote again to switch it off.

The owner, a trusted manager, or an administrator chooses the source. You also need the server's display permission to use the remote. Choosing a source while the display is off leaves it off; changing the source while it is on keeps it on.

By default, each occupied slot is shown for three seconds, within a viewing distance of 32 blocks. Empty slots are skipped. An empty source shows nothing until it has items. The display is only a preview: players and hoppers cannot collect it, and the stored stack stays intact.

Moving or placing a Glass Chest always turns its display off. Its chosen source remains saved. Use the remote to turn it on again after placement. A chest left in place can keep its on/off setting through a normal restart.

The remote toggles Glass displays only. It does not move chests or lock nearby storage. Put it away before interacting normally to open a chest menu. Your server may disable displays or adjust their height, item-change timing, and viewing distance.

Moving and carrying

Move a placed chest

Only an authentic Chest Wrench can move plugin chests. Administrators issue it; there is no wrench recipe. Some servers keep wrenches with staff.

1. Empty the physical inventory first if you want to avoid collecting its contents from the ground.
2. Leave a normal inventory slot free and hold the wrench in your main hand.
3. Use the break action once on a chest you may manage—left-click on mouse controls.
4. The chest item goes directly into your inventory after its storage has been saved.
5. Collect any physical contents dropped at the old location, then place the chest item at its new location.

Sub-chests, their contents, and settings move with the chest. Its new physical inventory starts empty. This also applies to moving an Auto Sort Chest: its input contents drop.

Wrench lock

Holding a wrench in either hand locks plugin chests within 15 blocks by default, including access by the person holding it. Open inventories close, and hopper transfers and sorting pause. Put the wrench away when you finish.

A mobile form may remain visible after a lock; dismiss it and reopen after the wrench is put away. Its old buttons cannot operate the locked chest.

Carrying rules

Carried plugin chests stay in your player inventory, hotbar, offhand, or temporary cursor. They cannot be stored inside chests, shulkers, barrels, bundles, backpacks, or other containers, even when empty. Manual dropping is blocked.

Carrying a loaded Iron, Gold, Emerald, Diamond, Netherite, Glass, or Void Chest reduces movement to 70% of normal speed by default. Carrying more loaded chests does not stack the penalty. Empty chests, Double, Copper, and Auto Sort do not slow you down.

Chest items are kept through death. If a saved chest needs to be returned, free a normal inventory slot and use /gch recover. The same command helps if closing a menu or crafting table left no room to return a carried chest.

If a move stops with an inspection or recovery warning, keep any chest item you received and contact staff.

Commands

Use these while looking at a placed chest within six blocks, except recover and link cancel. Sub-chest numbers start at 1.

Configuration and trust changes require management access. Commands apply their changes immediately. The older /gch filter <sub> <rule> form still accepts a valid sub-chest number, but changes the whole chest's filter and tells you so. Trust gives management rights; your server's claim and container rules control normal access.

Help

For pack, permission, or recovery problems, ask staff to use the Admin Wiki.

/gch shulkers