vKits

Omega vKits is a premium, chance-based virtual kit plugin designed for Minecraft Spigot and Paper servers. Inspired by popular gKit systems found across competitive PvP, Prison and Skyblock networks, Omega vKits introduces an exciting way for players to earn permanent kit unlocks.

Every vKit has its own configurable unlock chance. When a player receives a kit, a roll determines whether they unlock it permanently or receive its rewards as a one-time bonus.

Failed Roll: Players receive the kit's rewards one time, but the kit remains locked.

Successful Roll: Players permanently unlock the kit and can claim its rewards repeatedly based on a configurable cooldown.

With fully customisable kits, animated unlock sequences, interactive GUIs and flexible reward options, Omega vKits adds a new layer of progression and excitement to your server.

How Does It Work?

Omega vKits uses a simple but rewarding chance-based unlock system.

• Receive a vKit – An admin, crate, event, vote reward, Battle Pass or store purchase gives a player a vKit.
• The Roll Begins – The plugin automatically rolls against the kit's configured success chance.
• The Result Is Revealed – Players receive an animated success or failure sequence.
• Claim Your Rewards – Depending on the result, players either receive a one-time reward or permanently unlock the kit.

Example:

A player receives a vKit with a 25% permanent unlock chance.

• ❌ Failure (75%): The player receives the kit's rewards once. The kit remains locked.
• ✅ Success (25%): The player permanently unlocks the kit and can claim its rewards every 7 days.

Players always receive something from their roll, while successful rolls provide long-term rewards and progression.

✨ Features

Chance-Based Unlock System

Give every vKit its own configurable success chance, ranging from 0% to 100%.

Create common kits with generous unlock chances or make rare and legendary kits much harder to obtain. Every roll has two possible outcomes, each with its own reward system.

One-Time Rewards & Permanent Unlocks

Each kit supports two separate reward paths:

• Failed Roll: Instantly delivers the configured rewards one time. The kit remains locked.
• Successful Roll: Permanently unlocks the kit, allowing the player to claim its rewards repeatedly using the configured cooldown.

Cooldowns can be customised individually for every kit, making it easy to create daily, weekly or monthly rewards.

Animated Unlock Sequences

Make every vKit roll feel exciting with customisable animations and effects.

• Suspenseful particle effects during the roll.
• Rising-pitch sounds to build anticipation.
• Explosive particle effects for successful unlocks.
• Smoke effects for failed attempts.
• Customisable titles and messages for both outcomes.
• Adjustable animation timing, particles and sounds.

Give players a satisfying experience every time they receive a vKit.

️ Fully Configurable GUI

Players can browse and manage their available vKits through a clean, interactive menu using /vkit.

Each kit automatically displays its current status:

• Locked: Displays a custom icon and lore indicating the kit is unavailable.
• ✅ Unlocked: Shows that the player owns the kit and can claim its rewards.
• ⏳ On Cooldown: Displays a countdown until the next claim is available.

Customise the GUI title, size, filler items, decorative items, sounds, kit positions and more.

Players can also right-click a kit to open its preview menu and see exactly which rewards it contains before claiming.

Individual Kit Configuration

Every vKit has its own YAML configuration file inside the vkits/ folder.

Creating new kits is simple: copy an existing configuration, change the settings and reload the plugin.

Each kit can have its own:

• Display name and icon material.
• GUI slot and custom lore.
• Permanent unlock chance (0–100%).
• Claim cooldown.
• One-time failure rewards.
• Permanent unlock rewards.
• Preview menu contents.

No need to edit the main configuration every time you want to introduce a new kit.

⏱️ Flexible Cooldown System

Configure cooldowns using simple, human-readable formats:

• 7d – 7 days
• 1d – 1 day
• 2h30m – 2 hours and 30 minutes
• 45s – 45 seconds
• 0 – No cooldown

Cooldowns can be configured individually for each kit.

Administrators can also instantly reset a player's cooldown for a specific kit or all kits, making it ideal for rewards, compensation and special events.

PlaceholderAPI Support

Integrate Omega vKits with your existing scoreboards, tab lists, chat formats and other plugins using built-in PlaceholderAPI placeholders.

Available placeholders:

• %omegavkits_unlocked% – Number of permanently unlocked kits.
• %omegavkits_total% – Total number of available vKits.
• %omegavkits_locked% – Number of kits the player has yet to unlock.
• %omegavkits_has_<kitid>% – Checks whether the player owns a specific kit.

PlaceholderAPI is completely optional.

MiniMessage & Legacy Colour Support

Customise messages and GUI text using modern MiniMessage formatting or traditional Minecraft colour codes.

Supports:

• Gradients and custom colours.
• Bold, italic and underlined text.
• Custom message formatting.
• Hover and click events.
• Legacy colour codes.

Easily match Omega vKits to your server's existing design and branding.

Lightweight YAML Storage

Keep things simple with lightweight YAML-based player storage.

• No MySQL or database setup required.
• No external dependencies required.
• Player unlocks and cooldowns persist across restarts.
• No unnecessary background ticking tasks.
• Simple file-based data management.

Simply install the plugin and get started.

Complete Admin Toolkit

Manage your vKits with a straightforward command system.

• Give players vKits and trigger unlock rolls.
• Reset individual kit cooldowns.
• Reset all of a player's cooldowns.
• Reload configurations without restarting.
• Access an in-game help menu.

Everything you need to manage your server's vKit system in one place.

Commands

Command
Description
Permission

/vkit Open the vKit GUI omegavkits.use

/vkit give <player> <kit> Give a player a vKit and trigger the roll omegavkits.give

/vkit reload Reload all configuration files omegavkits.reload

/vkit resetcooldown <player> [kit] Reset a player's cooldowns omegavkits.resetcooldown

/vkit help Display the help menu None

Command Alias: /vkits

Permissions

Permission
Description
Default

omegavkits.use Open the vKit GUI Everyone

omegavkits.give Give vKits to players Operators

omegavkits.reload Reload plugin configurations Operators

omegavkits.resetcooldown Reset player cooldowns Operators

omegavkits.admin Access all admin subcommands Operators

Perfect For

Omega vKits is designed to work with a wide range of Minecraft server types.

• ⚔️ PvP Servers – Introduce rare gKit-style equipment and permanent kit unlocks.
• ⛏️ Prison Servers – Reward players with progression-based kits and exclusive rewards.
• ️ Skyblock Servers – Create valuable kits linked to ranks, crates and achievements.
• ️ Factions Servers – Add exclusive SOTW kits and event-based rewards.
• Crates & Events – Connect vKit rewards to crate openings, voting systems and special events.
• Donor Rewards – Offer players exciting kit rolls through store purchases and rank perks.

⚙️ Requirements

• Server Software: Spigot or Paper (compatible forks supported).
• Minecraft Versions: 1.16 – 1.21.11 and 26.0 – 26.2.
• Java Version: Java 17 or newer.
• Dependencies: None required.
• Optional Integration: PlaceholderAPI.

Everything needed is included within the plugin. PlaceholderAPI is only required if you want to use its placeholders.

Simply place the plugin JAR into your plugins/ folder and restart your server.

Why Choose Omega vKits?

• ⚡ Lightweight & Optimised – Designed to minimise server overhead without unnecessary background tasks.
• Fully Customisable – Configure GUIs, messages, animations, particles, sounds and rewards.
• Individual Kit Files – Create and manage unlimited kits through separate YAML configurations.
• Rewarding Failure System – Players always receive rewards, even when they fail to permanently unlock a kit.
• Permanent Progression – Successful rolls give players unlocks they can keep forever.
• Live Configuration Reloading – Apply changes instantly using /vkit reload.
• No Required Dependencies – Everything works straight out of the box.

Omega vKits – Every roll is a chance to unlock something permanent.

Images & Videos

Claiming vKit

Opening vKit (One time reward)

Opening vKit (unlocked forever)