Depo

<div align="center">

The Endex 1.5.3 | 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.3 Highlights:

- Optimized World Scanner — 30+ placeholders for scoreboards, holograms, and other plugins - Optimized World Scanner — Automatic notifications when new versions are available - Optimized World Scanner — Full layout, colors, and slot position customization - Optimized World Scanner — Create custom command shortcuts like /shop → /market - Optimized World Scanner — Intelligent chunk caching with dirty tracking

---

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

---

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

---

<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.web.trade - Web dashboard trading endex.web.admin - View other players' holdings ```

---

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