Essentials Warp 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 warps functionality of Essentials. Builds on top of it
  • No need to recreate the warps. This plugin automatically detects them
  • Each warp is being stored in its own file -> easily migrate and modify them
  • Fully customizable (even all the messages)
  • Multi-page support. Add as many warps 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)
• Warp button customizations
  • Change the display name in the GUI
  • Modify the icon
  • Add lore (text below the name)
  • Forcefully move the warps around where ever you like

CONFIGURATIONS

# The title of the inventory
inventory-title: Warps

# The title of the inventory that will be displayed on pages 2+
inventory-title-page: Warps - 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 warp 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-warp:
    name: UI_BUTTON_CLICK
    is-custom-resource-pack: false
    volume: 0.7
    pitch: 1.5
  teleport-warp:
    name: BLOCK_END_PORTAL_SPAWN
    is-custom-resource-pack: false
    volume: 0.3
    pitch: 2
  switch-page:
    name: ENTITY_HORSE_STEP_WOOD
    is-custom-resource-pack: false
    volume: 1.0
    pitch: 1.2

# The commands with which the warp GUI shall open
listen-to-commands:
- warps
- warp

command-usage: '&eCorrect usage: &6{usage}'
command-list: '&eAll warps ({amount}): &7{warps}'
command-set-displayname: '&eThe display name of the warp &6{warp} has been changed
  to {display-name}'
command-set-icon: '&eThe icon of the warp &6{warp} &ehas been changed to &6{icon}'
command-clear-lore: '&eRemoved all lore of the warp &6{warp}'
command-add-lore: '&eAdded lore to the warp &6{warp}&e: {lore}'
command-remove-lore: '&eRemoved lore from warp &6{warp}&e: {lore}'
command-set-lore: '&eSet lore in warp &6{warp}&e at &6{pos}&e: {lore}'
command-reload: '&eConfigurations have been reloaded'
command-set-slot: '&eWarp &6{warp} &eis now being displayed at &6X{x} Y{y}'
command-reset-slot: '&eWarp &6{warp} &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-warp: '&cUnknown warp &4{warp}'
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
warp-hook-disappear: '&cOops, it seems like the warp 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 warps for which he doesn't have the permissions for in the GUI.
• This means, that players must either have essentials.warps.<warpname> (grants access to specific warps) or essentials.warps.* (grants access to all warps).
• There is also an Essentials configuration with which you are able to check the permission check completely (called per-warp-permission).
• For further help, look at this permissions list or contact Essentials's support.
• To access the /warpcfg command, you will need the warpcfg.cfg permission.

ITEM SYNTAX

Same plugin, just for /kits

Official Website || SpigotMC