AxialSeries - EssentialsX Warps GUI v1.0.0

Axial Series · EssentialsX + DeluxeMenus pack

EssentialsX warp browser · paginated sunset GUI
Permission-gated VIP / staff warps · generator included
$4.99 USD · one-time · DeluxeMenus 1.14+ · EssentialsX · Paper 1.16+

================================================================================
OVERVIEW
================================================================================
Axial EssentialsX Warps is a DeluxeMenus warp browser for EssentialsX servers.
Players open a framed GUI, browse server destinations, and left-click to run
/warp <name>. Warps are defined in settings.yml to match your EssentialsX warp
files — Essentials PlaceholderAPI has no dynamic warp list. Optional permission
gates show locked gray dyes for VIP, black market, and staff destinations.
Sunset palette (#FA4A19 / #DB8E60), generator included.

19 sample warps | 28 per page | 2 warp states | 1 menu page (default)
EssentialsX /warp | DeluxeMenus layout | Generator included

================================================================================
REQUIREMENTS
================================================================================
Required plugins
· DeluxeMenus 1.14+ (open commands, permission requirements)
· EssentialsX (warp commands and warp storage)

Recommended
· PlaceholderAPI (future expansions; warp list is settings-driven)

Server
· Paper or Spigot 1.16+ (hex &#RRGGBB item text in DeluxeMenus)
· EssentialsX warps created via /setwarp

================================================================================
WHAT'S INCLUDED
================================================================================
DeluxeMenus (copy into plugins/DeluxeMenus/)
config.yml Registers warp menu + open commands
gui_menus/
axial_warps.yml Single-page warp browser (paginates when >28)

Generator source (customize & rebuild)
settings.yml Warps, palette, messages, permissions
tools/generate.mjs Rebuilds menus from settings
generate.bat Windows one-click generator

================================================================================
SAMPLE WARPS (19)
================================================================================
ID Label Material (icon)
───────────── ───────────── ─────────────────────
spawn Spawn sunflower
shop Shop emerald
crates Crates ender_chest
auction Auction gold_ingot
bank Bank gold_block
wilderness Wilderness oak_sapling
mines Mines diamond_pickaxe
farm Farm wheat
fishing Fishing fishing_rod
arena Arena diamond_sword
events Events firework_rocket
parkour Parkour lime_dye
nether Nether netherrack
end The End end_stone
end_portal End Portal ender_eye
casino Casino gold_nugget
blackmarket Black Market black_dye (gated)
vip VIP Lounge amethyst_shard (gated)
staff Staff Room nether_star (gated)

Edit warps[] in settings.yml — run generate.bat to rebuild.

================================================================================
FEATURES
================================================================================
[Warp GUI] 54-slot framed menu — up to 28 warps per page in the inner
grid. Black border, gray side padding, compass header hub.

[Left-click TP] Closes menu and runs [player] warp <id> — EssentialsX
handles teleport, cooldown, and per-warp permissions.

[Themed lore] Long lore with Actions → Details → Status blocks, sunset
dividers, destination blurb, and /warp command hint.

[Permission gates] Optional essentials.warps.* permission per warp — ready
item (priority 0) when allowed, gray locked dye (priority 1)
with deny message when blocked.

[Bottom bar] Refresh (anvil), Warp Guide (book), Overview (paper),
Close (red dye). Pagination arrows when warps exceed 28.

[Chat messages] Sunset-themed warp and locked messages in settings.yml —
DeluxeMenus &#RRGGBB hex format.

[Generator] Add warps, change materials, descriptions, or permissions
in settings.yml — run generate.bat to rebuild everything.

================================================================================
MENU LAYOUT (54-slot)
================================================================================
Inner grid (up to 28 warps)
Rows: 10–16 · 19–25 · 28–34 · 37–43 (unused slots = gray filler)

Bottom bar
Slot 45 Previous page (arrow) or black filler
Slot 47 Refresh (anvil)
Slot 48 Warp Guide (book — /warp and /setwarp help)
Slot 49 Overview (paper — warp count, /warp list hint)
Slot 51 Close (red dye)
Slot 53 Next page (arrow) or black filler

Header
Slot 4 Compass hub item — Server Warps title

Border
Black stained glass frame · gray stained glass side columns

================================================================================
COMMANDS
================================================================================
Player — warp menu (DeluxeMenus)
/warps Open warp browser
/warpgui Alias
/essentialswarps Alias

Player — EssentialsX
/warp <name> Teleport to a warp
/warp list List available warps

Staff — EssentialsX
/setwarp <name> Create warp at your location
/delwarp <name> Remove a warp

Admin — setup
/dm reload Reload DeluxeMenus after copying files

================================================================================
PERMISSIONS
================================================================================
essentials.warp Use /warp (EssentialsX default)
essentials.warp.list View warp list
essentials.warps.<id> Per-warp access (EssentialsX, optional)
essentials.setwarp Create warps (staff)
essentials.delwarp Delete warps (staff)

Gated sample warps in default pack:
essentials.warps.blackmarket
essentials.warps.vip
essentials.warps.staff

Set require-warp-permissions: true in settings.yml to auto-gate every warp
with essentials.warps.<id>. Use permission: auto on individual entries.

================================================================================
SETTINGS.YML HIGHLIGHTS
================================================================================
warps-per-page: 28
update-interval: 2

open-commands: warps, warpgui, essentialswarps
register-command: true
menu-id-prefix: axial_warps

permission-prefix: essentials.warps.
require-warp-permissions: false

scheme.from / scheme.to / scheme.emoji / scheme.body
Sunset palette for names, lore, and messages

messages.prefix / teleport / locked
Themed DeluxeMenus chat output

warps[] id, label, description, material, permission

================================================================================
CUSTOMIZATION
================================================================================
1. Edit AxialConfigs/EssentialsX Warps DeluxeMenus/settings.yml
— add/remove warps, materials, descriptions, permissions

2. Ensure each warp id matches an EssentialsX /setwarp name

3. Run generate.bat or: node tools/generate.mjs

4. Copy config.yml + gui_menus/ → plugins/DeluxeMenus/

5. /dm reload

================================================================================
WHY AXIAL ESSENTIALSX WARPS? (highlights)
================================================================================
Polished warp browser in one config purchase:
+ DeluxeMenus GUI replacing plain /warp list chat spam
+ 19 ready-to-edit sample destinations
+ Permission-gated donor and staff warps built in
+ Paginated layout scales past 28 warps automatically
+ Sunset Axial palette across menus, lore, and chat
+ Generator rebuilds menus from one settings file
+ $4.99 one-time (not subscription)

================================================================================
SETUP (quick)
================================================================================
1. Install DeluxeMenus and EssentialsX on your Paper server
2. Create warps with /setwarp <name> at each destination
3. Edit settings.yml so warp ids match your EssentialsX warps
4. Run generate.bat
5. Copy config.yml + gui_menus/ → plugins/DeluxeMenus/ → /dm reload
6. Players open /warps and left-click to teleport

================================================================================
Axial Series — EssentialsX Warps DeluxeMenus Pack · $4.99 one-time
Paste alongside image thread as feature, command & setup reference.
================================================================================