?️ ApoTags

适用于 Paper 服务器的完整 RGB 标签管理器。
为玩家提供色彩绚丽的前缀标签——支持完整的 GUI、PlaceholderAPI,且无需编辑任何文件。
✨ 功能特性
- ? 完整的 RGB / HEX 颜色支持 — 在任何地方使用
&#RRGGBB 十六进制代码和传统的 & 代码
- ?️ 分页玩家 GUI — 通过清晰的库存菜单浏览和装备标签
- ?️ 管理员 GUI — 在游戏中管理所有标签,通过 Shift+点击 切换启用/禁用状态
- ? H2 嵌入式数据库 或 FlatFile 存储 — 无需配置外部数据库
- ? PlaceholderAPI — 在聊天、Tab 列表、计分板等位置显示活跃标签
- ? 多语言支持 — 内置英文和西班牙文,轻松添加任意语言
- ⚙️ 完全可定制的 GUI — 独立的
gui_user.yml 和 gui_admin.yml 配置文件
- ? 细粒度权限控制 — 每个子命令对应一个权限节点,实现最大程度的控制
- ? 热重载 — 应用任何配置或标签更改而无需重启服务器
- ?️ 多行标签描述 — 在 GUI 中为每个标签添加丰富的描述信息
- ? 无硬编码文本 — 所有面向玩家的消息均位于语言文件中
? 依赖要求
| 依赖项 |
类型 |
版本 |
| Paper |
必需 |
1.19.4 |
| Java |
必需 |
17+ |
| PlaceholderAPI |
可选 |
2.11.6+ |
? 安装步骤
- 下载
ApoTags.jar 并将其放入 /plugins/ 文件夹
- 启动或重启你的服务器
- 首次启动时会自动生成所有配置文件
- 如果希望在聊天或 Tab 列表中显示标签,请安装 PlaceholderAPI
? 默认配置
config.yml
# ─────────────────────────────────────────────
# ApoTags Configuration
# Authors: ApoloCR & ApoStudios
# Version: 1.0.0
# ─────────────────────────────────────────────
# Plugin locale: en / es
locale: 'en'
# Storage type: H2 / FLATFILE
storage: 'H2'
# GUI Settings
gui_settings:
title: 'ApoTags - Select your Tag'
rows: 6
# Items for GUI navigation (Material names)
next_page_item: 'ARROW'
previous_page_item: 'ARROW'
reset_tag_item: 'BARRIER'
# Slot positions in row 6 (0-indexed from row start = slot 45)
# Row 6: slots 45-53
prev_slot: 45
next_slot: 53
reset_slot: 49
# Filler item for empty slots (set to 'NONE' to disable)
filler_item: 'GRAY_STAINED_GLASS_PANE'
filler_name: ' '
tags.yml — 默认标签
VIP:
order: 1
tag: '&7[&eVIP&7]'
lore:
- '&eAwarded to VIP members'
- '&7Thank you for your support!'
permission: apotags.tag.vip
enabled: true
MVP:
order: 2
tag: '&7[&bMVP&7]'
lore:
- '&bAwarded to MVP members'
- '&7The highest donor rank.'
permission: apotags.tag.mvp
enabled: true
Apolo:
order: 3
tag: '�f2ff&l[APO] '
lore:
- '�f2ffExclusive Developer Tag'
- '&7Reserved for ApoStudios staff.'
permission: none
enabled: true
Staff:
order: 4
tag: '&7[&cStaff&7]'
lore:
- '&cFor server staff members'
- '&7Helping keep the server safe.'
permission: apotags.tag.staff
enabled: true
Helper:
order: 5
tag: '&7[&aHelper&7]'
lore:
- '&aFor server helpers'
- '&7Always ready to assist.'
permission: apotags.tag.helper
enabled: true
Builder:
order: 6
tag: '&#ff9900&l[Builder] '
lore:
- '&#ff9900For talented builders'
- '&7Creating amazing things.'
permission: apotags.tag.builder
enabled: true
提示: 拥有 permission: none 的标签可供所有玩家免费使用。
gui/gui_user.yml — 玩家 GUI 外观
title: '�f2ff&lApoTags &8― &7Select your Tag'
rows: 6
tag_item_material: 'NAME_TAG'
tag_item_locked_material: 'PAPER'
filler_material: 'GRAY_STAINED_GLASS_PANE'
prev_page:
material: 'ARROW'
slot: 45 # leftmost slot of row 6
next_page:
material: 'ARROW'
slot: 53 # rightmost slot of row 6
reset_tag:
material: 'BARRIER'
slot: 49 # center of row 6
glow_active_tag: true
custom_model_data_available: 0
custom_model_data_active: 1
custom_model_data_locked: 2
gui/gui_admin.yml — 管理员 GUI 外观
title_prefix: '&c&l[Admin] &r'
enabled_tag_material: 'NAME_TAG'
disabled_tag_material: 'PAPER'
glow_enabled_tags: true
filler_material: 'BLACK_STAINED_GLASS_PANE'
info_item:
material: 'COMMAND_BLOCK'
slot: 49
? 指令
所有指令均以 /tags 为主命令别名:/apotags, /tag
玩家指令
| 指令 |
描述 |
/tags |
打开标签选择器 GUI |
/tags list |
列出你可用的标签和当前激活的标签 |
/tags select <id> |
装备一个标签 |
/tags version |
显示插件版本 |
/tags help |
显示你有权访问的所有指令 |
管理员命令
| 命令 |
描述 |
/tags admin |
打开管理员管理 GUI |
/tags list all |
列出所有已加载的标签 |
/tags list <player> |
列出特定玩家可用的标签 |
/tags set <player> <id> |
为玩家分配一个标签 |
/tags clear <player> |
移除玩家当前的活动标签 |
/tags create <id> <tag> |
创建新标签 |
/tags delete <id> |
永久删除一个标签 |
/tags enable <id> |
启用已禁用的标签 |
/tags disable <id> |
禁用一个标签(对所有玩家隐藏) |
/tags setorder <id> <n> |
更改标签的显示顺序 |
/tags setdisplay <id> <tag> |
更改标签的显示字符串 |
/tags setdesc <id> <desc> |
更改标签的描述文本(使用 | 分隔多行) |
/tags reload |
无需重启即可重新加载所有配置文件 |
? 权限
包权限
| 权限节点 |
默认值 |
描述 |
apotags.* |
false |
授予所有 ApoTags 权限 |
apotags.use |
true |
授予所有玩家命令 |
apotags.admin |
op |
授予所有管理员命令(继承 apotags.use) |
apotags.reload |
op |
授予 /tags reload 权限 |
apotags.tag.all |
op |
绕过所有按标签的权限检查 |
细粒度命令节点
| 权限节点 |
默认值 |
对应命令 |
apotags.command.tags |
true |
/tags |
apotags.command.list |
true |
/tags list |
apotags.command.select |
true |
/tags select |
apotags.command.version |
true |
/tags version |
apotags.command.help |
true |
/tags help |
apotags.command.admin |
op |
/tags admin |
apotags.command.list.all |
op |
/tags list all |
apotags.command.list.player |
op |
/tags list <player> |
apotags.command.set |
op |
/tags set |
apotags.command.clear |
op |
/tags clear |
apotags.command.create |
op |
/tags create |
apotags.command.delete |
op |
/tags delete |
apotags.command.enable |
op |
/tags enable |
apotags.command.disable |
op |
/tags disable |
apotags.command.setorder |
op |
/tags setorder |
apotags.command.setdisplay |
op |
/tags setdisplay |
apotags.command.setdesc |
op |
/tags setdesc |
apotags.command.reload |
op |
/tags reload |
按标签节点
单个标签的访问权限遵循格式 apotags.tag.<TagID>,其中 <TagID> 必须与 tags.yml 中的键完全匹配(区分大小写)。
这些节点不会在 plugin.yml 中声明——请根据你的权限插件需求自行创建。
apotags.tag.VIP → 访问 VIP 标签的权限
apotags.tag.Staff → 访问 Staff 标签的权限
apotags.tag.Legend → 访问自定义 Legend 标签的权限
在 tags.yml 中设置 permission: none 的标签对所有人免费开放——无需任何节点。
LuckPerms 示例:
/lp user <player> permission set apotags.tag.VIP true
/lp group vip permission set apotags.tag.all true
/lp group moderator permission set apotags.command.admin true
? PlaceholderAPI
安装 PlaceholderAPI 以在聊天、TAB 列表、计分板及其他支持 PAPI 的插件中显示标签。
| 占位符 |
返回值 |
%apotags_tag% |
带颜色代码的活动标签(旧版 § 格式)。若无或已禁用则返回 ""。 |
%apotags_tag_plain% |
去除所有颜色代码的活动标签纯文本 |
%apotags_tag_id% |
原始标签 ID(例如 VIP)。若无则返回 ""。 |
聊天格式示例 (EssentialsX):
format: '{prefix}%apotags_tag%%displayname%&r: {message}'
TAB 插件示例:
tabprefix: '%apotags_tag%'
? 语言支持
ApoTags 内置英语 (en) 和西班牙语 (es)。
要添加新语言:
- 复制
plugins/ApoTags/lang/en.yml → plugins/ApoTags/lang/<code>.yml
- 翻译所有值(保持所有键和
{tokens} 不变)
- 在
config.yml 中设置 locale: '<code>'
- 运行
/tags reload
➕ 添加新标签
通过命令(无需重启):
/tags create Legend &#FFD700&l[LEGEND]
/tags setdesc Legend &6The most legendary rank|&7Achieved through glory.
/tags setorder Legend 3
然后在你的权限插件中授予权限 apotags.tag.Legend。
直接在 tags.yml 中编辑:
Legend:
order: 3
tag: '&#FFD700&l[LEGEND] '
lore:
- '&6The most legendary rank'
- '&7Achieved through glory.'
permission: apotags.tag.Legend
enabled: true
然后运行 /tags reload。
?️ 给开发者
ApoTags 基于 Paper 1.19.4 + Adventure (Kyori) 构建,以支持原生 RGB 渲染。
支持的语法:
&#RRGGBB → 完整十六进制颜色 例如 �f2ff
&a &b &c ... → 旧版颜色代码
&l &o &n ... → 格式化代码
存储方式:
- H2 嵌入式数据库(默认)—
playerdata.mv.db
- FlatFile YAML 回退方案 —
playerdata.yml
包名: dev.apolostudios.apotags
由 ApoloCR 和 ApoStudios 用 ❤️ 制作
?️ ApoTags

The complete RGB tag manager for Paper servers.
Give your players beautifully colored prefix tags — with full GUI, PlaceholderAPI support, and zero file editing required.
✨ Features
- ? Full RGB / HEX color support — use
&#RRGGBB hex codes and legacy & codes anywhere
- ?️ Paginated player GUI — browse and equip tags with a clean inventory menu
- ?️ Admin GUI — manage all tags in-game, toggle enable/disable with Shift+Click
- ? H2 embedded database or FlatFile storage — no external database setup required
- ? PlaceholderAPI — display active tags in chat, tab, scoreboards, and more
- ? Multi-language — built-in English and Spanish, easily add any language
- ⚙️ Fully customizable GUIs — separate
gui_user.yml and gui_admin.yml config files
- ? Granular permissions — one permission node per subcommand for maximum control
- ? Live reload — apply any config or tag changes without restarting the server
- ?️ Multi-line tag lore — add rich descriptions to each tag shown in the GUI
- ? Zero hardcoded text — every player-facing message lives in the language file
? Requirements
| Dependency |
Type |
Version |
| Paper |
Required |
1.19.4 |
| Java |
Required |
17+ |
| PlaceholderAPI |
Optional |
2.11.6+ |
? Installation
- Download
ApoTags.jar and drop it into your /plugins/ folder
- Start or restart your server
- All config files are generated automatically on first launch
- Install PlaceholderAPI if you want to display tags in chat or tab
? Default Configuration
config.yml
# ─────────────────────────────────────────────
# ApoTags Configuration
# Authors: ApoloCR & ApoStudios
# Version: 1.0.0
# ─────────────────────────────────────────────
# Plugin locale: en / es
locale: 'en'
# Storage type: H2 / FLATFILE
storage: 'H2'
# GUI Settings
gui_settings:
title: 'ApoTags - Select your Tag'
rows: 6
# Items for GUI navigation (Material names)
next_page_item: 'ARROW'
previous_page_item: 'ARROW'
reset_tag_item: 'BARRIER'
# Slot positions in row 6 (0-indexed from row start = slot 45)
# Row 6: slots 45-53
prev_slot: 45
next_slot: 53
reset_slot: 49
# Filler item for empty slots (set to 'NONE' to disable)
filler_item: 'GRAY_STAINED_GLASS_PANE'
filler_name: ' '
tags.yml — Default tags
VIP:
order: 1
tag: '&7[&eVIP&7]'
lore:
- '&eAwarded to VIP members'
- '&7Thank you for your support!'
permission: apotags.tag.vip
enabled: true
MVP:
order: 2
tag: '&7[&bMVP&7]'
lore:
- '&bAwarded to MVP members'
- '&7The highest donor rank.'
permission: apotags.tag.mvp
enabled: true
Apolo:
order: 3
tag: '�f2ff&l[APO] '
lore:
- '�f2ffExclusive Developer Tag'
- '&7Reserved for ApoStudios staff.'
permission: none
enabled: true
Staff:
order: 4
tag: '&7[&cStaff&7]'
lore:
- '&cFor server staff members'
- '&7Helping keep the server safe.'
permission: apotags.tag.staff
enabled: true
Helper:
order: 5
tag: '&7[&aHelper&7]'
lore:
- '&aFor server helpers'
- '&7Always ready to assist.'
permission: apotags.tag.helper
enabled: true
Builder:
order: 6
tag: '&#ff9900&l[Builder] '
lore:
- '&#ff9900For talented builders'
- '&7Creating amazing things.'
permission: apotags.tag.builder
enabled: true
Tip: Tags with permission: none are available to every player for free.
gui/gui_user.yml — Player GUI appearance
title: '�f2ff&lApoTags &8― &7Select your Tag'
rows: 6
tag_item_material: 'NAME_TAG'
tag_item_locked_material: 'PAPER'
filler_material: 'GRAY_STAINED_GLASS_PANE'
prev_page:
material: 'ARROW'
slot: 45 # leftmost slot of row 6
next_page:
material: 'ARROW'
slot: 53 # rightmost slot of row 6
reset_tag:
material: 'BARRIER'
slot: 49 # center of row 6
glow_active_tag: true
custom_model_data_available: 0
custom_model_data_active: 1
custom_model_data_locked: 2
gui/gui_admin.yml — Admin GUI appearance
title_prefix: '&c&l[Admin] &r'
enabled_tag_material: 'NAME_TAG'
disabled_tag_material: 'PAPER'
glow_enabled_tags: true
filler_material: 'BLACK_STAINED_GLASS_PANE'
info_item:
material: 'COMMAND_BLOCK'
slot: 49
? Commands
All commands use /tags as the main label. Aliases: /apotags, /tag
Player Commands
| Command |
Description |
/tags |
Open the tag selector GUI |
/tags list |
List your available tags and active tag |
/tags select <id> |
Equip a tag |
/tags version |
Show plugin version |
/tags help |
Show all commands you have access to |
Admin Commands
| Command |
Description |
/tags admin |
Open the admin management GUI |
/tags list all |
List every loaded tag |
/tags list <player> |
List a specific player's available tags |
/tags set <player> <id> |
Assign a tag to a player |
/tags clear <player> |
Remove a player's active tag |
/tags create <id> <tag> |
Create a new tag |
/tags delete <id> |
Permanently delete a tag |
/tags enable <id> |
Enable a disabled tag |
/tags disable <id> |
Disable a tag (hides it from all players) |
/tags setorder <id> <n> |
Change a tag's display order |
/tags setdisplay <id> <tag> |
Change a tag's display string |
/tags setdesc <id> <desc> |
Change a tag's lore (| for multiple lines) |
/tags reload |
Reload all config files without restart |
? Permissions
Bundles
| Permission |
Default |
Description |
apotags.* |
false |
Grants every ApoTags permission |
apotags.use |
true |
Grants all player commands |
apotags.admin |
op |
Grants all admin commands (inherits apotags.use) |
apotags.reload |
op |
Grants /tags reload |
apotags.tag.all |
op |
Bypasses all per-tag permission checks |
Granular Command Nodes
| Permission |
Default |
Command |
apotags.command.tags |
true |
/tags |
apotags.command.list |
true |
/tags list |
apotags.command.select |
true |
/tags select |
apotags.command.version |
true |
/tags version |
apotags.command.help |
true |
/tags help |
apotags.command.admin |
op |
/tags admin |
apotags.command.list.all |
op |
/tags list all |
apotags.command.list.player |
op |
/tags list <player> |
apotags.command.set |
op |
/tags set |
apotags.command.clear |
op |
/tags clear |
apotags.command.create |
op |
/tags create |
apotags.command.delete |
op |
/tags delete |
apotags.command.enable |
op |
/tags enable |
apotags.command.disable |
op |
/tags disable |
apotags.command.setorder |
op |
/tags setorder |
apotags.command.setdisplay |
op |
/tags setdisplay |
apotags.command.setdesc |
op |
/tags setdesc |
apotags.command.reload |
op |
/tags reload |
Per-Tag Nodes
Individual tag access follows the format apotags.tag.<TagID> where <TagID> exactly matches the key in tags.yml (case-sensitive).
These are not declared in plugin.yml — create them in your permissions plugin as needed.
apotags.tag.VIP → access to the VIP tag
apotags.tag.Staff → access to the Staff tag
apotags.tag.Legend → access to a custom Legend tag
Tags with permission: none in tags.yml are free for everyone — no node needed.
LuckPerms examples:
/lp user <player> permission set apotags.tag.VIP true
/lp group vip permission set apotags.tag.all true
/lp group moderator permission set apotags.command.admin true
? PlaceholderAPI
Install PlaceholderAPI to display tags in chat, tab, scoreboards, and any other PAPI-compatible plugin.
| Placeholder |
Returns |
%apotags_tag% |
Active tag with color codes (legacy §-format). Returns "" if none or disabled. |
%apotags_tag_plain% |
Active tag with all color codes stripped |
%apotags_tag_id% |
The raw Tag ID (e.g. VIP). Returns "" if none. |
Chat format example (EssentialsX):
format: '{prefix}%apotags_tag%%displayname%&r: {message}'
TAB plugin example:
tabprefix: '%apotags_tag%'
? Language Support
ApoTags ships with English (en) and Spanish (es).
To add a new language:
- Copy
plugins/ApoTags/lang/en.yml → plugins/ApoTags/lang/<code>.yml
- Translate all values (keep all keys and
{tokens} unchanged)
- Set
locale: '<code>' in config.yml
- Run
/tags reload
➕ Adding a New Tag
Via command (no restart):
/tags create Legend &#FFD700&l[LEGEND]
/tags setdesc Legend &6The most legendary rank|&7Achieved through glory.
/tags setorder Legend 3
Then grant the permission apotags.tag.Legend in your permissions plugin.
Directly in tags.yml:
Legend:
order: 3
tag: '&#FFD700&l[LEGEND] '
lore:
- '&6The most legendary rank'
- '&7Achieved through glory.'
permission: apotags.tag.Legend
enabled: true
Then run /tags reload.
?️ For Developers
ApoTags is built on Paper 1.19.4 + Adventure (Kyori) for native RGB rendering.
Color syntax supported everywhere:
&#RRGGBB → full hex color e.g. �f2ff
&a &b &c ... → legacy codes
&l &o &n ... → formatting codes
Storage:
- H2 embedded database (default) —
playerdata.mv.db
- FlatFile YAML fallback —
playerdata.yml
Package: dev.apolostudios.apotags
Made with ❤️ by ApoloCR & ApoStudios
评论 0
登录后参与评分
还没有评论,来抢沙发吧