BetterProfiles • Custom items! Textures! Permissions! Commands! WorldGuard support! - BetterProfiles - 玩家档案展示插件

💡简介

厌倦了寻找查看玩家装备的插件？想要为你的 RPG 服务器找一个可自定义的个人资料插件？受够了那些一年都难得更新一次的付费插件？我也是！因此我创建了 BetterProfiles。本插件灵感来源于大型服务器网络，允许玩家实时查看其他玩家的装备。不仅如此，你还可以创建任意数量的自定义物品，并通过权限控制其显示，甚至可以执行命令来打开其他 GUI、发起交易、请求传送等。

💡重要须知

• 必需前置插件：本插件需要安装 NBTAPI。
• 不支持：不支持 Plugman 或类似插件。不支持离线玩家。
• 版本支持：仅支持每个 Minecraft 主版本的最新版（例如，仅支持 1.16.5，而非 1.16.4）。
• 版权声明：请尊重我的劳动成果。严禁在任何平台（包括 mcbbs.net 及类似网站）重新分发、发布或复制本插件。
• 翻译贡献：如果你想用你的母语贡献翻译，欢迎直接联系我。

🎮核心特性

多版本与兼容性

• 多版本支持 (BETA)：支持从 1.8.8 到最新的 Minecraft 版本。请务必使用对应版本的最新版插件。
• PlaceholderAPI 支持 (BETA)：自定义物品的显示名称和描述支持 PlaceholderAPI 变量。
• 关系型变量支持 (自 1.6-BETA)：可在物品的显示名称和描述中使用关系型变量（默认关闭，需手动启用）。
• WorldGuard 区域支持 (BETA)：可以设置允许或禁止使用个人资料功能的区域。区域标志：betterprofiles-can-view-profile。
• 禁用世界 (BETA)：可在特定世界禁用个人资料功能。

自定义物品与界面

• 添加自定义物品 (BETA)：可以添加任意数量的物品，填满整个库存界面。
• 自定义模型数据支持 (BETA，1.14+)：支持为物品设置自定义模型数据，适用于几乎所有物品（包括物品展示框）。
• 自定义槽位 (BETA)：你可以为每个物品指定任意槽位。
• 自定义显示名称与描述 (BETA)：可以为几乎所有物品设置自定义的显示名称和描述。
• 权限控制：

- **物品权限 (BETA)**：每个物品都可以设置独立的查看权限。

- **槽位权限 (BETA)**：可以为装备槽位（如头盔、胸甲）设置查看权限，并为隐藏的槽位设置替代的显示物品和描述。

• 动态物品 (BETA)：可以设置从玩家背包的特定槽位动态获取并显示物品。
• 专属物品：

- **ONLY_OWNER 物品 (BETA)**：仅个人资料所有者可见的物品。

- **ONLY_VIEWER 物品 (BETA)**：仅查看者可见的物品。

• 多种物品类型：支持多种物品类型，详细列表请查看 config.yml。
• 自定义材质头颅 (BETA)：支持使用自定义头颅材质。只要能在 minecraft-heads.com 找到的材质，都可以使用。
• 占位符物品 (BETA)：可以根据 PlaceholderAPI 变量的输出值来决定显示哪个物品。

个人资料管理

• 实时库存更新 (BETA)：玩家手持物品、穿戴/脱下盔甲时，个人资料界面会近乎实时地更新。1.9+ 版本支持副手。
• 锁定/解锁个人资料 (BETA)：

- 玩家可以通过权限锁定自己的个人资料，锁定后他人无法查看。

- 可设置特定权限来绕过锁定，查看被锁的资料。

• 启用/禁用查看功能 (BETA)：玩家可以禁用自己查看他人个人资料的功能（右键点击玩家将不会打开资料界面）。

- 此状态可通过 SQLite、MySQL 或 HikariCP 在不同服务器间持久化。

• 仅潜行模式 (BETA)：启用后，玩家需要潜行（按住 Shift）时右键点击其他玩家才能打开个人资料。
• 仅空手模式 (自 1.6-BETA)：启用后，只有空手时右键点击才能打开个人资料。
• 个人资料行数 (BETA)：可以自定义个人资料 GUI 的行数（更改后需要重启服务器）。

交互与命令

• 点击执行命令 (BETA)：点击物品可以执行命令。命令将以点击的玩家身份执行，非常适合 RPG 服务器（例如执行 /warp market 或 /trade <玩家>）。
• 丰富的命令修饰符 (自 1.6-BETA)：支持多种命令执行方式，如以控制台身份执行、发送消息、显示动作栏、显示标题等。完整列表请查阅 Wiki。
• 离线玩家替代命令 (自 1.6-BETA)：当玩家尝试查看离线玩家的资料时，可以执行预设的命令（此功能实用性有限，建议保持关闭）。
• 命令别名 (BETA)：可以为插件的主命令 /betterprofiles 和资料查看命令 /profile 设置别名。

其他功能

• 开发者 API (BETA)：提供 API 供开发者调用，以便为玩家打开个人资料界面，并允许监听事件和修改已打开的库存。
• 配置自动更新：插件更新时，配置文件会自动更新（注释会被移除）。
• 更新检查器：当有新版本可用时会收到通知。
• 自定义提示信息：可配置当玩家无权通过右键点击或命令查看资料时显示的提示信息。

🔧安装与配置

安装步骤

• 从 SpigotMC.org 下载插件。
• 将 jar 文件放入服务器的 plugins 文件夹。
• 重启服务器。
• 根据需要编辑配置文件（主要是 config.yml 和 items.yml）。
• 再次重启服务器以使配置生效。

配置文件

• ✪ config.yml：主配置文件，包含权限、世界设置、界面行数等全局选项。
• ✪ items.yml：自定义物品配置文件，用于添加和管理所有显示在个人资料中的物品。

权限与命令

所有权限和命令均可在配置文件中进行自定义。详细的命令和权限列表，请查看我们的 GitHub。

❓常见问题 (FAQ)

• 1) 为什么标注为 BETA？是有很多漏洞吗？

- 答：不，插件应该没有漏洞。使用 BETA 标签只是因为我喜欢这个词。

• 2) 我喜欢你的插件，可以为你提新插件的点子吗？

- 答：当然，欢迎加入我的 Discord 服务器并提出建议。我会评估并决定是否开发。提出建议不意味着一定会被制作。

• 3) 为什么这个插件是免费的？

- 答：为什么不呢？

• 4) 我可以创建新的自定义物品吗？

- 答：可以。你还可以为每个物品设置独立权限，从而实现管理员、捐赠者与普通玩家看到不同物品。

• 5) 我可以添加点击执行命令的功能吗？

- 答：可以。所有命令都将以点击物品的玩家身份执行。这非常有用，例如可以用于打开惩罚 GUI、发起交易、请求传送、冻结目标等。

• 6) 我可以在某些世界禁用个人资料功能吗？

- 答：可以。只需在 `config.yml` 的 `Disabled-worlds` 列表中添加世界名称即可。

• 7) 截图里显示玩家等级的插件是什么？

- 答：那是 **AlonsoLevels**，一个为全网络添加等级系统的免费插件。可以在这里获取。

• 8) 截图里显示社交媒体的插件是什么？

- 答：那是 **BetterSocial**，允许玩家分享社交媒体链接而无需刷屏。可以在这里获取。

• 9) 我太喜欢了！如何支持你？

- 答：你可以加入我的 Discord 并向朋友推荐我的插件，也可以请求你喜欢的 YouTuber 评测我的插件。当然，捐赠也是欢迎和支持我的方式。

• 10) 我可以把这个插件发布到 mcbbs.net 吗？

- 答：**不可以。**

• 11) 你确定吗？

- 答：是的，我确定。**严禁**发布。

• 12) 求助！插件在我的服务器上不工作！

- 答：在发布评论前，请确保已安装所有前置插件。如果问题依旧，请将服务器启动日志粘贴到 [https://sourceb.in/](https://sourceb.in/)，然后在讨论区发帖或加入我的 Discord 服务器寻求帮助。

✨开发者信息

API 访问

开发者可以通过 com.alonsoaliaga.betterprofiles.api.BetterProfilesAPI 访问插件 API。

详细的开发者 API 文档请查看我们的 GitHub。

依赖

• NBT API：必需。本插件使用 NBT 标签。
• [LIB]ArmorEquipEvent：非必需。该库已编译在插件内。

🔧支持与反馈

如果你发现了漏洞、错误，或者想请求新功能，请加入我的 Discord 服务器或使用项目的 Issue 跟踪器。请不要在评论区域报告错误。

如果你因为使用我的免费插件而省下了购买其他插件的费用，并且喜欢我的工作，可以考虑通过捐赠来支持我继续开发更多类似的插件。

***

下载即表示您同意以下条款：

• 您不得以任何形式（包括作为任何软件包的一部分）重新分发本插件。
• 您不得以任何形式对本插件进行反编译或修改。
• 您不得声称本资源是您自己的创作。