\ud83d\uded2 RoyalEconomy<\/p>\n
Advanced GUI-Based Economy Shop Plugin<\/p>\n
RoyalEconomy is a powerful and modern economy shop plugin for Minecraft servers.
\nIt provides a clean, intuitive GUI shop system for players and fully in-game management tools for administrators \u2014 no server restarts required.<\/p>\n
Built for SMP, Survival, and Economy servers, RoyalEconomy focuses on performance, flexibility, and ease of use.<\/p>\n
\u2728 Player Features
\n\ud83d\udecd Main Shop (\/shop)<\/p>\n
Clean 4-row Main Shop GUI<\/p>\n
All shop sections displayed in the top row<\/p>\n
Fully configurable sections via sections.yml<\/p>\n
Dedicated icons for:<\/p>\n
Item Prices<\/p>\n
Your Balance<\/p>\n
Smooth page navigation<\/p>\n
Section-based permissions<\/p>\n
\ud83d\udce6 Section Shop GUI<\/p>\n
Paginated section menus (Page X \/ Y)<\/p>\n
Items loaded from shops.yml<\/p>\n
Each item automatically shows:<\/p>\n
Slot index<\/p>\n
Buy price (if enabled)<\/p>\n
Sell price (if enabled)<\/p>\n
Worth (based on sell price)<\/p>\n
Click Actions<\/p>\n
Left-click item \u2192 Opens Buy GUI<\/p>\n
Right-click item \u2192 Sells 1 item from inventory<\/p>\n
Previous \/ Next arrows \u2192 Page navigation<\/p>\n
Back button \u2192 Returns to main shop<\/p>\n
\ud83d\udcb0 Sell Commands
\n\/sellhand<\/p>\n
Sells the entire stack in your main hand<\/p>\n
Uses the item\u2019s configured sell price<\/p>\n
Automatically deposits money<\/p>\n
Sends a clear confirmation message<\/p>\n
\/sellall [inventory|hand| \/sellall or \/sellall inventory<\/p>\n Sells all sellable items in your inventory<\/p>\n \/sellall hand<\/p>\n Sells all stacks of the item in your hand<\/p>\n \/sellall diamond_block<\/p>\n Sells only that specific material<\/p>\n Unsellable items are ignored safely.<\/p>\n \/sellgui<\/p>\n Opens a dedicated Sell GUI<\/p>\n Drag & drop items freely<\/p>\n Nothing is sold on click<\/p>\n When the GUI is closed:<\/p>\n Sellable items are sold<\/p>\n Unsellable items are returned<\/p>\n Shows a big title:<\/p>\n You earned $X<\/p>\n \ud83d\udee0 Admin Features<\/p>\n RoyalEconomy can be managed entirely in-game.<\/p>\n \ud83d\udd27 Reloading Reloads:<\/p>\n config.yml<\/p>\n sections.yml<\/p>\n shops.yml<\/p>\n messages.yml<\/p>\n \ud83d\uddc2 Section Management Admins can:<\/p>\n Create new sections<\/p>\n Change titles, icons, slots, permissions<\/p>\n Limit sections to specific worlds<\/p>\n Remove sections safely<\/p>\n \ud83d\udce6 Item Management Add items by material or directly from hand<\/p>\n Edit name, lore, material, buy & sell prices<\/p>\n Items are identified by slot index<\/p>\n Changes apply instantly<\/p>\n \ud83c\udf81 Utility Gives an exact shop item (with name & lore)<\/p>\n Useful for testing or rewards<\/p>\n \ud83e\uddea Testing \/ Remote Open Opens a shop section for another player<\/p>\n Useful for testing layouts or support<\/p>\n \ud83d\udd10 Permissions royaleconomy.sell.hand royaleconomy.sell.section. Admin Permission Grants access to all admin commands.<\/p>\n \ud83d\udd0c Dependencies<\/p>\n Required:<\/p>\n Vault<\/p>\n Compatible with:<\/p>\n EssentialsX<\/p>\n Any Vault-supported economy plugin<\/p>\n \ud83d\ude80 Performance & Stability<\/p>\n Lightweight and optimized<\/p>\n No async abuse<\/p>\n No unnecessary background tasks<\/p>\n Stable 20 TPS<\/p>\n Safe economy handling (no dupes)<\/p>\n \ud83d\udce6 Compatibility<\/p>\n Minecraft 1.20.x \u2013 1.21.x<\/p>\n Tested on:<\/p>\n Paper<\/p>\n Spigot<\/p>\n Purpur<\/p>\n \ud83e\udde9 Future Features (Planned)<\/p>\n Price importing<\/p>\n Layout system<\/p>\n Physical shop stands<\/p>\n Online layouts<\/p>\n Expanded sell logic<\/p>\n \u2705 Why RoyalEconomy?<\/p>\n \u2714 Fully in-game management COMMANDS USAGE WITH DETAIL<\/p>\n 1. Player commands text<\/p>\n \/shop Click on a section icon \u2192 opens that section at page 1. text<\/p>\n \/shop gear text<\/p>\n \/shop gear 2 Top rows: shop items from shops.yml. Left\u2011click any item: opens Buy GUI for that item. economyshopgui.shop \u2013 to use \/shop. \/sellhand economyshopgui.sellhand text<\/p>\n \/sellall text<\/p>\n \/sellall inventory text<\/p>\n \/sellall diamond_block Base: economyshopgui.sellall or EconomyShopGUI.sellall.*. \/sellgui Nothing is sold on click. You can freely move items. Plugin reads every slot: economyshopgui.sellgui or 2. Admin commands \/sreload (Equivalent to \/eshop reload.)<\/p>\n 2.2 \/eshop help \/eshop help reload 2.4 \/eshop open text<\/p>\n \/eshop open Zyroth_YT gear 2 text<\/p>\n \/eshop addsection potions 54 BREWING_STAND “&dPotions” 20 2.6 \/eshop deletesection text<\/p>\n \/eshop deletesection potions action can be:<\/p>\n set Set title:<\/p>\n text<\/p>\n \/eshop editsection gear set title “&b&lGEAR” text<\/p>\n \/eshop editsection gear set icon NETHERITE_SWORD text<\/p>\n \/eshop editsection gear set slot 13 text<\/p>\n \/eshop editsection gear set size 54 text<\/p>\n \/eshop editsection gear set permission EconomyShopGUI.shop.gear text<\/p>\n \/eshop editsection gear set worlds world,world_nether text<\/p>\n \/eshop editsection gear addworld world_the_end text<\/p>\n \/eshop editsection gear removeworld world_nether 2.8 \/eshop additem <\/p>\n text<\/p>\n \/eshop additem blocks STONE 4 1.5 shops: 2.9 \/eshop addhanditem <\/p>\n text<\/p>\n \/eshop addhanditem gear 25 10 Example:<\/p>\n text<\/p>\n \/eshop edititem gear 10 set buy 30 text<\/p>\n \/eshop edititem gear 10 set lore “&7This is line 1|&7This is line 2” material 2.11 \/eshop deleteitem <\/p>\n text<\/p>\n \/eshop deleteitem gear 10 text<\/p>\n \/eshop setprice gear 10 buy 50 \/eshop import Price importing from Essentials worth.yml, text<\/p>\n \/shopgive gear 10 # gives to yourself AND THESE ARE SOME SHORT DETAILS FOR YOU<\/p>\n Player commands Opens the main shop GUI or a specific section. Sells the entire stack in your main hand using its shop sell price. \/sellall or \/sellall inventory \u2013 sells all sellable items in your inventory. Opens the Sell GUI. Put items inside; when you close the GUI, all sellable items are sold automatically and unsellable ones are returned. Reloads config.yml, sections.yml, shops.yml, and messages.yml. Shows a list of all \/eshop subcommands and a short description. Same as \/sreload. Opens a specific section\/page of the shop for another player. Creates a new section and writes it to sections.yml. Removes the section from sections.yml and its items from shops.yml. Changes section settings (title, size, icon, slot, permission, worlds). Adds a new item to a section using a Material name. Adds a new item to a section using the item in your hand. Edits an item by slot index: material, buy, sell, name, lore. Deletes an item from a section by its slot index. Quick way to change just the buy or sell price. \/eshop import Gives 1x of a shop item (including name and lore) to a player. RoyalEconomy Shop plugin with more features<\/p>\n","protected":false},"featured_media":134306,"template":"","meta":{"_minecraft_slug":"royaleconomy","_minecraft_project_id":"QHTf8TbL","_minecraft_author":"Zyroth","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":108,"_minecraft_follows":2,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"royaleconomy.zip","_minecraft_size_bytes":52515,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T19:31:52.801198Z","_minecraft_date_created":"2026-01-13T22:46:41.992169Z","_minecraft_date_modified":"2026-01-06T07:10:48.766017Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/royaleconomy","_minecraft_icon_attachment_id":134306,"_minecraft_imported_at":"2026-06-07T22:16:07+00:00","_minecraft_import_hash":"bd8cb7375edb1e722b40bb6e3fefdc63","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[844,88,127,129],"mod_loader":[132,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-134305","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-economy","mod_category-equipment","mod_category-paper","mod_category-spigot","mod_loader-paper","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","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
\n\/sreload
\n\/eshop reload<\/p>\n
\n\/eshop addsection
\n\/eshop editsection
\n\/eshop deletesection
\n\/eshop additem <\/p>\n
\n\/eshop addhanditem <\/p>\n
\n\/eshop edititem <\/p>\n
\n\/eshop deleteitem <\/p>\n
\n\/eshop setprice <\/p>\n
\n\/shopgive <\/p>\n
\n\/eshop open
\nPlayer Permissions
\nroyaleconomy.shop
\nroyaleconomy.shop.section.
\nroyaleconomy.shop.section.*<\/p>\n
\nroyaleconomy.sell.all
\nroyaleconomy.sell.gui<\/p>\n
\nroyaleconomy.sell.section.*
\nroyaleconomy.sell.hand.section.
\nroyaleconomy.sell.item.section.
\nroyaleconomy.sell.gui.section.
\nroyaleconomy.sell.gui.section.*<\/p>\n
\nroyaleconomy.admin<\/p>\n
\n\u2714 Clean & modern GUI
\n\u2714 Section-based permissions
\n\u2714 Vault compatible
\n\u2714 Marketplace-ready<\/p>\n
\n1.1 \/shop [section] [page]
\nWithout arguments:<\/p>\n
\nOpens main shop GUI (4 rows, \u201cSHOP\u201d title).
\nTop row: your sections (BLOCKS, END, NETHER, GEAR, SPAWNER, SHARD SHOP, POINTS SHOP, FOOD, etc.) based on sections.yml.
\nExtra icons:
\nITEM PRICES (book) \u2013 slot from shop-main.itemprices-slot.
\nYour Balance (player head) \u2013 slot from shop-main.balance-slot.
\nClick actions in main shop GUI:<\/p>\n
\nClick on ITEM PRICES \u2192 opens the \u201cItem Prices\u201d GUI.
\nClick on Your Balance \u2192 nothing special (just a display).
\nWith section name:<\/p>\n
\nDirectly opens gear section, page 1.
\nWith section + page:<\/p>\n
\nOpens gear section, page 2 (if it exists).
\nInside a section GUI (“SHOP \u2013 GEAR (Page X\/Y)”)<\/p>\n
\nLore always shows:
\nIndex:
\nWorth: $
\nBuy: $X (if buy > 0)
\nSell: $Y (if sell > 0)
\nBottom row (navigation):
\nLeft slot: Previous Page arrow (if page > 1).
\nMiddle slot: Back to Shop (book) \u2013 returns to main \/shop.
\nRight slot: Next Page arrow (if more pages exist).
\nClicks in the section GUI:<\/p>\n
\nRight\u2011click any item: sells 1 of that item from your inventory using its sell price.
\nLeft\u2011click Previous Page arrow: go to previous page.
\nLeft\u2011click Next Page arrow: go to next page.
\nLeft\u2011click Back to Shop: go back to main \/shop GUI.
\nPermissions:<\/p>\n
\nEconomyShopGUI.shop.<\/p>\n
\n1.2 \/sellhand
\ntext<\/p>\n
\nTakes the item in your main hand.
\nLooks up that Material in shop items:
\nIf an item exists and sell > 0, it can be sold.
\nSells the entire stack in your hand:
\nRemoves it from main hand.
\nDeposits sellPrice * amount.
\nSends message using shop.item-sold:
\n\u201cYou sold Xx ITEM for $PRICE.\u201d
\nPermissions (effective):<\/p>\n
\nplus optional section level:
\nEconomyShopGUI.sellallhand.<\/p>\n
\n1.3 \/sellall [inventory|hand|
\nBase command:<\/p>\n
\nSame as:<\/p>\n
\n\/sellall or \/sellall inventory
\nScans your whole inventory (not armor).
\nFor each stack:
\nIf that Material is in the shop and has sell > 0, and you have section permission:
\nAdds sellPrice * amount to total and clears the stack.
\nDeposits total into your balance.
\nIf nothing could be sold \u2192 \u201cYou have no sellable items.\u201d
\nOtherwise \u2192 shop.item-sold with amount = all, item = items.
\n\/sellall hand
\nFinds the Material in your main hand.
\nThen scans entire inventory and sells all stacks of that same Material (if sell price > 0 & permissions).
\nRemoves all those stacks, deposits total.
\n\/sellall
\nExample:<\/p>\n
\nConverts
\nIf found:
\nScans inventory, selling only that material using its sell price.
\nRemoves those stacks, deposits total.
\nPermissions:<\/p>\n
\nPer section:
\nEconomyShopGUI.sellall.<\/p>\n
\nEconomyShopGUI.sellallhand.<\/p>\n
\nEconomyShopGUI.sellallitem.<\/p>\n
\n1.4 \/sellgui
\ntext<\/p>\n
\nOpens the Sell GUI (size from sell-gui.size, e.g. 54).
\nYou drag\/drop items from your inventory into this GUI.
\nClick behavior:<\/p>\n
\nWhen you close the Sell GUI:<\/p>\n
\nIf item has a shop entry with sell > 0 and your permissions allow selling in that section:
\n\u2192 it\u2019s sold and money is added to total.
\nElse:
\n\u2192 that stack is returned to your inventory (unsellable).
\nSell GUI is cleared.
\nIf total == 0:
\nMessage: sellgui.no-sellable-items.
\nIf total > 0:
\nMoney deposited.
\nMessage: sellgui.sold-items (\u201cYou sold items for $X.\u201d).
\nBig title: You earned $X.
\nPermissions:<\/p>\n
\nEconomyShopGUI.sellgui.* or EconomyShopGUI.sellgui.<\/p>\n
\nIf settings.enable-sell-gui: false \u2192 you get an error.<\/p>\n
\n2.1 \/sreload
\ntext<\/p>\n
\nReloads:
\nconfig.yml
\nsections.yml
\nshops.yml
\nmessages.yml
\nCalls shopManager.loadAll().
\nMessage: admin.reload-complete.
\nPermission: economyshopgui.admin.<\/p>\n
\ntext<\/p>\n
\nShows a help list for all admin subcommands (texts from messages.yml):<\/p>\n
\nopen
\naddsection
\neditsection
\ndeletesection
\nadditem
\naddhanditem
\nedititem
\ndeleteitem
\nsetprice
\nimport (stub)
\nuploadLayout (stub)
\ninstallLayout (stub)
\nshopstands (stub)
\n2.3 \/eshop reload
\nSame as \/sreload \u2013 reloads configs and shop data.<\/p>\n
\nExample:<\/p>\n
\nOpens gear section, page 2, for player Zyroth_YT.
\nUseful for testing or opening a shop for someone else remotely.
\n2.5 \/eshop addsection
\nExample:<\/p>\n
\nCreates a new section with ID potions:
\nTitle = &dPotions
\nSize = 54
\nIcon = Brewing Stand
\nAppears in main \/shop at slot 20
\nPermission = EconomyShopGUI.shop.potions
\nSaves it to sections.yml.
\nThen reloads configs and shops.
\nValid sizes: 9, 18, 27, 36, 45, 54.<\/p>\n
\nExample:<\/p>\n
\nRemoves sections.potions from sections.yml.
\nRemoves shops.potions from shops.yml.
\nReloads configs + shops.
\nMessages whether it existed or not.
\n2.7 \/eshop editsection
\nAllows editing existing section fields.<\/p>\n
\naddworld
\nremoveworld
\nExamples:<\/p>\n
\nSet icon:<\/p>\n
\nSet slot:<\/p>\n
\nSet size:<\/p>\n
\nSet permission:<\/p>\n
\nSet worlds list:<\/p>\n
\nAdd world:<\/p>\n
\nRemove world:<\/p>\n
\nAfter every change, config is saved and reloaded.<\/p>\n
\nExample:<\/p>\n
\nSection must already exist.
\nmaterial is a valid Material name.
\nbuy \/ sell are numbers (>= 0).
\nPlugin finds the first free slot in that section (0..53) and uses it.
\nGenerates an item ID like stone_10 and writes to shops.yml:
\nYAML<\/p>\n
\n blocks:
\n items:
\n stone_10:
\n material: STONE
\n slot: 10
\n buy: 4.0
\n sell: 1.5
\n name: “&fSTONE”
\n lore: []
\nThen reloads configs and shops.<\/p>\n
\nExample:<\/p>\n
\nYou must be holding the item in your main hand.
\nTakes its Material (e.g. IRON_SWORD) and adds it to the section exactly like additem.
\nAgain chooses the first free slot and creates a generated ID.
\n2.10 \/eshop edititem <\/p>\n
\nUsed to change an existing item by its slot index.<\/p>\n
\n\/eshop edititem gear 10 set sell 12
\n\/eshop edititem gear 10 set name “&fBetter Iron Sword”
\nFor lore (multiple lines), use pipe |:<\/p>\n
\nSupported keys:<\/p>\n
\nbuy
\nsell
\nname
\nlore
\nThe plugin finds the item in shops.<\/p>\n
\nExample:<\/p>\n
\nRemoves the item whose .slot == 10 from that section in shops.yml.
\nReloads configs and shop manager.
\n2.12 \/eshop setprice <\/p>\n
\n\/eshop setprice gear 10 sell 20
\nFinds item by slot (index).
\nUpdates either buy or sell.
\nReloads configs + shops.
\n\u201cWorth\u201d and sell commands all start using the new values.
\n2.13 Stub subcommands
\nRight now these only print a message, they\u2019re not fully implemented:<\/p>\n
\n\/eshop uploadLayout \u2013 \u201cLayout upload is not implemented.\u201d
\n\/eshop installLayout
\n\/eshop shopstands … \u2013 \u201cShopStands are not implemented.\u201d
\nThese are placeholders in case you want to later add:<\/p>\n
\nOnline layout marketplace,
\nPhysical shop stands, etc.
\n2.14 \/shopgive <\/p>\n
\nExamples:<\/p>\n
\n\/shopgive end 15 Zyroth_YT # gives to that player
\nFinds the ShopItem in that section at slot index.
\nCreates a 1\u2011stack of that Material, with the shop display name and lore.
\nAdds it to the target player\u2019s inventory.
\nUsed mostly for admins to give items as rewards or testing.<\/p>\n
\n\/shop [section] [page]<\/p>\n
\nNo args \u2192 main menu with all sections.
\n\/shop gear \u2192 opens the GEAR section, page 1.
\n\/shop gear 2 \u2192 opens GEAR, page 2.
\nPermissions:
\nroyaleconomy.shop \u2013 use \/shop.
\nroyaleconomy.shop.section.
\nroyaleconomy.shop.section.* \u2013 access all sections.
\n\/sellhand<\/p>\n
\nPermission:
\nroyaleconomy.sell.hand
\nplus (optional restriction) royaleconomy.sell.hand.section.
\n\/sellall [inventory|hand|
\n\/sellall hand \u2013 sells all stacks of the material in your hand.
\n\/sellall diamond_block \u2013 sells all diamond blocks in your inventory.
\nPermission:
\nroyaleconomy.sell.all \u2013 base permission.
\noptional per\u2011section:
\nroyaleconomy.sell.section.
\nroyaleconomy.sell.hand.section.
\n\/sellgui<\/p>\n
\nShows a big title \u201cYou earned $X\u201d when items are sold.
\nPermission:
\nroyaleconomy.sell.gui \u2013 open SellGUI.
\noptional per\u2011section restriction when closing:
\nroyaleconomy.sell.gui.section.
\nAdmin commands
\n\/sreload<\/p>\n
\nRebuilds all shop data.
\nPermission: royaleconomy.admin.
\n\/eshop help<\/p>\n
\nPermission: royaleconomy.admin.
\n\/eshop reload<\/p>\n
\nPermission: royaleconomy.admin.
\n\/eshop open
\nExample: \/eshop open Steve gear 2.
\nPermission: royaleconomy.admin.
\n\/eshop addsection
\nExample: \/eshop addsection potions 54 BREWING_STAND “&dPotions” 20.
\nPermission: royaleconomy.admin.
\n\/eshop deletesection
\nPermission: royaleconomy.admin.
\n\/eshop editsection
\nExample: \/eshop editsection gear set icon NETHERITE_SWORD.
\nPermission: royaleconomy.admin.
\n\/eshop additem <\/p>\n
\nExample: \/eshop additem blocks STONE 4 1.5.
\nPermission: royaleconomy.admin.
\n\/eshop addhanditem <\/p>\n
\nExample: \/eshop addhanditem gear 25 10.
\nPermission: royaleconomy.admin.
\n\/eshop edititem <\/p>\n
\nExample: \/eshop edititem gear 10 set sell 12.
\nPermission: royaleconomy.admin.
\n\/eshop deleteitem <\/p>\n
\nPermission: royaleconomy.admin.
\n\/eshop setprice <\/p>\n
\nExample: \/eshop setprice gear 10 sell 20.
\nPermission: royaleconomy.admin.
\nStub (not implemented yet):<\/p>\n
\n\/eshop uploadLayout \u2013 no real function yet.
\n\/eshop installLayout
\n\/eshop shopstands … \u2013 no real physical stands yet.
\n\/shopgive <\/p>\n
\nExample: \/shopgive gear 10 Steve.
\nPermission: royaleconomy.admin.<\/p>\n","protected":false},"excerpt":{"rendered":"