TheSacks v1.3.0

Meet TheSacks — a Premium sack system that lets players store huge amounts of specific materials in virtual sacks, with auto-pickup, tier upgrades, and a polished Sack of Sacks GUI.


▪ Virtual material storage
No physical chest rooms; sacks hold huge stacks per material or combined capacity (configurable).

▪ Category-based sacks
Mining, Ores, Agronomy, Combat, Foraging, Fishing, Potion (and any custom sacks you add in sacks.yml).

▪ Sack of Sacks GUI
One polished menu to open any sack, see locks, and manage settings.

▪ Per-sack content GUI
View stored amounts, take items out, upgrade tier, toggle auto-pickup / smelt / compress per sack.

▪ Auto-pickup pipeline
Ground items, block breaks (inventory snapshot — Telekinesis-friendly), and mob drops can route into the right sack.

▪ Manual store mode
When global auto-pickup is off, players deposit from inventory via GUI clicks.

▪ Economy progression
Vault-powered tier costs per sack in sacks.yml.

▪ Permission gates
Missing permissions show customizable locked items with lore and error sounds.

▪ Custom item plugins
ItemsAdder, Oraxen, Nexo, EcoItems IDs in accepted-items lists.

▪ PlaceholderAPI
Tablist, scoreboard, and chat placeholders for stored counts, tiers, auto-pickup state, and last pickup/takeout.

▪ Database choice
YAML, MySQL, or SQLite with async save and auto-save interval.

▪ Full localization
All messages, GUI titles, layouts, sounds, and console open/close commands in config files.




Player Commands
➤ /thesacks or /thesacks open — Opens the Sack of Sacks GUI.
▪ Permission: thesacks.use
➤ /thesacks toggle — Toggles global auto-pickup on/off.
▪ Permission: thesacks.toggle
➤ /thesacks help — Shows the help menu.
▪ Permission: thesacks.use

Admin Commands
➤ /thesacks forceopen <player> — Forces a player to open their Sacks menu.
▪ Permission: thesacks.admin
➤ /thesacks settier <player> <sack_id> <tier> — Sets a player's sack tier (e.g. mining, ores).
▪ Permission: thesacks.admin
➤ /thesacks giveitem <player> <items> — Get item for sacks. (ecoitems tabcomplete)
▪ Permission: thesacks.admin
➤ /thesacks reload — Reloads all configuration files.
▪ Permission: thesacks.admin


▪ thesacks.use — Open Sack GUI and help command.
▪ thesacks.sacks.* — Access all sacks.
▪ thesacks.toggle — Toggle auto-pickup (command + GUI).
▪ thesacks.autosmelt — Use auto-smelt on pickup.
▪ thesacks.autocompress — Use auto-compress when taking items out.
▪ thesacks.admin — reload, forceopen, settier.




▪ %thesacks_total_stored% — Total items stored across all sacks.
▪ %thesacks_auto_pickup% — Global auto-pickup state (true/false).
▪ %thesacks_last_actionbar% — Last action bar pickup message.
▪ %thesacks_stored_<sack_id>% — Items stored in a sack (e.g. %thesacks_stored_mining%).
▪ %thesacks_capacity_<sack_id>% — Max capacity of a sack at current tier.
▪ %thesacks_tier_<sack_id>% — Current upgrade tier number.
▪ %thesacks_lastpickup_<sack_id>_name% — Display name of last item picked up.
▪ %thesacks_lastpickup_<sack_id>_id% — Material ID of last item picked up.
▪ %thesacks_lasttakeout_<sack_id>_name% — Display name of last item taken out.
▪ %thesacks_lasttakeout_<sack_id>_id% — Material ID of last item taken out.


Same sack support for Eco / EcoItems custom items.
What it does: Uses the item's full Eco lookup key (namespace:key) for storage and display.
Item ID format: ecoitems:<item_id> (full key as returned by Eco, e.g. ecoitems:ruby)

Tip: Install only the custom-item plugins you use — TheSacks auto-hooks when the plugin is present. Mix vanilla materials and custom IDs in the same accepted-items list. Custom items use : in the ID (e.g. ecoitems:ruby); vanilla items use MATERIAL names (e.g. COBBLESTONE).