The Endex 1.5.3 | 动态市场与插件 [1.20.1 - 1.21.x]
为你的服务器注入鲜活的经济体系。价格随玩家需求与供给波动,配备精美的市场 GUI、限时事件、可选的网页仪表盘、虚拟持仓系统以及插件框架。
The Endex 是一款动态经济插件,为 Minecraft 服务器带来逼真的市场机制。价格会根据玩家交易活动、全服物品存储量以及随机市场事件而波动。
? 1.5.3 版本亮点:
- PlaceholderAPI 支持 — 提供 30+ 个占位符,可用于记分板、全息图及其他插件
- 更新检查器 — 有新版本时自动通知
- GUI 自定义 — 全面支持布局、颜色和槽位位置的自定义
- 命令别名 — 创建自定义命令快捷方式,例如 /shop → /market
- 优化的世界扫描器 — 智能区块缓存与脏数据追踪
? 动态定价
价格对供需做出反应,具备可配置的敏感度、EMA 平滑处理以及每项物品的最高/最低价格上限。
? 世界存储扫描器
价格根据全服所有存储中的物品总量进行调整。物品充裕时价格下跌,稀缺时价格上涨。
? 虚拟持仓
将物品买入虚拟存储,并跟踪平均成本及盈亏显示。随时提取所需物品。
?️ 市场 GUI
拥有精美界面,包含分类、搜索、排序、快速买卖按钮以及实时价格图表。
? 截图
⚡ 市场事件
限时价格倍数事件(如矿石狂热、市场崩盘等),并伴有全服广播提示。
? 网页仪表盘
可选 REST API,支持实时更新、图表展示、物品图标显示以及通过浏览器进行交易。
? 插件框架
可扩展 API,用于开发自定义插件,支持命令路由和网页集成。
? 投递系统
当背包或持仓已满时提供溢出保护。随时领取投递的物品。
? PlaceholderAPI 支持
提供 30+ 个占位符,适用于记分板、全息图、标签页列表等。可在任意位置显示价格、趋势、持仓、排行榜和市场统计数据。
/endex help - 显示帮助菜单
/endex version - 显示插件版本
/market - 打开市场 GUI
/market buy <item> <amt> - 购买物品
/market sell <item> <amt>- 出售物品
/market price <item> - 查看当前价格
/market top - 查看交易量最大的物品
/market holdings - 查看你的虚拟持仓
/market withdraw <item> - 从持仓中提取物品到背包
/market withdraw all - 提取所有物品
/market delivery list - 查看待领取的投递
/market delivery claim - 领取已投递的物品
/market delivery gui - 打开投递 GUI
/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 - 清除所有事件(管理员)
theendex.market - 访问市场 GUI(默认:true)
theendex.buy - 购买物品(默认:true)
theendex.sell - 出售物品(默认:true)
theendex.holdings - 访问持仓系统(默认:true)
theendex.withdraw - 从持仓中提取(默认:true)
theendex.invest - 使用投资功能(默认:true)
theendex.admin - 管理员命令(默认:op)
endex.web.trade - 网页仪表盘交易权限
endex.web.admin - 查看其他玩家的持仓
? 要求
- 服务端: Paper/Spigot 1.20.1 - 1.21.x
- Java: 17 或更高版本
- 经济系统: Vault + 经济插件(EssentialsX, CMI 等)
? 存储选项
- YAML(默认)或 SQLite 数据库
- 自动备份与安全重载
- CSV 价格历史导出
配置亮点
虚拟持仓:
holdings:
enabled: true
max-per-player: 10000
max-materials-per-player: 100
mode: VIRTUAL
世界存储扫描器:
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
基于库存的定价:
price-inventory:
enabled: true
sensitivity: 0.02
per-player-baseline: 64
max-impact-percent: 10.0
网页合并持仓:
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
兼容性
- 服务端: Paper/Spigot 1.20.1 至 1.21.x
- Java: 17 运行时环境
- 经济系统: Vault(软依赖)
数据与可靠性
- 默认在插件文件夹中使用 YAML 存储;可选 SQLite 数据库
- 定期备份与有序保存;安全重载可干净地重新调度任务
- 原子性 CSV 导出至
plugins/TheEndex/history
- 持仓操作使用原子事务,防止重复利用漏洞
API 与插件
- 供其他插件使用的公共 API 服务:
org.lokixcz.theendex.api.EndexAPI
- 带命令路由和别名的插件加载器
- 可自定义的 Web UI 覆盖(
web.custom.*)— 导出默认的 index.html 并进行修改
更新日志
? 完整更新日志
1.5.3 新增内容:
- PlaceholderAPI 集成:提供 30+ 个占位符,涵盖价格、趋势、持仓、排行榜和统计数据
- 更新检测器:当有可用更新时,在服务器启动及 OP(管理员)加入时自动发送通知
- GUI 自定义:支持通过独立的 GUI 配置文件来调整布局、颜色、槽位位置及分类
- 命令别名:通过
commands.yml 创建自定义快捷命令(例如 /shop → /market)
- 完整文档请参阅
1.5.2 新增内容:
- 优化的世界存储扫描器:完全重写,采用智能区块缓存与脏数据追踪机制
- 支持可配置过期时间的区块级缓存 —— 冗余扫描量减少 80-90%
- 基于事件的脏数据追踪 —— 仅重新扫描容器被修改过的区块
- 跨服务器重启的缓存数据磁盘持久化
- GUI 修复 (MC 1.21+):修复了市场物品可能被取走且点击无响应的关键 Bug
- 使用 UUID 进行 GUI 状态追踪,取代不可靠的标题匹配方式
1.5.1 新增内容:
- 世界存储扫描器:价格现在会对服务器上存储的所有物品做出反应(包括箱子、 barrels、潜影盒等)
- 全局物品追踪,实现真正的全服稀缺经济系统
- 防操纵保护:区块上限、材料限制、可疑活动日志记录
- TPS 感知节流:当服务器负载过高时,扫描器会自动跳过
- 双箱去重功能,防止重复计数
- 嵌套潜影盒内容扫描(即箱子内的潜影盒中的物品)
- 可配置的容器类型与世界排除列表
1.5.0 新增内容:
- 虚拟持仓系统:完全重新设计,购买的商品不再直接进入玩家背包,而是存入虚拟持仓
- 持仓 GUI:全新面板,显示所有持仓物品的数量、平均成本、当前价格以及盈亏情况
- 持仓命令:使用
/market holdings 查看持仓,使用 /market withdraw <item> [amount] 领取物品
- Web UI 提现:每个持仓行均有“提现”按钮,并支持“全部提现”按钮
- Minecraft 1.21 支持:全面兼容 Minecraft 1.21.x 服务器
- 新增权限:
theendex.holdings 和 theendex.withdraw(默认均为 true)
- 可配置的限制:
holdings.max-per-player(默认 10,000)和 holdings.max-materials-per-player(默认 100)
1.4.0 新增内容:
- 虚拟配送系统:溢出的购买订单将进入待配送队列
- 配送命令:
/market delivery list|claim|claim-all|gui
- Web + API 更新:新增
/api/deliveries 端点
- 修复了 1.20.1 服务器上的购买循环问题
1.3.x 新增内容:
- 在收费前检查库存容量;超大订单会被截断至最大容量
- 安全加固:移除了反射访问,会话令牌移至 Authorization 头部
- 支持通过
web.api.token-hashes 配置哈希 API 令牌(SHA-256)
请参阅 CHANGELOG.md 以获取完整的发行说明。
⚠️ 免责声明
本插件是在 AI 的帮助下开发的。尽管经过了 thorough testing(彻底测试),但仍可能出现潜在的 Bug 或问题。请在 Discord 或 GitHub 上报告相关问题。
The Endex 1.5.3 | 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.3 Highlights:
- PlaceholderAPI Support — 30+ placeholders for scoreboards, holograms, and other plugins
- Update Checker — Automatic notifications when new versions are available
- GUI Customization — Full layout, colors, and slot position customization
- Command Aliases — Create custom command shortcuts like /shop → /market
- Optimized World Scanner — Intelligent chunk caching with dirty tracking
? 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.
/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)
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
- 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.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
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.
评论 0
登录后参与评分
还没有评论,来抢沙发吧