PixelVip - VIP管理插件

简介

PixelVip 是一款功能强大的 VIP 管理插件，通过简单的命令和配置，为您的服务器提供丰富的 VIP 功能。它支持生成使用次数有限的密钥、多 VIP 管理、BungeeCord 网络同步，并能与权限系统完美协作。

💡重要链接

• 获取开发版本：访问 Jenkins 获取最新构建。
• 依赖项：本插件需要 Vault 才能正常运行。
• 社区与支持：加入我们的 Discord 聊天，获取开发版本和快速支持。
• 视频教程：观看 FabioZumbi12 制作的葡萄牙语视频教程。
• Bukkit 版本：访问 Bukkit 插件页面。
• 开源代码：插件源代码托管于 GitHub。

🎮核心功能

• 生成可设置使用次数的 VIP 密钥。
• 生成可执行命令的“物品密钥”，用于发放物品或权限。
• 与 RankUp 插件 100% 兼容，添加 VIP 权限组时不会移除玩家原有组。
• 允许玩家同时激活多个不同的 VIP，并可自由切换。
• 支持 Spigot 与 BungeeCord 网络间的完全同步。
• VIP 时间从激活瞬间开始精确计算，而非按自然日重置，确保玩家享受完整的 VIP 时长。
• 可配置在 VIP 变更、移除或到期时执行的命令。
• 支持基于百分比概率，在使用密钥时给予玩家额外物品。
• 记录玩家的原权限组，VIP 到期后自动恢复。
• 通过 Vault 自动更改玩家权限组。
• 支持 100% 自定义文本翻译。
• 提供权限组的 TAB 自动补全。
• 基于毫秒的时间计数器，无需频繁将 VIP 时间保存至文件。

🔧命令与权限

默认情况下，玩家拥有 pixelvip.cmd.player 权限，其他权限仅 OP 拥有。[] 内为必填参数，{} 内为可选参数。

玩家命令

• 命令：/usekey [密钥|交易ID]

-   **别名**：`/usarkey`

-   **权限**：`pixelvip.cmd.player`

-   **描述**：使用生成的密钥激活 VIP，或使用支付/订单 ID 自行激活。

• 命令：/viptime

-   **别名**：`/tempovip`

-   **权限**：`pixelvip.cmd.player`

-   **描述**：如果玩家是 VIP，可查看剩余天数。

• 命令：/setactive [权限组] {玩家名}

-   **别名**：`/changevip`, `/trocarvip`

-   **权限**：`pixelvip.cmd.player` (使用 `{玩家名}` 参数时需要 `pixelvip.cmd.setactive`)

-   **描述**：如果玩家激活了多个 VIP，可切换至另一个。

• 命令：/getvariant [ID] [变量名]

-   **别名**：`/getvar`, `/getv`

-   **权限**：`pixelvip.cmd.player`

-   **描述**：允许玩家获取之前激活密钥时可用的变体选项。

管理员命令

• 命令：/newkey [权限组] [天数] {使用次数}

-   **别名**：`/gerarkey`

-   **权限**：`pixelvip.cmd.newkey`

-   **描述**：根据配置的长度和现有 VIP 组生成新密钥，可指定同一密钥的使用次数。

• 命令：/newitemkey [命令1, 命令2, ...]

-   **别名**：`/newikey`, `/gerarikey`

-   **权限**：`pixelvip.cmd.newitemkey`

-   **描述**：生成一个新的“物品密钥”，使用时可执行指定命令来发放物品。

• 命令：/additemkey [密钥] [命令1, 命令2, ...]

-   **别名**：`/addikey`

-   **权限**：`pixelvip.cmd.additemkey`

-   **描述**：向现有的 VIP 密钥或物品密钥添加物品（命令）。

• 命令：/delkey [密钥]

-   **权限**：`pixelvip.cmd.delkey`

-   **描述**：删除任何类型的已生成密钥。

• 命令：/listkeys

-   **权限**：`pixelvip.cmd.listkeys`

-   **描述**：列出所有可用密钥。

• 命令：/removevip [玩家名] {权限组}

-   **别名**：`/delvip`

-   **权限**：`pixelvip.cmd.removevip`

-   **描述**：移除玩家的一个 VIP（若指定 `{权限组}`），或移除其所有 VIP（若不指定），并将玩家恢复至之前的权限组。

• 命令：/addvip [玩家名] [权限组] [天数]

-   **别名**：`/givevip`, `/darvip`

-   **权限**：`pixelvip.cmd.addvip`

-   **描述**：无需密钥即可为玩家添加 VIP，并发放激活物品。若用于已存在的 VIP 方案，天数将累加。

• 命令：/setvip [玩家名] [权限组] [天数]

-   **权限**：`pixelvip.cmd.setvip`

-   **描述**：无需密钥即可为玩家添加 VIP，但不发送激活物品（静默激活）。若用于已存在的 VIP 方案，天数将累加。

• 命令：/sendkey [玩家名] [密钥|VIP组] [天数] {使用次数}

-   **别名**：`/enviarkey`

-   **权限**：`pixelvip.cmd.sendkey`

-   **描述**：生成一个密钥并发送给玩家，或发送一个先前生成的密钥。

• 命令：/givepackage [玩家名] [ID]

-   **别名**：`/gpkg`, `/gpackage`, `/givep`

-   **权限**：`pixelvip.cmd.givepackage`

-   **描述**：向玩家发放一个命令和变体（如已设置）的礼包。通常由控制台用于自助激活。

• 命令：/listpackages

-   **别名**：`/listp`

-   **权限**：`pixelvip.cmd.listpackage`

-   **描述**：列出所有可用礼包及其是否包含变体。

• 命令：/addpackage [ID] [hand|command] {命令1, 命令2}

-   **别名**：`/addp`

-   **权限**：`pixelvip.cmd.addpackage`

-   **描述**：从手中物品或使用 `{p}` 作为占位符的命令来添加一个礼包。

• 命令：/delpackage [ID]

-   **别名**：`/delp`

-   **权限**：`pixelvip.cmd.delpackage`

-   **描述**：删除一个礼包。

• 命令：/pixelvip reload

-   **权限**：`pixelvip.cmd.pixelvip`

-   **描述**：重新加载配置文件。

✨BungeeCord 同步（测试版）

PixelVip 已具备（测试版）BungeeCord 协同工作能力，可在所有 Bungee 服务器间同步 VIP 方案。

安装方法

• 将下载的相同 jar 文件放入 BungeeCord 的 plugins 文件夹。
• 在您的 Spigot 服务器上，下载最新版本（1.0.2+）插件，进入 /plugins/PixelVip 目录，修改 config.yml 中的以下选项：

-   在 `serverID` 处，设置与 BungeeCord `config.yml` 中相同的服务器名称。必须使用相同 ID 以避免命令/同步循环。

• 确保在所有服务器的权限插件中添加相同的权限组。
• 完成更改后，使用 /pixelvip reload。

同步机制

当有人在启用同步的服务器上执行 PixelVip 命令时，相关参数将被发送到所有其他启用 Bungee 同步的服务器。

此同步不使用计划任务！仅在以下玩家操作时发送参数：

• 激活密钥时
• 生成密钥时
• 切换 VIP 时（如果激活了多个）
• VIP 到期时
• VIP 被移除时

注意事项

• BungeeCord 需要至少一名玩家在 Bungee 服务器上在线才能接收参数。如果某个同步服务器上没有玩家在线，该操作将保持挂起状态，直到有玩家加入。
• 此功能尚未经过 100% 测试（目前约 90%），正在更多环境和情况下进行测试。

❓待办事项

• 您有功能建议吗？欢迎反馈。

💡安装指南

请按照以下步骤安装 PixelVip 插件

• 从下载按钮获取插件的 .jar 文件。
• 将此文件放入您服务器的 plugins 文件夹中。
• 启动服务器，等待配置文件自动生成，然后停止服务器。
• 进入 plugins/Pixelvip 目录，根据您的需求设置配置文件。
• 再次启动服务器。

重要提示

• 在开启问题工单或前往 Discord 寻求支持前，请务必仔细阅读所有配置文件。
• 如需完整的配置与使用指南，请查阅我们的 Wiki。
• 欢迎加入我们的 Discord 社区进行交流：[Discord](Discord)
• 如有问题或建议，请通过我们的 [GitHub](GitHub) 页面提交。