Essentials Kit GUI

FEATURES

• Stability:
• Full support for all versions, starting at 1.8.8
• Better support for modern versions (1.13+)
• Full support for legacy Essentials and EssentialsX
• Clean and modular code-base
• Lightweight, no bullshit included
• Multi-threading support (less stress on your main thread -> almost no effect on the TPS)
• Functionality:
• It just works
• Pretty straightforward, don't waste time by configuring tons of things
• Does not replace the kits functionality of Essentials. Builds on top of it
• No need to recreate the kits. This plugin automatically detects them
• Each kit is being stored in its own file -> easily migrate and modify them
• Fully customizable (even all the messages)
• Multi-page support. Add as many kits as you want
• Cute sounds that get played at certain events (can be disabled)
• GUI looks decent, can be easily and fully customized as well
• Hex colors support (1.16+ only, e.g. &#FF00FF)
• Kit button customizations
• Change the display name in the GUI
• Modify the icon
• Add lore (text below the name)
• Forcefully move the kits around where ever you like

SCREENSHOTS

CONFIGURATIONS

Spoiler: config.yml

Code (YAML):

The title of the inventory

inventory-title
: Kits

The title of the inventory that will be displayed on pages 2+

inventory-title-page
: Kits - Page
{page
}

The height of the inventory. Must be between 1-6. Use -1 for auto resize

inventory-height
: 6

Whether an auto-formatting shall be applied at the given axis

You may choose between:

 - NONE: Items get added from left to right / top to bottom

 - CENTRALIZED: Items will be formatted as OOOXXXOOO (X = Item, O = Air)

 - ALIGNED: Items will be formatted as OXOXOXOXO (X = Item, O = Air)

inventory-center-x
: CENTRALIZED

inventory-center-y
:
NONE

The amount of offset there shall be for the kit items

inventory-offset-top
: 1

inventory-offset-right
: 1

inventory-offset-left
: 1

inventory-offset-bottom
: 1

Fill the empty slots with some material

inventory-background-material
: air

inventory-offset-material
: air

A bar at the bottom will be displayed with a button to switch to the next page in case there are too many items

next-page-bar-material
: STAINED_GLASS_PANE:7

next-page-button-material
: ARROW

Sound that is being played on various events

Note that custom resource pack sounds only are supported with 1.9+

sound:

  open:

    name
: ENTITY_CHICKEN_EGG

    is-custom-resource-pack
: false

    volume
: 0.7

    pitch
: 1.5

  close:

    name
: ENTITY_CHICKEN_EGG

    is-custom-resource-pack
: false

    volume
: 0.7

    pitch
: 0.5

  click-kit:

    name
: UI_BUTTON_CLICK

    is-custom-resource-pack
: false

    volume
: 0.7

    pitch
: 1.5

  switch-page:

    name
: ENTITY_HORSE_STEP_WOOD

    is-custom-resource-pack
: false

    volume
: 1.0

    pitch
: 1.2

The commands with which the kit GUI shall open

listen-to-commands
:

• kit
• kits

Spoiler: messages.yml

Code (YAML):

command-usage
: '&eCorrect usage
:
&6{usage}'

command-list
: '&eAll kits
(
{amount
}
)
:
&7{kits}'

command-set-displayname
: '&eThe display name of the kit &6
{kit
} has been changed to

 
{display-name
}'

command-set-icon
: '&eThe icon of the kit &6
{kit
} &ehas been changed to &6
{icon
}'

command-clear-lore
: '&eRemoved
all lore of the kit &6
{kit
}'

command-add-lore
: '&eAdded lore to the kit &6
{kit
}&e
:
{lore
}'

command-remove-lore
: '&eRemoved lore from kit &6
{kit
}&e
:
{lore
}'

command-set-lore
: '&eSet lore in kit &6
{kit
}&e at &6
{pos
}&e
:
{lore
}'

command-reload
: '&eConfigurations have been reloaded'

command-set-slot
: '&eKit &6
{kit
} &eis now being displayed at &6X
{x
} Y
{y
}'

command-reset-slot
: '&eKit &6
{kit
} &eis now being normally added to the GUI'

coord-out-of-bounds
: '&cThe coordinates &4X
{x
} Y
{y
} &care out of bounds'

line-out-of-bounds
: '&cThe line &4
{line
} &cis out of bounds'

unknown-kit
: '&cUnknown kit &4
{kit
}'

unknown-command
: '&cUnknown command &4
{command
}'

unknown-player
: '&cUnknown player &4
{player
}'

invalid-material
: '&cInvalid material &4
{material
}'

not-number
: '&4
{number
} &cis not a number'

players-only
: Only players may execute the command

insufficient-permissions
: '&cInsufficient permissions'

next-page
: '&aNext page'

prev-page
: '&aPrevious page'

page-info
: '&7Go to page
{new-page
}.'

none
:
None

kit-hook-disappear
: '&cOops, it seems like the kit does not exist anymore. Please

  re-open the GUI'

PERMISSIONS

• Essentials permissions aren't being touched by this plugin.
• However, the player won't see the kits for which he doesn't have the permissions for in the GUI.
• This means, that players must either have essentials.kits.<kitname> (grants access to specific kits) or essentials.kits.* (grants access to all kits).
• For further help, look at this permissions list or contact Essentials's support.
• To access the /kitcfg command, you will need the kitcfg.cfg permission.

ITEM SYNTAX

• There is a specific syntax required for the icon parameter of the /kitcfg icon <kit> <icon> command.
• Following features are available with it:
• 1.19+: You can use the same item syntax as with the /give command
• This means, that you can use NBT for versions 1.19 - 1.20.4
• Due to Mojang's changes, you must use item components for 1.20.5+ instead
• It is possible to use legacy material ids that were used past 1.12 (Not recommended)
• It is possible to use material names, even from newer or past versions
• Ability to have custom head textures:
• player_head:<player name>
• player_head:<texture>
• Ability to dye leather armor using HEX colors:
• leather_chestplate:#FF00FF
• Examples:
• stone
• 1 (turns into stone)
• 1:1 (turns into granite)
• iron_pickaxe:50 (adds some damage to the pickaxe)
• player_head:Notch (Notch's head)
• player_head:eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvYjA0ODMxZjdhN2Q4ZjYyNGM5NjMzOTk2ZTM3OThlZGFkNDlhNWQ5YmNkMThlY2Y3NWJmYWU2NmJlNDhhMGE2YiJ9fX0= (displays a globe, taken from the "other -> value" section at minecraft-heads.com)
• leather_chestplate:#FFFF00 (yellow chestplate)
• stick{Enchantments:[{id:"minecraft:knockback",lvl:1s}]} (1.19 - 1.20.4 only, item with knockback 1 enchantment)
• You may look at e.g. this website for a list of all available materials. Materials that do not exist with your Minecraft version obviously won't work.

Same plugin, just for /warps

[](s.marcely.de/bwspigot)
Official Website || SpigotMC