WCompactor
Add portable compactor items that automatically convert materials in a player's inventory.
Add portable compactor items that automatically convert materials in a player's inventory.
Overview
WCompactor adds configurable compactor items that players can carry in their inventory.
Players configure a compactor through a simple GUI. Once recipes are selected, WCompactor scans the player's inventory after pickups, inventory changes, joins, or manual commands, then converts matching materials into configured output items.
Selected recipes are stored directly on the physical compactor item, so the item keeps its settings when moved, stored, or traded.
Features
- Portable compactor items
- Configurable compactor tiers
- GUI-based recipe selection
- Automatic inventory compaction
- Manual compactor recipe files
- Automatic recipe generation from compatible server recipe files
- Selected recipes stored on the item itself
- Configurable item names and lore
- Configurable GUI title, filler item, empty slot item, names, and lore
- Delayed inventory scans for safer inventory handling
- Output space check before removing input items
Dependencies & Supported Plugins
- Required: eco
- Supported: EcoItems
When EcoItems is installed, WCompactor can read compatible item and recipe YAML files and generate compactor recipes from them.
Commands
Code (Text):
/wcompactor give <player> <tier> [amount]
/wcompactor reload
/wcompactor debugitem
/wcompactor compact
/compactor
Code (Text):
wcompactor.admin
1. Give a player a compactor item.
2. The player right-clicks the compactor to open its GUI.
3. The player clicks an output item sample into an empty compactor slot.
4. WCompactor stores the selected recipe ID on the item.
5. When the player's inventory changes, WCompactor attempts to compact matching items automatically.
WCompactor only auto-registers recipes that can safely be represented as:
Code (Text):
one input item type + amount -> one output item type + amount
Configuration Example
Code (YAML):
settings:
scan-cooldown-ticks : 4
max-crafts-per-scan : 16
compact-on-pickup : true
compact-on-inventory-click : true
compact-on-inventory-drag : true
compact-on-join : true
silent : true
gui:
title : "Personal Compactor"
rows : 3
filler:
material : "BLACK_STAINED_GLASS_PANE"
name : " "
lore : [ ]
empty-slot:
material : "GREEN_STAINED_GLASS_PANE"
name : "&aEmpty Compactor Slot"
lore :
- "&7Click with an output item sample."
selected-recipe:
append-lore :
- ""
- "&aSelected"
- "&7Recipe : &f{recipe_id}"
tiers:
basic:
slots : 3
fallback-material : "DROPPER"
display-name : "&6Personal Compactor 3000"
lore :
- "&7Automatically compacts selected items."
- "&7Right-click to configure."
experimental:
auto-discover-registry-recipes : true
auto-discover-eco-recipe-files : true
eco-recipe-directories :
- "EcoItems/items"
- "EcoItems/recipes"
Code (YAML):
id : compact_diamond
enabled : true
input : "diamond"
input-amount : 160
output : "diamond_block"
output-amount : 1
Code (Text):
plugins/WCompactor/recipes/
- Use /wcompactor reload after changing configuration or recipe files.
- Use /wcompactor debugitem to inspect the item currently held in your hand.
- If the output cannot fit in the inventory, input items are not removed.
- Recipe processing follows the GUI slot order.
- Newly added compatible item or recipe files can be picked up after reload.
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft version listed: 26.1
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Spigot — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
WCompactor is a free Minecraft Java mod. Compatible with Minecraft 26.1. Downloaded 5 times (via Spigot). Download it and open it directly in the game.