PowerPerms [MySQL] [Global AND Per-World permissions and inheritance] - PowerPerms - 全能权限管理插件

PowerPerms 是一款基于等级的强力权限插件，让你能完全掌控玩家的权限。它功能丰富，支持 UUID、无限等级、继承、临时数据、伪装模式等多种特性，并提供多语言、多存储方式支持。

💡Discord 帮助聊天

• Discord 帮助聊天: https://discord.gg/e5QRdBw

✨主要特性

核心功能

• UUID 支持：使用玩家的 UUID 存储数据，确保玩家改名时数据不会丢失。
• 无限等级：可创建无限数量的等级，每个等级都有独立的选项和权限。
• 等级继承：支持全局和分世界的等级继承，让一个等级可以继承一个或多个其他等级的权限。
• 负权限：通过在权限前添加 - 字符来否定权限，这将从玩家身上移除该权限而非赋予。
• 前缀与后缀：可为玩家分配前缀和后缀，并会显示在其显示名称中。支持所有颜色代码。
• 每玩家/每世界数据：可为等级和玩家分配全局或分世界的权限、前缀等数据。
• 自定义昵称：拥有自定义昵称系统，允许玩家设置自己的显示名称，确保与前后缀兼容。支持所有颜色代码。
• 临时数据：可为等级和玩家分配无限数量的临时等级、权限、前缀等数据，这些数据将在指定时间后过期。
• 自动更新检查与安装器：每 30 分钟检查一次更新，并在发现新更新时通知控制台和拥有 powerperms.notify 权限的玩家。可使用 /taiga install PowerPerms <version> 命令更新。

构建与交互控制

• 构建选项：可指定构建选项以控制玩家是否能建造。将 build 设为 false 将阻止以下行为：

- 放置方块

- 破坏方块

- 点燃方块

- 与炼药锅交互

- 填充桶

- 清空桶

- 与画/物品展示框交互

独特功能

• 伪装模式：管理员可通过一个简单命令，假装拥有另一个等级的前缀和后缀，同时保留自己等级的权限。
• 多种存储选项：支持多种数据存储方式：

- Flatfile (YAML)

- MySQL

- SQLite

- MariaDB

- Redis

• 游戏内管理：使用 /powerperms 命令，可轻松在游戏内或控制台中修改等级和玩家数据。
• 完整的 Tab 补全：所有命令均支持完整的 Tab 补全，并带有高级权限检查。玩家只会看到他们拥有权限的命令的补全。
• 轻松转移玩家数据：拥有 /transfer 命令，可轻松将一名玩家的数据移动或复制到另一名玩家。
• 自动语言检测与可定制消息：通过读取数据包检测玩家的 Minecraft 语言设置，并用该语言发送消息。所有消息均可定制，并可添加任意语言。使用 TaigaCore 的 /language 命令可手动更改语言。

- 当前支持的语言：English (US)、English (UK)、Dutch (NL)、German (DE)、LOLCAT、Pirate Speak。

🔧安装步骤

• 如果你在服务器上使用过 PowerPerms v1.2.2 或更低版本，请删除旧版本。
• 在服务器上安装 TaigaCore。
• 使用命令 /taiga install PowerPerms <version> 在服务器上安装 PowerPerms。
• 重启服务器，或使用命令 /taiga load PowerPerms 和 /taiga enable PowerPerms 来启用 PowerPerms。
• 配置 PowerPerms。配置说明详见下文。
• 重启服务器以使配置更改生效。

重要提示：更新前请务必阅读 Spigot 上的更新日志！

🎮命令列表

主要命令

• /rank <player> [rank] [time]

- 权限：`powerperms.player.rank`

- 别名：`/setrank`

- 查看或设置玩家的等级。使用 `[time]` 可为玩家分配临时等级。时间格式为：年(y)、天(d)、小时(h)、分钟(m)、秒(s)。例如：`/rank bys1 vip 1y 30d 12h 30m 10s`。使用 `-r` 标志作为 `[rank]` 来移除等级。为 `[time]` 指定原始时间字符串 (yyyyMMddHHmmss) 来移除临时等级。

• /transfer <player> <target> [-c]

- 权限：`powerperms.transfer`

- 将指定玩家的所有数据转移到指定目标。默认移动数据，使用 `-c` 标志可复制数据。

• /undercover <rank|off> [player]

- 权限：`powerperms.undercover`

- 别名：`/uc`

- 进入伪装模式：假装拥有另一个等级，获得该等级的前缀和后缀，同时保留自己等级的权限。

• /nick <nick|off> [player]

- 权限：`powerperms.nick`

- 别名：`/nickname`

- 为自己或他人设置昵称。支持所有颜色代码。

• /powerperms [args...]

- 权限：`powerperms.powerperms`

- 别名：`/pp`

- PowerPerms 主命令。

子命令

• /powerperms help

- 权限：`powerperms.help`

- 显示所有 PowerPerms 命令列表。

• /powerperms version

- 权限：`powerperms.version`

- 显示基本版本信息。

• /powerperms reload

- 权限：`powerperms.reload`

- 重载 PowerPerms。

- **注意**：建议重启服务器而非重载。

• /powerperms default [new]

- 权限：`powerperms.rank.default`

- 查看或设置默认等级。

• /powerperms player <player>

- 权限：`powerperms.player`

- 查看指定玩家的数据。

• /powerperms player <player> rank [new] [time]

- 权限：`powerperms.player.rank`

- 查看或设置玩家的等级。更多信息请参考 `/rank` 命令。

• /powerperms rank <rank>

- 权限：`powerperms.rank`

- 查看指定等级的信息。

• /powerperms <player|rank> <name> <prefix|suffix|build> [global|world] [world] [new] [time]

- 权限：`powerperms.player|rank.prefix|suffix|build`

- 查看或设置指定玩家或等级的全局或分世界前缀、后缀或构建选项。使用 `[time]` 设置临时值。时间格式请参考 `/rank` 命令。对 `[new]` 使用 `-r` 标志来移除前缀、后缀或构建选项；对 `[time]` 使用原始时间字符串 (yyyyMMddHHmmss) 来移除临时数据。

• /powerperms <player|rank> <name> permissions list [global|world] [world]

- 权限：`powerperms.player|rank.permissions`

- 列出指定玩家或等级的全局或分世界权限。

• /powerperms <player|rank> <name> permissions add <global|world> [world] <permission> [time]

- 权限：`powerperms.player|rank.permissions.add`

- 为指定玩家或等级添加全局或分世界权限。使用 `[time]` 分配临时权限。时间格式请参考 `/rank` 命令。

• /powerperms <player|rank> <name> permissions remove <global|world> [world] <permission>

- 权限：`powerperms.player|rank.permissions.remove`

- 从指定玩家或等级移除全局或分世界权限。

⭐权限节点

通知与工具

• powerperms.notify - 允许你接收更新、等级变更等通知。
• powerperms.transfer - 允许你使用 /transfer。

伪装模式

• powerperms.undercover - 允许你使用 /undercover 进行伪装。
• powerperms.undercover.others - 允许你对其他玩家使用 /undercover。
• powerperms.undercover.* - 授予你所有 powerperms.undercover 权限。

昵称

• powerperms.nick - 允许你使用 /nick 设置昵称。
• powerperms.nick.others - 允许你为其他玩家设置昵称。
• powerperms.nick.color - 允许你在昵称中使用颜色。
• powerperms.nick.format - 允许你在昵称中使用格式。
• powerperms.nick.magic - 允许你在昵称中使用魔法（混淆）。
• powerperms.nick.* - 授予你所有 powerperms.nick 权限。

主命令与帮助

• powerperms.powerperms - 允许你使用 /powerperms。
• powerperms.help - 允许你使用 /powerperms help。
• powerperms.version - 允许你使用 /powerperms version。
• powerperms.reload - 允许你使用 /powerperms reload。

玩家数据管理

• powerperms.player - 允许你使用 /powerperms player ...。
• powerperms.player.rank - 允许你使用 /rank 和 /powerperms player <player> rank。
• powerperms.player.rank.exempt - 防止其他玩家设置你的等级。
• powerperms.player.rank.undercover - 允许你查看玩家的真实等级和伪装等级。
• powerperms.player.rank.main - 允许你设置玩家的主等级。
• powerperms.player.rank.temp - 允许你为玩家分配临时等级。
• powerperms.player.rank.assign.<rank> - 允许你将指定等级分配给玩家。
• powerperms.player.rank.assign.* - 允许你分配所有等级。
• powerperms.player.rank.* - 授予你所有 powerperms.player.rank 权限。

• powerperms.player.prefix - 允许你查看玩家的前缀。
• powerperms.player.prefix.main - 允许你设置玩家的主前缀。
• powerperms.player.prefix.temp - 允许你为玩家分配临时前缀。
• powerperms.player.prefix.* - 授予你所有 powerperms.player.prefix 权限。

• powerperms.player.suffix - 允许你查看玩家的后缀。
• powerperms.player.suffix.main - 允许你设置玩家的主后缀。
• powerperms.player.suffix.temp - 允许你为玩家分配临时后缀。
• powerperms.player.suffix.* - 授予你所有 powerperms.player.suffix 权限。

• powerperms.player.build - 允许你查看玩家的构建选项。
• powerperms.player.build.main - 允许你设置玩家的主构建选项。
• powerperms.player.build.temp - 允许你为玩家分配临时构建选项。
• powerperms.player.build.* - 授予你所有 powerperms.player.build 权限。

• powerperms.player.permissions - 允许你查看玩家的权限。
• powerperms.player.permissions.add - 允许你使用 /powerperms player <player> permissions add。
• powerperms.player.permissions.add.main - 允许你为玩家添加主权限。
• powerperms.player.permissions.add.temp - 允许你为玩家添加临时权限。
• powerperms.player.permissions.add.* - 授予你所有 powerperms.player.permissions.add 权限。
• powerperms.player.permissions.remove - 允许你从玩家移除权限。
• powerperms.player.permissions.* - 授予你所有 powerperms.player.permissions 权限。
• powerperms.player.* - 授予你所有 powerperms.player 权限。

等级数据管理

• powerperms.rank - 允许你使用 /powerperms rank ...。
• powerperms.rank.default - 允许你查看默认等级。
• powerperms.rank.default.set - 允许你设置默认等级。
• powerperms.rank.default.* - 授予你所有 powerperms.rank.default 权限。

• powerperms.rank.prefix - 允许你查看等级的前缀。
• powerperms.rank.prefix.main - 允许你设置等级的主前缀。
• powerperms.rank.prefix.temp - 允许你为等级分配临时前缀。
• powerperms.rank.prefix.* - 授予你所有 powerperms.rank.prefix 权限。

• powerperms.rank.suffix - 允许你查看等级的后缀。
• powerperms.rank.suffix.main - 允许你设置等级的主后缀。
• powerperms.rank.suffix.temp - 允许你为等级分配临时后缀。
• powerperms.rank.suffix.* - 授予你所有 powerperms.rank.suffix 权限。

• powerperms.rank.build - 允许你查看等级的构建选项。
• powerperms.rank.build.main - 允许你设置等级的主构建选项。
• powerperms.rank.build.temp - 允许你为等级分配临时构建选项。
• powerperms.rank.build.* - 授予你所有 powerperms.rank.build 权限。

• powerperms.rank.permissions - 允许你查看等级的权限。
• powerperms.rank.permissions.add - 允许你使用 /powerperms rank <rank> permissions add。
• powerperms.rank.permissions.add.main - 允许你为等级添加主权限。
• powerperms.rank.permissions.add.temp - 允许你为等级添加临时权限。
• powerperms.rank.permissions.add.* - 授予你所有 powerperms.rank.permissions.add 权限。
• powerperms.rank.permissions.remove - 允许你从等级移除权限。
• powerperms.rank.permissions.* - 授予你所有 powerperms.rank.permissions 权限。
• powerperms.rank.* - 授予你所有 powerperms.rank 权限。

通配符权限

• powerperms.* - 授予你所有 PowerPerms 权限。

🔧配置说明

config.yml

这是 PowerPerms 的主配置文件，用于管理数据存储和等级。

• logging：日志级别，可选 INFO、NOTICE 或 DEBUG。

- `INFO`：仅显示警告、错误和一些非常基本的消息。

- `NOTICE`：通知你更多事情，如等级变更。

- `DEBUG`：显示多条消息以加速发现错误时的调试。

• data：数据存储管理。

- `type`：存储类型，可选 `FLATFILE`、`MYSQL`、`SQLITE`、`MARIADB` 或 `REDIS`。

- `host`：MySQL、MariaDB 或 Redis 的数据库主机地址，或 SQLite 的文件路径。

- `port`：MySQL、MariaDB 或 Redis 的数据库端口。

- `username` / `password`：数据库用户名和密码。

- `database`：MySQL 或 MariaDB 的数据库名称。

• default：指定默认等级。新玩家加入服务器时将被分配此等级。
• ranks：最重要的部分。在此处添加和修改等级及其权限、前缀、后缀和构建选项。
• players：当使用 YAML 作为存储选项时，玩家数据存储在此处。它以与 ranks 相同的方式存储每玩家的权限和其他数据。玩家的 rank 和 temp-rank 也存储在此处。此外还存储玩家的 name（仅用于方便识别，PowerPerms 不使用此名称）。

lang/config.yml

此文件管理所有语言。玩家加入时，PowerPerms 会在收到数据包后立即在此文件中查找玩家的语言环境。如果找到，将使用指定的文件向玩家发送消息。如果未找到，则将使用默认语言。

lang/en_us.yml

英语（美国）语言文件。可在此管理此语言的所有玩家消息。像 %player% 这样的占位符在发送给玩家时会自动替换为值。

有关配置 PowerPerms 的更深入教程，请点击此处。

❓常见问题解答

在寻求支持前，请先查看以下常见问题列表。

• 求助！如何正确设置 PowerPerms？

PowerPerms 的配置说明如上。关于如何设置 PowerPerms 的详细教程请[点击此处](https://www.spigotmc.org/resources/22812/)。如果仍然无法使 PowerPerms 工作，请联系我。更多信息请查看下文的支持部分。

• 求助！前缀和后缀不起作用 / 它一直显示 [default] 作为玩家的前缀！

如果一直看到 `[default]` 作为玩家的前缀，并且/或者你配置的前缀和后缀没有显示，这很可能是 Essentials 插件的问题。Essentials 会修改玩家的显示名称并添加自己的前缀。要解决此问题，请转到 Essentials 的配置文件（位于 `plugins/Essentials/config.yml`），将选项 `change-displayname` 设置为 `false`。重启服务器，PowerPerms 的前缀和后缀应该就能正常工作了。

• 求助！我发现了漏洞 / 我遇到了错误！

如果某些功能无法正常工作，或者控制台中出现错误，请就此事联系我，我会尽快尽力解决。更多信息请查看下文的支持部分。

• 支持 BungeeCord 吗？

PowerPerms 无法安装在 BungeeCord 代理上，因此没有高级的跨服务器支持。但是，如果你为多个服务器使用相同的数据库（例如使用相同的 MySQL 数据库），则玩家数据将在这些服务器之间同步。请注意，如果你有两个服务器使用相同的数据库但等级名称完全不同，这可能是个坏主意——如果等级不存在，PowerPerms 将使用默认等级。