Skip to content

Installation

Jump to bottom
DynamicShop Admin edited this page Jul 17, 2026 · 5 revisions

Installation

DynamicShop 2.6.4 requires Java 21 and the hard dependencies declared in plugin.yml.

Prerequisites

  1. Java 21 or newer - The 2.6.4 JAR targets Java 21 bytecode.
  2. A Bukkit-compatible server - The descriptor declares api-version: 1.20, while the project is compiled against Paper API 1.21.7. Paper 1.21.7+ is the full-feature target.
  3. Vault - A hard dependency in plugin.yml, including when optional CoinsEngine mode is configured.
  4. A Vault economy provider - Required in the default economy.system: vault mode. Examples include EssentialsX Economy and CMI.
  5. ProtocolLib - A hard dependency used for inventory packet/lore handling.

The classic inventory paths contain compatibility fallbacks for Spigot, CraftBukkit, and Arclight, and 2.6.4 specifically fixes the webadmin virtual-host call on runtimes that lack Paper's method. Those runtimes are not equivalent to the Paper 1.21.7 build target; validate the exact server build and keep gui.use_dialog_gui: false.

Optional Integrations

  • Nexo - Custom GUI textures, glyph-based titles, and custom item support. See Nexo Integration.
  • ItemsAdder - Alternative custom items support.
  • ValhallaMMO - Registered custom item detection and delivery.
  • CoinsEngine - Optional multi-currency backend selected with economy.system: coinengine; Vault remains a hard plugin dependency.
  • PlaceholderAPI - Exposes DynamicShop statistics placeholders to other PlaceholderAPI-aware plugins.
  • floodgate / Geyser - Floodgate identifies Bedrock players so DynamicShop uses its item-action inventory flow. DynamicShop does not send native Bedrock forms.

Installation Steps

  1. Stop your Minecraft server.
  2. Download the latest DynamicShop-2.6.4.jar.
  3. Place the JAR in your server's plugins/ directory and remove the older DynamicShop JAR.
  4. Start your server. The plugin will automatically generate the default configuration and web dashboard files in plugins/DynamicShop.
  5. Run /shop in game to view the bundled item catalog.

The catalog is a curated list in the bundled config.yml, not an automatically priced list of every vanilla item. Materials unknown to the running server are skipped with a console warning.

Upgrading

  1. Stop the server completely.
  2. Back up plugins/DynamicShop, then replace the old JAR with DynamicShop-2.6.4.jar.
  3. Start the server normally. Version 2.6.4 adds missing bundled settings without merging into or replacing the items and special_items sections.
  4. Review the console for compatibility warnings and confirm the web dashboard bind address and hostname.

Use a full restart when replacing the JAR. Bukkit's /reload command does not safely replace already loaded plugin classes.

Use /shopadmin reload for ordinary configuration, messages, category, shop-data, and restock changes. Changing the embedded web server bind/port/TLS/CORS lifecycle or the JeroMQ port/peer mesh requires a full server restart.

First-Time Nexo Setup

If Nexo is already enabled and DynamicShop has no existing messages.yml, the first DynamicShop startup copies the Nexo glyph template as messages.yml. DynamicShop also creates messages_nexo_example.yml when that reference file is absent. Installing Nexo later does not overwrite an existing messages.yml. See Nexo Integration for setup details.

Clone this wiki locally