Skip to content

Web Dashboard

Jump to bottom
selfservice0 edited this page May 13, 2026 · 3 revisions

Web Dashboard

DynamicShop runs its own lightweight, asynchronous embedded HTTP server using Javalin. You do not need an external Node.js process or Apache/Nginx (though it's recommended to run behind a reverse proxy for large networks!).

Player Dashboard

Players can visit standard endpoints built into the plugin to browse the live shop items, current stocks, and exact prices straight from their browser. To access this, simply navigate to http://<your-server-ip>:7713/.

(Note: Ensure you have port forwarded 7713 in your firewall/router if you aren't using a reverse proxy!)

Web Admin Panel

The Web Admin Panel is an interactable dashboard for server owners.

Features of the Admin Panel:

  • Fully live editing of item prices, stock, and properties.
  • Adding and removing items from the shop.
  • Changing an item's category.
  • Managing categories (create, rename, reorder, hide).
  • Bulk actions (disable/enable items, toggle buying/selling).
  • Permission & Group shop item management.
  • Resetting shortages and viewing analytical data.
  • Managing global configuration via the browser.
  • Full audit log of all admin changes.

Accessing the Admin Panel

Because of its extreme power, the standard Admin Panel is fully secure.

  1. Ensure you have Op in-game.
  2. Run /shopadmin webadmin in-game.
  3. The plugin will intercept the command, temporarily grant an expiring access token, and provide a clickable chat link directly into the authenticated web session.

Admin Panel Usage

Adding an Item to the Shop

  1. Open the Shop tab in the admin panel.
  2. Click into the category you want to add the item to.
  3. Click the ✚ Add Item button in the top-right corner.
  4. In the modal that appears:
    • Material Name — Type the Minecraft material name (e.g. DIAMOND, NETHERITE_INGOT). An autocomplete list will appear as you type.
    • Base Price — Set the starting price for the item.
    • Category Override (optional) — By default the item is placed in the category you're currently viewing. You can override this with the dropdown to place it in a different category.
  5. Click 💾 Add to Shop.

The item will immediately appear in the shop and be available for players to buy and sell.

Tip: You can also add items via the in-game admin commands. See Commands and Permissions for details.

Changing an Item's Category

  1. Open the Shop tab and navigate to the category containing the item (or use the search bar to find it).
  2. Click the Edit button on the item's row.
  3. In the edit modal, use the Category dropdown at the top to select the new category.
  4. Click 💾 Save.

The item will be moved to the new category immediately. This sets a category override — the item will stay in the chosen category regardless of its default auto-detected category.

Editing Item Properties

Clicking Edit on any item opens a modal where you can change:

Field Description
Category Which shop category the item belongs to.
Base Price The item's base price before any dynamic pricing adjustments.
Current Stock The server's current stock level. Positive = surplus, negative = deficit.
Shortage Rate Per-item price increase percentage per negative stock unit.
Pricing Curve Max Stock The stock ceiling used for the pricing curve. Leave empty to use the global default.
Storage Hard Limit Maximum stock the server will accept when players sell. Leave empty for unlimited.
Shortage Hours Accumulated hours this item has been at zero/negative stock (drives time inflation).
Buy Disabled Block players from purchasing this item.
Sell Disabled Block players from selling this item.
Item Disabled Completely hide this item from the shop.

You can also click Reset Shortage to zero out the shortage hours for that specific item.

Bulk Actions

  1. Use the checkboxes on the left of the items table to select multiple items (or use the header checkbox to select all).
  2. The Bulk Actions dropdown will appear. Available actions:
    • ❌ Disable Items / ✓ Enable Items
    • ⛔ Disable Buying / 🟢 Enable Buying
    • ⛔ Disable Selling / 🟢 Enable Selling

Managing Categories

Click the ✏️ button on any category card to edit it:

  • Display Name — The name shown to players.
  • Icon — The material used as the category icon (e.g. DIAMOND_SWORD).
  • Slot Position — The GUI slot (0–53). Set to -1 to hide the category.
  • Auto Restock — Set a target stock amount and interval (in minutes) for automatic restocking.

Click the ➕ Create Category card to set up a new custom category.

Changing the Port

You can modify the default port in config.yml:

webserver:
  enabled: true
  port: 7713
  bind: "0.0.0.0"
  admin-enabled: true

Clone this wiki locally