AlonsoTags • Unlimited tags! Textures! Custom model data! - AlonsoTags • 无限标签与材质

💡重要须知

本插件允许玩家自由选择称号，支持纹理材质，易于设置且高度可定制。请注意，使用前必须安装 NBTAPI，并搭配权限插件。不支持 Plugman 等插件重载。请尊重作者劳动成果，不得在任何配置中重新分发本插件，亦不得在 MCBBS 等平台发布、移动或复制。仅支持各 Minecraft 主版本的最新子版本（例如仅 1.16.5，而非 1.16.4）。如需贡献翻译，欢迎直接联系作者。

---

🎮核心特性

基础功能

• 多版本支持 (BETA)：支持帖子顶部指定的 Minecraft 版本，请务必使用各版本的最新发布。
• 无限称号 (BETA)：可添加任意数量的称号，插件会自动分页显示。
• 自定义模型数据支持 (BETA) (1.14+)：可为称号图标使用自定义纹理。
• 框架物品：GUI 使用黑色染色玻璃作为框架，可禁用或为其设置自定义模型数据。
• 每称号自定义物品 (BETA)：可为每个称号选择任意材料作为图标。
• 纹理头颅支持 (BETA)：可为每个称号图标添加自定义纹理（支持来自 minecraft-heads.com 的纹理）。
• 自定义描述与名称 (BETA)：可为称号设置不同的显示名称和描述（Lore），并根据其状态（已选择、已解锁、已锁定）显示不同的描述。
• PlaceholderAPI 支持 (BETA)：主物品（玩家头颅，位于槽位 49）支持 PlaceholderAPI，可显示玩家信息。
• 数据库支持 (BETA)：支持 SQLite（本地存储）和 MySQL（跨服务器同步）。
• 允许的世界 (BETA)：可配置仅在特定世界对普通玩家开放称号命令。
• 锁定称号 (BETA)：可为锁定称号设置全局纹理或自定义模型数据，并可混淆其显示名称（使用代码 &4&k&l，不可更改）。
• HikariCP 支持 (BETA)：MySQL 连接使用 HikariCP，可添加源属性（如 useSSL）。若遇问题，也可切换至普通 MySQL 连接。
• 解析“无”类占位符 (BETA)：可在默认（“无”类别）占位符中使用 PlaceholderAPI 占位符（此功能不会解析称号内的占位符）。
• 自定义权限 (BETA)：可为每个称号设置独立权限，也支持设置为 "none" 即无需权限。
• 命令别名 (BETA)：可为主命令设置不同的别名。注意：更改后必须重启服务器才能生效。

集成与扩展

• Vault 支持 (新功能 1.0-BETA)：可创建需购买的称号。此功能需要 Vault 及经济插件，目前处于测试阶段，请在使用前报告任何错误。
• EssentialsChat 支持 (BETA)：若使用 EssentialsChat，可启用此选项以支持占位符。只需在任一作者插件中启用即可。
• 兼容 NametagEdit (BETA)：可在玩家头顶显示称号前缀（推荐使用 TAB 替代）。
• 配置自动更新：插件更新时，配置文件会自动更新（注释将被移除）。
• 更新检查器：在有新版本时接收通知。

---

🔧配置文件说明

✪ config.yml

• 支持设置材料、纹理和随机材料。
• 包含 17 个默认称号。
• 可移除 GUI 框架，并支持为其设置自定义模型数据 (1.14+)。
• 称号数量无限制，自动分页显示。
• 包含用于显示当前称号的玩家头颅物品，以及未选择称号时的默认头颅物品。
• 可为称号的不同状态（已选择、可用、锁定）设置自定义描述。
• 提供无限可能性，由您决定显示内容。

✪ tags.yml

• 在此文件中配置所有称号。

---

✨与其他插件联动

• 奖励与活动：可结合其他奖励插件，通过授予权限来让玩家解锁特定称号，以此促进玩家活跃度。例如，可使用作者的另一插件 AlonsoLevels，在玩家升级时给予称号作为奖励。
• 在名牌中显示称号：需要安装 NametagEdit。
• 在聊天中显示称号：需要安装 PlaceholderAPI 及支持它的聊天插件。
• 在记分板中显示称号：需要安装 PlaceholderAPI 及支持它的记分板插件。
• 占位符使用：选择新称号时的提示消息支持占位符，可在任何需要的地方使用（需要 PlaceholderAPI 及相应的聊天/记分板插件）。
• 部分 Unicode 支持 (BETA)。

---

❓安装与使用

安装步骤

• 从 SpigotMC.org 下载插件。
• 将 jar 文件放入服务器的 plugins 文件夹。
• 重启服务器。
• 根据需要编辑配置文件 (config.yml, tags.yml)。
• 再次重启服务器以使配置生效。
• 权限在配置文件中进行配置。

命令与权限

请前往我们的 GitHub 页面查看完整的命令和权限列表。

开发者 API

插件提供 API 供开发者使用。

• 访问路径：com.alonsoaliaga.alonsotags.api.AlonsoTagsAPI
• 详情请查看：我们的 GitHub 开发者 API 页面。

---

⭐常见问题解答 (FAQ)

• 为什么标注为 BETA？这意味着有漏洞吗？

答：不，插件应该没有漏洞。使用 BETA 标签只是作者的个人偏好。

• 我喜欢你的插件，可以提新插件的建议吗？

答：当然可以，请加入我的 Discord 服务器并提出。我会评估建议，但这不意味着一定会被实现。

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

答：为什么不呢？

• 你能添加 Vault 支持来让称号可购买吗？

答：不能。本插件的设计初衷是让您通过其他插件（以奖励形式）或您的网络商店（用真实货币）来发放称号，以促进玩家活跃度。

• “促进玩家活跃度”是什么意思？

答：有些插件允许服务器所有者因玩家的特定行为（如投票、升级等）给予奖励。您可以设置奖励命令，为玩家添加使用特定称号所需的权限。

• 我不知道用什么插件来实现，有推荐吗？

答：您可以使用我的另一个插件 **[AlonsoLevels](https://www.spigotmc.org/resources/73351/)**。它可以在您的服务器网络中建立等级系统，并允许玩家在达到特定等级时解锁奖励（物品、执行命令等）。

• 你会为插件添加新功能吗？

答：不确定。如果收到非常棒且不改变插件本质的建议，我可能会添加（提出建议不保证会被采纳）。

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

答：您可以加入我的 Discord 并与朋友分享我的插件，也可以请求您喜欢的 YouTuber 评测我的插件。捐赠同样欢迎，所有捐赠都将被感激。

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

答：**不可以。**

• 你确定吗？

答：是的，非常确定。您不被允许发布它。

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

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

---

💡依赖与支持

• 必需依赖：

- **NBTAPI**：本插件需要使用 NBT 标签。请确保已安装。

- **权限插件**：必须安装一个权限管理插件。

• 可选依赖（用于特定功能）：

- **PlaceholderAPI**：用于在聊天、记分板等处显示称号。

- **NametagEdit**：用于在玩家头顶名牌显示称号。

- **Vault 及经济插件**：用于实现称号购买功能 (BETA)。

• 错误与建议：如果您发现任何漏洞、错误，或想请求新功能，请加入我的 Discord 或使用我们的 问题追踪器。请不要在评论区域报告错误。

---

🔧支持作者

我的插件为您节省了购买其他插件的费用吗？我的 网页工具 对您有用并节省了大量时间吗？如果您喜爱我的作品，请考虑支持我，以便我能继续开发更多这样的插件！

查看占位符列表：请访问我们的 GitHub 占位符页面。

---

💡条款与条件

下载此资源即表示您同意以下所有条款

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