原创 经济 [1.16-26.2|支持Folia]BlackMarket —— 动态市场|跳蚤市场|以物换物|全懒人GUI配置|高度可自定义|支持模组物品 1.1.0-Preview

Add
- 商品类型由两种扩展为四种：普通（可购买可出售）、仅售出、隐藏（仅可出售且不展示）、归档（不可购买不可出售且不展示）。
- 商品新增两项属性：单格堆叠上限、单次购买上限（0 表示跟随全局）。
- 一键出售新增黑白名单过滤：支持按分类（含子分类）、按关键词多来源组合匹配、大小写开关，并可切换黑/白名单模式。
- 物品编辑器新增三个编辑项：堆叠上限、单次购买上限、商品类型（循环切换）。
- 适配 1.20.5+ 的物品堆叠上限数据组件，并在不支持的服务端提供降级实现。
- 管理员面板新增会话与筛选状态保持：切换界面后自动恢复此前的搜索与筛选。
- 跳蚤市场新增多货币比价（与市场价对比，含汇率折算），数据不足时给出「暂无」提示。
- Web 端商品数据新增堆叠上限与单次购买上限字段（含后端校验与前端展示）。
- 对外 API 的商品比价信息新增「是否可比价」标识。
- 新增返回上级入口。
- 新增若干提示文案（堆叠上限、单次购买上限、商品类型切换、一键出售排除、商品启动重试等，中英双语）。

Fix
- 修复服务器启动阶段因外部物品数据（如 CraftEngine 等）尚未就绪而解析失败的商品丢失问题：服务器完全启动后自动重试并恢复。
- 修复物品堆叠数据异常：物品编辑器可设置单格堆叠上限（0=自动，1–127），并拦截越界输入。
- 修复多货币改造后历史挂单上架金额不准确：按多货币选项与汇率重算旧挂单。
- 修复「一键出售」误回收重要物品：新增黑白名单过滤，命中规则的物品不再参与批量出售。
- 修复白名单模式漏配导致一键出售完全不可用：规则为空时不排除任何物品。
- 修复批量发放物品超出堆叠上限导致丢失：按堆叠上限拆分发放。
- 修复发放时背包已满却无任何提示：新增物品掉落提示。
- 修复一键出售全部被排除时无反馈：新增提示。
- 修复跳蚤市场比价数据缺失时的异常：改为显示「暂无」。
- 修复历史商品类型配置兼容：旧的「仅售出」标识仍可被正确识别。

Remove
- 移除旧商品类型「仅售出」的旧标识，命令参数与帮助文案统一改用新类型体系。

Change
- 商品类型体系调整：由「普通 / 仅售出」两种，改为「普通 / 仅售出 / 隐藏 / 归档」四种；相关命令参数与帮助文案同步更新。
- 配置文件版本升级并自动迁移（迁移前自动备份、失败回滚）：新增一键出售黑白名单节点、物品编辑器新增编辑项、新增各类提示文案。
- 「一键出售」行为调整：被排除的物品仍显示在界面、仍可单件出售，仅不参与「一键出售全部」；与既有的「完全不出现在界面」规则语义明确区分。
- 单次购买上限优先级：商品自身设置优先于全局设置。
- 堆叠上限语义：0 表示自动使用物品默认堆叠。

Improve
- 启动健壮性：商品解析失败自动重试，提升依赖外部物品数据场景的可用性。
- 发放健壮性：按堆叠上限拆分发放，并在背包满时提示掉落。
- 跨服务端版本兼容性：物品名称解析与堆叠上限适配均增加版本分支与降级。
- 一键出售安全性：多维度规则组合，有效防止重要物品被误批量回收。
- 管理操作效率：面板筛选/搜索状态跨界面保持。
- 配置迁移可靠性：覆盖本次全部新增配置项，支持从任意旧版本增量升级。
- 错误反馈清晰度：多处静默失败改为明确提示。
- Web 前端版本更新，并展示商品新增属性。

BlackMarket 1.0.4 → 1.0.5 更新日志

Fix - 修复待领取物品在并发领取或同一毫秒多条记录时可能被重复发放的问题，背包满时只掉落放不下的部分
Fix - 修复搜索时空关键词会匹配出全部商品的问题
Fix - 修复按物品ID搜索时符号干扰匹配、含数字物品名拼音首字母匹配异常的问题
Fix - 修复删除/买空某一页最后一条商品后停留在空白页的问题（自动回退到上一页）
Fix - 修复跳蚤市场卖家离线且无法发放离线收益时，购买仍成功导致卖家收益丢失的问题（现会拦截并提示）
Fix - 修复取消/删除跳蚤市场上架时，卖家离线物品静默丢失的问题（现自动转入待领取）
Fix - 修复背包满时物品整叠重复发放的问题
Fix - 修复并发购买/取消上架导致物品或资金重复发放的问题
Fix - 修复市场价格未知时低价上架被错误卡住的问题
Fix - 修复跳蚤市场功能关闭时会清空挂单数据的问题
Fix - 修复卖家收益（含离线收益）未按挂单实际支付货币发放的问题（此前固定发放默认货币）
Fix - 修复以物换物旧数据中非法/失效物品材质导致加载崩溃的问题
Fix - 修复对同一商品重设更长折扣时旧到期任务误删新折扣的问题
Fix - 修复跨午夜定时活动（如 22:00-02:00）无法生效的问题
Fix - 修复服务器异常关闭后重启遗留活动实体未清理的问题
Fix - 修复神秘商人刷新价格区间可能出现负区间导致商品归入错误区间的问题
Fix - 修复每日补货日志显示错误数值的问题
Fix - 修复价格历史趋势图周期计算错误的问题
Fix - 修复热重载后部分配置缺失键返回空值的问题（现正确回退默认值）
Fix - 修复配置迁移整段覆盖导致新增默认键丢失的问题（改为仅恢复叶子键，保护自定义值）
Fix - 修复配置迁移保存失败后下次启动跳过迁移导致数据丢失的问题（现自动回滚备份）
Fix - 修复日志解析/清理失败时无提示的问题
Fix - 修复声望未启用时仍生成空数据文件的问题

Change - 货币配置从 config.yml 迁移至独立的 currency_settings.yml，旧配置启动时自动迁移
Change - /bm discount 命令语法调整为：set <物品ID|all|*> <折扣率> [时长秒] [叠加声望折扣]
Change - 折扣默认时长改为可在配置中自定义（原固定 1 小时）
Change - 折扣消息改为显示「优惠 X% off」，时长统一以秒显示
Change - 快捷出售支持统一结算货币，可将所有商品收益按汇率折算为指定货币发放；未配置汇率时退回商品原货币
Change - 非默认货币商品现可正常出售（1.0.4 中会被直接跳过）
Change - 声望系统：各等级可单独配置每日获取上限（-1 为无限制）；声望购买折扣、出售加成与活动折扣的叠加模式可配置（乘法/加法/取最高/互斥）
Change - 自动削减库存默认触发阈值由 200% 调整为 80%
Change - 交易日志格式新增 {currency} 占位符，默认日志将记录交易货币
Change - 价格趋势图改用更平滑的显示字符，并换行显示首末价与涨跌幅，相关文案支持本地化
Change - 固定税费在交易货币为非默认货币时按汇率折算到交易货币计价
Change - 移除打开/关闭界面时的音效

New - 新增 Web 管理界面：通过浏览器管理黑市（商品/库存/价格编辑、跳蚤市场与以物换物管理、货币与汇率管理、价格统计与图表、冻结与安全、交易日志浏览与CSV导出）；支持访问Token、会话超时、可选SSL、访问日志，默认关闭
New - 新增多货币标价：商品与跳蚤市场上架可设置多种货币价格，买家可用其中任意一种货币全额支付
New - 新增组合支付：买家可组合多种货币付款，支持汇率换算、实时余额校验与超付上限
New - 新增汇率管理：管理员可在界面中设置/移除货币间兑换汇率
New - 新增货币管理：管理员可重命名、启用/禁用、新增/删除物品货币，并可修改货币图标
New - 新增别名系统：/bm alias 命令可为商品设置/移除搜索别名，别名可替代商品ID使用
New - 新增别名自动导入：支持从物品自定义名称、CraftEngine 物品名、Forge 模组物品名自动生成别名（可配置覆盖策略与日志）
New - 新增权限：绕过税费、冻结/解冻账户、查看声望
New - 新增权限组税率倍数配置
New - 新增对 Folia 服务器的支持
New - 搜索界面尺寸可在配置中调整，按钮支持关闭界面/执行命令等新动作
New - 快捷出售与批量出售收益按货币分组显示，出售结果界面总收入摘要槽位可配置
New - 神秘商人出现公告附带优惠百分比
New - 每日流水统计支持按货币分组

Improve - 待领取物品数据加载更健壮，损坏数据不再导致功能异常
Improve - 声望数据改为延迟异步保存，减少卡顿
Improve - 商店、搜索、快捷出售、以物换物等界面优先显示商品别名
Improve - 管理员直接调整声望时同步触发等级提升通知
Improve - 配置迁移保留用户自定义值（增量迁移，仅合并缺失键）
Improve - 各音效类型支持独立配置音量与音调
Improve - 新增价格统计能力（当前价、24小时/7天涨跌、最高/最低/均价、变动原因分布），供 Web 界面使用

Remove - 移除打开/关闭界面的音效及其配置
Remove - 移除部分细粒度权限节点：商店购买、跳蚤市场上架、跳蚤市场购买、物品信息查看等独立权限（访问控制由现有主权限统一管理）

几乎重构了60%+的代码
关于配置文件虽然有自动迁移 但建议手动迁移配置项
兼容了CraftEngine的自定义物品

黑市 BlackMarket V1.0.1 更新日志
Fix - 即使关闭交易限额或对玩家组进行上限修定，仍然会触发交易限额机制
Fix - 修复了部分许可证阻断失效的问题
Fix&Remaster/New - 修复/重置/添加了Message.yml中的消息键，修复了部分gui内容提示未找到的问题
Remaster - 在gui.yml重置了MainShopGUI的默认布局
Remaster - 重置了以物换物的gui布局以及使用方式
Remaster&New - 在AdminGUI重置了部分gui的布局，并添加了新的多选逻辑
New&Remaster - 完善了神秘商人的所有功能，重做了部分逻辑
New - 添加了bStats支持

WaterBlackMarket

View statistics for WaterBlackMarket by harry_h2o on Bukkit / Spigot.

bstats.org

欢迎大家进行测试，有Bug请及时进群反馈！