All resources
Minecraft plugins

mcVkits

Scaling Odds | vKit Shards |

A kit for one day? Give them a kit to chase forever.









Changelog

v2.0.1

  • Added: update checks with BuiltByBit. The console and players with mcvkits.admin are told when a new version is out.
  • Added: optional auto-download (updates.auto-download, off by default). The new jar goes into plugins/update and installs on the next restart, and the current jar is backed up to plugins/mcVkits/backup.
  • Safe downloads: every download is checked before it’s used. It must be a valid mcVkits jar of the right version.

2.0.0

v2.0.0

The menus, the roll animation, the look and the storage were all redone. Your kits, player progress and settings carry over. On the first start, the old menu and animation files move to plugins/mcVkits/backups/1.x/ and the new ones take their place.

New look
  • New violet and pink theme across the menus, messages, shard item and roll animation.
  • Redesigned /vkit menu:
- A profile head with kits owned, kits ready and shards used.
- Live timers: icons refresh every second while the menu is open, so cooldowns count down.
- Chance and cooldown progress bars in the lore (%chance_bar%, %cooldown_bar%).
- Contents listed automatically: %contents% lists what a kit gives, so you don't have to type it into the lore.
- Kit descriptions: a new description: list per kit, shown where the menu has %description%.
- Kits that are ready to claim glow.
- New menu buttons:
- Claim all: claims every ready kit in one click.
- Category filter: appears when kits use more than one category.
- New sort modes: Ready first and Best chance.
- An "empty" icon when there are no kits to show.
  • Redesigned preview menu: 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 now show their real contents instead of an empty menu.
  • Confirm menu shows the kit and the player's live chance in the middle.

New roll animation
  • The shard now glows. The glow switches between the win and lose colors on every flash.
  • A progress bar and the roll's chance show under the label.
  • The shard pops bigger on a win and shrinks on a loss.
  • Smooth movement: the client glides between positions, so the shard no longer jitters when you look around.
  • New sequence step COMMAND runs a console or player command at any moment of a roll or claim.
  • BOSSBAR steps keep their colors and can fill up over the roll (fill: true).
  • FIREWORK steps take hex colors and a shape:.

New features
  • Shards for offline players: /vkit give works for anyone who has joined before, and offline players get their shards the next time they join. Store purchases are never lost.
  • /vkit give <player> <kit> [amount] gives up to 64 shards at once.
  • /vkit giveall <kit> [amount] gives shards to everyone online.
  • /vkit claim <kit> and /vkit preview <kit>, for menus and NPCs.
  • /vkit info <player> shows a player's progress on every kit: state, chance, rolls, misses, claims and waiting shards.
  • /vkit test <kit> [success|fail] plays the full roll animation. Nothing is saved or given.
  • Join reminder: "You have 2 kits ready to claim" with a clickable /vkit.
  • Spare shards turn into rewards: right-clicking a shard for a kit the player already owns runs that kit's owned-shard-commands, if it has any.
  • Hidden kits: hidden: true keeps a kit out of /vkit until the player owns it.
  • Player stats: rolls, misses and claims are now tracked per kit.
  • New placeholders: %mcvkits_ready_<kit>%, %mcvkits_chance_<kit>%, %mcvkits_cooldown_<kit>%, %mcvkits_rolls_<kit>%, %mcvkits_fails_<kit>%, %mcvkits_claims_<kit>%, %mcvkits_name_<kit>%, %mcvkits_owned_count%, %mcvkits_ready_count%, %mcvkits_total% and %mcvkits_rolls_total%.
  • Admin editor: new buttons for the description, owned-shard commands, the hidden toggle, a test roll (left-click to win, right-click to lose) and Give Me a Shard.
  • New example kit: Royal, a rare kit with owned-shard commands.
  • unlock, lock, setchance, resetpity and resetcooldown now work on offline players too.

Fixes
  • The roll effects never played. The titles, fireworks, boss bar, particles and sounds in the success, fail, claim, pity and suspense sequences were read the wrong way and skipped, both in animations.yml and in each kit file. They all play now.
  • Fireworks from roll effects could hurt players. They are now for show only.
  • The shard didn't actually spin in the roll animation. It does now.
  • TRAIL_HOLOGRAM particles never appeared, because the suspense sequence wasn't given the shard's position.
  • Stopping the server during a roll used up the shard with no result. The roll is now finished and saved, and a lost roll still gives its one-time contents.
  • Free rolls: the confirm menu could start a roll without a shard if the shard had moved. Fixed.
  • /vkit give to an offline name gave the shard to the admin who typed it. It now queues the shard for the right player.
  • Missing messages: /vkit reload, setchance, resetpity and resetcooldown printed nothing, because their messages were missing. Fixed.
  • Bad colors in kit files: a firework color that isn't a dye name no longer throws an error.
  • Lag: player data is now written to disk in the background, through a temporary file, so a crash can't leave a broken file.
  • /vkit reload no longer drops cached player data.
  • The help list only shows commands the player has permission for.
  • Unused settings (debug, storage) were removed from config.yml.

v1.0.3

  • Added: PlaceholderAPI placeholder %mcvkits_owned_<kit>%, which returns true or false for whether the player owns the kit. Unknown kit ids return false. PlaceholderAPI stays optional.
  • Added: owned-shard-commands: option in each vKit config, a list of console commands with %player%. When /vkit give targets a player who already owns the kit, these commands run instead of giving a shard, and the sender sees the "already owns" message.
  • Changed: if owned-shard-commands is empty or missing, /vkit give now gives a shard to players who already own the kit. It used to refuse with the "already owns" message. The spare shard is not used up when right-clicked.
  • Added: softdepend: [PlaceholderAPI] in plugin.yml, so PlaceholderAPI always loads first.
  • Existing kit files keep working without changes.

v1.0.2

  • Fixed: the default starter and gladiator kits were re-created on every startup, every /vkit reload, and after any kit was created, saved or deleted, so deleted defaults always came back.
  • Changed: the default kits are now only created on first install. Deleting them from the admin panel or the folder is now permanent.
  • Added: a plugins/mcVkits/.defaults-installed marker file. To get the bundled kits back, delete this file and the vkits/ folder.
  • Upgrading from v1.0.2: your current kits stay as they are, and the defaults aren’t added back.

v1.0.1

  • Fixed: startup warning about starter.yml / gladiator.yml already existing
  • Fixed: ugly console startup/shutdown messages
  • Added: /vkit unlock <player> <kit> — unlocks the kit itself to a player, no shard needed
  • Added: /vkit lock <player> <kit> — removes the kit from a player and resets their progress

mcVkits | Scaling Odds | vKit Shards |









Full history on BuiltByBit

More from TechnoTech