牢李称号LiTitle —— 现代化称号系统（商店 / 仓库 / 抽奖 / 权限称号）

starkaimian

有问题点击加群 作者qq：2562661003​

插件功能/特点
称号系统
[size=1.2]Wiki：
称号文件独立管理（每个称号一个 yml）佩戴称号后聊天前缀显示（可开关）支持称号动作：购买/佩戴时执行命令（console/op/player）

称号商店（GUI）
[size=1.2]Wiki：
从 shop_titles/ 自动读取上架称号支持购买方式：免费 / Vault(金币) / PlayerPoints(点券) / permission(权限) / itemStack(物品)支持限时称号（按天数到期）

称号仓库（GUI）
[size=1.2]Wiki：
展示玩家已拥有称号右键可取消佩戴（具体取决于你的 GUI 配置/交互）

称号抽奖（GUI）
[size=1.2]Wiki：
从上架称号中抽取玩家未拥有的称号支持抽奖金币消耗（Vault）抽到的称号同样支持限时到期权限称号自动发放称号文件里配置 permission 后，玩家拥有权限会自动获得（定时同步）




安装与快速开始
[size=1.2]Wiki：
1. 将 LiTitle.jar 放入 plugins/2. 安装 Vault 与一个 Vault 经济插件 （例如 XConomy-Paper）3. （可选）安装 PlaceholderAPI、PlayerPoints4. 启动服务器生成配置5. 使用命令快速上架一个称号：   /lititle shop add 测试1 1000 0这会在 shop_titles/测试1.yml 生成商店称号配置，并自动导入生成 titles/测试1.yml （首次导入会把 enable 置为 true）


玩家指令/管理指令​[size=1.2]Wiki：
主命令/lititle （别名： /title ）命令列表/lititle shop ：打开称号商店/lititle warehouse ：打开称号仓库/lititle lottery ：打开称号抽奖/lititle reload ：重载配置与称号文件（管理员）/lititle give <玩家> <称号ID> ：给予称号（管理员）/lititle shop add <称号ID> [价格] [天数] 自动生成配置文件并上架（管理员）/lititle shop remove <称号ID> ：下架称号（管理员）



PlaceholderAPI 占位符
[size=1.2]Wiki：
-%lititle_name% ：玩家当前佩戴的称号



配置示例
抽奖配置 lottery.yml
[size=1.2]YAML：
# =========================# LiTitle 抽奖配置文件# =========================## 说明：# - titles 为空时：抽奖奖池默认使用 shop_titles/ 目录中 enable=true 且 isHide=false 的称号# - titles 不为空时：只从这里指定的称号ID抽取# - 抽奖始终会排除玩家已拥有的称号# - cost: 每次抽奖需要的金币（Vault 经济），0 表示免费#cost: 1000titles: []



抽奖 GUI gui/lottery_gui.yml
[size=1.2]YAML：
gui:  rows: 3  title: "称号抽奖"  command-fake-op: true  content: "T"  layout:    - "#########"    - "#..D..#.#"    - "S##W#C##."  items:    "#":      material: "ORANGE_STAINED_GLASS_PANE"      name: " "    "D":      material: "NETHER_STAR"      name: "开始抽奖"      lore:        - "点击抽取一个称号，需要%cost%金币"      action: "draw"    "S":      material: "EMERALD"      name: "返回商店"      lore:        - "返回称号商店"      action: "open-shop"    "W":      material: "CHEST"      name: "称号仓库"      lore:        - "查看你已拥有的称号"      action: "open-warehouse"    "C":      material: "BARRIER"      name: "关闭"      lore:        - "点击关闭界面"      action: "close"



商店称号配置 shop_titles/富豪.yml
[size=1.2]Wiki：
# =========================# LiTitle 商店称号配置文件# =========================## 是否已导入，导入过的会变为 true，无法重复导入enable: false# 称号名称titleName: "&e富豪"# 称号类型 not(免费) vault(金币) playerPoints(点券) permission(权限) itemStack(物品)buyType: "vault"# 称号价格/称号数量amount: 10000# 称号出售天数 0为永久day: 0# buyType 为 itemStack(物品) 填需要的物品材质 例如 APPLE# buyType 为 permission(权限) 填需要的权限 例如 abcitemStack: ""# 是否在商城隐藏 - true 隐藏isHide: false# 称号描述description:  - "&e这是一个示例称号"



称号自定义 titles/富豪.yml
[size=1.2]代码：
# =========================# LiTitle 称号配置文件# =========================id: "富豪"name: "富豪"display: "§f[ §e富豪 §f]"lore:  - "&7一个新的称号"icon:  material: "NAME_TAG"  custom-model-data: 0permission: ""cost:  vault: 0  points: 0actions:  on-buy: []  on-select: []



动作命令（actions / GUI commands）说明
[size=1.2]代码：
执行console: 控制台执行op: 以 OP 执行（可配置是否临时提权）player: / command: 玩家执行（默认）占位符{player} 玩家名{uuid} UUID{title} 称号ID多条命令用英文分号 ; 分隔（同一行可写多条）command-fake-op在 GUI 配置里设置 command-fake-op: true 时， op: 执行会临时 setOp(true) 执行后还原。



常见问题（排查）
商店/抽奖提示“未检测到经济系统”
- 确认已安装 Vault + 经济插件（例如 XConomy-Paper）
- 确认 Vault 能识别到经济提供者（服务器启动日志里会有经济挂钩信息）
抽奖抽不到称号
- lottery.yml 的 titles 为空时：只会从 shop_titles/ 中 enable=true 且 isHide=false 的称号抽取
- 玩家已拥有的称号会被排除
称号到期后还显示
- 玩家普通权限下：到期会自动视为未拥有并取消佩戴（管理员 lititle.admin 会跳过到期限制）