How kits work
- You give a player a shard for a kit (
/vkit give, for example from your store). - The player right-clicks the shard. It is used up and a roll starts: a floating shard spins in front of them while a label flashes between the two outcomes.
- Win: the kit is unlocked forever. Nothing is handed out on the win itself. The kit can be claimed at once from
/vkit, and then again each time the cooldown ends. A server-wide unlock announcement is sent ifbroadcast-unlockis on. - Loss: the kit stays locked, but the player still receives the full kit contents once, and their chance for that kit goes up (pity).
The chance for each player and kit starts at the kit's base chance and goes up by the pity increase after every loss, up to the cap. Example from the config comments: base 25 percent, increase 5, cap 95 means that after 3 losses the player rolls at 40 percent.
Store friendly
Run /vkit give %player% starter as the delivery command in your store. If the buyer is offline, the shard is waiting for them when they join.
Shards#
- Shards stack. Giving 10 gives one stack of 10, and new shards join a stack the player already has.
- The shard tooltip shows the holder's own current chance (
%chance%) and updates after rolls, on join and when inventories open. - You can give up to 64 shards in one command.
- If the player already owns the kit and the kit has
owned-shard-commands, the shard is turned into those commands (right-click, or at once on/vkit give). If the kit has none, the player keeps the spare shard. - Only one roll can run at a time per player. A shard is used up only once its roll actually starts.
- If a player logs out in the middle of a roll, the result is saved so pity is never lost.
Anti-dupe#
Every shard stack has a hidden id, and the server records how many shards each stack really has. If the same id turns up twice in one inventory or on the cursor, every copy is removed, a copied shard cannot be used, and players with the alert permission are told.
anti-dupe:
enabled: true
alert-permission: mcvkits.admin