ApoTags

插件

· 作者 ApoloCR

ApoTags 是一款针对 Paper 和 Velocity 网络优化的 Minecraft 插件。它管理自定义标签和视觉前缀,简化了服务器中的等级组织,并增强了玩家在整个服务器中的身份标识。

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

最新 1.0.0 · 1.21.11 · Bukkit / Paper

一键开服(送7天)

?️ ApoTags

Logo

适用于 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+

? 安装步骤

  1. 下载 ApoTags.jar 并将其放入 /plugins/ 文件夹
  2. 启动或重启你的服务器
  3. 首次启动时会自动生成所有配置文件
  4. 如果希望在聊天或 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: '&#00f2ff&l[APO] '
  lore:
    - '&#00f2ffExclusive 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: '&#00f2ff&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)。

要添加新语言:

  1. 复制 plugins/ApoTags/lang/en.yml → plugins/ApoTags/lang/<code>.yml
  2. 翻译所有值(保持所有键和 {tokens} 不变)
  3. 在 config.yml 中设置 locale: '<code>'
  4. 运行 /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      → 完整十六进制颜色   例如 &#00f2ff
&a &b &c ...  → 旧版颜色代码
&l &o &n ...  → 格式化代码

存储方式:

  • H2 嵌入式数据库(默认)— playerdata.mv.db
  • FlatFile YAML 回退方案 — playerdata.yml

包名: dev.apolostudios.apotags


由 ApoloCR 和 ApoStudios 用 ❤️ 制作

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源