The Endex | Dynamic Market & Addons [1.20.1 - 1.21.8]
![[IMG]](//proxy.spigotmc.org/4fd78e6cee3aa5d345ec04d8ab23b53918be8802/68747470733a2f2f692e696d6775722e636f6d2f6f6e44624453572e706e67)
Bring a living economy to your server. Prices move with player demand and supply, with a slick Market GUI, timed events, optional web dashboard, and an addon framework.
Key Features
Dynamic Pricing — Prices react to demand/supply with configurable sensitivity, EMA smoothing, and per‑item min/max caps.
Inventory‑Aware Pricing (Optional) — Prices can gently adapt to how many items players are holding (online inventories). Above‑baseline stock nudges price down; scarce items nudge it up. Fully capped and smoothed.
Market GUI — Categories, search, sorting, quick buy/sell amounts, a details panel with a tiny sparkline, plus last‑cycle demand/supply and an estimated impact percentage. GUI auto‑refreshes on price updates.
Investments — Buy positions in items, view holdings, and redeem accrued value with simple in‑game commands.
Events & Shocks — Time‑boxed multipliers (e.g., Ore Rush) with broadcasts; configurable and hot‑reloadable.
Addon Framework — Lightweight API for addons to plug in new behaviors.
Web Dashboard (Optional) — REST API, live updates (WS/SSE), charts, real item icons from your resource pack with caching, and
Combined Holdings that show both
Invest (DB) and
Inv (live inventory) with badges.
Commands
Code (Text):
/endex help
/endex version
/market
/market buy <item> <amount>
/market sell <item> <amount>
/market price <item>
/market top
/market invest buy <item> <amount>
/market invest list
/market invest redeem-all
/market event list
/market event <name>
/market event end <name>
/market event clear
Permissions
theendex.market — default: true
theendex.buy — default: true
theendex.sell — default: true
theendex.invest — default: true
theendex.admin — default: op
endex.web.trade — allow web trading role
endex.web.admin — allow viewing others’ holdings via /api/holdings/{uuid}
Configuration Highlights
Versioned configuration with automated migration on startup and reload.
Adjustable update interval, price sensitivity, history length, and autosave frequency.
Transaction tax, item blacklist, category settings, and event multiplier caps.
Storage selection (YAML or SQLite) with automatic seeding and CSV price history export.
Optional web server (host/port, WS/SSE, icons, caching, rate limits).
Inventory‑aware pricing:
Code (Text):
price-inventory:
enabled: true
sensitivity: 0.02
per-player-baseline: 64
max-impact-percent: 10.0
Web combined holdings:
Code (Text):
web:
roles:
default: TRADER
trader-permission: endex.web.trade
admin-view-permission: endex.web.admin
holdings:
inventory:
enabled: true
include-enderchest: false
cache-seconds: 15
Compatibility
Server: Paper/Spigot 1.20.1 to latest.
Java 17 runtime.
Economy: Vault (soft dependency).
Data & Reliability
YAML storage in the plugin folder by default; optional SQLite database.
Periodic backups and orderly saves; safe reload reschedules tasks cleanly.
Atomic CSV export to plugins/TheEndex/history.
Last‑cycle demand/supply persist (no more 0% on idle cycles).
API & Addons
Public API service for other plugins: org.lokixcz.theendex.api.EndexAPI
Addon loader with command routing and aliasing
Support
Issues:
https://github.com/khristianaarongarcia/endex/issues
Join our Discord
Changelog
Latest highlights:
- Inventory‑aware pricing (optional) with smoothing & per‑cycle impact caps
- Web Combined Holdings with [Inv]/[Invest] badges; admin holdings view endpoint
- Web icons improvements, WS live updates, rate‑limit polish
See docs/changelogs.md for full notes.
Join our Discord!