原创 开源 娱乐 CloudProfile —— 玩家个人档案查询插件 | GUI界面支持 | Kether支持 1.0.0

[MD] # ☁️ CloudProfile —— 玩家个人档案查询插件 > **一个基于 TabooLib 6.3 开发的 Minecraft 玩家档案插件，让你轻松查看自己和其他玩家的装备与个人档案！** --- ## 📖 插件介绍 **CloudProfile（云档案）** 是一款轻量、易配置的玩家档案查询插件。 玩家只需一条指令，即可打开**自己**或**任意在线玩家**的个人档案界面： - 🎒 **实时装备展示** —— 头盔、胸甲、护腿、靴子、主手、副手全部一目了然； - 🧩 **PlaceholderAPI 变量** —— 界面标题、物品名称、Lore 均可显示任意变量（如金币余额、点券数量）； - 🎮 **Kether 脚本动作** —— 点击图标可执行自定义脚本，玩法扩展空间无限； - 🎨 **完全可视化配置** —— 界面布局、图标、动作全部由 `gui.yml` 控制，不需要任何代码基础。 > 💡 插件对 PlaceholderAPI 为软依赖：不安装也能正常运行，只是 `%变量%` 无法解析。 --- ## ✨ 功能特性 | 特性 | 说明 | |------|------| | 📋 档案查询 | 指令查看自己 / 指定玩家的档案 | | 🤝 快捷查看 | 潜行 + 副手右键玩家，一键打开对方档案 | | 🎒 装备展示 | 实时展示玩家头盔、胸甲、护腿、靴子、主手、副手 | | 🧩 变量支持 | 界面任意文本支持 PlaceholderAPI 变量 | | 🎮 Kether 脚本 | 图标左右键动作由 Kether 脚本驱动 | | 🎨 全量配置 | 布局、图标、材质、动作均可自定义 | | 🌐 多语言 | 所有提示文字独立于语言文件，随意修改 | | 🔄 热重载 | 配置文件支持指令热重载，无需重启服务器 | --- ## 🎮 指令一览 | 指令 | 说明 | 权限 | |------|------|------| | `/cp` | 查看指令帮助 | `cloudprofile.use` | | `/cp profile` | 查看**自己**的档案 | `cloudprofile.use` | | `/cp profile <玩家名>` | 查看**指定玩家**的档案 | `cloudprofile.use` | | `/cp reload` | 重载全部配置文件（管理员） | `cloudprofile.admin` | > 主指令别名：`/cloudprofile`、`/cp`、`/profile`；输入玩家名时有 Tab 补全，非常方便！ --- ## 📄 配置文件 插件首次启动会自动生成以下配置文件。 ### `config.yml` —— 主配置 ```yaml settings: # 是否允许玩家蹲下右键玩家查看该玩家档案 sneakLook: true ``` ### `gui.yml` —— 档案界面 界面内**所有地方**（标题、名称、Lore）都支持变量解析，首次启动生成的默认文件（完整内容）： ```yaml # 该界面内所有地方都支持变量解析 # 界面特殊TYPE: Helmet Chestplate Leggings Boots Hand OffHand # 分别对应 头盔 胸甲 护腿 靴子 主手 副手 Title: "&fCloudProfile | 玩家 %player_name% 个人档案" Layout: - "####i####" - "# 1 #" - "#526 #" - "# 3 #" - "# 4 #" - "#########" Icons: '1': Type: Helmet display: # 回退材质 如果玩家没有对应槽位的物品 将使用该材质 # 如果想显示空白则材质填写air name: "&f玩家头盔" mats: "stone" lore: - "&7玩家头盔" actions: left: - 'sound UI_BUTTON_CLICK by 1 1' '2': Type: Chestplate display: name: "&f玩家胸甲" mats: "stone" lore: - "&7玩家胸甲" actions: left: - 'sound UI_BUTTON_CLICK by 1 1' '3': Type: Leggings display: name: "&f玩家护腿" mats: "stone" lore: - "&7玩家护腿" actions: left: - 'sound UI_BUTTON_CLICK by 1 1' '4': Type: Boots display: name: "&f玩家靴子" mats: "stone" lore: - "&7玩家靴子" actions: left: - 'sound UI_BUTTON_CLICK by 1 1' '5': Type: Hand display: name: "&f玩家主手" mats: "stone" lore: - "&7玩家主手" actions: left: - 'sound UI_BUTTON_CLICK by 1 1' '6': Type: OffHand display: name: "&f玩家副手" mats: "stone" lore: - "&7玩家副手" actions: left: - 'sound UI_BUTTON_CLICK by 1 1' # 隔板 '#': display: # 物品名称 name: "&7隔板" # 物品材质 mats: "Gray_Stained_Glass_Pane" # CustomModelData数据 默认为-1 cmd: -1 # 物品描述 lore: - "&7我只是个隔板" - "&e爱上一只小猪?" # 这里使用的是Kether脚本 actions: # 左键点击触发音效 left: - 'sound UI_BUTTON_CLICK by 1 1' # 右键触发tell right: - 'tell "你是一只猪猪"' - 'sound entity.pig.ambient by 1 1' # 玩家信息 'i': display: name: "&7玩家: &f%player_name%" mats: "player_head" lore: - "&7金币余额: &e%xconomy_balance%" - "&7点券余额: &e%playerpoints_points%" ``` **图标类型（`Type`）：** | 类型 | 说明 | |------|------| | `Normal` | 普通图标，使用配置中的材质 | | `Helmet` / `Chestplate` / `Leggings` / `Boots` | 显示目标玩家头盔 / 胸甲 / 护腿 / 靴子（空槽位时回退到配置材质） | | `Hand` / `OffHand` | 显示目标玩家主手 / 副手物品 | **材质支持**：XMaterial 材质名（如 `stone`、`player_head`、`Gray_Stained_Glass_Pane`）；填写 `air` 可显示为空白。 ### `lang/zh_CN.yml` —— 语言文件 所有提示消息、指令帮助均由此文件控制，支持 `{参数}` 占位符替换（如 `{player_name}`）： ```yaml # 前缀 prefix: "&7[&b玩家个人档案系统&7] &r" # 档案界面打开提示 profile-other-open: "&a已为您打开玩家 &e{player_name} &a的个人档案" profile-self-open: "&a已打开您的个人档案" # 目标玩家不在线 player-off-online: '&c目标玩家 &e{0} &c不在线' # 帮助信息 help-message: - '&b指令帮助' - ' &7- /cp profile [玩家名] &f- 查看自身/目标玩家档案' - ' &7- /cp reload &f- 重载配置文件' # 重载提示 reload-message: '&a重载配置成功' # 打开档案失败提示 profile-open-other-fail: '&c打开玩家 &e{0} &c的个人档案失败' ``` --- ## 📥 安装方法 1. 下载最新版 `CloudProfile-<版本>.jar`； 2. 将 JAR 放入服务器 `plugins` 目录； 3. 重启服务器，插件自动生成配置文件； 4. （可选）安装 [PlaceholderAPI](https://www.spigotmc.org/resources/placeholderapi.6245/)，解锁变量解析功能。 --- ## 🧩 环境要求 | 项目 | 要求 | |------|------| | Java | 8 及以上 | | 服务端 | Bukkit / Spigot / Paper 1.12+ | | PlaceholderAPI | 软依赖（可选） | | TabooLib | 无需安装（已内嵌） | --- ## 🔗 相关链接 | 资源 | 链接 | |------|------| | 📥 下载 | [GitHub Releases](https://github.com/BalanceSea/CloudProfile/releases) | | 🐛 问题反馈 | [GitHub Issues](https://github.com/BalanceSea/CloudProfile/issues) | --- ## 🙋 关于作者 - 👨‍💻 作者：山海（BalanceSea） - 💬 作者 QQ：`3643203568` - 👥 插件交流群：`342097496` 遇到问题欢迎进群交流，也欢迎提出建议与反馈！ --- <div align="center"> **觉得好用的话，别忘了给个 ⭐ Star 支持一下！** </div> [/MD]