The Endex

<div align="center">

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

<img src="https://i.imgur.com/onDbDSW.png" alt="The Endex Banner" />

*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.*

</div>

---

<div align="center"> <img src="https://i.imgur.com/QK38If6.png" alt="About" /> </div>

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:

- ⚡ Zero Performance Impact — 4-layer defense prevents infinite money exploits! - ⚡ Zero Performance Impact — Creates friction cost that blocks profitable arbitrage loops! - ⚡ Zero Performance Impact — Prevents instant buy→sell flipping after purchases! - ⚡ Zero Performance Impact — Manipulated prices drift back to base during idle periods! - ⚡ Zero Performance Impact — Automatically migrates old configs while preserving your settings! - ⚡ Zero Performance Impact — All protections use <0.01% CPU overhead!

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

🔐 Permissions Fix - 🔐 Permissions Fix — Fixed deleteCategory() and saveShopChanges() not working properly! - 🔐 Permissions Fix — 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!

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

---

<div align="center"> <img src="https://i.imgur.com/5OYklKS.png" alt="Features" /> </div>

💰 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.

<div align="center"> <img src="https://i.imgur.com/2NVDOxj.gif" alt="Market GUI Demo" /> </div>

⚡ Market Events

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

<div align="center"> <img src="https://i.imgur.com/Qa5Hrhw.gif" alt="Market Events Demo" /> </div>

🌐 Web Dashboard

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

<div align="center"> <img src="https://i.imgur.com/2hXIQfx.gif" alt="Web Dashboard Demo" /> </div>

🔌 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.

<div align="center"> <img src="https://bstats.org/signatures/bukkit/The%20Endex.svg" alt="bStats" /> </div>

---

<div align="center"> <img src="https://i.imgur.com/Up3T3eB.png" alt="Commands" /> </div>

``` /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 ```

---

<div align="center"> <img src="https://imgur.com/jNDfH1h.png" alt="Permissions" /> </div>

``` 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

- Economy: Paper/Spigot 1.20.1 - 1.21.x - Economy: 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:

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

World Storage Scanner:

```yaml 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:

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

Web combined holdings:

```yaml 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

- Economy: Paper/Spigot 1.20.1 to 1.21.x - Economy: 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

---

⚠️ 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.

<div align="center">

Discord

Join our Discord!

</div>