高级插件 MythicVIP - 轻量化VIP管理丨购买/续费/累计续费天数丨自定义VIP礼包丨1.21+ 1.0.1.2 1.0.1.2

MythicVIP 插件​

一款基于 LuckPerms 的 Minecraft 服务器 VIP 系统插件。支持多等级购买、续费叠加、低级升级高级VIP天数折算、首次/每日/每周/无限礼包、可视化编辑器，礼包物品完美兼容 ItemsAdder 等自定义物品。

其他版本请自行测试，这个插件是我自己服务器需要所以才写的一个。
​

核心特性​

多经济支持​

Vault 金币 · PlayerPoints 点券 · 免费模式

智能礼包​

首次/每日/每周/无限领取，内置冷却与计数

升级折算​

旧等级剩余天数按比例转为新等级，不浪费

🛠 可视编辑器​

拖拽物品配置礼包，支持 ItemsAdder 等 NBT 物品


安装步骤

1. 下载 MythicVIP-1.0.1.0.jar 放入 plugins/ 文件夹。
2. 重启服务器或执行 /plugman load MythicVIP。
3. 在 LuckPerms 中创建与配置对应的权限组（例如 /lp creategroup vip）。
4. 编辑 plugins/MythicVIP/config.yml 调整价格、天数等。
5. 执行 /mvip reload 重载配置。

• 命令与权限​

  玩家命令​

  /mvip gift <等级>	打开对应等级的礼包 GUI	mythicvip.use
  /mvip info [玩家]	查看自己或他人的 VIP 信息	mythicvip.use

  管理员命令​

  /mvip buy <玩家> <等级> [天数]	为玩家购买/续费 VIP/在不填写天数时默认配置项设置的天数	mythicvip.admin
  /mvip reload	重载配置文件	mythicvip.admin
  /mvip admin <等级>	打开礼包编辑器（可视化配置）	mythicvip.admin

折叠 : 游戏内图片展示

配置文件详解​

配置文件位于 plugins/MythicVIP/config.yml，首次启动自动生成。【记得修改为自己服务器中VIP权限组名称，以及记得把支付模式修改为你想要的，以免出现不必要的麻烦。】

Config配置项​

YAML：
# MythicVIP 配置文件
database:
type: sqlite
filename: mythicvip.db

# =============== 经济设置 ===============
economy: #一般情况无需修改
enabled: true #启用经济系统。若设为 false，所有 VIP 购买都将免费（忽略各组配置的 price）。
default-payment: vault #默认支付方式。当某个 VIP 组的 payment.type 未设置时，将使用此处指定的支付类型。可选值：vault（金币）、points（点券）、free（免费）。

# =============== VIP 组配置 ===============
groups:
vip:
name: vip
display-name: '&6[VIP]'
days: 30
payment:
type: points
price: 1000.0
upgrade-refund-ratio: 0.5
upgrade-from:
- NONE
mvp:
name: mvp # LuckPerms 权限组的实际名称（必须与 LP 中创建的组名一致）
display-name: '&b[MVP]' # 在游戏内显示给玩家的 VIP 称号（支持彩色代码）
days: 30 # 单次购买默认赠送的天数（可在命令中手动指定覆盖）
payment: # 支付方式配置
type: points # 支付类型：vault（金币）、points（点券）、free（免费）
price: 3000.0 # 购买所需的价格（对应上述类型的货币数量）
upgrade-refund-ratio: 0.4 # 升级退款比例：若玩家从旧 VIP 升级至此，旧等级剩余天数按此比例折算为新天数
upgrade-from: # NONE无升级，允许从哪些等级升级到此等级
- vip
mvp+:
name: mvp+
display-name: '&5[MVP+]'
days: 30
payment:
type: points
price: 6800.0
upgrade-refund-ratio: 0.3
upgrade-from:
- mvp

# =============== 购买成功/失败时执行的命令 ===============
purchase-success-commands:
- tell %player% &a恭喜你成功购买了 %group% ，当前剩余有效期 %days% 天！
- broadcast &6[VIP系统] 玩家 %player% 成为了 %group% ！

purchase-fail-commands:
- tell %player% &c购买失败：%reason%

# =============== 购买提示消息设置 ===============
purchase-message:
enabled: true
# 首次购买提示（玩家从未拥有过该等级）
first-purchase:
- '&a 您首次购买 %group% ！'
- '&a 有一个礼包待领取，使用 &e/mythicvip gift %group_key% &a打开！'
# 重复购买提示（续费时，若礼包可重复领取则提示）
repeat-purchase:
- "&e♻ 您已续费 %group% ，有效期延长至 %days% 天！"
- "&a 礼包剩余冷却：%cooldown% ，使用 &e/mythicvip gift %group_key% &a打开！"
# 重复购买但礼包不可重复领取时的提示（仅续费提示，不提示礼包）
repeat-purchase-no-gift:
- '&e♻ 您已续费 %group% ，有效期延长至 %days% 天！'

# =============== 礼包配置 ===============
gift-packs:
vip:
title: '&6VIP 礼包'
size: 27
# 领取模式: once 首次/ daily 每日/ weekly 每周/ repeat 无限
claim-mode: once
# 以下为 daily/weekly 模式时的额外限制（once 忽略）
# claim-limit: 每日/每周可领取次数（默认为1）
claim-limit: 1
items:
'10':
v: 3955
type: DIAMOND
mvp:
title: '&5MVP 礼包'
size: 36
claim-mode: daily # 每天可领取
claim-limit: 1 # 每周1次
items:
'10':
material: DIAMOND_BLOCK
amount: 5
name: '&b钻石块 x5'
lore:
- '&7点击领取'
mvp+:
claim-mode: once
claim-limit: 1
items:
'19':
v: 3955
type: BREAD
amount: 5
'22':
v: 3955
type: CAKE
'25':
v: 3955
type: PUMPKIN_PIE
amount: 2

# =============== 消息配置 ===============
messages:
prefix: '&8[&6MythicVIP&8] &7'
no-permission: '&c你没有权限使用此命令！'
player-not-found: '&c找不到玩家 %player%！'
group-not-found: '&c找不到 VIP 组 %group%！'
purchase-success: '&a成功为玩家 %player% 购买了 %group% ，当前剩余有效期 %days% 天！'
purchase-self-success: '&a成功购买了 %group% ，当前剩余有效期 %days% 天！'
insufficient-funds: '&c余额不足，需要 %price% %currency%！'
vip-info: '&e玩家 &6%player% &e的 VIP 信息：'
vip-info-entry: '&7- %group% &f剩余 &e%days% &f天'
gift-received: '&a你已成功领取 %item%！'
gift-already-claimed: '&c你已经领取过这个礼包了！'
gift-cooldown: '&c该礼包需要等待 %time% 后才能再次领取！'
no-pending-gift: '&c你没有待领取的礼包！'

使用指南​

购买 VIP​

管理员执行命令：
/mvip buy Steve vip 需要玩家拥有足够的金币或者点券
/mvip buy Steve vip [天数，不填写天数为默认配置项天数30天，填写多少天扣除的价格依然是配置项中设置的价格.]

菜单购买例如Trmenu[你可以自行设置是否需要判定金额，MythicVIP自带判定具体根据您自行设置]：
- 'command: mvip buy %player_name% VIP等级'

系统自动扣款，并叠加天数。若玩家已有该 VIP，天数累加；若购买更高等级且满足升级条件，触发升级折算[升级需在配置项填写]。

领取礼包​

玩家执行：
/mvip gift vip


打开 GUI，点击物品直接领取。物品优先放入背包，背包满则掉落地面。若配置了命令，命令以控制台身份执行（受白名单限制）。

升级机制​

当玩家从低等级升级到高等级时：

1. 检查新等级的 upgrade-from 是否包含旧等级名称。
2. 计算旧等级剩余天数，按 upgrade-refund-ratio 折算。
3. 移除旧等级权限组，添加新等级权限组（天数为 折算天数 + 购买天数）。

举例：玩家剩余 10 天 vip，购买 30 天 mvp（比例 0.6） → 最终获得 10 * 0.6 + 30 = 36 天 mvp。

🛠 礼包编辑器（管理员）​

1. 执行 /mvip admin vip 打开编辑器。
2. 将背包中的物品拖入界面（槽位 0-44 可用）。
3. 点击绿色绿宝石保存配置。
4. 执行 /mvip reload 应用更改。

编辑器保存的物品保留完整 NBT，支持 ItemsAdder、Oraxen 等自定义物品。

购买日志​

日志文件 plugins/MythicVIP/logs/purchases.log 记录每笔交易，便于审计。
管理员可据此核对扣款与 VIP 添加情况，必要时进行退款操作。

常见问题 FAQ​

Q：购买后玩家没有获得 VIP？​

A：检查 LuckPerms 中的组名是否与配置 name 完全一致（区分大小写）。

Q：扣款成功但 VIP 未添加？​

A：查看服务器日志，确认 LuckPerms 是否正常运行。日志中会记录异常详情。

Q：礼包物品未到账？​

A：检查控制台是否有反序列化警告；确保玩家背包有空间，否则物品会掉落地面。

Q：升级没有触发？​

A：确认新等级的 upgrade-from 包含旧等级的 name 值。

Q：如何让玩家自己购买？​

A：当前购买命令仅限管理员。可使用菜单插件（如 DeluxeMenus）调用 /mvip buy %player% vip 并给予权限。

Q：支持 MySQL 吗？​

A：目前仅支持 SQLite，数据文件为 mythicvip.db。