- ◆ 支持核心
- CatServer,Spigot,PaperSpigot,Magma,Arclight
- ◆ 插件前置
- PlaceholderAPI
- ◆ 游戏版本
- 1.21.1
YAML:
# =============== VIP 等级配置：ZL1（例如“高级 VIP”） ===============
# 该等级代表一种 VIP 身份，拥有特定权限、福利和有效期。
ZL1:
# 【必填】初始默认天数（单位：天）
# 当通过 /VipSystem set 或 /add 命令设置此等级时，
# 若未指定天数，则默认赋予玩家 30 天有效期。
days: 30
# 升级时返还 50% 剩余天数作为奖励
upgrade-refund-ratio: 0.5
upgrade-from:
- "NONE" # 允许非 VIP 玩家直接“升级”到 ZL1（实际是首次开通）
# 当玩家获得此 VIP 等级时，立即执行的指令列表
set-commands:
- "lp user %player_name% parent add ZL1" # 使用 LuckPerms 插件添加 ZL1 权限组
- "tell %player_name% §a恭喜！你已获得 ZL1 VIP，有效期 30 天！" # 私聊通知玩家
# 当此 VIP 等级到期时，自动执行的指令列表
expire-commands:
- "lp user %player_name% parent remove ZL1" # 移除 ZL1 权限组，撤销特权
- "tell %player_name% §c你的 ZL1 VIP 已到期，感谢支持！" # 到期提醒
# 示例等级：ZL2（普通 VIP）
ZL2:
# 初始有效期（单位：天）。设置后玩家拥有 120 天 VIP。
days: 120
# 只允许从 ZL1 升级而来
upgrade-from:
- "ZL1"
set-commands:
- "lp user %player_name% parent add ZL2"
- "give %player_name% diamond 5"
expire-commands:
- "lp user %player_name% parent remove ZL2"
- "broadcast §e[系统] 玩家 %player_name% 的 ZL2 VIP 已到期！"| 指令 | 功能说明 |
|---|---|
| /VipSystem help | 显示 VIP 系统帮助信息 |
| /VipSystem check <玩家名> | 查看指定玩家的 VIP 等级、总天数及精确剩余时间（支持离线玩家） |
| /VipSystem set <玩家名> <会员等级> | 覆盖设置玩家的 VIP 等级（使用配置中该等级的默认天数） |
| /VipSystem add <玩家名> <会员等级> <天数> | 为玩家增加指定天数的 VIP（可切换到新等级） |
| /VipSystem remove <玩家名> <会员等级> <天数> | 从玩家当前 VIP 中扣除天数（仅当当前等级匹配时生效） |
| /VipSystem upgrade <玩家名> <新会员等级> <天数> | 将玩家 VIP 升级到新等级，并按配置折算老会员剩余天数作为奖励 |
| /VipSystem expiretest <玩家名> | 强制使玩家的 VIP 立即过期（用于测试到期逻辑和指令） |
| /VipSystem reload | 重载 config.yml 配置文件（不重启插件） |
| 占位符（变量） | 说明 | 示例输出 |
|---|---|---|
| %vipsystem_days% | 显示玩家当前 VIP 的剩余整数天数 | 3天或者无 |
| %vipsystem_<等级名>_days% | 显示玩家该 VIP 等级剩余天数 | 3天或者无 |
