Using it

The shard item and pity defaults

The shard item and the default pity values are in config.yml:

pity:
  # Chance on the first roll (%).
  base-chance: 25.0
  # Added to that player's chance for the kit after each failed roll (%).
  increase: 5.0
  # The chance never goes above this (%). 100.0 = no cap.
  cap: 95.0

shard:
  material: AMETHYST_SHARD
  glint: true
  custom-model-data: -1
  name: "<gradient:#B57CFF:#FF7AC6><bold>%kit% Shard</bold></gradient>"
  lore:
    - "<color:#A69CC4>Roll for the %kit%<color:#A69CC4> vKit."
    - ""
    - "<color:#A69CC4>Your chance: <color:#FF7AC6><bold>%chance%%</bold>"

Shard placeholders are %kit%, %player% and %chance%. The lore in the file continues with the win and loss explanation; edit it freely. Use custom-model-data for a resource pack texture.

Other settings#

# Announce to the whole server when a player unlocks a kit forever.
broadcast-unlock: true

# Your store link. Shown as a clickable link in the unlock broadcast (%store-url%).
store-url: "https://store.yourserver.net"

# Ask "are you sure?" before a shard is used. Look: guis/confirm.yml.
confirm-menu:
  enabled: false

join:
  # Ticks to wait before the messages below (20 ticks = 1 second).
  delay-ticks: 40
  # "You have 2 vKits ready to claim" with a clickable /vkit.
  ready-reminder: true
  • The unlock broadcast text is the broadcast-unlock list in messages.yml.
  • With confirm-menu.enabled: true, a confirmation menu shows the kit and the player's live chance before the shard is used.
  • Shards given while a player was offline are always handed over on join. There is nothing to turn on for that.
Set your store link

Change store-url to your real store address, or the unlock broadcast links to the placeholder.