RoyalEconomy

插件

· 作者 Zyroth

RoyalEconomy 商店插件,提供更多功能

0 本站下载 0 关注 更新于 10 个月前

需要前置:EssentialsX

最新 1.0.0 · 1.21.11 · Paper / Spigot

一键开服(送7天)

? 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.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 → 你会收到错误提示。
  1. 管理员命令 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。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源