VIP SystemPaper · Spigot · Purpur

Playcore VIP

The ultimate standalone VIP & Kit Management system.

Built as a robust replacement for legacy plugins like PixelVip. Enjoy real-time WebSocket integrations, paused packages, dynamic Vault synchronization, and flawless login-based expiration checks.

Features

Smart Expiration

Replaces periodic checking! Expirations are checked instantly upon login. Includes precise task scheduling and paused packages.

Relational DB

Advanced SQLite/MySQL tracking across kits, codes, packages, paused_packages, and active_packages.

WebSockets Sync

Seamlessly connects to external web-panels via WebSockets allowing real-time package inserts without server restarts.

GUI Menus

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

LuckPerms Integration

Assign Vault/LuckPerms groups automatically when players activate VIP packages.

Code Redemption

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

Compatibility

Paper

Spigot

Velocity

1.8.8 – 26.2Java 17+MariaDB required

Kit Commands

Command	Description	Permission
`/createkit <name> <icon> <displayName>`	Initialize a new kit with a specific Material icon.	`playcorevip.kit.create`
`/additem <kit>`	Add the item currently held in your hand to the specified kit.	`playcorevip.kit.additem`
`/addinv <kit>`	Bulk import your entire current inventory contents into the kit.	`playcorevip.kit.addinv`
`/modifykit <name> <enum> <value>`	Modify deep kit properties (e.g. max uses, cooldowns, icons, allowed servers).	`playcorevip.kit.modify`
`/delkit <name> [force]`	Delete a kit. Using 'true' for force deletes all unredeemed codes linked to it.	`playcorevip.kit.delete`
`/kitpreview <kitname> [player]`	Open a non-editable GUI displaying the contents of the kit.	`playcorevip.kit.preview`
`/givekit <name> [player]`	Give the kit directly to a player, bypassing codes.	`playcorevip.kit.give`

Code Commands

Command	Description	Permission
`/genkey <type> <name> [duration]`	Generate an 8-character redemption code. Type can be 'vip' or 'kit'.	`playcorevip.generate`
`/redeem <code>`	Redeem a code. Aliases include /usecode and /usekey.	—
`/delcode <code>`	Revoke and permanently delete a generated code.	`playcorevip.delcode`
`/codeinfo <code>`	Check which package/kit is assigned to a code and its usage status.	`playcorevip.codeinfo`
`/listcodes [type] [page] [type2]`	View a paginated list of all active codes in the database.	`playcorevip.listcodes`

VIP Commands

Command	Description	Permission
`/createvip <name> <group> <priority> <duration> <displayName>`	Create a new VIP package mapped to a Vault group.	`playcorevip.package.add`
`/deletevip <name> [force]`	Permanently delete a VIP package from the database.	`playcorevip.package.remove`
`/addvip <name> <package> <duration> [flags]`	Assign a VIP package to a player. Allows duration overrides.	`playcorevip.package.add / playcorevip.addvip.<group>`
`/removevip <name> <package>`	Forcefully remove an active or paused VIP package from a player.	`playcorevip.package.remove`
`/removetime <name> <package> <duration>`	Decrease the duration of a players active VIP package.	`playcorevip.package.removetime`
`/vipinfo <name>`	View detailed VIP history, paused packages, and active data for a player.	`playcorevip.vipinfo / playcorevip.vipinfo.others`
`/viptime [player]`	Check the remaining time on the current active VIP package.	`playcorevip.viptime / playcorevip.viptime.others`
`/i [vip]`	View technical info and statistics regarding a specific VIP package.	`playcorevip.vipinfo`

Management

Command	Description	Permission
`/pcv`	Display the main help menu and plugin version information.	`playcorevip.*`
`/pcv gui`	Open the interactive VIP administrative GUI.	`playcorevip.gui`
`/pcv reload`	Reload configuration files and database connections.	`playcorevip.reload`
`/pcv forcereconnect`	Forcefully re-establish the WebSocket connection to the main web panel.	`playcorevip.reconnect`
`/pcv editor`	Open the advanced editor panel.	`playcorevip.editor`

WebSocket API

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

SCRAPETrigger sendNewDat(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

Gallery

Documentation

1Creating Packages

VIP packages map directly to LuckPerms/Vault groups. Create them using /createvip <name> <group> <priority> <duration> <displayName>. Packages with higher priorities will automatically pause packages with lower priorities when redeemed!

2Generating Codes

Generate 8-character redemption codes using /genkey vip <packageName> <duration>. Distribute these codes via your e-shop, and players can claim their ranks using /usekey or /redeem.

Default Config

config.yml49 lines


prefix: "&8[&6PcVIP&8] &r"
debug: false

skipTaskAfter: 86400

default_group: "group.default"

database:
    host: "localhost"
    port: 3306
    database: "playcorevip"
    username: "root"
    password: "asdf"
    useSSL: false
    reconnect: true
    reconnectTime: 15

web:
    enabled: true
    apiUrl: "ws://localhost:8012/ws/playcore/in"
    apiKey: "ksapej"
    timeout: 10 # seconds

announceVip:
    enabled: true

    # Zvuk není poviný, klidě se může odebrat
    sound: "DRAGON_BREATH"

    # %player% - Jméno hráče
    # %vip% - Jméno VIP
    # %time% - Doba VIP
    # %oldvip% - Starý VIP. Pokud nemá, bude hodnota "&cN/A"
    messages:
        - "&6Děkujeme! Hráč &e%player% &7si zakoupil VIP &r%vip%"
        - " &b- &7na &r%time%"
        - "&7Máš také možnost si zakoupit VIP na &eplaycore.cz"

announceKit:
    enabled: true
    #sound: "LEVEL_UP"

    # %player% - Jméno hrace
    # %kit% - Jméno kitu
    messages:
        - "&6Děkujeme! Hráč &e%player% &7si zakoupil kit &r%kit%"