Kit Configuration

Overview

Kits are defined under the kits key in /plugins/EssentialsC/kits.yml. Each entry is loaded into a permission, a cooldown, a claim limit, and a list of items, then handed off to the kit GUI and the /kit command at the same time.

Changes to kits.yml are picked up with /kits reload. There's no need to restart the server.

Server Settings

These live in config.yml under kits and control the kit system itself rather than individual kits:

Kit Options

These fields sit directly under each kit's name.

Claim Rules

one-time, max-claims, and cooldown are checked in that order, after the kit permission. A one-time kit is blocked once claimed, max-claims stops the kit once the limit is hit regardless of time, and only a remaining cooldown blocks a claim when both pass.

Item Options

Each entry under items describes one stack a player receives on claim.

Example

A starter kit with a one-day cooldown and a ten claim cap.

kits:
  starter:
    display-name: "<#2791F5>Starter Kit"
    description: "Basic items"
    cooldown: 86400
    one-time: false
    first-join: true
    max-claims: 10
    gui-slot: 10
    gui-icon: "CHEST"
    items:
      - type: STONE_SWORD
        amount: 1
        name: "<b><#2791F5>Kit Starter"
        lore: []
        enchantments: {}
        unbreakable: false
        flags: []
        custom-model-data: 0
        nbt: {}

Permissions

Commands