PvP

KitPvP

Ready-made PvP kits picked from a menu (right-click = preview of what's inside). Free, rank or paid kits, each with its own cooldown. Staff create kits straight from their inventory. Kill stats, K/D and kill streaks with chat announcements.

Buy a license Paper, Spigot, Bukkit 1.20 – 1.21 · Java 17+

Installation

Download the file from the customer area and copy it into your server's plugins folder.
Start the server once: the plugin folder with config.yml is created.
Paste your license under license: and restart the server.

Commands

Aliases: /kits

Command	Permission	Description
`/kit`	`—`	Kit menu (left-click = take, right-click = preview)
`/kit <name>`	`—`	Takes a kit right away
`/kitpvp stats [player] · top`	`—`	Stats and kill leaderboard
`/kitpvp create <name> [cooldown] [price]`	`kitpvp.admin`	Creates a kit from your inventory (armor and offhand too)
`/kitpvp delete <name>`	`kitpvp.admin`	Deletes a kit
`/kitpvp reload`	`kitpvp.admin`	Reloads configuration, kits and languages

Permissions

Permission	Default	Description
`kitpvp.kit.<kit>`	—	Only when the kit has permission: ... (e.g. kitpvp.kit.tank for the Tank kit)
`kitpvp.bypass.cooldown`	op	Takes kits without waiting
`kitpvp.admin`	op	Create and delete kits, reload the plugin

Making a kit

Put what you want in the kit in your inventory (worn armor and shield too), hold the item to use as icon and type /kitpvp create name 60 0 (60 seconds cooldown, free). Then in kits.yml you can change the colored name, description and permission, and run /kitpvp reload.

Rank and paid kits

For a VIP kit write permission: "kitpvp.kit.vip" in kits.yml and give that permission to the rank with your permissions plugin (e.g. LuckPerms). To charge for it set price: 500: Vault and an economy plugin (e.g. EssentialsX) are needed.

Configuration files

config.yml

# Your license key (you received it privately from our Discord bot).
license: "PASTE-YOUR-LICENSE-HERE"

# Message language: "en" (English) or "it" (Italiano). Files are in /lang and can be edited freely.
language: en
# When true, each player sees the messages in their own game language (when a file for it exists).
use-client-language: true

# The kits are in kits.yml. You can also make one from your inventory: /kitpvp create <name> [cooldown-seconds] [price]

kits:
  # true = taking a kit empties the inventory first. false = the kit items are added to what the player already has.
  clear-inventory: true

death:
  # true = players drop nothing when they die (good for kit arenas).
  clear-drops: false

rewards:
  # Money for every kill (needs Vault and an economy plugin). 0 = nothing.
  money-per-kill: 0
  # Tell everyone when a player reaches a kill streak of 5, 10, 15... (0 = never).
  announce-streak-every: 5

# Sound names from https://minecraft.wiki/w/Sounds.json  ->  "name:volume:pitch"  ("none" = no sound)
sounds:
  kit: "item.armor.equip_iron:1:1"
  streak: "entity.ender_dragon.growl:0.4:1.5"

kits.yml

kits:
  warrior:
    display-name: "&c&lWarrior"
    icon: iron_sword
    lore:
      - "&7Iron armor, sword and food."
    permission: ""
    price: 0
    cooldown: 30
    items: ["iron_sword", "bow", "arrow:16", "cooked_beef:16", "golden_apple:1"]
    armor: ["iron_helmet", "iron_chestplate", "iron_leggings", "iron_boots"]
    offhand: shield
  archer:
    display-name: "&a&lArcher"
    icon: bow
    lore:
      - "&7Light armor and lots of arrows."
    permission: ""
    price: 0
    cooldown: 30
    items: ["stone_sword", "bow", "arrow:64", "cooked_beef:16"]
    armor: ["leather_helmet", "chainmail_chestplate", "chainmail_leggings", "leather_boots"]
  tank:
    display-name: "&9&lTank"
    icon: diamond_chestplate
    lore:
      - "&7Diamond armor, but slow weapons."
      - "&eVIP only"
    permission: "kitpvp.kit.tank"
    price: 0
    cooldown: 120
    items: ["stone_axe", "cooked_beef:16", "golden_apple:2"]
    armor: ["diamond_helmet", "diamond_chestplate", "diamond_leggings", "diamond_boots"]
    offhand: shield
  berserker:
    display-name: "&6&lBerserker"
    icon: diamond_sword
    lore:
      - "&7A diamond sword and golden apples."
    permission: ""
    price: 250
    cooldown: 300
    items: ["diamond_sword", "golden_apple:4", "cooked_beef:16"]
    armor: ["iron_helmet", "iron_chestplate", "iron_leggings", "iron_boots"]