🧩插件 zAuctionHouse 4.0.0.9

• 修复了销售历史中日志ID警告中“找不到物品”的垃圾信息。从V3迁移的日志创建时item_id = 0（因为与V4项目无直接对应），导致每个条目都显示警告。此类记录现在在SQL层面被过滤掉。
• 新增了历史设置config.yml：
  • history.max条目 - 限制每位玩家显示的历史条目数量（默认：500条，0条 - 无限）。
  • history.expire-after-days - 隐藏超过指定天数的条目（默认：0 - 未过期）。
  • 对于拥有大量事务的服务器来说，它有助于减轻数据库负载并加快历史记录的加载速度。
• 为管理员增加了日志管理命令：
  • /AH 管理员日志会清除 <days> — 删除所有超过指定天数的日志。
  • /ah 管理员会记录玩家<player>——删除特定玩家的所有日志。
  • /ah 管理员日志清除迁移——删除所有从 V3 迁移的日志（item_id = 0）。
  • 所有操作均异步执行，并报告已删除记录的数量。
• 修复了/ah中多服务器（Redis）构建中出售的“幽灵”物品。此前，如果玩家在服务器No1删除物品并前往服务器No2，该物品可以保持“已购买”状态并锁定销售槽位。已经进行了三项修正：
  • ItemRemovedListener 现在在收到消息后立即从内存中移除该项，无需等待对数据库的异步请求。
  • 如果本地删除已经完成，RemoveService将不再通过Redis恢复项目状态。
  • getPlayerSellingItems 现在会进一步过滤状态为 DELETED 的物品。
• 更改了Discord的webhook %expires_at%占位符，改用动态Discord时间戳（<t：unix_seconds：f>）代替预先格式化的日期。Discord会自动显示每个用户当地时区的日期。没有保质期的商品仍会使用正常的日期。
• 新增了对Discord webhook自定义物品图片的支持：
  • 该discord.yml新增了一个自定义图片板块。
  • 你可以针对特定物品覆盖 %item_image_url%。
  • 支持与categories.yml/rules.yml格式相同的规则：材料、名称、背景、自定义模型数据、Oraxen、Itemsadder、Nexo、mmoitems等。
  • 使用第一匹配规则。
  • 如果没有匹配，则根据物体的材料使用标准图像。
  • 图像颜色现在通过URL缓存，因此相同材质的不同自定义项目不再冲突。

点击展开...

• 新增了对类别的禁令支持——允许即使特定物品符合纳入规则，也可以排除类别中的某些物品。例如，下界合金锄通常会出现在“工具”类别中，但如果它有特定的自定义模型数据（例如300），可以通过禁用规则排除。使用与常规规则相同的规则类型（材料、标签、背景、自定义模型数据等）。
• 新增内容广播系统——当物品上架或购买时，向所有在线玩家发送消息。可根据事件类型（卖/买）配置，并有排除卖家/买家的选项。支持使用MiniMessage格式的按类别覆盖消息，使用%seller%、%buyer%、%items%、%price%、%category%占位符。默认禁用，广播时config.yml启用
• 新增内容玩家选项系统——由数据库支持的可扩展的每位玩家偏好系统。玩家可以通过 /ah 选项（打开 GUI）或 /ah 选项<option_name>[value]（命令切换）来切换选项。选项缓存在内存中，只有在与默认值不同时才存储在数据库中。目前支持broadcast_sell和broadcast_purchase选择退出广播消息
• 新增内容选项库存（/ah option）——27槽图形界面，每个广播选项都有切换按钮，显示当前状态（启用/禁用）
• 新增内容管理员选项命令 - /ah admin option 设置 <player> <option> <value> 用于设置玩家选项，/ah 管理员选项列表 <player> 查看玩家选项，/ah admin option reset <player> 将所有选项重置为默认
• 新增 %zauctionhouse_option_<option_name>% 占位API占位符——返回玩家选项值的真/假（例如，%zauctionhouse_option_broadcast_sell%）

点击展开...

• 新增了“拍卖行领取”按钮：该按钮能够以动态占位符的形式显示各经济体中尚未领取的款项，玩家可以直接在拍卖界面进行领取操作。
• 新增了可配置的加载项，该加载项会在获取资金数据的过程中显示出来。
• 新增了“不显示小数”的价格格式——该格式下，价格将不显示小数部分（例如：10000.50会显示为10000）。
• 新增了 %price-price-without-decimal%占位符——用于显示商品描述中不带小数的价格。
• 已添加：现在可以从控制台执行“ah admin forceopen”命令了。
• 新增了时区配置选项——用户可以自行指定所有日期占位符（%date%、%formatted-expire-date%、%expires_at%）所使用的时区。该功能支持所有的Java时区标识符，例如Europe/Paris、America/New_York、UTC等。默认情况下，系统会使用服务器的默认时区。
• 已修复：/ah管理员界面中的“历史记录”选项不再会加载所有离线玩家的信息，从而避免了玩家众多的服务器出现延迟现象。
• 已修复在Folia/Canvas模式下，updateListedItems功能出现崩溃的问题。原来，与库存管理相关的操作是在异步线程中执行的，而不是在主线程中处理。
• 已修复“sell”命令中与经济系统相关的参数配置问题。之前，当该参数的索引未进行配置时，系统会忽略默认值，从而导致经济系统名称为空。

• 新增内容ZAUCTIONHOUSE_CLAIM按钮——显示每个经济体的待处理资金，带有动态占位符，允许玩家直接从拍卖图形界面领取
• 新增内容可配置的领取按钮加载物品，显示在获取待处理资金数据时
• 新增内容PRICE_WITHOUT_DECIMAL 价格格式——显示不含小数位的价格（例如，10000.50 - > 10000）
• 添加 %price-price-但无小数%占位符——在物品背景中显示无小数点的价格
• 新增了 /ah 管理员强制开放，现在可以在控制台执行
• 新增时区配置选项——允许更改所有日期占位符的时区（%date%、%formatted-expire-date%、%expires_at%）。支持所有 Java 时区 ID（例如，欧洲/巴黎，美国/New_York，UTC）。默认设置为自动（服务器时区）
• 修复了/ah管理员打开和/ah管理员历史标签的完成功能，不再加载所有离线玩家，避免了多人服务器的延迟
• 修复了 Folia/Canvas 上 updateListedItems 崩溃的问题——库存持有者的访问运行在异步线程上，而不是主 tick 线程
• 卖出命令的固定经济名称参数配置——当经济参数索引未配置时，默认值被忽略，导致经济名称为空

• 新增内容ZelAuction 迁移 - 使用 /ah admin migrate zelauction confirm 从 ZelAuction 插件迁移数据到 zAuctionHouse V4
• 新增内容搜索系统——玩家可以直接通过拍卖行的图形界面或/ah搜索<查询）按名称、材料、背景故事或卖家搜索物品>
• 新增内容ZAUCTIONHOUSE_SEARCH 按钮 - 打开基于聊天的搜索输入，支持高级过滤操作符
• 新增内容ZAUCTIONHOUSE_CLEAR_SEARCH按钮——清除活跃搜索筛选，仅在搜索处于激活状态时显示
• 新增了 /ah 搜索<query>命令——无需先打开 GUI 即可直接从聊天中搜索项目
• 新增内容带有运算符的高级搜索筛选器：~（包含）、=（精确）、~=（包含，忽略大小写）、==（精确，忽略大小写）
• 新增内容可搜索字段：姓名、材料、背景故事、卖家（例如，卖家=缺口，姓名~钻石）
• 新增 /ah 管理员强制打开<player> <inventory> [page] - 在特定页面为玩家打开任意库存。支持所有库存名称（例如拍卖、管理员销售物品、历史记录、管理员日志等），并支持标签页完成。页面默认为1
• 新增了重置搜索搜索配置选项——启用（默认：true）时，每次玩家打开拍卖行时搜索过滤器都会清除，符合现有的重置类别开机行为

• 修复：当找不到玩家时显示的提示信息的修改
• 修复：更新至最新的zMenu及Sarah版本

• 固定宣称占位符，他可以断开某些玩家的连接
• 固定广播消息
• 固定的ZSellButton