PlayerStatus

PlayerStatus 是适用于 Minecraft 服务器的状态与头衔系统。玩家可以通过游戏内 GUI 浏览、购买并装备自定义状态。已装备的状态会显示在 TAB 列表、聊天、名称标签以及任何支持 PlaceholderAPI 的地方。
该插件完全可配置。每个状态、消息、图标、价格和 GUI 元素均可通过 YAML 文件进行修改,无需触碰代码。

功能特性
- 多页库存 GUI,用于浏览和装备状态
- 通过 Vault 实现经济集成——玩家使用游戏内货币购买状态
- 完整的 PlaceholderAPI 支持,包含多种占位符类型
- TAB 插件集成,可在玩家列表中显示状态
- 支持 LuckPerms,基于权限限制状态使用
- 支持 MiniMessage 格式化,包含渐变、颜色和装饰效果
- 支持 SQLite 和 MySQL 数据库,并使用 HikariCP 连接池
- 所有设置均通过三个简单的 YAML 文件进行配置
- 异步数据库操作与缓存机制,提升性能


命令
| 命令 |
权限节点 |
描述 |
| /status |
playerstatus.use |
打开状态选择 GUI |
| /status list |
playerstatus.use |
在聊天中列出所有可用状态 |
| /status reload |
playerstatus.reload |
重新加载所有配置文件 |
| /status give <player> <status> |
playerstatus.give |
授予某玩家一个状态 |
| /status remove <player> <status> |
playerstatus.remove |
移除某玩家的一个状态 |
| /status reset <player> |
playerstatus.admin |
重置某玩家的所有状态 |
别名:/ps, /playerstatus
占位符
需要 PlaceholderAPI。
| 占位符 |
描述 |
| %playerstatus_current% |
当前装备的状态(含颜色代码) |
| %playerstatus_current_minimessage% |
MiniMessage 格式显示的已装备状态 |
| %playerstatus_raw% |
纯文本形式的已装备状态 |
| %playerstatus_id% |
已装备状态的 ID |
| %playerstatus_count% |
玩家拥有的状态数量 |
| %playerstatus_total% |
服务器上状态的总数 |
| %playerstatus_has_<id>% |
玩家是否拥有指定状态 |
TAB 集成
要在 TAB 中显示状态,请将占位符添加到你的 TAB 配置中:
tabsuffix:
enabled: true
default-value: " %playerstatus_current%"
根据你的设置,你也可以将其用作前缀或用于选项卡列表名称格式化。
经济系统
与任何兼容 Vault 的经济插件开箱即用。每个状态在 statuses.yml 中都有可配置的价格。将价格设置为 0 可使该状态免费获取,或者通过权限进行锁定。
配置
插件会在插件文件夹中创建三个文件:
config.yml — 常规设置:数据库类型、GUI 布局、音效、集成开关、缓存设置。
statuses.yml — 所有状态定义。每个状态都有一个唯一的 ID,并支持显示名称、描述、材质图标、价格、权限、类别、GUI 槽位/页码、自定义模型数据以及等级要求。
状态示例:
statuses:
warrior:
display: '<red>Warrior'
description: 'Fierce fighter of battles'
icon: IRON_SWORD
price: 1000
permission: ''
category: combat
slot: 11
page: 1
custom-model-data: 0
requirements: []
也支持渐变效果:
inferno:
display: '<gradient:#FF4500:#FF8C00>Inferno</gradient>'
messages.yml — 所有插件消息。支持 MiniMessage 格式。
权限
| 权限 |
默认值 |
描述 |
| playerstatus.use |
Everyone |
使用 /status 命令和 GUI |
| playerstatus.admin |
OP |
完全管理访问权限 |
| playerstatus.reload |
OP |
重新加载配置 |
| playerstatus.give |
OP |
向玩家发放状态 |
| playerstatus.remove |
OP |
移除玩家的状态 |
依赖
全部为可选项。该插件可独立运行,但集成各组件后会获得额外功能。
| 插件 |
用途 |
| Vault |
经济系统支持 |
| PlaceholderAPI |
占位符支持 |
| TAB |
TAB 列表集成 |
| LuckPerms |
基于权限的限制 |

兼容性
- Minecraft 1.20.x 至 26.1.2+
- Paper、Purpur、Pufferfish
- Java 25+
PlayerStatus

PlayerStatus is a status and title system for Minecraft servers. Players can browse, purchase, and equip custom statuses through an in-game GUI. Equipped statuses show up in TAB, chat, nametags, and anywhere else through PlaceholderAPI.
The plugin is fully configurable. Every status, message, icon, price, and GUI element can be changed through YAML files without touching the code.

What it does
- Multi-page inventory GUI for browsing and equipping statuses
- Economy integration through Vault — players buy statuses with in-game currency
- Full PlaceholderAPI support with multiple placeholder types
- TAB plugin integration for displaying statuses in the player list
- LuckPerms support for permission-based status restrictions
- MiniMessage formatting with gradients, colors, and decorations
- SQLite and MySQL database support with HikariCP connection pooling
- Everything is configurable through three simple YAML files
- Async database operations and caching for performance


Commands
| Command |
Permission |
Description |
| /status |
playerstatus.use |
Opens the status selection GUI |
| /status list |
playerstatus.use |
Lists all available statuses in chat |
| /status reload |
playerstatus.reload |
Reloads all configuration files |
| /status give <player> <status> |
playerstatus.give |
Grants a status to a player |
| /status remove <player> <status> |
playerstatus.remove |
Revokes a status from a player |
| /status reset <player> |
playerstatus.admin |
Resets all statuses for a player |
Aliases: /ps, /playerstatus
Placeholders
Requires PlaceholderAPI.
| Placeholder |
Description |
| %playerstatus_current% |
Equipped status with color codes |
| %playerstatus_current_minimessage% |
Equipped status in MiniMessage format |
| %playerstatus_raw% |
Equipped status as plain text |
| %playerstatus_id% |
ID of the equipped status |
| %playerstatus_count% |
Number of statuses the player owns |
| %playerstatus_total% |
Total number of statuses on the server |
| %playerstatus_has_<id>% |
Whether the player owns a specific status |
TAB Integration
To display statuses in TAB, add the placeholder to your TAB config:
tabsuffix:
enabled: true
default-value: " %playerstatus_current%"
You can also use it as a prefix or in tablist-name-formatting depending on your setup.
Economy
Works out of the box with any Vault-compatible economy plugin. Each status has a configurable price in statuses.yml. Set the price to 0 to make a status free, or lock it behind a permission instead.
Configuration
The plugin creates three files in the plugin folder:
config.yml — General settings: database type, GUI layout, sound effects, integration toggles, cache settings.
statuses.yml — All status definitions. Each status has a unique ID and supports display name, description, material icon, price, permission, category, GUI slot/page, custom model data, and level requirements.
Example status:
statuses:
warrior:
display: '<red>Warrior'
description: 'Fierce fighter of battles'
icon: IRON_SWORD
price: 1000
permission: ''
category: combat
slot: 11
page: 1
custom-model-data: 0
requirements: []
Gradients are also supported:
inferno:
display: '<gradient:#FF4500:#FF8C00>Inferno</gradient>'
messages.yml — All plugin messages. Supports MiniMessage formatting.
Permissions
| Permission |
Default |
Description |
| playerstatus.use |
Everyone |
Use the /status command and GUI |
| playerstatus.admin |
OP |
Full admin access |
| playerstatus.reload |
OP |
Reload configuration |
| playerstatus.give |
OP |
Give statuses to players |
| playerstatus.remove |
OP |
Remove statuses from players |
Dependencies
All optional. The plugin runs standalone, but gains features with each integration.
| Plugin |
Purpose |
| Vault |
Economy support |
| PlaceholderAPI |
Placeholder support |
| TAB |
TAB list integration |
| LuckPerms |
Permission-based restrictions |

Compatibility
- Minecraft 1.20.x through 26.1.2+
- Paper, Purpur, Pufferfish
- Java 25+
评论 0
登录后参与评分
还没有评论,来抢沙发吧