加入我们的 Discord！
# The Endex | 动态市场 & 插件 [1.20.1 - 1.21.8]
为您的服务器带来一个生动的经济体系。价格根据玩家供需波动，并拥有美观的市场 GUI、定时事件、可选的网络仪表盘以及插件框架。
## 新增功能于 1.2.0
- 可定制的网络 UI 覆盖 (`web.custom.*`)：导出和编辑 `index.html` 和静态资源。
- 统一的单页市场视图，具有高级过滤器（类别、趋势、价格范围、排序、可折叠面板）。
- 移除旧的插件选项卡（插件内容可以作为物品或通过自定义路由显示）。
- 实时更新和布局的稳定性和性能改进。
- 保留了 1.1.x 版本的功能：资源包图标、合并持有量、对库存情况敏感的定价。
### 动态定价
价格根据供需波动，并带有钳制和滚动历史记录。可选的对库存情况敏感的定价可以温和地适应玩家在线库存的数量（基线和上限可配置）。
### 市场 GUI
分页库存，具有排序、过滤器、搜索和详情视图。显示上个周期的供需情况和预计影响；在更新时自动刷新。
### 事件 & 冲击
可堆叠的乘数，带有广播和跨重启的持久性。
### 插件框架
即插即用的插件，具有自动命令路由、别名和标签补全。
### 网络仪表盘 (可选)
REST API，实时更新 (WS/SSE)，图表，来自你的资源包的真实物品图标（带有缓存），以及显示投资 (DB) 和库存 (实时库存) 并带有徽章的合并持有量。
## 概览
The Endex 为您的服务器引入了动态的、以需求为驱动的市场。价格通过供需和（可选）玩家的在线库存来反映玩家行为。打磨过的 GUI 和强大的命令集使交易变得简单而有趣。管理员可以通过可配置的参数、市场事件、黑名单和安全重新加载来保留完全控制权。数据可以存储在 YAML 或 SQLite 中，具有自动迁移和版本配置。
## 主要功能
- 由供需驱动的动态定价，带有钳制和滚动历史记录；可选的对库存情况敏感的定价。
- 全功能的市场 GUI：分页、排序、类别过滤器、文本搜索和详情视图。
- Vault 经济集成，具有可配置的交易税。
- 市场事件和冲击：可堆叠的乘数，具有可配置的上限；广播和跨重启的持久性。
- 投资：使用简单的命令购买、列出和兑换所有累积价值。
- 存储灵活性：默认情况下为 YAML 或 SQLite；启用 SQLite 时自动从 YAML 迁移。
- 玩家偏好：跨会话记住数量、排序、类别、搜索和最后一页。
- 历史洞察：在聊天/GUI 中显示 ASCII 趋势 sparkline 和用于分析的 CSV 历史导出。
- 管理工具：安全重新加载、事件控制、黑名单、CSV 导出和版本报告。
- 插件框架：具有自动命令路由、别名和标签补全的即插即用 jar。
- 加密插件 (可选)：YAML 驱动的商店、每个物品的权限、具有均值回归的固定/市场定价、`/endex crypto info`。
- 资源跟踪：跟踪收集的材料（方块破坏、怪物掉落、钓鱼），定期持久化和 `/endex track dump`。
- 网络仪表盘 (可选)：WS/SSE 实时更新，来自你的资源包的真实物品图标，以及显示投资 (DB) 加上库存 (实时库存) 并带有徽章的合并持有量。
- 可定制的网络 UI 覆盖：通过 `web.custom.*` 启用 `index.html` & 静态资源的系统文件覆盖，带有导出和重新加载管理命令；统一的单页市场（移除了旧的插件选项卡）。
## 游戏机制
- 定期价格更新使用基于敏感度的公式，反映最近的供需情况；可选的库存压力将平均每个玩家的库存与可配置的基线进行比较。
- 价格钳制在每件物品的最小和最大值之间；每个周期重置供需。
- 黑名单中的物品被排除在交易和显示之外。
- 事件将临时乘数应用于有效买/卖价格（显示和交易），并且可以堆叠到定义的上限。
## 图形界面
- 分页的 54 槽库存视图，带有快速数量选择器 (1/8/16/32/64)。
- 左键单击购买，右键单击出售；Shift/中键单击打开一个丰富的详情面板。
- 按名称、价格和变化进行排序；类别过滤器和文本搜索。
- 每个玩家的偏好持久保存；交易后界面自动刷新。
## 命令
```
/endex help
/endex version
/market
/market buy -
/market sell -
/market price -
/market top
/market invest buy
-
/market invest list
/market invest redeem-all
/market event list
/market event
/market event end
/market event clear
```
## 权限
- theendex.market — 默认：true
- theendex.buy — 默认：true
- theendex.sell — 默认：true
- theendex.invest — 默认：true
- theendex.admin — 默认：op
- 加密插件: `theendex.crypto.*` (info, balance, buy, sell, transfer, shop, admin)
## 配置重点
- 版本配置，在启动和重新加载时自动迁移。
- 可调整的价格更新间隔、灵敏度、历史长度和自动保存频率。
- 交易税、物品黑名单、类别设置和事件乘数上限。
- 存储选择（YAML 或 SQLite）带有路径配置和自动播种。
- 对库存情况敏感的定价：
```yaml
price-inventory:
enabled: true
sensitivity: 0.02
per-player-baseline: 64
max-impact-percent: 10.0
```
- 网络合并持有量 & 角色：
```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
```
## 兼容性
- 服务器：Paper/Spigot 1.20.1 到最新（基于 API 1.20.1 构建）。
- Java 17 运行时。
- 经济：Vault (软依赖)。
## 数据 & 可靠性
- 默认情况下在插件文件夹中存储 YAML；可选的 SQLite 数据库。
- 定期备份和有序保存可防止数据丢失。
- 安全重新加载重新初始化管理器、重新加载配置/事件和重新安排任务。
## 支持
如有疑问、反馈或问题报告，请使用资源讨论，并附上`/endex version`的输出以及任何相关日志。