Skip to content

Nexo Integration

Jump to bottom
DynamicShop Admin edited this page May 13, 2026 · 1 revision

Nexo Integration

DynamicShop provides deep integration with Nexo for custom GUI textures, glyph-based titles, and custom item support.

Setup

  1. Install Nexo on your server
  2. DynamicShop will auto-detect Nexo on startup and log: Nexo glyph resolver cache warmed up.
  3. On first startup with Nexo present, messages.yml is automatically generated with Nexo glyph tags

GUI Textures

DynamicShop supports Nexo glyphs for custom GUI backgrounds and shift-aligned titles. Configure these in your messages.yml:

messages:
  gui-category-title: "<white><shift:-48><glyph:shop_gui_menu><shift:-170><black><bold>Categories"
  shop-gui-title: "<white><shift:-48><glyph:shop_item_display><shift:-170><black><bold>{category}"
  admin-shop-gui-title: "<white><shift:-48><glyph:shop_gui_menu><shift:-170><black><bold>Shop Admin"

Required Nexo Glyphs

Define these glyphs in your Nexo configuration:

Glyph ID Purpose
shop_gui_menu Background texture for category selection & admin GUIs
shop_item_display Background texture for shop item browsing

Required Nexo Items (Navigation Buttons)

Define these custom items in Nexo for the bottom navigation bar:

Nexo Item ID Purpose Fallback
shop_back_button Previous page arrow ARROW
shop_next_button Next page arrow ARROW
shop_categories_button Back to categories BARRIER
shop_search_button Search items COMPASS
shop_page_button Page info display PAPER
shop_filter_button Filter toggle HOPPER

Note: If any Nexo item ID is not found, DynamicShop automatically falls back to the vanilla Material listed in the "Fallback" column.

Custom Filler Items

Use a Nexo item as the GUI border/filler by setting:

gui:
  filler_material: "nexo:shop_empty_slot"

Custom Shop Items

Nexo items can be added to the shop as purchasable items. Hold the Nexo item in your hand and run:

/shopadmin add item <price>

The plugin automatically detects the Nexo item ID and creates a server-shop entry with nexo delivery method. The item appears in the Server Shop category by default.

Troubleshooting

GUI shows boxes (□□□) instead of textures

Your client's Nexo resource pack isn't loaded. Try:

  1. Press F3 + T to force-reload resource packs
  2. Check your Multiplayer server entry — ensure Server Resource Packs is set to Enabled
  3. Check server console for Nexo startup errors

GUI shows purple/black checkerboard items

The Nexo items are being sent correctly, but the client's resource pack is missing the textures. Same fix as above.

Glyph tags appear as raw text (e.g., <glyph:shop_gui_menu>)

The MiniMessage tags weren't parsed. Check:

  1. Server console for [DynamicShop/Nexo] warning messages
  2. Ensure Nexo is listed in softdepend in plugin.yml
  3. Verify the glyph IDs match your Nexo configuration exactly

Messages.yml got corrupted after an update

If your messages.yml MiniMessage tags got mangled (quotes changed, characters escaped), this was caused by a previous version's auto-merge using Bukkit's YAML serializer. This is fixed in v2.5.9+. Restore your tags from messages_nexo_example.yml.

Reference: messages_nexo_example.yml

A complete Nexo-ready messages template is auto-generated at plugins/DynamicShop/messages_nexo_example.yml. If you need to restore your messages.yml, copy the relevant keys from this file.

Clone this wiki locally