VIP System - VIP系统

简介

VIP 是一款功能完善的 Minecraft 插件，用于管理玩家的 VIP 身份与特权。它支持自定义 VIP 类型、菜单设计，并集成了丰富的 API 与占位符，方便与其他插件联动。

💡重要配置说明

启用 VIP 到期提醒

如需在 VIP 到期时向玩家发送提醒，请在配置文件中进行如下设置：

• 将 watch-to-end-vip: false 修改为 watch-to-end-vip: true
• 同时可以设置提醒时间 watch-to-end-vip-time: 1 (单位：分钟)

数据库配置

插件默认使用 YAML 文件存储数据。如需使用 MySQL，请在 config.yml 中配置以下字段：

database:
  type: yml
mysql:
  hostname: localhost
  user: root
  password: password
  database: database

执行命令

插件可在设置或移除 VIP 时执行特定命令

• 设置 VIP 时执行的命令 (commands-to-set-vip)
• 移除 VIP 时执行的命令 (commands-to-remove-vip)

命令中的 %name% 和 %rank% 将被自动替换为玩家名和 VIP 等级。

消息与菜单

• 前缀消息可在 message.prefix 中修改。
• VIP 信息菜单的标题可在 inventory.name 中修改。

🎮核心功能

• VIP 类型管理：通过 types.yml 文件自定义 VIP 等级与权限组。
• 占位符支持：兼容 PlaceholderAPI 与 MVdWPlaceholderAPI。
• 菜单设计：在高级版本中提供可视化的菜单自定义功能。
• 激活码系统：在高级版本中支持使用激活码发放 VIP。

🔧VIP 类型配置 (`types.yml`)

VIP 等级在 types.yml 文件中定义。基本格式如下：

vip:
  group-Name: VIP
  name: VIP

请注意：如果您在设置 VIP 时使用了 Date 类，请确保从 the.max.vip.date.Date 正确导入。

✨API 使用方法

以下为插件提供的 API 接口示例

检查 VIP 状态

• VIP.getVIP().getAPI().have(playerName);
• 返回布尔值。玩家拥有 VIP 则返回 true，否则返回 false。

获取 VIP 时间信息

• VIP.getVIP().getAPI().getEndingDate(playerName);
• 返回 VIP 到期时间的时间戳（Long 类型）。
• VIP.getVIP().getAPI().getTime(playerName);
• 返回 VIP 剩余总时长（毫秒，Long 类型）。

设置与移除 VIP

• VIP.getVIP().getAPI().set(playerName, days, Date);
• 为指定玩家设置 VIP 时长。
• 示例：VIP.getVIP().getAPI().set("The_MaxCZ", 1, Date.HOURS);
• VIP.getVIP().getAPI().remove(playerName);
• 移除指定玩家的 VIP。成功移除返回 true，失败返回 false。

其他操作

• VIP.getVIP().getAPI().openInventory(player);
• 为指定玩家打开 VIP 信息菜单。
• VIP.getVIP().getAPI().watchEndVIP();
• 手动触发 VIP 到期检查。

❓占位符列表 (支持 1.8 及以上版本)

安装 PlaceholderAPI 或 MVdWPlaceholderAPI 后，可使用以下占位符：

• {vip_rank}：返回玩家当前的 VIP 等级名称。
• {vip_endingdate}：返回玩家 VIP 的到期日期。
• {vip_activate}：返回玩家的 VIP 账户状态（已激活/未激活）。

⭐感谢与测试服务器

• 特别鸣谢：感谢 maxo_svk 提供的创意与想法。
• 测试服务器（均为捷克服务器）：
• play.Dream-Play.cz
• MoonLands.eu
• mc.IceLands.eu
• mc.Ultra-Core.eu
• mc.ExtremePlay.cz
• mc.Legend-Plays.eu
• mc.enderly.eu
• play.stylemine.cz

> 如果您正在使用本插件，可通过私信联系作者，将您的服务器添加至此列表。

💡使用条款

下载并使用本插件，即表示您同意遵守以下条款

• 不得对本插件进行反编译。
• 不得修改插件源代码。
• 不得将插件上传至其他任何地方分发。
• 不得声称本插件是您自己的作品。

💡运行环境要求

您必须安装或重新安装 Java 8 环境以确保插件正常运行。