Using it

The /vkit menu

/vkit opens the kit menu for players. Each kit shows as locked, ready to claim or on cooldown. Left-click a kit to claim it, right-click to preview what is inside. Timers count down live while the menu is open (refresh-ticks).

  • A profile head shows kits owned, kits ready and shards used.
  • Claim all claims every ready kit in one click.
  • A category button appears when kits use more than one category.
  • A sort button switches between Ready first, Default, Category, Best chance and Shortest cooldown. The default is set by sort.default.
  • Arrows appear when there is more than one page.
  • Hidden kits (hidden: true) are not shown until the player owns them.

The preview menu (right-click, or /vkit preview <kit>) shows what a kit gives, a status icon with the player's chance, cooldown and stats, and a Claim button when the kit is ready. Kits with no preview items show their real contents.

In guis/vkits.yml the lore of each state (locked, unlocked, cooldown) can use %kit% %chance% %base% %pity% %cap% %time% %cooldown% %rolls% %fails% %claims% %category% %chance_bar% %cooldown_bar%. Two lines expand into several: %description% (the kit's description: list) and %contents% (an automatic list of what the kit gives).

contents-line: "<color:#6E6589> - <color:#F3EEFF>%amount%x <color:#A69CC4>%item%"
contents-max-lines: 6
contents-more: "<color:#6E6589>   and %more% more..."

Menu size, border, sounds, button slots and the per-state icon overrides are also in this file. To give one kit its own lore, add a lore: section with locked:, unlocked: and cooldown: lists to its kit file.