The Endex

插件

· 作者 lokixcz

The Endex 是一款 Minecraft 插件,它将资源转化为由玩家供需驱动的动态股票市场。

0 本站下载 0 关注 更新于 10 个月前

最新 1.5.8-JAN80235 · 1.21.11 · Bukkit / Paper

一键开服(送7天)

The Endex 1.5.8-JAN80235 | 动态市场与插件 [1.20.1 - 1.21.x]

为你的服务器带来生机勃勃的经济体系。价格随玩家供需波动,配备精美的市场图形界面、定时事件、可选的网页仪表盘、虚拟持仓系统以及插件框架。


The Endex 是一款动态经济插件,将真实的市场机制带入你的 Minecraft 服务器。价格根据玩家交易活动、全服物品存储量以及随机市场事件而波动。

? 版本 1.5.8-JAN80235 亮点:

  • ?️ 反作弊保护系统 — 四层防御防止无限刷钱漏洞!
  • ? 6% 买卖价差 — 产生摩擦成本,阻断有利可图的套利循环!
  • ⏱️ 60秒卖出冷却 — 防止购买后立即买入→卖出的快速倒卖!
  • ? 价格均值回归 — 被操纵的价格在闲置期间会漂移回基准价!
  • ? 配置自动更新 — 自动迁移旧配置同时保留你的设置!
  • ⚡ 零性能影响 — 所有保护机制均使用 <0.01% CPU 开销!

受保护的功能:

  • ✅ 低买高卖套利 — 无法通过低价买入高价卖出获取即时利润
  • ✅ 价格操纵 — 当停止操纵时,价格会自动修正
  • ✅ 即时倒卖 — 购买后必须等待 60 秒才能卖出
  • ✅ 你的经济系统 — 为所有玩家提供公平、平衡的游戏体验

上一版本 (1.5.8-JAN70109):

  • ? 商店编辑器修复 — 修复了 deleteCategory() 和 saveShopChanges() 无法正常工作的情况!
  • ? 语言文件 — 在韩国语、俄语、葡萄牙语和中文翻译中添加了商店编辑器的语言部分!
  • ? 权限修复 — 在 plugin.yml 中添加了缺失的商店编辑器和网页仪表盘权限!

更早的 1.5.8 功能:

  • 通货膨胀系统 — 新增可配置的通胀/通缩系统,支持按类别设定比率!
  • 市场物品管理器 — 新增编辑器按钮,可在一个地方查看/编辑所有市场物品!
  • 价格编辑器修复 — 修复了在市场中编辑原版物品价格的问题!
  • 管理员命令修复 — /market remove, disable, setbase, setmin, setmax 现在能正确持久化保存!

? 动态定价

价格对供需做出反应,具有可配置的灵敏度、EMA(指数移动平均)平滑处理以及每项物品的最低/最高价格上限。

? 全球存储扫描器

价格适应全服所有存储中的全局物品数量。物品充裕则价格下跌;物品稀缺则价格上涨。

? 虚拟持仓

以平均成本追踪购买物品到虚拟存储中,并显示盈亏。随时提取。

?️ 市场图形界面

美观的界面,包含分类、搜索、排序、快速买卖按钮以及实时价格图表。

? 截图

⚡ 市场事件

限时价格倍数事件(如矿石热潮、市场崩盘等),并伴有全服广播。

? 网页仪表盘

可选的 REST API,提供实时更新、图表、物品图标以及浏览器内的交易功能。

? 插件框架

可扩展的 API,用于自定义插件,支持命令路由和网页集成。

? 投递系统

当背包或持仓已满时提供溢出保护。随时领取物品。

? PlaceholderAPI 支持

30+ 个占位符,可用于记分板、全息图、标签页列表等。在任何位置显示价格、趋势、持仓、排行榜和市场统计信息。

? bStats 指标

匿名使用统计数据,以帮助改进该插件。


/endex help              - 显示帮助菜单
/endex version           - 显示插件版本

/market                  - 打开市场图形界面
/shop                    - /market 的别名
/m, /trade, /exchange    - 其他市场别名

/market buy <item> <amt> - 购买物品
/market sell <item> <amt>- 出售物品
/market price <item>     - 查看当前价格
/market top              - 查看交易量最高的物品

/market holdings         - 查看你的虚拟持仓
/market withdraw <item>  - 将物品提取到背包
/market withdraw all     - 提取所有物品
/market sellholdings <item> <amt> - 直接从持仓中出售物品

/market delivery list    - 查看待处理的投递
/market delivery claim   - 领取已投递的物品
/market delivery 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      - 清除所有事件(管理员)

# 命名空间命令同样有效:
/endex:shop, /endex:market, /endex:m

theendex.market      - 访问市场图形界面(默认:true)
theendex.buy         - 购买物品(默认:true)
theendex.sell        - 出售物品(默认:true)
theendex.holdings    - 访问持仓系统(默认:true)
theendex.withdraw    - 从持仓中提取(默认:true)
theendex.invest      - 使用投资功能(默认:true)
theendex.admin       - 管理员命令(默认:op)
endex.shop.editor    - 访问商店编辑器(默认:op)
endex.shop.admin     - 商店管理员命令(默认:op)
endex.web.trade      - 网页仪表盘交易(默认:true)
endex.web.admin      - 查看其他玩家的持仓(默认:op)

? 要求

  • 服务器: 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 综合持有量:

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.8-JAN70109 新增内容:

  • 商店编辑器 deleteCategory() 修复: 删除分类按钮现在正确调用 CustomShopManager.removeCategory(),而不是显示“即将推出”
  • 商店编辑器 saveShopChanges() 修复: 保存按钮现在正确调用 CustomShopManager.reload(),而不仅仅是播放声音
  • 语言文件: 在韩语、俄语、葡萄牙语和中文翻译中添加了商店编辑器语言部分(约 60 个键)
  • 权限修复: 在 plugin.yml 中添加了缺失的权限:endex.shop.editor, endex.shop.admin, endex.web.trade, endex.web.admin

1.5.8-JAN60132 新增内容:

  • 商店编辑器分类修复: 修复了商店编辑器中“创建分类”对话框无法响应点击的问题
  • 点击罗盘(过滤模式)或箱子(手动模式)图标现在会正确创建新分类
  • 添加了 CREATE_CATEGORY 状态跟踪和正确的点击处理流程
  • 分类现在立即持久保存到商店 YAML 配置文件中

1.5.7-dec1038 新增内容:

  • 波兰语支持:插件和文档的完整波兰语 (Polski) 翻译
  • 配置翻译自动提取:首次运行时,10 个语言配置文件会自动提取到 plugins/TheEndex/config_translations/
  • 优化默认配置:默认以最小资源使用设置发货
  • 世界存储扫描默认禁用(可轻松重新启用以获得全部功能)
  • 基于库存的定价默认禁用
  • 每次更新时保存默认禁用(减少磁盘 I/O)
  • 更新间隔增加到 120 秒(原为 60 秒)
  • 在 config.yml 顶部添加了显眼的优化指南

1.5.7-dec1022 新增内容:

  • Web 仪表板翻译:集成 Google Translate,支持 26 多种语言
  • GUI 错误修复:修复了在市场详情中鼠标中键点击物品时出现的 ArrayIndexOutOfBoundsException
  • 性能指标:配置选项现在显示 [PERF: LOW/MEDIUM/HIGH] 影响标签
  • 已翻译的配置:9 种语言的预翻译配置文件(中文、西班牙语、法语、德语、日语、韩语、葡萄牙语、俄语、阿拉伯语)
  • 市场 GUI:将详细信息库存大小从 27 增加到 36 格,以修复按钮放置问题

1.5.7 新增内容:

  • 从持有量出售:无需先撤回至库存,即可直接从虚拟持有量中出售物品
  • Arclight/混合服务器兼容性:修复了插件识别、SLF4J 日志记录、ServiceLoader 和可点击的聊天链接
  • 市场 GUI:物品详细信息现在显示“库存:X | 持有量:Y”,并带有新的出售按钮(第 33 和 35 格)
  • 自定义商店 GUI:当库存不足时,现在可以从持有量中出售原版物品
  • Web API:新增用于 Web 仪表板出售的 POST /api/sell-holdings 端点
  • 新命令:/market sellholdings <material> <amount>

1.5.6 新增内容:

  • Minecraft 1.20.1+ 兼容性:将 api-version 从 '1.21' 降低到 '1.20',以恢复对 1.20.1+ 服务器(如 Arclight 等)的支持
  • 游戏内布局编辑器:完整的可视化 GUI 编辑器,用于自定义商店布局——无需编辑配置!
  • 自定义物品支持:添加任何材质作为装饰,并带有个性化名称和描述
  • 5 种编辑器模式:放置分类、放置装饰、放置按钮、编辑槽位、移除槽位
  • 右键单击编辑:通过聊天提示自定义物品名称和描述
  • 实时预览:在保存之前即时查看更改
  • 一键保存:直接将布局保存到商店配置文件
  • 自定义分类图标:分类在 /market 中显示自定义名称/描述

1.5.5 新增内容:

  • 经济插件兼容性:修复了与延迟加载的经济插件(如 SimpleEconomy 等)一起使用时出现的“经济不可用”错误
  • 为经济提供者检测添加了延迟重试(2 秒)
  • 在 TheEndex 加载后注册的经济插件现在可以被正确检测到
  • 将常见的经济插件添加到 softdepend 列表中,以改善加载顺序

1.5.4 新增内容:

  • bStats 指标:带有自定义图表的插件分析(存储模式、商店模式、Web UI、持有量、物品数量)
  • 自定义商店增强:类别页面中的持有量按钮(第 45 格)和排序按钮(第 53 格)
  • 基于过滤器的分类:使用材质过滤器自动填充商店类别,而不是手动物品列表
  • 默认 GUI 改进:移除了数量按钮,排序移至第 49 格,布局更简洁
  • 修复:打开 GUI 时不再阻止快捷栏交互
  • 修复:排序顺序现在正确显示最高价格/变化在前(降序)
  • 修复:自定义商店中的持有量按钮现在正确打开持有量面板
  • 修复:/ex market 命令现在尊重 shop.mode 配置设置

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 的帮助下开发的。虽然经过全面测试,但仍可能出现潜在的错误或问题。请在 Discord 或 GitHub 上报告问题。

加入我们的 Discord!

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源