VipSystem - VIP管理插件

VipSystemEx 是一款专为 Minecraft 服务器设计的 VIP 管理系统插件。它支持永久、限时、可切换的 VIP 用户组，并使用高效的缓存数据库，能帮助您轻松管理服务器的 VIP 权限。

💡联系与支持

• Discord: 由于网络限制，可能无法访问。
• 推荐联系方式: 请通过站内私信 (PM) 或电子邮件联系。
• 电子邮箱: [email protected]

🎮功能简介

VipSystemEx 可以帮助您管理服务器的 VIP 用户。

• 支持永久、限时、可切换的 VIP 用户组。
• 使用带索引的缓存 MySQL 或 SQLite 数据库。
• 支持启用/禁用连接池（默认启用），确保兼容性与运行效率。

🔧基本使用指南

准备工作

• 将插件安装到服务器并重启。
• 您无需配置默认用户组，插件会根据您的权限插件自动设置。
• 创建一个 VIP 用户组，例如命名为 vip。
• 注意: 如果您安装了旧版 VipSystem，数据将自动从旧版本导入。

授予 VIP

假设要给玩家 Test 授予一个为期 30 天的 vip 用户组。

• 使用命令：/vipsys give Test vip 30d
• 玩家可以使用 /vipsys me 查看自己的 VIP 详情。
• 如需移除 VIP，请使用命令：/vipsys remove Test

变量占位符 (Placeholder)

如需使用 VipSystemEx 提供的变量占位符，您需要：

• 安装 PlaceholderAPI 插件。
• 使用命令 /papi ecloud download vipsystem 下载扩展。
• 下载完成后，即可使用相关占位符。

⭐高级配置

语言设置

插件内置中文与英文两种语言。

• 在配置文件中设置 lang 为 zh_CN 或 en 来切换语言。
• 您也可以自定义语言：将 lang 设置为自定义名称（如 my_lang），重载插件后，插件会在 messages 文件夹内生成一个从 en.yml 复制而来的新文件（如 my_lang.yml），您可以自由编辑它。

UUID 模式

如果您的服务器开启了在线模式，建议在配置中设置：

uuid: true

数据库配置

插件默认使用 HikariCP 连接池连接 SQLite 数据库。

• 若无特殊需求，可忽略此部分。
• 如果插件启用时出错，请尝试设置 usePool: false。
• 如需使用 MySQL，请设置 useMySQL: true 并配置下方的 JDBC 连接地址。

全局 VIP 设置

• 如果您使用 GroupManager，通常无需修改此部分。
• 如果您使用 PermissionsEx，并且发现 VIP 权限无法应用到所有世界，需要设置 isGlobal: false。
• 若问题依旧，请在 worlds 列表中添加您的所有世界名称：

worlds:
  - world
  - world_nether
  - world_the_end

自定义命令

您可以定义当 VIP 激活或过期时执行的命令。

配置示例 (`customCommands`)

customCommands:
  vip:
    activate:
      - 'say {0} has activated vip!'
      - 'give {0} minecraft:diamond'
    expire:
      - 'say {0} is no longer a vip'
  svip:
    activate:
      - 'say {0} has activated svip!'
      - 'give {0} minecraft:diamond'
    expire:
      - 'say {0} is no longer a svip'

• 当激活 vip 时，会依次执行 activate 下的命令（发送消息并给予一颗钻石）。
• 当 vip 过期时，会执行 expire 下的命令（发送消息）。
• 如需添加更多用户组，方法相同。若不需要此功能，可直接删除此配置节。

✨API 接口

开发者可以通过 VipSystemAPI.getInstance() 获取 VipSystemAPI 的实例。

• Javadoc 文档正在准备中。

❓更多信息

如需查看网页版的完整介绍，请访问

https://gitee.com/Soldier233/VipSystemRecode/blob/master/README.en.md