Compressy — Block Compression for Inventory Storage
Version 2.5.10 · Minecraft 26.2 · Paper/Spigot · Java 25
Stack 9 identical blocks into 1 compressed item — tier up to 32 (configurable), decompress in any crafting grid, gate every rank with LuckPerms.
What is Compressy?
Compressy is a Paper / Spigot plugin that turns bulky block stacks into tiered compressed items — 9→1 per craft, 1→9 to decompress. Each tier multiplies effective storage: tier I holds 9 blocks, tier II holds 81, tier III holds 729, and so on (9^n).Players compress and decompress in any 3×3 crafting grid (crafting table, inventory, Crafter). Compressed items are inventory-only — they cannot be placed in the world. Display name, lore, and plugin metadata (
compressed_level, compressed_block) show tier and block type at a glance.Server owners configure who may compress what through LuckPerms-ready permission nodes, per-block allow/deny lists, optional tier gates, and advanced policy gates (custom permission nodes or AuraSkills skill levels). Everything is editable in-game through chest GUIs or
policies.yml; changes save automatically.What you get in 2.5.10
- 9→1 / 1→9 crafting — shapeless compress and shaped decompress in player grids; PDC-matched Bukkit recipes
- Tier scaling — server max tier default 32 (hard ceiling 128); per-block max overrides; Roman numeral lore + progress bar
- LuckPerms integration — all gates use Bukkit
hasPermission(LuckPerms hooks automatically) - Three-layer permission model —
compress/decompress, per-blockcompressy.block.<id>, optionalcompressy.tier.<n> - Policy gates — per-block permission or AuraSkills requirements scoped to tier ranges and actions
- List modes —
MANIFEST,ALLOWLIST,MANIFEST_MINUS_DENY - Interactive guidebook —
/cblocks helpchest UI - /cblocks info — held-item diagnostics, policy blockers, tips
- Admin hub — block catalog, presets, global settings, allow/deny, max tier, permission reference, reload
- Per-block admin — allow/deny, enabled override, max tier, custom perm node, gates
- Crafter autocrafting — 9-slot compress + 1-slot decompress on redstone pulse; block policy only
- Vanilla recipe respect — full-grid vanilla recipes win when present
- Storage prefabs (admin) —
/cblocks prefabfor testing; not for loot tables yet - Custom catalog entries — register non-vanilla item prototypes
- Compress — 3×3 filled with the same block or compressed tier → 1 item at tier + 1
- Decompress — 1 compressed item alone → 9 items at tier − 1 (or 9 plain blocks at tier I)
The Crafter has no recipe-book preview — Compressy detects the 3×3 grid on redstone pulse.
- Compress — all 9 slots enabled, identical item in each; pulse when comparator reads 9
- Decompress (tier I+) — 8 slots disabled, 1 compressed item in the remaining slot
- Tier I = 9 blocks · Tier II = 81 · Tier III = 729 · … · Tier 32 = 9^32
- Global max:
policies.yml→max-compression-level(default 32, ceiling 128) - Per-block max: admin GUI or
blocks.<id>.max-tier - Tier permissions: when enabled, compressing to tier ≥
from-tierrequirescompressy.tier.<n>orcompressy.tier.*
- Guidebook (
/cblocks help) — paginated chest UI - Info (
/cblocks info) — block ID, tier, equivalent count, blockers, tips - Craft preview — Compressy recipes win at prepare time when compressed stacks are in the matrix
- Denial cooldown — policy messages throttle ~1.5s
Open with
Per-block detail: allow/deny, enabled override, max tier, custom permission node, add/remove gates (permission or AuraSkills).
Admin CLI (
/cblocks config or /cblocks admin gui (compressy.admin).- Block catalog — browse, search, filter, bulk allow/deny
- Quick presets — curated block groups
- Global settings — list mode, tier-permissions toggle
- Max compression tier — server-wide cap (+1/−1, shift ±10, reset)
- Allow / deny lists — global overrides
- Permission nodes — LuckPerms-ready reference chest
- Save & reload — reload
policies.yml(GUI edits auto-save)
Per-block detail: allow/deny, enabled override, max tier, custom permission node, add/remove gates (permission or AuraSkills).
Admin CLI (
compressy.admin.policy unless noted):/cblocks admin reload—compressy.admin.reload/cblocks admin list [page]/cblocks admin allow|deny <block>/cblocks admin mode <MANIFEST|ALLOWLIST|MANIFEST_MINUS_DENY>/cblocks admin block <id> info|enable|disable|maxtier <n>|gate .../cblocks admin gui·/cblocks admin perms
Compressy checks Bukkit
Wildcard & bundle nodes
Player action nodes
Per-block nodes
Output-tier nodes
Example rank ladder
Admin nodes
Reserved prefab nodes (WIP) —
Custom rank gates (policy gates) — per-block extra requirements for tier ranges:
Evaluation order (player crafting)
Player#hasPermission. With LuckPerms, assign nodes via /lp user <player> permission set <node> true or group templates.Wildcard & bundle nodes
compressy.*— all permissions (default: op)compressy.block.*— all block types (default: true)compressy.tier.*— all output tiers (default: true)
Player action nodes
compressy.use— guidebook + info (default: true)compressy.compress— compress in grid (default: true)compressy.decompress— decompress in grid (default: true)compressy.bypass— skip all policy gates (default: op); does not allow placing compressed items
Per-block nodes
compressy.block.<namespace_block>— e.g.compressy.block.minecraft_dirt(minecraft:dirt→ underscores, lowercase)- Custom override per block in
policies.yml→blocks.<id>.permissionor admin GUI
Output-tier nodes
compressy.tier.<n>— allow compressing to output tier n- Controlled by
tier-permissions.enabledandtier-permissions.from-tierinpolicies.yml
Example rank ladder
default→compressy.use,compressy.compress,compressy.decompress,compressy.tier.1…compressy.tier.5vip→compressy.tier.6…compressy.tier.16elite→compressy.tier.17…compressy.tier.32staff→compressy.bypass,compressy.admin
Admin nodes
compressy.admin— admin hub,/cblocks config, prefab commands (default: op)compressy.admin.policy— edit lists, blocks, gatescompressy.admin.reload—/cblocks reload
Reserved prefab nodes (WIP) —
compressy.prefab.common, uncommon, rare (default: false). give/place requires compressy.admin. Do not add to Offerings loot yet.Custom rank gates (policy gates) — per-block extra requirements for tier ranges:
- Permission gate —
type: PERMISSION,action: compress|decompress|both,min-output-tier,max-output-tier,permission: compressy.rank.elite - AuraSkills gate —
type: AURASKILLS,skill: mining,min-skill-level: 15, same tier/action fields
compressy.rank.vip, compressy.rank.elite — you define these in LuckPerms; Compressy checks them when configured as gates.Evaluation order (player crafting)
compressy.bypass→ allow- Block on server list (list mode + allow/deny + enabled)
compressy.compressorcompressy.decompress- Output tier within per-block and global max
compressy.block.<id>orcompressy.block.*compressy.tier.<n>orcompressy.tier.*(if tier permissions enabled)- Each applicable policy gate (permission or AuraSkills)
- MANIFEST — built-in catalog + global-allow − global-deny − per-block disabled
- ALLOWLIST — only global-allow and per-block enabled entries
- MANIFEST_MINUS_DENY — same effective behavior as MANIFEST
config.yml— guidebook rows, messagespolicies.yml— list mode, max tier, tier permissions, allow/deny, per-block overrides and gatesguidebook/pages.json— guidebook contentcatalog/(data folder) — custom item prototypes
compressed_level + compressed_block.Players
Admin
/cblocks help— guidebook (compressy.use)/cblocks info— held-item status (compressy.use)
compressy, cbAdmin
/cblocks config— admin hub (compressy.admin)/cblocks reload— reload (compressy.admin.reload)/cblocks prefab give|place <common|uncommon|rare> [player]— WIP prefabs (compressy.admin)/cblocks prefab place test [player]— smoke test/cblocks admin ...— policy CLI (see Admin section)
Spawns a build four blocks ahead of the player.
- common — vertical autocrafter line (feed chest, hopper, crafter, output, comparator pulse)
- uncommon — wider pad, double output chest
- rare — full base: cobble house, 3 autocrafter lines, bed, furnace, supplies
Required
Soft dependencies
Integrations
- Paper or Spigot
- Minecraft 26.2
- Java 25
Soft dependencies
- LuckPerms — recommended for rank/group permissions (optional)
- AuraSkills — optional skill-level gates
Integrations
- LuckPerms-ready — all nodes in admin hub → Permission nodes and
/cblocks admin perms - AuraSkills — reflection API; clear denial if plugin missing
- Offerings / loot — use permission grants + material commands, not prefab WIP
Why server owners choose Compressy
- Massive storage — exponential 9^n stacking without chest mods
- Rank-ready — per-block, per-tier, and custom gates map to LuckPerms groups
- Skill progression — optional AuraSkills gates for high-tier compress
- GUI-first policy — rarely touch YAML
- Crafter-native — redstone factories respect block policy
- Honest vanilla — recipe conflicts defer to vanilla; compressed items stay inventory-safe
- Player diagnostics —
/cblocks infoexplains denials without staff
Nine blocks enter. One treasure leaves. Tier up.
