1快速开始
LinuxTitle 是一个自动解锁的头衔插件：玩家不需要申请， 只要满足条件就会自动获得对应头衔。获得后可以自由切换显示或关闭。
三步上手
- 把
LinuxTitle.jar放入plugins/目录并重启服务器。 - 编辑
plugins/LinuxTitle/titles.yml，按需调整头衔名称与解锁条件。 - 执行
/title reload让配置生效，玩家即可用/title list查看头衔。
可选依赖
装了
PlaceholderAPI 的话，头衔可以用于其它插件的变量显示；
没装也能正常运行，只是变量不可用。
2命令详解
玩家命令
| 命令 | 说明 | 权限 |
|---|---|---|
/title help [页码] | 显示帮助菜单，按身份展示不同目录，可点击翻页 | 所有人 |
/title list [页码] | 列出全部头衔，并标出自己哪些已解锁 | 所有人 |
/title use <头衔ID> | 使用指定头衔（必须是已解锁的） | 所有人 |
/title off | 关闭头衔显示 | 所有人 |
/title info <头衔ID> | 查看某个头衔的解锁条件与说明 | 所有人 |
管理员命令
| 命令 | 说明 | 权限 |
|---|---|---|
/title give <玩家> <头衔ID> | 手动授予玩家头衔（无视解锁条件） | linuxtitle.admin |
/title revoke <玩家> <头衔ID> | 收回玩家已获得的头衔 | linuxtitle.admin |
/title check [玩家] | 立即复查解锁条件（不填玩家则查全体在线） | linuxtitle.admin |
/title reload | 重载 config.yml 与 titles.yml | linuxtitle.admin |
命令别名
/title 也可以用 /titles 或 /lt 代替，效果完全相同。
3解锁条件
头衔按 解锁方式 分为六类，全部配置在 titles.yml 里。
| 解锁类型 | 判定依据 | 例子 |
|---|---|---|
first_join | 首次进入服务器 | 新人 |
playtime | 累计游玩时长达到阈值 | 常驻 / 元老 |
statistic | 某项原版统计达标（击杀 / 挖掘 / 死亡等） | PVP 之王 / 矿工 |
daily_playtime | 当日在线时长达到阈值 | 每日活跃 / 每日传奇 |
festival | 处于指定节日期间 | 春节 / 中秋 |
manual | 只能由管理员 /title give 授予 | 赞助者 / 自定义头衔 |
怎么改解锁阈值
打开 plugins/LinuxTitle/titles.yml，找到对应头衔，修改
condition-value 即可。例如把「常驻」改成需要 10 小时：
resident:
name: "&a常驻"
type: playtime
condition-value: 36000000 # 毫秒，10 小时
改完执行 /title reload 生效。时长一律用毫秒，
3600000 = 1 小时。
4节日活动
插件内置农历换算，春节、端午、中秋会按当年农历日期自动开放， 不需要每年手动改日期。
| 节日 | 类型 | 默认时间 | 持续 |
|---|---|---|---|
| 元旦 | 公历 | 12-30 ~ 01-02 | 跨年 |
| 春节 | 农历 | 正月初一 | 10 天 |
| 端午节 | 农历 | 五月初五 | 6 天 |
| 中秋节 | 农历 | 八月十五 | 6 天 |
| 国庆节 | 公历 | 09-30 ~ 10-07 | 8 天 |
# 农历节日：填农历月、日，插件自动换算当年公历日期
spring_festival:
name: "春节"
type: "lunar"
lunar-month: 1
lunar-day: 1
duration: 10 # 持续天数（含开始当天）
# 公历节日：直接填 MM-dd
national_day:
name: "国庆节"
type: "solar"
start: "09-30"
end: "10-07"
5配置说明
config.yml 主要配置项
| 配置项 | 默认值 | 说明 |
|---|---|---|
allow-self-switch | true | 是否允许玩家自己切换头衔。关掉后只能由管理员授予与指定。 |
allow-self-disable | true | 是否允许玩家用 /title off 关闭头衔显示。 |
auto-check-interval-seconds | 60 | 自动复查解锁条件的间隔（秒）。调小会更及时，但更耗性能。 |
help.mode | auto | 帮助菜单的身份判定：auto 自动 / admin 一律管理员视角 / player 一律玩家视角。 |
chat.enabled | true | 是否在聊天里显示头衔前缀。 |
daily.enabled | true | 是否启用每日头衔（每天重新统计）。 |
daily.reset-hour / reset-minute | 0 / 0 | 每日头衔的重置时间，默认每天 0 点。 |
newcomer.enabled | true | 新玩家首次进服是否自动授予「新人」头衔。 |
newcomer.title-id | newcomer | 新人头衔的 ID。 |
newcomer.delay-seconds | 10 | 进服后延迟几秒授予，避免与其它登录插件抢时序。 |
newcomer.max-playtime-millis | 3600000 | 累计游玩超过这个时长就不再算新人（默认 1 小时）。 |
关于 help.mode
linuxtitle.admin 的默认值是 op，也就是说服里的 OP 会自动通过这个判定，
与他是不是"管理员"其实无关。如果你只是加了 OP、并不想看到管理员目录，
把 help.mode 设为 player 即可。
6权限节点
| 权限节点 | 说明 | 默认 |
|---|---|---|
linuxtitle.use | 玩家命令：list / use / info / off | 所有人 |
linuxtitle.admin | 管理命令：give / revoke / check / reload | OP |
只想给管理员、不想给全部 OP？
在权限插件里把
linuxtitle.admin 显式授予指定玩家组，
同时不要给 -linuxtitle.admin 以外的 OP 默认权限（默认值改为 false）。
7常见问题
玩家说"我达到条件了但没解锁"？
先让玩家重进一次服务器，或执行
/title check <玩家> 立即复查。
若仍未解锁，用 /title info <头衔ID> 看条件是否与预期一致
（特别注意时长的单位是毫秒）。
头衔没有显示在聊天里？
依次检查：
config.yml 的 chat.enabled 是否为 true；
玩家是否用 /title off 关掉了显示；确认玩家确实已经 /title use 了某个头衔。
我不是管理员，为什么 /title help 显示管理员目录？
因为
linuxtitle.admin 的默认值是 op，只要你是 OP 就会通过判定。
把 config.yml 的 help.mode 改成 player 可以强制按玩家视角显示。
每日头衔第二天还在？
每日头衔会在
daily.reset-hour / reset-minute 指定的时间重新统计。
如果没重置，检查 daily.enabled 是否为 true，以及服务器时间是否正确。
节日头衔日期不对？
农历节日由插件自动换算，一般不需要手动改。若确实需要固定日期，
把
type 从 lunar 改成 solar，
再用 start / end 指定 MM-dd。
改了配置怎么生效？
执行
/title reload。玩家已获得的头衔不会因为重载丢失。