GuardAttackShop
GuardAttackShop 是一款面向 Paper 服务器的可配置 GUI 商店插件。它提供基于 Vault 的传统经济商店,以及一种独立的自定义货币——Guards。
该插件专为希望拥有类似 EconomyShopGUI 风格商店、同时完全掌控价格、货币、分类、特殊奖励和自定义物品的 SMP 和生存服务器而设计。
功能特性
- 基于 GUI 的
/shop
- Vault 经济支持
- 兼容 EssentialsX Economy 及其他支持 Vault 的经济提供商
- 自定义 Guards 货币
- 可配置的购买与出售价格
- 支持以 1、16 或 64 为单位购买物品
- 支持以 1、16 或 64 为单位出售物品
- “全部出售”功能
- 多个可配置的商店分类
- 支持 MONEY 和 GUARDS 两种货币
- 内置管理命令,用于添加和管理商店物品
- 支持附魔物品和自定义物品
- 保留自定义物品名称和描述(Lore)
- 保留自定义物品元数据(Metadata)
- 控制台命令奖励,可用于箱子钥匙、刷怪笼或其他插件奖励
- 支持 PlaceholderAPI
- 无需重启服务器即可重载配置
- Guards 持久化存储
默认分类
默认配置包含以下分类:
- PVP
- End
- Nether
- Blocks
- Food
- Gear
- Guards Shop
分类和商店内容可通过配置文件进行自定义。
双货币系统
Money
常规商店购买使用 Vault 经济系统。
需要安装一个兼容 Vault 的经济提供商。支持 EssentialsX Economy,这也是推荐的设置方案。
Guards
Guards 是 GuardAttackShop 内置的一种自定义货币。
Guards 可用于购买以下特殊商店物品:
商店条目可以使用 MONEY 或 GUARDS 作为货币类型。
游戏内商店管理
操作员可以直接从自己的背包中添加物品。
在主手持有物品并使用以下命令:
/shopadmin add <category> <buy-price> <sell-price> <money|guards>
示例:
/shopadmin add pvp 5000 2500 money
整个物品将被保存,包括附魔和支持的物品元数据。
将售价或买价设置为 -1 将禁用该操作。
示例:
/shopadmin add guards 500 -1 guards
这将创建一个仅可用 500 Guards 购买而无法出售的 Guards 商店物品。
管理命令
| 命令 |
描述 |
/shopadmin add <category> <buy> <sell> <money|guards> |
添加主手中的物品 |
/shopadmin setbuy <id> <price> |
修改购买价格 |
/shopadmin setsell <id> <price> |
修改出售价格 |
/shopadmin setcurrency <id> <money|guards> |
修改货币类型 |
/shopadmin setcommand <id> <command> |
设置控制台奖励命令 |
/shopadmin remove <id> |
移除商店物品 |
/shopadmin list [category] |
列出商店条目 |
/shop reload |
重载商店配置 |
Guards 命令
| 命令 |
描述 |
/guards |
显示你的 Guards 余额 |
/guards balance [player] |
显示指定玩家的 Guards 余额 |
/guards give <player> <amount> |
给予 Guards |
/guards take <player> <amount> |
扣除 Guards |
/guards set <player> <amount> |
设置 Guards 余额 |
管理员 Guards 命令需要相应的权限。
命令奖励
商店物品可以执行控制台命令,而不是直接给予物品。
这使得 GuardAttackShop 非常适合用于其他插件提供的奖励,例如箱子钥匙和自定义刷怪笼。
支持的命令占位符:
%player% — 玩家名称
%amount% — 购买数量
示例:
crate key give %player% vote %amount%
具体命令取决于服务器上安装的箱子或刷怪笼插件。
PlaceholderAPI
PlaceholderAPI 为可选组件。
可用的占位符:
%guardattackshop_guards%
%guardattackshop_guards_formatted%
%guardattackshop_money%
GuardAttackShop 不会创建自己的记分板。这些占位符可由其他记分板、Tab 列表、全息图或聊天插件调用。
权限
| 权限 |
描述 |
默认值 |
guardattackshop.use |
访问 /shop |
所有人 |
guardattackshop.guards |
访问 Guards 余额命令 |
所有人 |
guardattackshop.admin |
商店和 Guards 管理 |
OP |
依赖要求
- Minecraft Java Edition 26.1.2
- Paper 26.1.2
- Java 25 或更高版本
- Vault
- 一个兼容 Vault 的经济提供商,如 EssentialsX Economy
可选依赖
安装步骤
- 使用 Java 25 或更高版本安装 Paper 26.1.2。
- 安装 Vault。
- 安装兼容 Vault 的经济提供商,如 EssentialsX。
- (可选)安装 PlaceholderAPI。
- 将
GuardAttackShop-1.0.0.jar 放入服务器的 plugins 文件夹中。
- 重启服务器。
- 在
plugins/GuardAttackShop/config.yml 中配置商店。
- 在游戏中使用
/shop。
配置
购买价格、出售价格、货币、分类、商店物品、命令奖励以及额外的“全部出售”价格均可通过配置文件进行修改。
商店物品也可以通过游戏内的 /shopadmin 命令进行管理。
兼容性
本版本针对以下环境优化:
- Minecraft 26.1.2
- Paper 26.1.2
- Java 25+
其他服务器实现和 Minecraft 版本未经过测试,本版本不提供官方支持。
GuardAttackShop
GuardAttackShop is a configurable GUI-based shop plugin for Paper servers. It provides a traditional Vault-powered economy shop together with a separate custom currency called Guards.
The plugin is designed for SMP and survival servers that want an EconomyShopGUI-style shop while keeping full control over prices, currencies, categories, special rewards, and custom items.
Features
- GUI-based
/shop
- Vault economy support
- Works with EssentialsX Economy and other Vault-compatible economy providers
- Custom Guards currency
- Configurable buy and sell prices
- Buy items in quantities of 1, 16, or 64
- Sell items in quantities of 1, 16, or 64
- Sell All functionality
- Multiple configurable shop categories
- MONEY and GUARDS currencies
- In-game admin commands for adding and managing shop items
- Support for enchanted and custom items
- Custom item names and lore are preserved
- Custom item metadata is preserved
- Console command rewards for crate keys, spawners, or other plugin rewards
- PlaceholderAPI support
- Config reload without restarting the server
- Guards are stored persistently
Default Categories
The default configuration contains:
- PVP
- End
- Nether
- Blocks
- Food
- Gear
- Guards Shop
Categories and shop contents can be customized through the configuration.
Two Currency Systems
Money
Normal shop purchases use Vault.
A Vault-compatible economy provider is required. EssentialsX Economy is supported and is the recommended setup.
Guards
Guards are a custom currency included with GuardAttackShop.
Guards can be used for special shop items such as:
- Crate keys
- Spawners
- Special rewards
- Server-exclusive items
Shop entries can use either MONEY or GUARDS.
In-Game Shop Management
Operators can add items directly from their inventory.
Hold an item in your main hand and use:
/shopadmin add <category> <buy-price> <sell-price> <money|guards>
Example:
/shopadmin add pvp 5000 2500 money
The complete item is stored, including enchantments and supported item metadata.
A sell price or buy price of -1 disables that action.
Example:
/shopadmin add guards 500 -1 guards
This creates a Guards shop item that can be purchased for 500 Guards but cannot be sold.
Admin Commands
| Command |
Description |
/shopadmin add <category> <buy> <sell> <money|guards> |
Adds the item in your main hand |
/shopadmin setbuy <id> <price> |
Changes the buy price |
/shopadmin setsell <id> <price> |
Changes the sell price |
/shopadmin setcurrency <id> <money|guards> |
Changes the currency |
/shopadmin setcommand <id> <command> |
Sets a console reward command |
/shopadmin remove <id> |
Removes a shop item |
/shopadmin list [category] |
Lists shop entries |
/shop reload |
Reloads the shop configuration |
Guards Commands
| Command |
Description |
/guards |
Shows your Guards balance |
/guards balance [player] |
Shows a Guards balance |
/guards give <player> <amount> |
Gives Guards |
/guards take <player> <amount> |
Removes Guards |
/guards set <player> <amount> |
Sets a Guards balance |
Administrative Guards commands require the admin permission.
Command Rewards
Shop items can execute console commands instead of directly giving an item.
This makes GuardAttackShop suitable for rewards provided by other plugins, such as crate keys and custom spawners.
Supported command placeholders:
%player% — Player name
%amount% — Purchased amount
Example:
crate key give %player% vote %amount%
The exact command depends on the crate or spawner plugin installed on your server.
PlaceholderAPI
PlaceholderAPI is optional.
Available placeholders:
%guardattackshop_guards%
%guardattackshop_guards_formatted%
%guardattackshop_money%
GuardAttackShop does not create its own scoreboard. These placeholders can be used by another scoreboard, tablist, hologram, or chat plugin.
Permissions
| Permission |
Description |
Default |
guardattackshop.use |
Access to /shop |
Everyone |
guardattackshop.guards |
Access to Guards balance commands |
Everyone |
guardattackshop.admin |
Shop and Guards administration |
OP |
Requirements
- Minecraft Java Edition 26.1.2
- Paper 26.1.2
- Java 25 or newer
- Vault
- A Vault-compatible economy provider such as EssentialsX Economy
Optional
Installation
- Install Paper 26.1.2 using Java 25 or newer.
- Install Vault.
- Install a Vault-compatible economy provider such as EssentialsX.
- Optionally install PlaceholderAPI.
- Place
GuardAttackShop-1.0.0.jar inside your server's plugins folder.
- Restart the server.
- Configure the shop in
plugins/GuardAttackShop/config.yml.
- Use
/shop in-game.
Configuration
Buy prices, sell prices, currencies, categories, shop items, command rewards, and additional Sell All prices can be edited through the configuration.
Shop items can also be managed in-game using /shopadmin.
Compatibility
This release targets:
- Minecraft 26.1.2
- Paper 26.1.2
- Java 25+
Other server implementations and Minecraft versions have not been tested and are not officially supported by this release.
评论 0
登录后参与评分
还没有评论,来抢沙发吧