The Endex

Minecraft 版本： 1.2.1 1.2.2 1.2.3 1.2.4 1.2.5 1.20 1.20.1 1.20.2 1.20.3 1.20.4 1.20.5 1.20.6 1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8 1.21.9 1.21.10 1.21.11

平台： bukkit paper purpur spigot

标签： economy game-mechanics

---

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 ` ### 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 [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.