🏷️ AdventureTitle

一、简介

AdventureTitle —— 一款安全、干净、功能完整的 Minecraft 称号系统插件

AdventureTitle 允许您轻松创建自定义称号供玩家拥有和使用。支持称号仓库、商城、三槽位系统（前缀/属性/粒子）、Buff 绑定、粒子效果、称号卡、收集奖励等功能。玩家可以购买、佩戴、切换称号，展示个性身份。

AdventureTitle 支持 Paper / Purpur 1.21+ 的全部版本，并且会第一时间支持未来版本。

AdventureTitle

  • 称号管理 > 创建/删除/导入/导出称号，支持多种购买类型
  • 三槽位系统 > 前缀(展示)、属性(buff)、粒子 三个独立槽位
  • 聊天/Tab显示 > 自动在聊天前显示称号，可选 Tab 和头顶显示
  • Buff绑定 > 药水效果、AttributePlus、SX-Attribute、MythicLib 等多属性插件支持
  • 粒子系统 > 绑定 PlayerParticles、SuperTrails 等插件粒子效果
  • 称号卡 > 称号卡物品、随机卡，玩家可通过物品获取称号
  • 收集奖励 > 收集指定数量称号后触发奖励
  • 称号商城 > 自定义GUI商城，支持多种货币购买
  • 称号仓库 > 玩家拥有的称号集中管理GUI
  • GUI操作 > 内容高度自定义，所有界面通过GUI交互
  • 数据存储 > 支持 SQLite 和 MySQL 存储
  • PAPI变量 > 支持 PlaceholderAPI 变量

二、插件前置说明

都是非必须

  • PlaceholderAPI — PAPI变量支持
  • Vault — 经济插件(需基础插件例如ess，cmi等)
  • PlayerPoints — 点券插件
  • AttributePlus / SX-Attribute / MythicLib — 属性 Buff 集成
  • PlayerParticles / SuperTrails — 粒子效果集成
下一篇安装 →

📥 安装

环境要求

项目要求
服务端Paper / Purpur 1.21+
JavaJava 21+
可选依赖PlaceholderAPI、Vault、PlayerPoints

安装步骤

  1. 将 AdventureTitle-2.0.0.jar 放入服务器 plugins/ 目录
  2. 启动/重启服务器
  3. 编辑 plugins/AdventureTitle/ 下的配置文件
  4. 执行 /at reload 重载配置
上一篇← 插件总览
下一篇GUI 系统 →

🖥️ GUI 系统

称号仓库

展示玩家已拥有的全部称号，点击即可切换使用/禁用。支持分页和自定义按钮。

  • 配置文件: gui/open.yml
  • 打开方式: /at open

称号商城

展示所有可购买的称号，支持按类型筛选。点击购买后自动存入仓库。

  • 配置文件: gui/shop.yml
  • 打开方式: /at shop

称号奖励界面

根据收集的称号数量领取奖励，支持 Vault、PlayerPoints、称号币三种奖励类型。

上一篇← 安装
下一篇三槽位系统 →

🎰 三槽位系统

概览

开启 selectEnable: true 后，玩家点击称号时会弹出槽位选择界面：

槽位用途PAPI 变量
展示(前缀)聊天/Tab/头顶显示的称号%adventuretitle_use%
属性(中缀)提供 buff 效果的称号%adventuretitle_use_buff%
粒子(后缀)触发粒子效果的称号%adventuretitle_use_particle%

每个槽位可以设置不同的称号，互不影响。

⚠️ 注意

三槽位系统默认关闭。未开启时，点击称号仍按传统方式直接切换佩戴/取消。

上一篇← GUI 系统
下一篇购买类型 →

💰 购买类型

类型说明
not免费
vaultVault 金币
playerPointsPlayerPoints 点券
coin称号币
itemStack物品（需指定材质）
permission权限（需指定权限节点）
activity活动称号（仅管理员发放）
上一篇← 三槽位系统
下一篇Buff 系统 →

💪 Buff 系统

概览

每个称号可绑定多种类型的 buff 效果。佩戴称号后自动获得 buff，取消佩戴后移除。

Buff 类型

类型说明示例
potion_effect原版药水效果SPEED 2
AttributePlusAttributePlus 属性攻击力#10
SX-AttributeSX-Attribute 属性物理伤害#5-10
AttributeSystemAttributeSystem 属性AttackDamage#5
MythicLibMythicLib/MMO 属性ATTACK_DAMAGE#3
SagaLoreStatsSagaLoreStats 属性物理攻击力#10

使用示例

# 添加药水buff (速度 II)
/at buff addBuff <称号ID> potion_effect SPEED#2

# 添加 AttributePlus buff
/at buff addBuff <称号ID> AttributePlus 攻击力#10 攻击力+10 wear

# 编辑 buff
/at buff editBuff <称号ID> SPEED#3 速度提升III wear

# 删除称号所有buff
/at buff deleteBuff <称号ID>

支持的药水效果

SPEED SLOW FAST_DIGGING INCREASE_DAMAGE JUMP REGENERATION DAMAGE_RESISTANCE FIRE_RESISTANCE WATER_BREATHING NIGHT_VISION HEALTH_BOOST ABSORPTION SATURATION LUCK SLOW_FALLING CONDUIT_POWER

⚠️ 注意

在 config.yml 中可通过 disabledBuffWorld 配置禁用 buff 的世界。设置 isAllBuff: true 会让所有已拥有称号的 buff 同时生效。命令中使用 # 代替空格来输入带空格的参数。

上一篇← 购买类型
下一篇粒子系统 →

✨ 粒子系统

概览

每个称号可绑定粒子效果。需安装对应的粒子插件，佩戴称号后自动触发粒子效果。

支持的粒子插件

插件类型说明
PlayerParticlesPlayerParticles 插件粒子
SuperTrailsSuperTrails 插件粒子
SuperTrailsProSuperTrails Pro 插件粒子

使用示例

# 添加粒子 (PlayerParticles 火焰粒子)
/at particle addParticle <称号ID> PlayerParticles FLAME spiral red

# 删除称号粒子
/at particle deleteParticle <称号ID>

# 清空所有粒子数据
/at clear particle
上一篇← Buff 系统
下一篇称号卡 →

🎴 称号卡

概览

管理员可创建称号卡物品给予玩家。玩家右键使用即可获得对应称号。

使用示例

# 创建指定称号卡
/at card create <玩家> <称号ID> [天数]

# 创建随机称号卡
/at card random <玩家> [天数]
上一篇← 粒子系统
下一篇称号奖励 →

🎁 称号奖励

概览

设置称号数量奖励，激励玩家收集更多称号。

使用示例

# 添加奖励: 收集5个称号奖励1000金币
/at reward add 5 vault 1000

# 添加奖励: 收集10个称号奖励500称号币
/at reward add 10 coin 500
上一篇← 称号卡
下一篇配置文件 →

⚙️ 配置文件

config.yml — 主配置

配置项说明默认值
language语言文件名zh_CN
default默认称号（无称号时显示）§f[ §7萌新 §f]
prefixBrackets称号前缀括号§f[
suffixBrackets称号后缀括号 §f]
isChat聊天显示称号true
isTabTab/头顶显示称号false
essChatessChat 兼容模式false
togglesCoolDown切换称号冷却(秒)1
isEnableBuff启用 buff 功能true
isAllBuff全局 bufffalse
isAutoUse获取称号后自动佩戴false
customLength自定义称号长度限制16
disabledBuffWorld禁用 buff 的世界列表[]
shopHideBought商城隐藏已购称号false
selectEnable三槽位选择false

storage.yml — 存储配置

storage-method: SQLite   # 或 MySQL
MySQL:
  Host: 127.0.0.1
  Port: 3306
  Database: mc
  User: root
  Password: root
  UseSSL: false

material.yml — 材质配置

自定义称号在 GUI 中的材质和模型数据：

# 称号ID: 材质名
1: PAPER
1_custom-model-data: 7

randomCard:
  material: PAPER
  custom-model-data: 0

changeItem:
  material: PAPER
  custom-model-data: 0

gui/open.yml & gui/shop.yml

完全可自定义的 GUI 布局，包括称号槽位、按钮位置、材质、lore 模板等。

上一篇← 称号奖励
下一篇数据存储 →

🗄️ 数据存储

存储类型

支持 SQLite（默认）和 MySQL 两种存储方式，通过 storage.yml 配置。

数据表

表名说明
at_title称号数据
at_player_title玩家-称号关联
at_title_buff称号 buff 配置
at_title_particle称号粒子配置
at_coin称号币余额
at_reward奖励配置
at_reward_claimed奖励领取记录
上一篇← 配置文件
下一篇命令列表 →

⌨️ 命令列表

主命令: /adventuretitle (别名: /at, /plt)

称号管理

命令说明
/at reload重载插件配置
/at title add <购买类型> <名称> <金额> ...新增称号
/at title delete <ID>删除称号
/at title list [页码]查看称号列表
/at title import从 import.yml 导入
/at title export导出到 export.yml

玩家称号管理

命令说明
/at player add <玩家> <ID> [天数]给玩家添加称号
/at player addTitle <玩家> <名称> [天数]新建称号并给予
/at player setTitle <玩家> <ID> [天数]设置当前称号
/at player list <玩家>查看玩家称号
/at player delete <玩家> <ID>删除玩家称号

经济 / Buff / 粒子 / 其他

命令说明
/at coin give|set|take <玩家> <金额>称号币管理
/at buff addBuff <ID> <类型> <属性> ...添加 buff
/at buff editBuff <ID> <属性> ...编辑 buff
/at buff deleteBuff <ID>删除 buff
/at particle addParticle <ID> <类型> ...添加粒子
/at particle deleteParticle <ID>删除粒子
/at card create <玩家> <ID> [天数]创建称号卡
/at card random <玩家> [天数]创建随机卡
/at reward add <数> <类型> <金额>添加奖励
/at view open|shop <玩家>查看 GUI
/at clear ...清理数据

玩家命令

命令说明权限
/at open打开称号仓库adventuretitle.open
/at shop打开称号商城adventuretitle.shop
/at help查看帮助所有人
上一篇← 数据存储
下一篇权限节点 →

🔐 权限节点

权限说明默认
adventuretitle.*全部权限OP
adventuretitle.admin管理员权限组OP
adventuretitle.reload重载配置OP
adventuretitle.title称号管理OP
adventuretitle.player玩家称号管理OP
adventuretitle.coin称号币管理OP
adventuretitle.buffBuff 管理OP
adventuretitle.particle粒子管理OP
adventuretitle.card称号卡管理OP
adventuretitle.reward奖励管理OP
adventuretitle.view查看 GUIOP
adventuretitle.clear清理数据OP
adventuretitle.open打开称号仓库所有人
adventuretitle.shop打开称号商城所有人
adventuretitle.shop.custom自定义称号所有人
上一篇← 命令列表
下一篇PAPI 变量 →

📊 PlaceholderAPI 变量

变量说明
%adventuretitle_use%当前展示(前缀)称号 (带前后缀)
%adventuretitle_title%同上
%adventuretitle_use_raw%当前展示称号名 (无前后缀)
%adventuretitle_title_raw%同上
%adventuretitle_use_buff%当前属性(中缀)称号名称
%adventuretitle_use_particle%当前粒子(后缀)称号名称
%adventuretitle_coin%称号币数量
%adventuretitle_count%拥有称号数量
上一篇← 权限节点
© 2024-2026 Feiiy · AdventureTitle 称号系统 · QQ: 823959438