VIP SystemPaper · Spigot · Velocity

VIP System

The ultimate VIP system for Minecraft servers. Players redeem codes for VIP status or exclusive kits, with full GUI management, MySQL backend, and WebSocket integration.

This plugin allows players to redeem 8-character codes purchased from your e-shop, granting them VIP status (with LuckPerms group) or exclusive item kits. A priority-based package system means players can hold multiple VIP tiers simultaneously, with the highest priority one active. VIP expiry is checked on player join — not periodically — for maximum efficiency.

Features

Code Redemption

Generate and redeem 8-character codes for VIP status or exclusive kits, purchased from your e-shop.

8 GUI Menus

Intuitive GUI management system with 8 different menus for complete in-game administration.

LuckPerms Integration

Assign LuckPerms groups automatically when players activate VIP packages.

MySQL Support

Full MySQL database backend with 6 tables for codes, kits, packages, players, and active/paused packages.

WebSocket API

Real-time WebSocket integration for syncing with external systems like e-shops and dashboards.

18 Commands

Complete administration with 18 commands covering kits, codes, VIP packages, and GUI management.

Kit Commands

Command	Description
`/createkit <name> <icon> <displayName>`	Create a new kit with custom icon and display name
`/deletekit <name> [force]`	Delete a kit. Use force=true to also delete all associated codes
`/kitpreview <kitname> [player]`	Preview kit contents in a read-only GUI
`/addinv <kitName>`	Add all inventory items to a kit (OP)
`/additem <kitName>`	Add held item to a kit (OP)
`/modifykit <kitName> <enum> <value>`	Modify kit properties: icon, max uses, allowed servers, display name, commands

Code Commands

Command	Description
`/genkey <type> <name> [duration]`	Generate a redemption code. Types: vip, kit. Duration required for vip (e.g. 10d10m10s, 1M)
`/redeem <code>`	Use/redeem a code (also: /usekey, /usecode)
`/delcode <code>`	Permanently delete a code — cannot be undone

VIP Commands

Command	Description
`/createvip <name> <group> <priority> <duration> <displayName>`	Create a VIP package with LuckPerms group and priority
`/deletevip <name>`	Permanently delete a VIP package
`/addvip <player> <package> <duration>`	Grant VIP to a player for a specified duration
`/removevip <player>`	Remove VIP from a player
`/viptime [player]`	Show remaining VIP time of active package
`/vipinfo [player]`	Show full player VIP info: active, paused, and historical packages

Management

Command	Description
`/vipgui \| /pcv gui`	Open the VIP management GUI
`/pcv`	Show plugin version
`/pcv reload`	Reload plugin configuration `pcv.reload`

WebSocket API

Real-time events for syncing with external systems (e-shop, dashboard):

SCRAPETrigger sendNewData(uid)

SCRAPE_CODESTrigger sendCodes(uid)

SCRAPE_PACKAGESTrigger sendPackages(uid)

SCRAPE_ACTIVE_PACKAGESTrigger sendActivePackages(uid)

{"type":"DELETE","data":{...}}Delete code, vip, or active_vip by uid

Database Schema

codeskitspackagespaused_packagesactive_packagesplayers

Compatibility

PaperSpigotVelocity1.8 – 1.21Java 11+MySQL required