? RoyalEconomy
基于高级图形用户界面的经济商店插件
RoyalEconomy 是一款功能强大且现代化的 Minecraft 服务器经济商店插件。
它为玩家提供简洁直观的 GUI 商店系统,并为管理员提供完全在游戏中的管理工具——无需重启服务器。
专为 SMP、生存服和经济服设计,RoyalEconomy 注重性能、灵活性和易用性。
✨ 玩家功能
? 主商店 (/shop)
整洁的 4 行主商店 GUI
所有商店分区显示在第一行
通过 sections.yml 完全可配置的分区
专用图标用于:
物品价格
你的余额
平滑的分页导航
基于分区的权限控制
? 分区商店 GUI
分页分区菜单(第 X / Y 页)
从 shops.yml 加载物品
每个物品自动显示:
槽位索引
购买价格(如果启用)
出售价格(如果启用)
价值(基于出售价格)
点击操作
左键点击物品 → 打开购买 GUI
右键点击物品 → 从背包中卖出 1 个物品
上一页/下一页箭头 → 分页导航
返回按钮 → 回到主商店
? 出售命令
/sellhand
出售主手中的一整组物品
使用物品配置好的出售价格
自动存入金钱
发送清晰的确认消息
/sellall [inventory|hand|<material>]
/sellall 或 /sellall inventory
出售背包中所有可出售的物品
/sellall hand
出售手中该物品的所有组
/sellall diamond_block
仅出售特定材质的物品
安全忽略不可出售的物品。
/sellgui
打开专用的出售 GUI
自由拖放物品
点击不会立即出售
当 GUI 关闭时:
可出售的物品将被出售
不可出售的物品将返还
显示大号标题:
你获得了 $X
? 管理员功能
RoyalEconomy 可以完全在游戏中进行管理。
? 重载
/sreload
/eshop reload
重载以下内容:
config.yml
sections.yml
shops.yml
messages.yml
? 分区管理
/eshop addsection <id> <size> <material> <displayname>
/eshop editsection <id> <set|addworld|removeworld> <key> <value>
/eshop deletesection <id>
管理员可以:
创建新分区
更改标题、图标、槽位、权限
限制分区至特定世界
安全移除分区
? 物品管理
/eshop additem
<material> <buy> <sell>
/eshop addhanditem <buy> <sell>
/eshop edititem <index> set <key> <value>
/eshop deleteitem <index>
/eshop setprice <index> <buy|sell> <price>
按材质或直接手持添加物品
编辑名称、描述、材质、购买和出售价格
物品通过槽位索引识别
更改即时生效
? 实用工具
/shopgive
<index> [player]
给予确切的商店物品(包含名称和描述)
适用于测试或奖励
? 测试 / 远程打开
/eshop open <player>
[page]
为其他玩家打开一个商店分区
适用于测试布局或提供支持
? 权限
玩家权限
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.*
管理员权限
royaleconomy.admin
授予所有管理员命令的访问权限。
? 依赖项
必需:
Vault
兼容:
EssentialsX
任何支持 Vault 的经济插件
? 性能与稳定性
轻量级且经过优化
无异步滥用
无不必要的后台任务
稳定 20 TPS
安全的经济处理(防止重复生成)
? 兼容性
Minecraft 1.20.x – 1.21.x
已测试于:
Paper
Spigot
Purpur
? 未来功能(计划中)
价格导入
布局系统
实体商店摊位
在线布局
扩展的销售逻辑
✅ 为什么选择 RoyalEconomy?
✔ 完全在游戏内管理
✔ 简洁现代的 GUI
✔ 基于分区的权限控制
✔ 兼容 Vault
✔ 面向市场就绪
带详细信息的命令用法
- 玩家命令
1.1 /shop [分区] [页码]
不带参数时:
text
/shop
打开主商店 GUI(4 行,“SHOP”标题)。
第一行:你的分区(BLOCKS、END、NETHER、GEAR、SPAWNER、SHARD SHOP、POINTS SHOP、FOOD 等),基于 sections.yml。
额外图标:
ITEM PRICES(书本)– 来自 shop-main.itemprices-slot 的槽位。
你的余额(玩家头颅)– 来自 shop-main.balance-slot 的槽位。
在主商店 GUI 中的点击操作:
点击区块图标 → 打开该区块的第 1 页。
点击 ITEM PRICES → 打开“物品价格”图形用户界面 (GUI)。
点击 Your Balance → 无特殊功能(仅显示)。
带区块名称时:
text
/shop gear
直接打开装备区块,第 1 页。
带区块 + 页码时:
text
/shop gear 2
打开装备区块,第 2 页(如果存在)。
在区块 GUI 内("SHOP – GEAR (Page X/Y)")
顶部行:来自 shops.yml 的商店物品。
描述信息始终显示:
索引:<槽位>
价值:$<出售价格>(仅在出售价格 > 0 时显示)
购买:$X(如果购买价格 > 0)
出售:$Y(如果出售价格 > 0)
底部行(导航栏):
左侧槽位:上一页箭头(如果当前页码 > 1)。
中间槽位:返回商店(书本图标)——返回主 /shop 页面。
右侧槽位:下一页箭头(如果存在更多页面)。
在界面 GUI 中的点击操作:
左键点击任意物品:打开该物品的购买界面。
右键点击任意物品:根据售价从你的库存中出售 1 个该物品。
左键点击“上一页”箭头:返回上一页。
左键点击“下一页”箭头:进入下一页。
左键点击“返回商店”:回到主 /shop 界面。
权限:
economyshopgui.shop – 用于使用 /shop 命令。
EconomyShopGUI.shop.
或 EconomyShopGUI.shop.* – 用于查看特定分类。
1.2 /sellhand
文本
/sellhand
将主手物品售出。
在商店物品中查找该材质:
如果存在可出售的物品且 sell > 0,则可以出售。
出售手中的整组物品:
将其从主手中移除。
存入 sellPrice * amount 的金额。
使用 shop.item-sold 发送消息:
“你以 $PRICE 的价格售出了 Xx ITEM。”
权限(生效):
economyshopgui.sellhand
另外可选的区块级别:
EconomyShopGUI.sellallhand.
或 EconomyShopGUI.sellallhand.*
1.3 /sellall [inventory|hand|<material>]
基础命令:
文本
/sellall
与以下命令相同:
text
/sellall inventory
/sellall 或 /sellall inventory
扫描你的整个物品栏(不包括护甲)。
对于每个物品组:
如果该材质在商店中且售价 > 0,并且你拥有对应分区的权限:
将 sellPrice * amount 加入总金额并清空该物品组。
将总金额存入你的余额。
如果没有任何物品可出售 → “You have no sellable items.”
否则 → 触发 shop.item-sold 事件,amount = all,item = items。
/sellall hand
查找你主手中持有的材质。
然后扫描整个物品栏,并出售所有相同材质的物品组(前提是售价 > 0 且拥有相应权限)。
移除所有这些物品组,并将总金额存入余额。
/sellall <material>
示例:
text
/sellall diamond_block
将 <material> 转换为对应的 Material 类型。
如果找到:
扫描物品栏,仅使用该材质的售价进行出售。
移除这些物品组,并将总金额存入余额。
权限:
基础权限:economyshopgui.sellall 或 EconomyShopGUI.sellall.*。
按分区权限:
EconomyShopGUI.sellall.
– 物品栏模式。
EconomyShopGUI.sellallhand. – 手持模式。
EconomyShopGUI.sellallitem. – /sellall <material> 模式。
1.4 /sellgui
text
/sellgui
打开出售 GUI(大小由 sell-gui.size 设定,例如 54)。
你可以从物品栏中将物品拖放到此 GUI 中。
点击行为:
点击时不会立即出售。你可以自由移动物品。
当你关闭出售 GUI 时:
插件会读取每一个槽位:
如果物品在商店中有条目且售价 > 0,并且你的权限允许在该分区出售:
→ 该物品会被出售,钱款会计入总金额。
否则:
→ 该物品组会返回到你的物品栏中(不可出售)。
清空出售 GUI。
如果 total == 0:
发送消息:sellgui.no-sellable-items。
如果 total > 0:
存入钱款。
发送消息:sellgui.sold-items (“You sold items for $X.”)。
大字标题显示:You earned $X。
权限:
economyshopgui.sellgui 或
EconomyShopGUI.sellgui.* 或 EconomyShopGUI.sellgui.
(针对特定分区)。
如果 settings.enable-sell-gui: false → 你会收到错误提示。
- 管理员命令
2.1 /sreload
text
/sreload
重载:
config.yml
sections.yml
shops.yml
messages.yml
调用 shopManager.loadAll()。
发送消息:admin.reload-complete。
权限:economyshopgui.admin。
(等同于 /eshop reload。)
2.2 /eshop help
text
/eshop help
显示所有管理员子命令的帮助列表(文本来自 messages.yml):
reload
open
addsection
editsection
deletesection
additem
addhanditem
edititem
deleteitem
setprice
import (存根)
uploadLayout (存根)
installLayout (存根)
shopstands (存根)
2.3 /eshop reload
与 /sreload 相同——重载配置文件和商店数据。
2.4 /eshop open <player>
[page]
示例:
text
/eshop open Zyroth_YT gear 2
为玩家 Zyroth_YT 打开 gear 分区的第 2 页。
可用于测试或远程为其他人打开商店。
2.5 /eshop addsection <id> <size> <material> <displayname>
示例:
text
/eshop addsection potions 54 BREWING_STAND "&dPotions" 20
创建一个 ID 为 potions 的新分区:
标题 = &dPotions
大小 = 54
图标 = Brewing Stand
在主 /shop 中出现在第 20 个槽位
权限 = EconomyShopGUI.shop.potions
将其保存到 sections.yml。
然后重载配置和商店。
有效的大小值:9, 18, 27, 36, 45, 54。
2.6 /eshop deletesection <id>
示例:
text
/eshop deletesection potions
从 sections.yml 中移除 sections.potions。
从 shops.yml 中移除 shops.potions。
重载配置和商店。
无论分区是否存在都会发送相应消息。
2.7 /eshop editsection <id> <action> <key> <value>
允许编辑现有分区的字段。
action 可以是:
set
addworld
removeworld
示例:
设置标题:
text
/eshop editsection gear set title "&b&lGEAR"
设置图标:
text
/eshop editsection gear set icon NETHERITE_SWORD
设置槽位:
text
/eshop editsection gear set slot 13
设置大小:
text
/eshop editsection gear set size 54
设置权限:
text
/eshop editsection gear set permission EconomyShopGUI.shop.gear
设置世界列表:
text
/eshop editsection gear set worlds world,world_nether
添加世界:
text
/eshop editsection gear addworld world_the_end
移除世界:
text
/eshop editsection gear removeworld world_nether
每次更改后,配置文件会被保存并重新加载。
2.8 /eshop additem
<material> <buy> <sell>
示例:
text
/eshop additem blocks STONE 4 1.5
分区必须已经存在。
material 必须是有效的 Material 名称。
buy / sell 是数字(>= 0)。
插件会在该分区中找到第一个空闲槽位(0..53)并使用它。
生成一个类似 stone_10 的物品 ID 并写入 shops.yml:
YAML
shops:
blocks:
items:
stone_10:
material: STONE
slot: 10
buy: 4.0
sell: 1.5
name: "&fSTONE"
lore: []
然后重载配置和商店。
2.9 /eshop addhanditem
<buy> <sell>
示例:
text
/eshop addhanditem gear 25 10
你必须手持该物品。
获取其材质(例如 IRON_SWORD)并按与 additem 完全相同的方式添加到分区中。
同样选择第一个空闲槽位并创建生成的 ID。
2.10 /eshop edititem
<index> set <key> <value>
用于通过槽位索引更改现有物品。
示例:
text
/eshop edititem gear 10 set buy 30
/eshop edititem gear 10 set sell 12
/eshop edititem gear 10 set name "&fBetter Iron Sword"
对于描述(多行),使用管道符 |:
text
/eshop edititem gear 10 set lore "&7This is line 1|&7This is line 2"
支持的键:
material
buy
sell
name
lore
插件会在 shops.
.items.* 中找到 .slot == index 的物品,然后编辑该节点。
2.11 /eshop deleteitem
<index>
示例:
text
/eshop deleteitem gear 10
从 shops.yml 的该分区中移除 .slot == 10 的物品。
重载配置和商店管理器。
2.12 /eshop setprice
<index> <buy|sell> <price>
快速更改价格:
text
/eshop setprice gear 10 buy 50
/eshop setprice gear 10 sell 20
通过槽位(索引)查找物品。
更新 buy 或 sell。
重载配置和商店。
“Worth” 和出售命令都将开始使用新值。
2.13 存根子命令
目前这些命令仅打印一条消息,尚未完全实现:
/eshop import <plugin> <file> – “导入功能尚未实现。”
/eshop uploadLayout – “布局上传功能尚未实现。”
/eshop installLayout <id> – “布局安装功能尚未实现。”
/eshop shopstands ... – “ShopStands 功能尚未实现。”
这些是占位符,以便您日后添加以下功能:
从 Essentials worth.yml 导入价格、
在线布局市场、
实体商店摊位等。
2.14 /shopgive
<index> [player]
示例:
text
/shopgive gear 10 # 给自己发放物品
/shopgive end 15 Zyroth_YT # 给指定玩家发放物品
查找该部分中位于索引槽位的 ShopItem。
创建一个包含该 Material 的 1 组(stack),并带有商店显示名称和描述文本(lore)。
将其添加到目标玩家的背包中。
主要用于管理员作为奖励或测试用途发放物品。
以下是供您参考的一些简要说明
玩家命令
/shop [section] [page]
打开主商店 GUI 或特定部分。
无参数 → 打开包含所有部分的菜单主界面。
/shop gear → 打开 GEAR 部分,第 1 页。
/shop gear 2 → 打开 GEAR,第 2 页。
权限:
royaleconomy.shop – 使用 /shop。
royaleconomy.shop.section.<id> – 访问特定部分。
royaleconomy.shop.section.* – 访问所有部分。
/sellhand
使用主手中物品的商店卖出价格出售整组物品。
权限:
royaleconomy.sell.hand
以及(可选限制) royaleconomy.sell.hand.section.<id> 或 royaleconomy.sell.hand.section.*。
/sellall [inventory|hand|<material>]
/sellall 或 /sellall inventory – 出售背包中所有可出售的物品。
/sellall hand – 出售手中该材料的所有堆叠。
/sellall diamond_block – 出售背包中所有的钻石块。
权限:
royaleconomy.sell.all – 基础权限。
可选按部分限制:
royaleconomy.sell.section.<id> 或 royaleconomy.sell.section.*
royaleconomy.sell.hand.section.<id> / royaleconomy.sell.item.section.<id> 等。
/sellgui
打开卖出 GUI。将物品放入其中;关闭 GUI 时,所有可出售的物品会自动出售,不可出售的物品会退还。
当物品售出时,会显示大标题“您赚取了 $X”。
权限:
royaleconomy.sell.gui – 打开 SellGUI。
关闭时的可选按部分限制:
royaleconomy.sell.gui.section.<id> / royaleconomy.sell.gui.section.*。
管理员命令
/sreload
重新加载 config.yml、sections.yml、shops.yml 和 messages.yml。
重建所有商店数据。
权限:royaleconomy.admin。
/eshop help
列出所有 /eshop 子命令及其简短说明。
权限:royaleconomy.admin。
/eshop reload
与 /sreload 相同。
权限:royaleconomy.admin。
/eshop open <player>
[page]
为其他玩家打开商店的特定部分/页面。
示例:/eshop open Steve gear 2。
权限:royaleconomy.admin。
/eshop addsection <id> <size> <material> <displayname>
创建新部分并将其写入 sections.yml。
示例:/eshop addsection potions 54 BREWING_STAND "&dPotions" 20。
权限:royaleconomy.admin。
/eshop deletesection <id>
从 sections.yml 中移除该部分,并从 shops.yml 中移除其物品。
权限:royaleconomy.admin。
/eshop editsection <id> <set|addworld|removeworld> <key> <value>
更改部分设置(标题、大小、图标、槽位、权限、世界)。
示例:/eshop editsection gear set icon NETHERITE_SWORD。
权限:royaleconomy.admin。
/eshop additem
<material> <buy> <sell>
使用 Material 名称向部分中添加新物品。
示例:/eshop additem blocks STONE 4 1.5。
权限:royaleconomy.admin。
/eshop addhanditem
<buy> <sell>
使用手中的物品向部分中添加新物品。
示例:/eshop addhanditem gear 25 10。
权限:royaleconomy.admin。
/eshop edititem
<index> set <key> <value>
通过槽位索引编辑物品:材料、买入价、卖出价、名称、描述文本。
示例:/eshop edititem gear 10 set sell 12。
权限:royaleconomy.admin。
/eshop deleteitem
<index>
通过槽位索引从部分中删除物品。
权限:royaleconomy.admin。
/eshop setprice
<index> <buy|sell> <price>
快速修改仅买入或卖出价格的方法。
示例:/eshop setprice gear 10 sell 20。
权限:royaleconomy.admin。
存根(尚未实现):
/eshop import <plugin> <file> – 本应导入物品价格,目前仅打印一条消息。
/eshop uploadLayout – 尚无实际功能。
/eshop installLayout <layoutId> – 尚无实际功能。
/eshop shopstands ... – 尚无实际的物理摊位。
/shopgive
<index> [player]
向玩家发放 1x 商店物品(包括名称和描述文本)。
示例:/shopgive gear 10 Steve。
权限:royaleconomy.admin。
? 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>
/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
COMMANDS USAGE WITH DETAIL
- Player commands
1.1 /shop [section] [page]
Without arguments:
text
/shop
Opens main shop GUI (4 rows, “SHOP” title).
Top row: your sections (BLOCKS, END, NETHER, GEAR, SPAWNER, SHARD SHOP, POINTS SHOP, FOOD, etc.) based on sections.yml.
Extra icons:
ITEM PRICES (book) – slot from shop-main.itemprices-slot.
Your Balance (player head) – slot from shop-main.balance-slot.
Click actions in main shop GUI:
Click on a section icon → opens that section at page 1.
Click on ITEM PRICES → opens the “Item Prices” GUI.
Click on Your Balance → nothing special (just a display).
With section name:
text
/shop gear
Directly opens gear section, page 1.
With section + page:
text
/shop gear 2
Opens gear section, page 2 (if it exists).
Inside a section GUI ("SHOP – GEAR (Page X/Y)")
Top rows: shop items from shops.yml.
Lore always shows:
Index:
Worth: $<sell price> (only if sell price > 0)
Buy: $X (if buy > 0)
Sell: $Y (if sell > 0)
Bottom row (navigation):
Left slot: Previous Page arrow (if page > 1).
Middle slot: Back to Shop (book) – returns to main /shop.
Right slot: Next Page arrow (if more pages exist).
Clicks in the section GUI:
Left‑click any item: opens Buy GUI for that item.
Right‑click any item: sells 1 of that item from your inventory using its sell price.
Left‑click Previous Page arrow: go to previous page.
Left‑click Next Page arrow: go to next page.
Left‑click Back to Shop: go back to main /shop GUI.
Permissions:
economyshopgui.shop – to use /shop.
EconomyShopGUI.shop.
or EconomyShopGUI.shop.* – to view specific sections.
1.2 /sellhand
text
/sellhand
Takes the item in your main hand.
Looks up that Material in shop items:
If an item exists and sell > 0, it can be sold.
Sells the entire stack in your hand:
Removes it from main hand.
Deposits sellPrice * amount.
Sends message using shop.item-sold:
“You sold Xx ITEM for $PRICE.”
Permissions (effective):
economyshopgui.sellhand
plus optional section level:
EconomyShopGUI.sellallhand.
or EconomyShopGUI.sellallhand.*
1.3 /sellall [inventory|hand|<material>]
Base command:
text
/sellall
Same as:
text
/sellall inventory
/sellall or /sellall inventory
Scans your whole inventory (not armor).
For each stack:
If that Material is in the shop and has sell > 0, and you have section permission:
Adds sellPrice * amount to total and clears the stack.
Deposits total into your balance.
If nothing could be sold → “You have no sellable items.”
Otherwise → shop.item-sold with amount = all, item = items.
/sellall hand
Finds the Material in your main hand.
Then scans entire inventory and sells all stacks of that same Material (if sell price > 0 & permissions).
Removes all those stacks, deposits total.
/sellall <material>
Example:
text
/sellall diamond_block
Converts <material> to a Material.
If found:
Scans inventory, selling only that material using its sell price.
Removes those stacks, deposits total.
Permissions:
Base: economyshopgui.sellall or EconomyShopGUI.sellall.*.
Per section:
EconomyShopGUI.sellall.
– inventory mode.
EconomyShopGUI.sellallhand. – hand mode.
EconomyShopGUI.sellallitem. – /sellall <material> mode.
1.4 /sellgui
text
/sellgui
Opens the Sell GUI (size from sell-gui.size, e.g. 54).
You drag/drop items from your inventory into this GUI.
Click behavior:
Nothing is sold on click. You can freely move items.
When you close the Sell GUI:
Plugin reads every slot:
If item has a shop entry with sell > 0 and your permissions allow selling in that section:
→ it’s sold and money is added to total.
Else:
→ that stack is returned to your inventory (unsellable).
Sell GUI is cleared.
If total == 0:
Message: sellgui.no-sellable-items.
If total > 0:
Money deposited.
Message: sellgui.sold-items (“You sold items for $X.”).
Big title: You earned $X.
Permissions:
economyshopgui.sellgui or
EconomyShopGUI.sellgui.* or EconomyShopGUI.sellgui.
for specific sections.
If settings.enable-sell-gui: false → you get an error.
- Admin commands
2.1 /sreload
text
/sreload
Reloads:
config.yml
sections.yml
shops.yml
messages.yml
Calls shopManager.loadAll().
Message: admin.reload-complete.
Permission: economyshopgui.admin.
(Equivalent to /eshop reload.)
2.2 /eshop help
text
/eshop help
Shows a help list for all admin subcommands (texts from messages.yml):
reload
open
addsection
editsection
deletesection
additem
addhanditem
edititem
deleteitem
setprice
import (stub)
uploadLayout (stub)
installLayout (stub)
shopstands (stub)
2.3 /eshop reload
Same as /sreload – reloads configs and shop data.
2.4 /eshop open <player>
[page]
Example:
text
/eshop open Zyroth_YT gear 2
Opens gear section, page 2, for player Zyroth_YT.
Useful for testing or opening a shop for someone else remotely.
2.5 /eshop addsection <id> <size> <material> <displayname>
Example:
text
/eshop addsection potions 54 BREWING_STAND "&dPotions" 20
Creates a new section with ID potions:
Title = &dPotions
Size = 54
Icon = Brewing Stand
Appears in main /shop at slot 20
Permission = EconomyShopGUI.shop.potions
Saves it to sections.yml.
Then reloads configs and shops.
Valid sizes: 9, 18, 27, 36, 45, 54.
2.6 /eshop deletesection <id>
Example:
text
/eshop deletesection potions
Removes sections.potions from sections.yml.
Removes shops.potions from shops.yml.
Reloads configs + shops.
Messages whether it existed or not.
2.7 /eshop editsection <id> <action> <key> <value>
Allows editing existing section fields.
action can be:
set
addworld
removeworld
Examples:
Set title:
text
/eshop editsection gear set title "&b&lGEAR"
Set icon:
text
/eshop editsection gear set icon NETHERITE_SWORD
Set slot:
text
/eshop editsection gear set slot 13
Set size:
text
/eshop editsection gear set size 54
Set permission:
text
/eshop editsection gear set permission EconomyShopGUI.shop.gear
Set worlds list:
text
/eshop editsection gear set worlds world,world_nether
Add world:
text
/eshop editsection gear addworld world_the_end
Remove world:
text
/eshop editsection gear removeworld world_nether
After every change, config is saved and reloaded.
2.8 /eshop additem
<material> <buy> <sell>
Example:
text
/eshop additem blocks STONE 4 1.5
Section must already exist.
material is a valid Material name.
buy / sell are numbers (>= 0).
Plugin finds the first free slot in that section (0..53) and uses it.
Generates an item ID like stone_10 and writes to shops.yml:
YAML
shops:
blocks:
items:
stone_10:
material: STONE
slot: 10
buy: 4.0
sell: 1.5
name: "&fSTONE"
lore: []
Then reloads configs and shops.
2.9 /eshop addhanditem
<buy> <sell>
Example:
text
/eshop addhanditem gear 25 10
You must be holding the item in your main hand.
Takes its Material (e.g. IRON_SWORD) and adds it to the section exactly like additem.
Again chooses the first free slot and creates a generated ID.
2.10 /eshop edititem
<index> set <key> <value>
Used to change an existing item by its slot index.
Example:
text
/eshop edititem gear 10 set buy 30
/eshop edititem gear 10 set sell 12
/eshop edititem gear 10 set name "&fBetter Iron Sword"
For lore (multiple lines), use pipe |:
text
/eshop edititem gear 10 set lore "&7This is line 1|&7This is line 2"
Supported keys:
material
buy
sell
name
lore
The plugin finds the item in shops.
.items.* whose .slot == index, then edits that node.
2.11 /eshop deleteitem
<index>
Example:
text
/eshop deleteitem gear 10
Removes the item whose .slot == 10 from that section in shops.yml.
Reloads configs and shop manager.
2.12 /eshop setprice
<index> <buy|sell> <price>
Quick price change:
text
/eshop setprice gear 10 buy 50
/eshop setprice gear 10 sell 20
Finds item by slot (index).
Updates either buy or sell.
Reloads configs + shops.
“Worth” and sell commands all start using the new values.
2.13 Stub subcommands
Right now these only print a message, they’re not fully implemented:
/eshop import <plugin> <file> – “Import feature is not implemented.”
/eshop uploadLayout – “Layout upload is not implemented.”
/eshop installLayout <id> – “Layout install is not implemented.”
/eshop shopstands ... – “ShopStands are not implemented.”
These are placeholders in case you want to later add:
Price importing from Essentials worth.yml,
Online layout marketplace,
Physical shop stands, etc.
2.14 /shopgive
<index> [player]
Examples:
text
/shopgive gear 10 # gives to yourself
/shopgive end 15 Zyroth_YT # gives to that player
Finds the ShopItem in that section at slot index.
Creates a 1‑stack of that Material, with the shop display name and lore.
Adds it to the target player’s inventory.
Used mostly for admins to give items as rewards or testing.
AND THESE ARE SOME SHORT DETAILS FOR YOU
Player commands
/shop [section] [page]
Opens the main shop GUI or a specific section.
No args → main menu with all sections.
/shop gear → opens the GEAR section, page 1.
/shop gear 2 → opens GEAR, page 2.
Permissions:
royaleconomy.shop – use /shop.
royaleconomy.shop.section.<id> – access a specific section.
royaleconomy.shop.section.* – access all sections.
/sellhand
Sells the entire stack in your main hand using its shop sell price.
Permission:
royaleconomy.sell.hand
plus (optional restriction) royaleconomy.sell.hand.section.<id> or royaleconomy.sell.hand.section.*.
/sellall [inventory|hand|<material>]
/sellall or /sellall inventory – sells all sellable items in your inventory.
/sellall hand – sells all stacks of the material in your hand.
/sellall diamond_block – sells all diamond blocks in your inventory.
Permission:
royaleconomy.sell.all – base permission.
optional per‑section:
royaleconomy.sell.section.<id> or royaleconomy.sell.section.*
royaleconomy.sell.hand.section.<id> / royaleconomy.sell.item.section.<id> etc.
/sellgui
Opens the Sell GUI. Put items inside; when you close the GUI, all sellable items are sold automatically and unsellable ones are returned.
Shows a big title “You earned $X” when items are sold.
Permission:
royaleconomy.sell.gui – open SellGUI.
optional per‑section restriction when closing:
royaleconomy.sell.gui.section.<id> / royaleconomy.sell.gui.section.*.
Admin commands
/sreload
Reloads config.yml, sections.yml, shops.yml, and messages.yml.
Rebuilds all shop data.
Permission: royaleconomy.admin.
/eshop help
Shows a list of all /eshop subcommands and a short description.
Permission: royaleconomy.admin.
/eshop reload
Same as /sreload.
Permission: royaleconomy.admin.
/eshop open <player>
[page]
Opens a specific section/page of the shop for another player.
Example: /eshop open Steve gear 2.
Permission: royaleconomy.admin.
/eshop addsection <id> <size> <material> <displayname>
Creates a new section and writes it to sections.yml.
Example: /eshop addsection potions 54 BREWING_STAND "&dPotions" 20.
Permission: royaleconomy.admin.
/eshop deletesection <id>
Removes the section from sections.yml and its items from shops.yml.
Permission: royaleconomy.admin.
/eshop editsection <id> <set|addworld|removeworld> <key> <value>
Changes section settings (title, size, icon, slot, permission, worlds).
Example: /eshop editsection gear set icon NETHERITE_SWORD.
Permission: royaleconomy.admin.
/eshop additem
<material> <buy> <sell>
Adds a new item to a section using a Material name.
Example: /eshop additem blocks STONE 4 1.5.
Permission: royaleconomy.admin.
/eshop addhanditem
<buy> <sell>
Adds a new item to a section using the item in your hand.
Example: /eshop addhanditem gear 25 10.
Permission: royaleconomy.admin.
/eshop edititem
<index> set <key> <value>
Edits an item by slot index: material, buy, sell, name, lore.
Example: /eshop edititem gear 10 set sell 12.
Permission: royaleconomy.admin.
/eshop deleteitem
<index>
Deletes an item from a section by its slot index.
Permission: royaleconomy.admin.
/eshop setprice
<index> <buy|sell> <price>
Quick way to change just the buy or sell price.
Example: /eshop setprice gear 10 sell 20.
Permission: royaleconomy.admin.
Stub (not implemented yet):
/eshop import <plugin> <file> – would import item prices, currently prints a message.
/eshop uploadLayout – no real function yet.
/eshop installLayout <layoutId> – no real function yet.
/eshop shopstands ... – no real physical stands yet.
/shopgive
<index> [player]
Gives 1x of a shop item (including name and lore) to a player.
Example: /shopgive gear 10 Steve.
Permission: royaleconomy.admin.
评论 0
登录后参与评分
还没有评论,来抢沙发吧