PlayerProfile - 玩家档案与魔法装扮

您是否正在为玩家寻找一款个人资料插件，但现有的插件要么不支持离线玩家，要么配置过于复杂，要么无法与您的魔法饰品系统完美集成？那么，这款插件正是您需要的解决方案。

这款个人资料插件专为支持 MagicCosmetics 插件而设计，旨在避免使用那些对大多数人来说过于复杂的其他类型插件。

💡核心特性

• 运行稳定
• 完全自定义控制
• 支持 CustomModelData
• 支持 ItemsAdder / Oraxen 的自定义物品与字体
• 支持 PlaceholderAPI 占位符（注意：并非所有占位符都适用于离线玩家）
• 全面支持 MagicCosmetics（在线与离线玩家均可使用）
• 支持 SQLite / MySQL 数据库

❓依赖要求

• 无强制依赖：本插件无需依赖任何其他插件即可运行！

🔧功能预览

• 在线玩家预览：[点击查看图片]
• 离线玩家预览：[点击查看图片]

请注意，本页面展示的图片效果均通过资源包实现，部分效果依赖于 MagicCosmetics 的资源包。

**主要操作与展示**

• 按下 Shift + 右键 打开个人资料菜单。
• 支持公开/私密个人资料设置。
• 支持多级菜单，并可通过权限管理（例如：为 staff 和普通用户显示不同菜单）。
• 可更改个人状态并在资料中显示。

✨兼容支持

本插件兼容以下插件/系统

• ItemsAdder
• PlaceholderAPI
• Oraxen
• MagicCosmetics（您可以在 Discord 服务器中询问并获取该插件的链接）

🎮重要说明与链接

重要提示：为了获得完整的功能体验，我们强烈建议您搭配使用为其设计的 MagicCosmetics 插件。

**相关链接**

• Discord 社区：[点击加入]
• 插件文档：[点击查看]

PlayerProfile 是一个用于展示玩家个性化信息的菜单插件，玩家可以查看自己或他人的个人资料，并展示自定义的装扮、装备和状态。

💡权限与命令

主要权限节点为 playerprofile.*，它用于授予特定命令的访问权限，例如查看更详细的 /profile help 信息或使用 /profile reload 命令。

可用命令：

• /profile <玩家名> - 打开指定玩家的个人资料。
• /profile help - 显示插件帮助信息。
• /profile reload - 重载插件配置文件。
• /profile <offline|player> <玩家名> - 为另一名玩家打开指定玩家的个人资料。

🎮占位符

本插件内置了可在配置中使用的占位符，同时也支持 PlaceholderAPI。

插件内置占位符：

• %viewer% - 指代正在查看个人资料的玩家。
• %owner% - 指代该个人资料的所有者。

PlaceholderAPI 占位符：

• %playerprofile_viewer% - 正在查看个人资料的玩家。
• %playerprofile_owner% - 所查看个人资料的所有者。
• %playerprofile_status% - 玩家的在线状态。
• %playerprofile_is_public% - 验证玩家是否拥有公开的个人资料。

🔧动作

动作可在菜单图标配置中定义，用于在玩家点击时触发特定效果。

可用动作：

• player: help - 以点击菜单的玩家身份执行命令。
• console: help - 通过控制台执行命令。
• owner_message: 自定义消息 - 向资料所有者发送一条消息（无需命令）。
• viewer_message: 自定义消息 - 向资料查看者发送一条消息（无需命令）。
• close_inventory - 关闭查看者的物品栏界面。

⭐配置与菜单

主要配置 (config.yml)

• offline-players: true - 设置为 true 以支持查看离线玩家的个人资料。

可用的槽位类型

插件支持多种类型的物品槽位，用于展示不同内容

装扮类：

• HAT (帽子)
• BACKPACK (背包)
• OFF_HAND (副手物品)
• BALLOON (气球)
• SPRAY (喷雾)

装备类：

• HELMET (头盔)
• CHEST_PLATE (胸甲)
• LEGGINGS (护腿)
• BOOTS (靴子)

状态与功能类：

• STATUS (玩家在线状态)
• SAVED_ITEM (保存的物品)
• DRAG_AND_DROP (拖放区域)

菜单配置示例

以下是一个简化的菜单配置示例，展示了布局和图标定义的基本结构：

title: '%owner%´s Profile'
rows: 4
layout:
  - 'GGGGGGOHh'
  - 'G      Bc'
  - 'G      Cl'
  - 'GGGGGGSgb'
icons:
  G:
    material: BLACK_STAINED_GLASS
    # ... 其他图标属性
  H:
    type: HAT
    # ... 帽子图标配置
  O:
    type: STATUS
    online:
      display: '&aOnline'
      material: GREEN_WOOL
    offline:
      display: '&cOffline'
      material: RED_WOOL
  # ... 其他图标配置

配置说明：

• layout 定义了菜单的布局，每个字符对应 icons 部分的一个图标配置。
• 图标配置中，type 字段用于指定槽位类型（如 HAT, STATUS 等）。
• 对于 STATUS 类型，可以分别设置玩家在线 (online) 和离线 (offline) 时显示的物品。