RoodyCompressor
RoodyCompressor is an item-based auto-compressor. A player who carries a compressor item that is turned on has their full stacks compressed up a tiered chain — for example 64 gold ingots → 1 gold block → 1 redstone block. Everything, from tiers to recipes and item looks, is edited in-game with /rcomp.
Installation
Put
RoodyCompressor-<version>.jarin your server'splugins/folder. (Optional: install PlaceholderAPI for placeholders.)Start the server once. Open
plugins/RoodyCompressor/license.ymland paste your license key:key: RDY-XXXXX-XXXXX-XXXXX-XXXXXRestart. The console shows
License: licensed.Join and run
/rcompto open the editor.
Works on Paper (and forks such as Purpur) from 1.20.4 to 1.21.x with the same jar.
How it works
- Every second (configurable), and instantly after a pick-up or closing a chest, the inventory of each player is checked.
- The recipes used are those of every compressor item the player carries turned on. A higher tier can inherit a lower one, so the top tier does everything.
- Recipes repeat until nothing changes, so a full chain climbs all the way in one go.
- It never runs while an inventory is open or an item is on the cursor, and it pauses after trading, so shops and villagers are safe. If an output does not fit, it only does what fits — items are never dropped.
- Only plain items (on by default) means renamed or enchanted items of the same material are never touched.
Tiers
Each tier is one compressor item with its own recipes and two looks: on and off. Tiers are ordered; the order is their level (I, II, III…). The item is recognised by a hidden tag, so it keeps any enchantments, attributes or lore you add and can be sold in shops or Shopkeepers.
The in-game editor
Run /rcomp with the roodycompressor.admin permission.
| Menu | What you can do |
|---|---|
| Tiers | See every tier. Click to edit, right-click to get one. Create tier, Settings, Reload. |
| Tier | Live preview, recipes, look when on/off, inheritance, permission, auto tier, order, give, delete. |
| Recipes | Own recipes (click to edit, shift-right to delete) and inherited ones. Add recipe, Presets. |
| Recipe builder | Click Input or Output, then an item in your inventory. Left/right ±1, shift ×2/÷2, Q to type a number. |
| Look | Material, glint, custom model data, name, lore, copy to the other look. |
| Presets | Add common packs in one click: storage blocks 9→1, raw ores, nuggets, farming, small blocks 4→1. |
| Settings | Mode, auto tier, timings, game modes, worlds, sounds, notifications, ON/OFF labels. |
Every change is saved to config.yml (comments are kept) and applied instantly.
Player menu
/compressor opens the player's own menu: status, the recipe chain, turn on/off, compress now, and two personal preferences — where to show notifications (action bar, chat or nowhere) and whether to play the sound.
Commands
| Command | Description |
|---|---|
/compressor |
Open your compressor menu. |
/compressor on · off · toggle |
Turn the compressor in your hand (or your auto mode) on/off. |
/compressor now · info |
Compress right now / show your status in chat. |
/rcomp |
Open the in-game editor. |
/rcomp settings · /rcomp edit <tier> |
Open the settings / a tier. |
/rcomp create <id> · /rcomp deletetier <id> confirm |
Create / delete a tier. |
/rcomp give <player> <tier> [amount] [on|off] |
Give a compressor item. |
/rcomp addrecipe <tier> <from> <amount> <to> <result> · /rcomp delrecipe <tier> <n> |
Edit recipes from the console. |
/rcomp list · reload · license |
List tiers, reload, show the license status. |
Permissions
| Permission | Default | Description |
|---|---|---|
roodycompressor.use |
everyone | Use compressor items and /compressor. |
roodycompressor.auto |
nobody | Be compressed without an item (modes auto / both). |
roodycompressor.admin |
op | /rcomp and the editor. |
roodycompressor.tier.<id> |
— | Optional, if you set it as a tier's permission. |
Modes
- item (default) — players need a compressor item turned on.
- auto — no item: players with
roodycompressor.autoare compressed with the auto tier, and turn it on/off with/compressor on|off. - both — either of them.
PlaceholderAPI
| Placeholder | Value |
|---|---|
%roodycompressor_state% |
The ON/OFF label |
%roodycompressor_active% |
true / false |
%roodycompressor_tier% · _tier_level · _tier_roman |
Highest active tier |
%roodycompressor_holding% |
Carries any compressor item |
%roodycompressor_auto% |
Auto mode is on |
%roodycompressor_compressed% · _compressed_formatted |
Items compressed so far |
License and servers
Your license allows a number of servers at the same time. The plugin checks the license when it starts and every 12 hours; if our server cannot be reached it keeps working for 14 days.
Moving to a new server? Sign in to My licenses and press Free seat on the old one. Servers that have not been seen for 21 days free their seat automatically.
Updates: when a new version is out, the console says so and ops (permission roodycompressor.update) get a message with the download link when they join. Turn it off with check-updates: false in config.yml.
Troubleshooting
NOT licensed: not_found— the key inlicense.ymlis wrong. Copy it again from My licenses.NOT licensed: too_many_servers— all your seats are in use. Free one in My licenses.- Nothing is compressed — check that the item is on, the player has
roodycompressor.use(and the tier permission), is in an allowed game mode and world, and that the items are plain (not renamed/enchanted). - Need help? Join our Discord and open a ticket.