Getting started

Installation and requirements

mcVkits adds chance-based virtual kits to a Paper server. Players use a shard item to roll for a kit. A win unlocks the kit forever and lets them claim it again on a cooldown. A loss still gives the kit once and raises their chance for next time.

RequirementDetails
ServerPaper 1.21.4 or newer
Java21 or newer
PlaceholderAPI (optional)Enables the %mcvkits_...% placeholders.
  1. Stop the server and put mcVkits-2.0.1.jar in plugins/.
  2. Start the server. mcVkits creates plugins/mcVkits/ with config.yml, messages.yml, animations.yml, a guis/ folder and a vkits/ folder with three example kits (Starter, Gladiator, Royal).
  3. Run /vkitadmin in game to open the editor.
Example kits come back only once

The three example kits are written only on the first install. If you delete them, they will not return.

Upgrading from 1.x#

Replace the old jar. Kits, player data, config.yml and messages.yml stay. The old menu and animation files move to plugins/mcVkits/backups/1.x/ and the new ones take their place.