Craftorithm

### 更新内容 | Update Contents 1. 移除配置项 `use_experimental_recipe_ingredients`，新增配置项 `ingredient_match_mode`，用于选择配方材料的匹配方式：`first`（默认，使用第一个识别到的物品 id 匹配）或 `all`（收集物品所有可能的物品 id 后逐个尝试匹配，性能开销更高） | Removed the `use_experimental_recipe_ingredients` option and added the `ingredient_match_mode` option to choose how recipe ingredients are matched: `first` (default, matches using the first recognized item id) or `all` (collects all possible item ids of an item and tries them one by one, which costs more performance). 2. `not_convert_listener_classes` 支持以 `*` 结尾的条目按类名前缀匹配 | `not_convert_listener_classes` now supports entries ending with `*` for class-name prefix matching. 3. 连续发起的插件重载请求现在会进入队列依次执行，不再被直接丢弃 | Consecutive plugin reload requests are now queued and executed in order instead of being dropped. 4. 优化插件启动加载流程 | Optimized the plugin's startup loading flow. 5. 优化26.3版本下禁用较多酿造配方时，重载过程占用较多网络带宽的问题 | Reduced excessive network bandwidth usage during reload on 26.3 when a large number of brewing recipes are disabled. 6. 其他插件监听器转换成功的日志级别由 `verbose` 调整为 `info` | The log level for successfully converted third-party listeners has been changed from `verbose` to `info`. 7. 修复通过 `/craftorithm restore` 恢复的配方无法出现在命令补全列表中的问题 | Fixed recipes restored via `/craftorithm restore` not showing up in command tab completion. 8. 修复 `ingredient_restriction_rules` 中的物品 id 无法解析时导致整份限制规则重载中断的问题 | Fixed an issue where an unparseable item id in `ingredient_restriction_rules` aborted reloading of the entire rule list. 9. 修复迁移整型配置项时输出无意义警告的问题 | Fixed meaningless warnings when migrating integer config options.

### 更新内容 | Update Contents 1. 修复 [#148](https://github.com/YufiriaMazenta/Craftorithm/issues/148) | Fixed [#148](https://github.com/YufiriaMazenta/Craftorithm/issues/148)

### 更新内容 | Update Contents 1. 新增配置项`log_level`，用于控制插件输出日志的内容，允许`debug/verbose/info/warn/error/off`六种级别 | Added a new config option `log_level` to control the plugin's log output, supporting six levels: `debug/verbose/info/warn/error/off`. 2. **破坏性更新：重构Craftorithm提供的api，具体请看文档** | **BREAKING CHANGE: Refactored the API provided by Craftorithm. Please refer to the documentation for details.** 3. 优化插件代码结构 | Optimized the plugin's code structure.

### 更新内容 | Update Contents 1. **破坏性更新:** 重构插件权限结构，具体权限请查看[插件文档](https://yufiriamazenta.github.io/Craftorithm-Docs/guide/permissions) | **Breaking change:** Refactored the plugin's permission structure. For specific permissions, please refer to the [plugin documentation](https://yufiriamazenta.github.io/Craftorithm-Docs/en/guide/permissions). 2. 配方编辑器菜单新增删除配方按钮 | Added a delete recipe icon to the recipe editor menu. 3. 酿造配方展示菜单兼容服务器本身的酿造配方 | The brewing recipe display menu now supports the server's builtin brewing recipes. 4. 添加`recipe_load`类型触发器，在Craftorithm加载配方时触发，具有字段`recipe_key`，表示为本次加载的配方key | Added a `recipe_load` trigger type that fires when Craftorithm loads recipes, with a `recipe_key` field indicating the key of the recipe being loaded. 5. 添加`discover_recipe_all`和`undiscover_recipe_all`函数，用于给在线的全体玩家解锁配方 | Added `discover_recipe_all` and `undiscover_recipe_all` functions to unlock recipes for all online players. 6. 修复26.2及以上版本如果禁用了原版的工作台转换配方，会导致插件无法正常重载配方的问题 | Fixed an issue where, on versions 26.2 and above, disabling vanilla crafting table transmute recipes would prevent the plugin from reloading recipes properly.

### 更新内容 | Update Contents 1. spigot 26.3服务端现在也支持创建酿造配方 | Spigot 26.3 servers now also support creating brewing recipes. 2. 新增命令`/craftorithm item getgroupitem <tag>/<item_pack>`命令, 用于获取在配方相关菜单中使用的物品标签或物品包占位物品 | Added the command `/craftorithm item getgroupitem <tag>/<item_pack>`, used to obtain the placeholder item for an item tag or item pack used in recipe menus. 3. 新增设置配方在指定世界才能使用的功能 | Added the ability to make recipes usable only in specified worlds. 4. `/craftorithm item`命令下的子命令不再需要单独权限 | Subcommands under the `/craftorithm item` command no longer require separate permissions. 5. 修复酿造配方如果材料不能用于合成的情况下，不能正确拦截酿造的问题 | Fixed an issue where plugin could not correctly block brewing when the ingredients could not be used for crafting. 6. 修复铁砧配方的材料数量在菜单里表现异常的问题 | Fixed an issue where the material count of anvil recipes was displayed incorrectly in the menu. 7. 优化代码结构和性能 | Optimized code structure and performance.

### 更新内容 | Update Contents 1. 新增PostgreSQL支持 | Added PostgreSQL support. 2. 脚本函数`discover_recipe`和`undiscover_recipe`现在可以也使用正则表达式匹配配方 | The script functions `discover_recipe` and `undiscover_recipe` can now also use regular expressions to match recipes. 3. 新增脚本函数`recipe_discovered`，返回玩家是否解锁了某个配方 | Added a new script function `recipe_discovered`, which returns whether a player has unlocked a specific recipe. 4. 优化插件代码结构和性能 | Optimized plugin code structure and performance.

### 更新内容 | Update Contents 1. 优化插件在禁用时的资源释放策略 | Optimized the resource release strategy when the plugin is disabled.

### 破坏性更新 | Breaking Changes 1. 插件提供的 `ItemProvider` 接口发生了改变，因此为旧版本编写的物品源插件需要额外适配才能兼容此版本 | The `ItemProvider` interface provided by the plugin has changed, so item provider plugins written for older versions need extra adaptation to be compatible with this version 2. 物品组内不再能设置物品数量，所有数量都必须在配方文件中定义 | Item amounts can no longer be defined inside item packs; all amounts must be defined in the recipe files ### 常规更新 | Regular Changes 1. 兼容Minecraft 26.3 | Compatible with Minecraft 26.3 2. 铁砧配方材料使用物品组时现在支持指定数量，例如 `item_pack:物品组名 4` | Item pack ingredients in anvil recipes now support specifying an amount, e.g. `item_pack:pack_name 4` 3. 新增插件重载与服务器启动完成后从数据库恢复在线玩家已解锁配方的功能 | Added restoring online players' discovered recipes from the database after plugin reload and server startup 4. 修复玩家在配方未注册完毕时加入服务器会导致已经解锁的配方被取消解锁的问题 | Fixed an issue where joining the server before recipe registration completed would cause already unlocked recipes to be locked again 5. 修复重载期间合成限制规则会短暂失效，导致本应被拦截的合成得以进行的问题 | Fixed an issue where ingredient restriction rules briefly stopped working during reload, allowing crafting that should have been blocked 6. 修复 `item_packs.yml` 中使用 `tag:` 或嵌套引用其他物品组（`item_pack:组名`）的条目无法解析的问题 | Fixed item pack entries in `item_packs.yml` using `tag:` or nested item pack references (`item_pack:pack_name`) failing to parse 7. 修复 `/craftorithm item fuel add` 在手持多个物品时会向 `custom_fuels.yml` 写入带数量的无效配置键的问题，历史无效键需手动清理 | Fixed `/craftorithm item fuel add` writing invalid config keys containing amounts to `custom_fuels.yml` when holding a stack; existing invalid keys need to be removed manually 8. 修复数据库连接池的连接数上限、心跳启动时机与空闲连接驱逐逻辑，以及 DAO 语句与结果集未关闭导致的资源泄漏 | Fixed database connection pool connection limits, heartbeat startup timing and idle connection eviction, as well as resource leaks from unclosed DAO statements and result sets 9. 修复特定情况下保存物品时出现并发修改异常的问题 | Fixed a ConcurrentModificationException when saving items under certain conditions 10. 修复假结果预览功能在特定时序下可能报空指针的问题 | Fixed a NullPointerException in the fake result preview feature under certain timing 11. 修复自定义菜单加载失败时打开回调会被执行两次的问题 | Fixed the open callback of custom menus being invoked twice when menu loading fails 12. 修复重载时触发器数据在异步线程与主线程之间存在的并发问题 | Fixed a concurrency issue with trigger data between the async reload thread and the main thread 13. 优化内部代码结构，清理无引用代码 | Optimized internal code structure and removed unreferenced code

### 更新内容 | Update Contents 1. 新增基于数据库的跨服配方解锁数据同步功能 | Added database-based cross-server recipe unlock data synchronization functionality. 2. 修复铁砧配方在没有铁砧类型触发器情况下无法合成的问题 | Fixed an issue where anvil recipes could not be crafted without an anvil-type trigger

### 更新内容 | Update Contents 1. 修复在插件重载时, 如果被禁用的配方数量非常多, 可能会导致服务器网络带宽被瞬间占满的问题 | Fixed an issue where a large number of disabled recipes could instantly saturate the server's network bandwidth during plugin reload