The Endex 1.5.8-JAN80235 | Dynamic Market & Addons [1.20.1 - 1.21.x]

Bring a living economy to your server. Prices move with player demand and supply, with a slick Market GUI, timed events, optional web dashboard, virtual holdings system, and an addon framework.

The Endex is a dynamic economy plugin that brings realistic market mechanics to your Minecraft server. Prices fluctuate based on player trading activity, server-wide item storage, and random market events.

🆕 Version 1.5.8-JAN80235 Highlights:

🛡️ Anti-Exploit Protection System — 4-layer defense prevents infinite money exploits!
💰 6% Buy/Sell Spread — Creates friction cost that blocks profitable arbitrage loops!
⏱️ 60-Second Sell Cooldown — Prevents instant buy→sell flipping after purchases!
📉 Price Mean Reversion — Manipulated prices drift back to base during idle periods!
🔄 Config Auto-Update — Automatically migrates old configs while preserving your settings!
⚡ Zero Performance Impact — All protections use <0.01% CPU overhead!

What's Protected:

✅ Buy-Sell Arbitrage — Can't buy low and sell high for instant profit
✅ Price Manipulation — Prices automatically correct when manipulation stops
✅ Instant Flipping — Must wait 60 seconds after buying before selling
✅ Your Economy — Fair, balanced gameplay for all players

Previous Version (1.5.8-JAN70109):

🔧 Shop Editor Fixes — Fixed deleteCategory() and saveShopChanges() not working properly!
🌐 Language Files — Added shop-editor language section to Korean, Russian, Portuguese, and Chinese translations!
🔐 Permissions Fix — Added missing shop editor and web dashboard permissions to plugin.yml!

Earlier 1.5.8 Features:

Inflation System — New configurable inflation/deflation system with per-category rates!
Market Items Manager — New editor button to view/edit all market items in one place!
Price Editor Fix — Fixed vanilla item price editing in the market editor!
Admin Commands Fixed — /market remove, disable, setbase, setmin, setmax now persist properly!

💰 Dynamic Pricing

Prices react to demand/supply with configurable sensitivity, EMA smoothing, and per-item min/max caps.

🌍 World Storage Scanner

Prices adapt to global item quantities across ALL server storage. Abundant items drop in price; scarce items rise.

📦 Virtual Holdings

Buy items into virtual storage with average cost tracking and profit/loss display. Withdraw when ready.

🖥️ Market GUI

Beautiful interface with categories, search, sorting, quick buy/sell buttons, and real-time price charts.

📸 Screenshots

⚡ Market Events

Time-boxed price multipliers (Ore Rush, Market Crash, etc.) with server broadcasts.

🌐 Web Dashboard

Optional REST API with live updates, charts, item icons, and trading from your browser.

🔌 Addon Framework

Extensible API for custom addons with command routing and web integration.

📬 Delivery System

Overflow protection when inventory or holdings are full. Claim items anytime.

🔗 PlaceholderAPI Support

30+ placeholders for scoreboards, holograms, tab lists, and more. Display prices, trends, holdings, leaderboards, and market stats anywhere.

📊 bStats Metrics

Anonymous usage statistics to help improve the plugin.

/endex help              - Show help menu
/endex version           - Display plugin version

/market                  - Open market GUI
/shop                    - Alias for /market
/m, /trade, /exchange    - Additional market aliases

/market buy <item> <amt> - Purchase items
/market sell <item> <amt>- Sell items
/market price <item>     - Check current price
/market top              - View top traded items

/market holdings         - View your virtual holdings
/market withdraw <item>  - Withdraw items to inventory
/market withdraw all     - Withdraw everything
/market sellholdings <item> <amt> - Sell directly from holdings

/market delivery list    - View pending deliveries
/market delivery claim   - Claim delivered items
/market delivery gui     - Open delivery GUI

/market invest buy <item> <amount>
/market invest list
/market invest redeem-all

/market event list       - View active events
/market event <name>     - Start an event (admin)
/market event end <name> - End an event (admin)
/market event clear      - Clear all events (admin)

# Namespaced commands also work:
/endex:shop, /endex:market, /endex:m

theendex.market      - Access market GUI (default: true)
theendex.buy         - Purchase items (default: true)
theendex.sell        - Sell items (default: true)
theendex.holdings    - Access holdings system (default: true)
theendex.withdraw    - Withdraw from holdings (default: true)
theendex.invest      - Use investments (default: true)
theendex.admin       - Admin commands (default: op)
endex.shop.editor    - Access shop editor (default: op)
endex.shop.admin     - Shop admin commands (default: op)
endex.web.trade      - Web dashboard trading (default: true)
endex.web.admin      - View other players' holdings (default: op)

📋 Requirements

Server: Paper/Spigot 1.20.1 - 1.21.x
Java: 17 or higher
Economy: Vault + Economy plugin (EssentialsX, CMI, etc.)

💾 Storage Options

YAML (default) or SQLite database
Automatic backups and safe reloads
CSV price history export

Configuration Highlights

Virtual Holdings:

holdings:
  enabled: true
  max-per-player: 10000
  max-materials-per-player: 100
  mode: VIRTUAL

World Storage Scanner:

price-world-storage:
  enabled: true
  scan-interval-seconds: 300
  sensitivity: 0.01
  global-baseline: 1000
  containers:
    chests: true
    barrels: true
    shulker-boxes: true
  anti-manipulation:
    per-chunk-item-cap: 10000
    per-material-chunk-cap: 5000
    min-tps: 18.0

Inventory-aware pricing:

price-inventory:
  enabled: true
  sensitivity: 0.02
  per-player-baseline: 64
  max-impact-percent: 10.0

Web combined holdings:

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 1.21.x
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
Holdings operations use atomic transactions to prevent duplication exploits

API & Addons

Public API service for other plugins: org.lokixcz.theendex.api.EndexAPI
Addon loader with command routing and aliasing
Customizable Web UI override (web.custom.*) – export default index.html and modify

Changelog

📜 Full Changelog

New in 1.5.8-JAN70109:

Shop Editor deleteCategory() Fix: Delete category button now properly calls CustomShopManager.removeCategory() instead of showing "coming soon"
Shop Editor saveShopChanges() Fix: Save button now properly calls CustomShopManager.reload() instead of only playing a sound
Language Files: Added shop-editor language section (~60 keys) to Korean, Russian, Portuguese, and Chinese translations
Permissions Fix: Added missing permissions to plugin.yml: endex.shop.editor, endex.shop.admin, endex.web.trade, endex.web.admin

New in 1.5.8-JAN60132:

Shop Editor Category Fix: Fixed "Create Category" dialog in the shop editor not responding to clicks
Clicking compass (Filter mode) or chest (Manual mode) icons now properly creates new categories
Added CREATE_CATEGORY state tracking and proper click handling flow
Categories now persist immediately to shop YAML config files

New in 1.5.7-dec1038:

Polish Language Support: Complete Polish (Polski) translation for plugin and documentation
Config Translations Auto-Extract: 10 language configs now auto-extract to plugins/TheEndex/config_translations/ on first run
Optimized Default Configuration: Ships with minimal resource usage settings by default
World storage scanning DISABLED by default (easily re-enabled for full features)
Inventory-based pricing DISABLED by default
Save-on-each-update DISABLED by default (reduced disk I/O)
Update interval increased to 120 seconds (was 60)
Prominent optimization guide added to top of config.yml

New in 1.5.7-dec1022:

Web Dashboard Translation: Google Translate integration for 26+ languages
GUI Bug Fix: Fixed ArrayIndexOutOfBoundsException when middle-clicking items in market details
Performance Indicators: Config options now show [PERF: LOW/MEDIUM/HIGH] impact tags
Translated Configs: Pre-translated config files in 9 languages (Chinese, Spanish, French, German, Japanese, Korean, Portuguese, Russian, Arabic)
Market GUI: Increased details inventory size from 27 to 36 slots to fix button placement

New in 1.5.7:

Sell from Holdings: Sell items directly from virtual holdings without withdrawing to inventory first
Arclight/Hybrid Server Compatibility: Fixed plugin recognition, SLF4J logging, ServiceLoader, and clickable chat links
Market GUI: Item details now shows "Inventory: X | Holdings: Y" with new sell buttons (slots 33 & 35)
Custom Shop GUI: Vanilla items can now be sold from holdings when inventory is insufficient
Web API: New POST /api/sell-holdings endpoint for web dashboard selling
New Command: /market sellholdings <material> <amount>

New in 1.5.6:

Minecraft 1.20.1+ Compatibility: Lowered api-version from '1.21' to '1.20' to restore support for 1.20.1+ servers (Arclight, etc.)
In-Game Layout Editor: Complete visual GUI editor for custom shop layouts — no config editing required!
Custom Items Support: Add any material as decoration with personalized names and lores
5 Editor Modes: Place Category, Place Decoration, Place Button, Edit Slot, Remove Slot
Right-Click Editing: Customize item names and lores via chat prompts
Real-Time Preview: See changes instantly before saving
One-Click Save: Save layouts directly to shop config file
Custom Category Icons: Categories display custom names/lores in /market

New in 1.5.5:

Economy Plugin Compatibility: Fixed "Economy unavailable" error with late-loading economy plugins (SimpleEconomy, etc.)
Added delayed retry (2 seconds) for economy provider detection
Economy plugins that register with Vault after TheEndex loads are now properly detected
Added common economy plugins to softdepend list to improve load order

New in 1.5.4:

bStats Metrics: Plugin analytics with custom charts (storage mode, shop mode, web UI, holdings, item count)
Custom Shop Enhancements: Holdings button (slot 45) and Sort button (slot 53) in category pages
Filter-Based Categories: Auto-populate shop categories using material filters instead of manual item lists
Default GUI Improvements: Removed Amount button, Sort moved to slot 49, cleaner layout
Fixed: Hotbar interaction no longer blocked while GUI is open
Fixed: Sort order now correctly shows highest prices/changes first (descending)
Fixed: Holdings button in Custom Shop now properly opens holdings panel
Fixed: /ex market command respects shop.mode config setting

New in 1.5.3:

PlaceholderAPI Integration: 30+ placeholders for prices, trends, holdings, leaderboards, and stats
Update Checker: Automatic notifications on startup and OP join when updates available
GUI Customization: Per-GUI config files for layout, colors, slot positions, and categories
Command Aliases: Create custom shortcuts (e.g., /shop → /market) via commands.yml
Full documentation available at https://lokixcz-plugins.kagsystems.tech/

New in 1.5.2:

Optimized World Storage Scanner: Complete rewrite with intelligent chunk caching and dirty tracking
Chunk-level caching with configurable expiry — 80-90% reduction in redundant scanning
Event-driven dirty tracking — only re-scans chunks where containers were modified
Disk persistence for cache data across server restarts
GUI Fix (MC 1.21+): Fixed critical bug where market items could be taken and clicks weren't registering
UUID-based GUI state tracking replaces unreliable title matching

New in 1.5.1:

World Storage Scanner: Prices now react to ALL items stored on your server (chests, barrels, shulker boxes, etc.)
Global item tracking for true server-wide scarcity economics
Anti-manipulation protection: per-chunk caps, per-material limits, suspicious activity logging
TPS-aware throttling: scanner skips if server is under load
Double chest deduplication prevents double-counting
Nested shulker content scanning (items inside shulkers in chests)
Configurable container types and world exclusions

New in 1.5.0:

Virtual Holdings System: Complete redesign where purchased items go into virtual holdings instead of inventory
Holdings GUI: New panel showing all holdings with quantity, avg cost, current price, and profit/loss
Holdings Commands: /market holdings to view, /market withdraw <item> [amount] to claim items
Web UI Withdraw: Withdraw buttons on each holding row plus "Withdraw All" button
Minecraft 1.21 Support: Full compatibility with Minecraft 1.21.x servers
New permissions: theendex.holdings and theendex.withdraw (both default: true)
Configurable limits: holdings.max-per-player (default 10,000) and holdings.max-materials-per-player (default 100)

New in 1.4.0:

Virtual Delivery System: overflow purchases now enter a pending delivery queue
Delivery Commands: /market delivery list|claim|claim-all|gui
Web + API updates: new /api/deliveries endpoints
Fixed buy loop issue on 1.20.1 servers

New in 1.3.x:

Inventory capacity checked before charging; oversized orders capped
Security hardening: removed reflective access, session token moved to Authorization header
Hashed API token support via web.api.token-hashes (SHA-256)

See CHANGELOG.md for full release notes.

⚠️ Disclaimer

This plugin was created with the help of AI. While thoroughly tested, please expect potential bugs or issues. Report problems on Discord or GitHub.

Join our Discord!

The Endex