ItemChestShop
\nThe most flexible item-to-item chest shop plugin – no economy required!<\/p>\n
A modern Minecraft plugin for creating chest shops that trade items directly for items. No Vault, no currency, no complicated setup. Just place a chest, add a sign, and start trading. Built with intelligent parsing that understands over 10 different input formats and 200+ item aliases.<\/p>\n
\u2728 KEY FEATURES<\/p>\n
No Economy Required – Trade items directly for items, no currency system needed
\nUltra-Flexible Parsing – Supports 10+ different input formats for maximum convenience
\n200+ Item Aliases – Recognizes common abbreviations and alternative item names
\nSmart Item Recognition – Understands partial names, case variations, and shortcuts
\nAll Minecraft Items – Supports every vanilla Minecraft item automatically
\n\u2705 Simple Setup – Just place a chest and sign – no complex configuration
\nPermission System – Configurable access control for shops
\n\u2699\ufe0f Admin Tools – Management commands and statistics tracking
\nModern API – Built with Adventure API for future compatibility
\nStatistics – Track sales, purchases, and shop performance
\nREQUIREMENTS<\/p>\n
Minecraft Server 1.21.4
\nPaper server (Spigot compatible but Paper recommended)
\nJava 17 or higher
\nNo economy plugin needed!
\nNo additional dependencies required!<\/p>\n
\u2699\ufe0f INSTALLATION<\/p>\n
Download the latest ItemChestShop-1.0.0-shaded.jar file
\nPlace the JAR in your server’s plugins\/ folder
\nRestart your server
\nThe plugin will automatically generate a config.yml in plugins\/ItemChestShop\/
\nPlayers can immediately start creating shops!
\nNo configuration needed – it works out of the box!<\/p>\n
QUICK START GUIDE<\/p>\n
Creating Your First Shop:<\/p>\n
Place a chest where you want your shop
\nPlace a sign on or near the chest (within 2 blocks)
\nWrite on the sign:
\n[SHOP]
\nYourUsername
\nWant: 1 Diamond
\nGive: 64 Bread
\nThe sign will automatically format and validate
\nStock your chest with bread
\nYour shop is ready!
\nUsing Shops:<\/p>\n
Right-click the sign to make a purchase
\nShift + Right-click (or left-click) to view shop information
\nYou must have the required items to trade
\nYou cannot buy from your own shops
\nThat’s it! No complicated setup, no economy plugin, just simple item trading.<\/p>\n
FLEXIBLE SHOP FORMATS<\/p>\n
One of the most powerful features – the plugin understands MANY different ways to write the same trade!<\/p>\n
All These Formats Work for the Same Trade (64 Bread \u2194 1 Diamond):<\/p>\n
Want: 1 Diamond Want: Diamond 1 Want: 1 dia
\nGive: 64 Bread Give: Bread x64 Give: 64x bread<\/p>\n
Want: 1*Diamond Want: Diamond*1 Want: DIAMOND
\nGive: Bread 64 Give: 64*Bread Give: bread x64<\/p>\n
Want: 1 x Diamond Want: Diamond * 1 Want: dia 1
\nGive: 64 x Bread Give: Bread*64 Give: bread 64
\nSupported Input Patterns:<\/p>\n
Space-separated: 1 Diamond or Diamond 1
\nX-notation: 64x Bread or Bread x64
\nAsterisk notation: 5*Iron or Iron*5
\nNo amount: Diamond (defaults to 1)
\nCase insensitive: diamond, DIAMOND, Diamond
\nFlexible spacing: Extra spaces are ignored
\nMulti-word items: Oak Log, Iron Ingot, Cooked Beef
\nMix and Match:<\/p>\n
You can use different formats on each line:<\/p>\n
[SHOP]
\nPlayerName
\nWant: Diamond 1
\nGive: 64x Bread
\nSUPPORTED ITEMS<\/p>\n
\u2705 ALL Minecraft Items Supported<\/p>\n
The plugin recognizes every vanilla Minecraft item with intelligent parsing:<\/p>\n
Full Material Support:<\/p>\n
Blocks: Stone, Cobblestone, Oak_Log, Diamond_Block, Glass, Sand
\nItems: Diamond, Iron_Ingot, Stick, String, Leather, Paper
\nOres: Iron_Ore, Gold_Ore, Diamond_Ore, Emerald_Ore, Coal_Ore
\nTools: Diamond_Sword, Iron_Pickaxe, Golden_Axe, Bow, Fishing_Rod
\nWeapons: Sword, Bow, Crossbow, Trident, Arrow
\nFood: Bread, Apple, Cooked_Beef, Golden_Apple, Cake
\nRails: Rail, Powered_Rail, Detector_Rail, Activator_Rail
\nRedstone: Redstone, Repeater, Comparator, Piston, Dispenser
\nSmart Name Recognition:<\/p>\n
The plugin is incredibly flexible with item names:<\/p>\n
Exact Names (All Work):<\/p>\n
DIAMOND_SWORD (uppercase)
\ndiamond_sword (lowercase)
\nDiamond Sword (spaces)
\nDiamond_Sword (underscores)
\nCommon Aliases (200+ Built-in):<\/p>\n
Wood \u2192 Oak_Log
\nStone \u2192 Cobblestone
\nIron \u2192 Iron_Ingot
\nGold \u2192 Gold_Ingot
\nDia \u2192 Diamond
\nEme \u2192 Emerald
\nCobble \u2192 Cobblestone
\nPearl \u2192 Ender_Pearl
\nPartial Matching:<\/p>\n
Diamond finds Diamond
\nDia matches Diamond
\nEme matches Emerald
\nRail finds Rail
\nCart finds Minecart
\nPick matches Iron_Pickaxe
\nSword matches Iron_Sword
\nAuto-Completion:<\/p>\n
Iron \u2192 Iron_Ingot
\nGold \u2192 Gold_Ingot
\nOak \u2192 Oak_Log
\nCooked \u2192 Cooked_Beef
\nULTRA-FLEXIBLE FORMATTING<\/p>\n
Multiple Amount Formats:<\/p>\n
Every format style works:<\/p>\n
1 Diamond (space before)
\nDiamond 1 (space after)
\n64x Bread (x before amount)
\nBread x64 (x after item)
\n5*Iron_Ingot (asterisk before)
\nIron_Ingot*5 (asterisk after)
\n32 Oak Log (multi-word items)
\nOak Log 32 (reversed)
\nDiamond (no amount = 1)
\nCase & Spacing Flexibility:<\/p>\n
Case insensitive: diamond, DIAMOND, Diamond, DiAmOnD
\nSpace variations: Oak Log, Oak_Log, OakLog, OAKLOG
\nExtra spaces ignored: 1 Diamond works fine
\nUnderscores optional: Iron_Ingot = Iron Ingot
\nCommon Abbreviations Work:<\/p>\n
Dia \u2192 Diamond
\nEme \u2192 Emerald
\nCobble \u2192 Cobblestone
\nPick \u2192 Iron_Pickaxe
\nSword \u2192 Iron_Sword
\nCart \u2192 Minecart
\nPearl \u2192 Ender_Pearl
\nWood \u2192 Oak_Log
\nCOMMANDS<\/p>\n
All basic commands are available to players with the itemchestshop.use permission (default: everyone).<\/p>\n
Player Commands:<\/p>\n
\/itemchestshop help – Display all available commands and usage \/itemchestshop info – Show plugin version and information \/itemchestshop stats – View your personal shop statistics \/itemchestshop list [page] – Browse all shops on the server \/itemchestshop find Admin Commands:<\/p>\n \/itemchestshop reload – Reload the plugin configuration<\/p>\n Command Examples:<\/p>\n \/itemchestshop find Diamond \/itemchestshop list 2 \/itemchestshop stats \/itemchestshop help You can use \/ics as a shortcut:<\/p>\n \/ics help &]:eek:dd:bg-bg-500\/10″>Permission Description Default Setting Up Permissions:<\/p>\n For LuckPerms:<\/p>\n \/lp group default permission set itemchestshop.create true \/pex group default add itemchestshop.create Example 1: Basic Food Shop<\/p>\n [SHOP] Example 2: Using Abbreviations<\/p>\n [SHOP] Example 3: Mixed Formats<\/p>\n [SHOP] Example 4: Tool Trading<\/p>\n [SHOP] Example 5: Using Aliases<\/p>\n [SHOP] Example 6: High-Value Rare Items<\/p>\n [SHOP] HOW IT WORKS<\/p>\n Shop Creation Process:<\/p>\n Player places sign on\/near chest with format: [SHOP], username, Want:, Give: Buyer right-clicks shop sign Transaction rollback if any step fails The plugin uses advanced parsing to understand many formats:<\/p>\n Tries exact material name match first The plugin creates a config.yml file with customizable options:<\/p>\n yaml # Enable debug logging # Message customization # Item aliases (add custom shortcuts) max_shops_per_player – Limit shops per player (0 = unlimited) Limiting Shops Per Player:<\/p>\n yaml yaml yaml yaml TROUBLESHOOTING<\/p>\n Shop Not Creating:<\/p>\n Verify sign format: Line 1 must be [SHOP] Try common aliases: dia, eme, wood, iron, gold Ensure shop chest has items in stock Verify itemchestshop.use permission is set Ensure first line is exactly [SHOP] Enable detailed logging for troubleshooting:<\/p>\n yaml Sign creation attempts and validation Enable in config.yml Flexible Amount Parsing:<\/p>\n The plugin accepts amounts in many formats:<\/p>\n 64 (number only) Priority order for item recognition:<\/p>\n Exact material name match (e.g., DIAMOND) \/itemchestshop find Diamond Statistics Tracking:<\/p>\n \/itemchestshop stats Total shops owned Built With:<\/p>\n Paper API 1.21.4 – Core server framework Command system with subcommand routing Lightweight event handling (only active when signs are placed\/used) \u2705 Modernized to Adventure API (no deprecated methods) Having issues? Follow these steps:<\/p>\n Check the troubleshooting section above Other chest shop plugins (uninstall competing plugins) The only chestshop plugin with items, not $<\/p>\n","protected":false},"featured_media":86731,"template":"","meta":{"_minecraft_slug":"item-chestshop","_minecraft_project_id":"kbaARtCB","_minecraft_author":"ethanmcrisptherealone","_minecraft_license":"MIT","_minecraft_downloads":341,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"item-chestshop.zip","_minecraft_size_bytes":290477,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-16T11:27:08.258899Z","_minecraft_date_created":"2025-10-27T08:11:12.745174Z","_minecraft_date_modified":"2025-10-27T01:17:36.643465Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/item-chestshop","_minecraft_icon_attachment_id":86731,"_minecraft_imported_at":"2026-06-04T22:54:35+00:00","_minecraft_import_hash":"2834be15832577d24421d28c1df47b9f","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[844,127,92],"mod_loader":[132],"minecraft_version":[59,36,60,93,94,101,102,62,37,40,73,74,38,78,79,80,81,82],"class_list":["post-86730","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-economy","mod_category-paper","mod_category-utility","mod_loader-paper","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\nLists all shops selling diamonds<\/p>\n
\nShows page 2 of all active shops<\/p>\n
\nShows your trading statistics<\/p>\n
\nDisplays command help
\nCommand Aliases:<\/p>\n
\n\/ics find Iron
\n\/ics stats
\n\/ics list
\nPERMISSIONS<\/p>\n
\n&]:eek:dd:bg-bg-500\/10″>itemchestshop.create Allow creating chest shops Everyone
\n&]:eek:dd:bg-bg-500\/10″>itemchestshop.use Allow using chest shops and commands Everyone
\n&]:eek:dd:bg-bg-500\/10″>itemchestshop.admin Allow admin commands and breaking others’ shops OP only<\/p>\n
\n\/lp group default permission set itemchestshop.use true
\n\/lp group admin permission set itemchestshop.admin true
\nFor PermissionsEx:<\/p>\n
\n\/pex group default add itemchestshop.use
\n\/pex group admin add itemchestshop.admin
\nSHOP EXAMPLES<\/p>\n
\nPlayerName
\nWant: 5 Iron
\nGive: 64 Bread
\nTrade 5 Iron Ingots for 64 Bread<\/p>\n
\nSteve
\nWant: 1 dia
\nGive: 32x cobble
\nTrade 1 Diamond for 32 Cobblestone<\/p>\n
\nAlex
\nWant: Emerald * 2
\nGive: Oak Log 128
\nTrade 2 Emeralds for 128 Oak Logs<\/p>\n
\nMiner
\nWant: 10 Diamond
\nGive: 1 Diamond_Pickaxe
\nTrade 10 Diamonds for 1 Diamond Pickaxe (enchant it for premium value!)<\/p>\n
\nFarmer
\nWant: 16 wheat
\nGive: 8x bread
\nConvert raw wheat to processed bread<\/p>\n
\nBlacksmith
\nWant: 64 dia
\nGive: Netherite_Ingot
\nPremium shop for rare materials<\/p>\n
\nPlugin parses item names using intelligent matching (checks aliases, partial names, case variations)
\nPlugin validates amounts and ensures items exist
\nSign is automatically formatted with colors
\nShop is registered in database with owner information
\nShop is ready to use!
\nTransaction Process:<\/p>\n
\nPlugin checks buyer has required “Want” items in inventory
\nPlugin checks shop chest has “Give” items in stock
\nPlugin verifies buyer has inventory space for items
\nItems are safely exchanged between inventories
\nShop owner is notified of the sale
\nTransaction is logged for statistics
\nSafety Features:<\/p>\n
\nAutomatic validation before any changes
\nPermission checks before modifications
\nStock verification
\nInventory space verification
\nPrevents item loss or duplication
\nIntelligent Parsing:<\/p>\n
\nFalls back to alias lookup (200+ aliases)
\nChecks partial name matches
\nCase-insensitive throughout
\nHandles spaces, underscores, and special characters
\nSupports amount-first or amount-last formats
\nRecognizes x-notation and asterisk notation
\n\u2699\ufe0f CONFIGURATION<\/p>\n
\n# Maximum shops per player (0 = unlimited)
\nmax_shops_per_player: 10<\/p>\n
\ndebug: false<\/p>\n
\nmessages:
\nprefix: “&8[&6ItemChestShop&8]&r ”
\nshop_created: “&aShop created successfully!”
\nshop_removed: “&cShop removed!”
\ntransaction_success: “&aTransaction complete!”
\ninsufficient_stock: “&cThis shop is out of stock!”
\ninsufficient_funds: “&cYou don’t have enough items!”
\nno_space: “&cNot enough inventory space!”
\ncannot_buy_own: “&cYou cannot buy from your own shop!”<\/p>\n
\nitem_aliases:
\nwood: oak_log
\ngold: gold_ingot
\niron: iron_ingot
\ndia: diamond
\neme: emerald
\ncobble: cobblestone
\nConfiguration Options:<\/p>\n
\ndebug – Enable detailed console logging
\nmessages – Customize all player messages
\nitem_aliases – Add custom item name shortcuts
\nColor codes: &a green, &c red, &e yellow, &6 gold
\nCONFIGURATION TIPS<\/p>\n
\nmax_shops_per_player: 5
\nCustom Server Messages:<\/p>\n
\nmessages:
\nprefix: “&8[&b&lMarket&8]&r ”
\nshop_created: “&a&l\u2713 &aShop opened!”
\ntransaction_success: “&a&l\u2713 &aTrade complete!”
\nAdding Custom Aliases:<\/p>\n
\nitem_aliases:
\nlog: oak_log
\nplank: oak_planks
\npick: diamond_pickaxe
\nsword: diamond_sword
\ncart: minecart
\nDebug Mode for Troubleshooting:<\/p>\n
\ndebug: true
\nShows detailed parsing and transaction logs in console.<\/p>\n
\nCheck Lines 2-4 have username, Want:, and Give:
\nEnsure item names are valid (try abbreviations like dia for diamond)
\nConfirm chest is within 2 blocks of sign
\nCheck player has itemchestshop.create permission
\nItems Not Recognized:<\/p>\n
\nUse partial names: Diamond works, Dia works, D might not
\nCheck spelling (case doesn’t matter)
\nEnable debug mode to see parsing attempts
\nUse underscores for multi-word: Oak_Log or Oak Log
\nTransaction Failing:<\/p>\n
\nVerify buyer has required payment items
\nCheck buyer has inventory space
\nMake sure chest isn’t full (for receiving payment)
\nReview console for specific error messages
\n“No Permission” Errors:<\/p>\n
\nTry giving player OP temporarily to test
\nCheck permission plugin is loaded
\nReload permissions: \/lp reloadconfig or similar
\nSigns Not Formatting:<\/p>\n
\nCheck Want: and Give: have colons
\nTry different item name formats
\nEnable debug mode to see parsing errors
\nDEBUG MODE<\/p>\n
\ndebug: true
\nDebug Output Shows:<\/p>\n
\nItem name parsing (tried names, aliases, matches)
\nAmount parsing (formats tested)
\nTransaction steps and outcomes
\nPermission checks
\nStock verification
\nInventory calculations
\nError messages with details
\nUsing Debug Mode:<\/p>\n
\nRun \/itemchestshop reload
\nTry creating a shop
\nCheck console for detailed logs
\nShare logs when asking for support
\nADVANCED FEATURES<\/p>\n
\nx64 (x-prefix)
\n64x (x-suffix)
\n*64 (asterisk-prefix)
\n64* (asterisk-suffix)
\nNo amount (defaults to 1)
\nSmart Item Matching:<\/p>\n
\nAlias lookup (e.g., dia \u2192 DIAMOND)
\nPartial name match (e.g., Diam \u2192 DIAMOND)
\nCase-insensitive comparison throughout
\nShop Discovery:<\/p>\n
\nReturns all shops selling diamonds with prices and owner names<\/p>\n
\nShows your:<\/p>\n
\nTotal sales made
\nTotal purchases
\nMost traded items
\n\ufe0f TECHNICAL DETAILS<\/p>\n
\nAdventure API – Modern text components (bundled with Paper)
\nGson 2.10.1 – JSON data storage
\nMaven – Build automation
\nArchitecture:<\/p>\n
\nEvent-driven shop interaction (sign events, inventory events)
\nJSON-based persistent data storage
\nTransaction rollback support for safety
\nFull Bukkit permission integration
\nIntelligent item parsing with multiple fallback strategies
\nPerformance:<\/p>\n
\nEfficient shop lookup system
\nMinimal memory footprint
\nNo database required (JSON files)
\nFast item name parsing with caching
\nRecent Updates:<\/p>\n
\n\u2705 Enhanced item parsing with 200+ aliases
\n\u2705 Flexible format support (10+ input patterns)
\n\u2705 Improved error handling and validation
\n\u2705 Future-proof for Paper updates
\n\u2705 Shaded JAR with all dependencies included
\nSUPPORT<\/p>\n
\nTry using item aliases: dia, eme, wood, iron
\nEnable debug mode in config.yml for detailed logs
\nVerify you’re running Paper 1.21.4 with Java 17+
\nCheck console logs for specific error messages
\nTest with OP permissions first
\nCommon Conflicts:<\/p>\n
\nProtection plugins blocking sign placement (add shop regions)
\nEconomy plugins (not needed, can cause conflicts)<\/p>\n","protected":false},"excerpt":{"rendered":"