RoyalEconomy

🛒 RoyalEconomy

Advanced GUI-Based Economy Shop Plugin

RoyalEconomy is a powerful and modern economy shop plugin for Minecraft servers. It provides a clean, intuitive GUI shop system for players and fully in-game management tools for administrators — no server restarts required.

Built for SMP, Survival, and Economy servers, RoyalEconomy focuses on performance, flexibility, and ease of use.

✨ Player Features 🛍 Main Shop (/shop)

Clean 4-row Main Shop GUI

All shop sections displayed in the top row

Fully configurable sections via sections.yml

Dedicated icons for:

Item Prices

Your Balance

Smooth page navigation

Section-based permissions

📦 Section Shop GUI

Paginated section menus (Page X / Y)

Items loaded from shops.yml

Each item automatically shows:

Slot index

Buy price (if enabled)

Sell price (if enabled)

Worth (based on sell price)

Click Actions

Left-click item → Opens Buy GUI

Right-click item → Sells 1 item from inventory

Previous / Next arrows → Page navigation

Back button → Returns to main shop

💰 Sell Commands /sellhand

Sells the entire stack in your main hand

Uses the item’s configured sell price

Automatically deposits money

Sends a clear confirmation message

/sellall [inventory|hand|<material>]

/sellall or /sellall inventory

Sells all sellable items in your inventory

/sellall hand

Sells all stacks of the item in your hand

/sellall diamond_block

Sells only that specific material

Unsellable items are ignored safely.

/sellgui

Opens a dedicated Sell GUI

Drag & drop items freely

Nothing is sold on click

When the GUI is closed:

Sellable items are sold

Unsellable items are returned

Shows a big title:

You earned $X

🛠 Admin Features

RoyalEconomy can be managed entirely in-game.

🔧 Reloading /sreload /eshop reload

Reloads:

config.yml

sections.yml

shops.yml

messages.yml

🗂 Section Management /eshop addsection <id> <size> <material> <displayname> <slot> /eshop editsection <id> <set|addworld|removeworld> <key> <value> /eshop deletesection <id>

Admins can:

Create new sections

Change titles, icons, slots, permissions

Limit sections to specific worlds

Remove sections safely

📦 Item Management /eshop additem

<material> <buy> <sell> /eshop addhanditem

<buy> <sell> /eshop edititem

<index> set <key> <value> /eshop deleteitem

<index> /eshop setprice

<index> <buy|sell> <price>

Add items by material or directly from hand

Edit name, lore, material, buy & sell prices

Items are identified by slot index

Changes apply instantly

🎁 Utility /shopgive

<index> [player]

Gives an exact shop item (with name & lore)

Useful for testing or rewards

🧪 Testing / Remote Open /eshop open <player>

[page]

Opens a shop section for another player

Useful for testing layouts or support

🔐 Permissions Player Permissions royaleconomy.shop royaleconomy.shop.section.<id> royaleconomy.shop.section.*

royaleconomy.sell.hand royaleconomy.sell.all royaleconomy.sell.gui

royaleconomy.sell.section.<id> royaleconomy.sell.section.* royaleconomy.sell.hand.section.<id> royaleconomy.sell.item.section.<id> royaleconomy.sell.gui.section.<id> royaleconomy.sell.gui.section.*

Admin Permission royaleconomy.admin

Grants access to all admin commands.

🔌 Dependencies

Required:

Vault

Compatible with:

EssentialsX

Any Vault-supported economy plugin

🚀 Performance & Stability

Lightweight and optimized

No async abuse

No unnecessary background tasks

Stable 20 TPS

Safe economy handling (no dupes)

📦 Compatibility

Minecraft 1.20.x – 1.21.x

Tested on:

Paper

Spigot

Purpur

🧩 Future Features (Planned)

Price importing

Layout system

Physical shop stands

Online layouts

Expanded sell logic

✅ Why RoyalEconomy?

✔ Fully in-game management ✔ Clean & modern GUI ✔ Section-based permissions ✔ Vault compatible ✔ Marketplace-ready