Nickname Request - 昵称申请系统

💡简介

Nickname Request Lite 是一款轻量级的独立昵称系统，让玩家可以轻松申请自定义昵称。它适用于所有使用标准 Spigot getDisplayName() 方法的插件。在玩家较多的服务器中，管理员常常需要手动处理大量昵称修改请求。本插件允许玩家随时提交申请，管理员上线后即可审批，玩家将在下次登录或在线时收到通知。

🎮功能特性

• 昵称申请：玩家可提交昵称申请，等待管理员审批。
• 权限化格式控制：精确控制每位玩家可使用的颜色与格式代码。
• 申请冷却：防止玩家频繁提交申请。
• 申请限制：可对特定玩家临时或永久禁止申请昵称。
• 自定义语言文本：支持修改所有提示信息。
• 数据存储：支持 MySQL 和本地文件存储，并可相互迁移数据。
• Vault 支持：与权限组插件兼容。
• StaleAPI 支持：与 StaleAPI 集成，自动清理过期数据。
• 交互式聊天审批：管理员可直接在聊天界面点击按钮审批，无需输入命令。

🔧安装与配置

前置需求

• 服务器需运行 Spigot、Paper 或兼容的 CraftBukkit 核心。
• 如需 Vault 支持，请安装 Vault 插件。
• 如需 StaleAPI 支持，请安装 StaleAPI 插件。

配置说明

配置文件内容不多，主要选项为 nick-format，用于定义昵称在服务器内部的显示格式（例如模仿 Essentials 的组前缀样式）。修改配置后，请重启服务器（避免使用 /reload）。

⭐命令列表

所有命令均有对应的权限节点控制访问。

• /nick request - 提交一个昵称申请。
• /nick accept <用户名> - 批准某玩家的昵称申请。
• /nick deny <用户名> - 拒绝某玩家的昵称申请。
• /nick status - 查看自己待处理的申请状态。
• /nick set [用户名] <昵称> - 设置自己或他人的昵称。
• /nick remove [用户名] - 移除自己或他人的昵称。
• /nick cancel - 取消自己待处理的申请。
• /nick list - 列出所有待处理的昵称申请。
• /nick restrict <用户名> [时间] - 限制某玩家申请昵称的权限（可设时长）。
• /nick unrestrict <用户名> - 解除对某玩家的申请限制。
• /nick info [用户名] - 查看自己或他人的昵称信息。

✨权限节点

基础权限

• nicknamerequest.request - 使用 /nick request
• nicknamerequest.accept - 使用 /nick accept
• nicknamerequest.deny - 使用 /nick deny
• nicknamerequest.status - 使用 /nick status
• nicknamerequest.set - 使用 /nick set
• nicknamerequest.remove.self - 使用 /nick remove 移除自己的昵称
• nicknamerequest.remove.others - 移除他人的昵称
• nicknamerequest.cancel - 使用 /nick cancel
• nicknamerequest.list - 使用 /nick list
• nicknamerequest.notify - 当有新申请或申请被处理时收到通知
• nicknamerequest.restrict - 使用 /nick restrict 和 /nick unrestrict
• nicknamerequest.info - 使用 /nick info 查看自己的信息
• nicknamerequest.info.others - 查看他人的昵称信息

格式与颜色权限

默认情况下，玩家无权使用任何格式代码。请根据需要授予以下权限。

通用格式：

• nicknamerequest.allow.bold
• nicknamerequest.allow.italic
• nicknamerequest.allow.underline
• nicknamerequest.allow.strikethrough
• nicknamerequest.allow.obfuscated

颜色代码：

• nicknamerequest.allow.dark_blue
• nicknamerequest.allow.dark_green
• nicknamerequest.allow.dark_aqua
• nicknamerequest.allow.dark_red
• nicknamerequest.allow.dark_purple
• nicknamerequest.allow.dark_gray
• nicknamerequest.allow.black
• nicknamerequest.allow.gold
• nicknamerequest.allow.gray
• nicknamerequest.allow.blue
• nicknamerequest.allow.green
• nicknamerequest.allow.aqua
• nicknamerequest.allow.red
• nicknamerequest.allow.yellow
• nicknamerequest.allow.white
• nicknamerequest.allow.light_purple

额外权限：

• nicknamerequest.allow.spaces - 允许昵称中包含空格

❓已知问题

• 当玩家权限组变更后，其昵称/显示名不会立即更新前缀/后缀，需要重新登录才能生效。
• 使用 /nick set 用户名 带空格的昵称 为他人设置昵称时，只会应用第一个单词（例如输入“some nick”只会应用“some”）。
• 插件目前处于 Alpha 阶段，可能存在其他未知错误，我们会持续修复。

🔧与其他插件配合使用

与 Essentials 共存

若想禁用 Essentials 的昵称功能，让 Nickname Request 完全接管，请按以下步骤操作：

• 打开 Essentials 的 config.yml。
• 找到 change-displayname 并设为 false。
• 找到 add-prefix-suffix 并设为 false。
• 找到 disabled-commands，取消注释或添加 - nick。
• （可选）在 Spigot/Paper/Bukkit 的 commands.yml 中，添加 nick: - nicknamerequest:nick $1- 以将 /nick 命令完全指向本插件。

与 Towny、TownyChat 和 Essentials 共存

如果在 TownyChat 的 ChatConfig.yml 中使用 {modplayername} 来显示组前缀和昵称，你可能需要相应地添加 {permprefix} 或 {permsuffix} 占位符。

已支持的集成

• StaleAPI：如果安装了 StaleAPI，昵称和待处理请求将根据其指令自动过期。

💡重要提示

• 当前版本为 v0.10 Alpha，请留意可能存在的错误。该插件已在实际繁忙的服务器上运行，大部分问题会得到快速修复。
• 欢迎在插件讨论区提交建议、错误报告或问题反馈。
• 如果您在 2015 年 5 月 12 日之前发布过同名插件，请联系我们，我们愿意更改插件名称。

支持开发

如果您觉得这个插件有用，可以考虑通过 PayPal 捐赠来支持后续开发。感谢您的支持！

使用本插件的服务器

• Phoenix MCN - http://p-n.ca/

想让您的服务器出现在这里？请在插件讨论区留下服务器名称和网址。