ВЕРСИИ (88)

### 更新内容 | 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

### 更新内容 | Update Contents 1. 修复`crafting`触发器无法作用于合成器的问题 | Fixed a bug where `crafting` type triggers did not work on the crafter 2. 修复在`crafting`, `smithing`和`anvil`类型触发器的conditions里执行close动作关闭容器会吞掉物品的问题 | Fixed a bug where executing the close action in the conditions of `crafting`, `smithing`, and `anvil` triggers would cause the crafting ingredients to disappear 3. 触发器的enabled配置键更名为enable(保留对旧版enabled的兼容) | Renamed the `enabled` config key in triggers to `enable` (with backward compatibility for the old `enabled` key).

### 更新内容 | Update Contents 1. 修复MMOItems物品无法在异步线程加载的问题 | Fixed the issue where MMOItems items could not be loaded in asynchronous threads. 2. 优化配方创建和编辑页面配方加载流程 | Optimized the recipe loading process in the recipe creator and editor

### 更新内容 | Update Contents 1. 优化插件重载代码，通过多线程并行加载的方式降低性能占用 | Optimized plugin reload by using multi-threaded parallel loading to reduce performance overhead 2. 新增命令`/craftorithm restore <recipe_id>`，用于恢复被禁用的配方 | Added command `/craftorithm restore <recipe_id>` to re-enable disabled recipes 3. 新增配置项`ingredient_use_set_threshold`，用于配置配方材料的匹配方式 | Added config option `ingredient_use_set_threshold` to configure recipe ingredient matching behavior 4. 优化重载提示消息 | Optimized reload notification messages 5. 优化插件代码结构 | Optimized plugin code structure 6. 优化配方材料匹配性能 | Optimized recipe ingredient matching performance 7. 优化无序配方性能表现 | Optimized shapeless recipe performance 8. 优化触发器性能表现 | Optimized trigger performance 9. 修复被禁用的配方在reload后无法恢复的问题 | Fixed disabled recipes not being restored after reload

**注意，从旧版本升级到此版本建议删除`menus/internal/display`文件夹让其重新生成** **Note: If upgrading from a previous version, please delete the `menus/internal/display` folder to let it regenerate** ### 更新内容 | Update Contents 1. 结果处理器现在允许第三方插件注册新的操作类型 | Result processors now allow other plugins to register new action types 2. Craftorithm物品源现在也可以在`item_plugin_hook_priority`配置项里配置优先级 | Craftorithm item sources can now also have priority configured via the `item_plugin_hook_priority` config option 3. 修复切石机配方在插件自带的查看页面材料显示错误的问题 | Fixed an issue where stonecutter recipe ingredient were displayed incorrectly in the recipe display menu 4. 修复熔炉、烟熏炉、营火、锻造转化配方展示页面的错误文本 | Fixed incorrect text on the display menus for furnace, smoker, campfire, and smithing transform recipes

### 更新内容 | Update Contents 1. 修复1.13.5.1版本插件在Folia端无法启动的问题 | Fixed an issue where the plugin failed to enable on Folia servers in version 1.13.5.1 2. 修复结果处理器对于`display_name`, `item_name`和`lore`的add操作不能解析颜色代码的问题 | Fixed an issue where the result processor could not parse style codes for the add operation on `display_name`, `item_name`, and `lore` 3. 现在`lore`、`display_name`和`item_name`类型的结果处理器支持在add时解析PlaceholderAPI变量 | Result processors of type `lore`, `display_name`, and `item_name` now support parsing PlaceholderAPI variables during add operations

**此版本没有任何新增特性，只是对插件的整体性能表现进行了大幅度优化** **This version does not introduce any new features; it is solely focused on significantly optimizing the plugin's overall performance** ### 更新内容 | Update Contents 1. 优化ItemManager匹配物品id的性能 | Optimized the performance of ItemManager when matching item id. 2. 优化CraftorithmItemProvider匹配物品id的性能 | Optimized the performance of CraftorithmItemProvider in matching item id 3. 优化触发器冷却的内存消耗 | Optimized memory consumption of trigger cooldowns 4. 优化NamespacedItemId.toString性能开销 | Optimized the performance overhead of NamespacedItemId.toString() 5. 优化配方加载性能 | Optimized recipe loading performance 6. 优化UI创建、编辑配方性能开销 | Optimized performance overhead of UI recipe creation and editing 7. 修复一些可能导致内存泄漏的问题 | Fixed some issues that could cause memory leaks

### 更新内容 | Update Contents 1. `blocked_crafting_lore_rules`配置项由`ingredient_restriction_rules`替代，用于配置规则拦截物品用于合成 | The `blocked_crafting_lore_rules` config option has been replaced by `ingredient_restriction_rules`, which is used to configure rules that block items from being used in crafting ( @YufiriaMazenta ) 2. 修复[#142](https://github.com/YufiriaMazenta/Craftorithm/issues/142) | Fixed [#142](https://github.com/YufiriaMazenta/Craftorithm/issues/142) ( @YufiriaMazenta )

### 更新内容 | Update Contents 1. 新增`prepare_grindstone`和`trade_select`类型的触发器 | Added `prepare_grindstone` and `trade_select` trigger types 2. 脚本系统新增函数`match_item_id`，用于识别物品的id | Added `match_item_id` function to the script system for identifying item id 3. 脚本系统新增全局变量`server`、`recipe_manager`、`item_manager`，可在触发器、script命令、UI中使用 | Added global variables `server` `recipe_manager` ` item_manager` to the script system, which can now be used in triggers, the script command, and menus 4. 现在script子命令返回使用的纳秒数而不是毫秒数 | The script subcommand now returns the time taken in nanoseconds instead of milliseconds 5. 新增CustomFishing物品源适配（[#138](https://github.com/YufiriaMazenta/Craftorithm/pull/138)） | Added CustomFishing item source adapter ([#138](https://github.com/YufiriaMazenta/Craftorithm/pull/138)) 6. 适配EmakiItem 2.7.0版本 | Added support for EmakiItem 2.7.0 7. 修复[#136](https://github.com/YufiriaMazenta/Craftorithm/issues/136) | Fixed [#136](https://github.com/YufiriaMazenta/Craftorithm/issues/136) 8. 修复[#139](https://github.com/YufiriaMazenta/Craftorithm/issues/139) | Fixed [#139](https://github.com/YufiriaMazenta/Craftorithm/issues/139)

### 更新内容 | Update Contents 1. 现在切石机配方也可以使用结果处理器（仅paper及其衍生端） | Now stonecutter recipes can also use result processors(Paper and its forks only). 2. 结果处理器新增支持一个组件类型里定义多个处理器 | Result processors now support defining multiple processors within one component type. 3. 修复属性的结果处理器不支持1.20-1.20.4的问题 | Fixed an issue where the attribute result processor did not support versions 1.20 to 1.20.4. 4. 修复服务器重载、启用、禁用数据包时会导致插件配方失效的问题（仅paper及其衍生端） | Fixed an issue where reloading, enabling, or disabling datapacks would cause plugin recipes to become invalid(Paper and its forks only). 5. 修复create命令和配方创建菜单无法使用/符号作为配方名字的bug | Fixed a bug where the create command and the recipe creation menu could not use the '/' symbol as a recipe name.

### 更新内容 | Update Contents 1. 现在物品组可以导入tag或其他物品组的物品 | Now item pack can import items from tags or other item packs 2. 修复[#135](https://github.com/YufiriaMazenta/Craftorithm/issues/135) | Fixed [#135](https://github.com/YufiriaMazenta/Craftorithm/issues/135) 3. 将配方书UI的配置文件目录从`menus/internal/recipeBook`修改为`menus/internal/recipe_book` | Change the configuration file directory for the recipe book UI from `menus/internal/recipeBook` to `menus/internal/recipe_book`

### 更新内容 | Update Contents 1. 新增配方结果后处理器(result_processor)功能，用于合成时为配方结果增加额外效果 | Added a result processor feature to add additional effects to the recipe output during crafting. 2. 所有类型的触发器的上下文中新增event对象，用于操作相关事件行为 | Added an `event` object to the context of all trigger types, allowing manipulation of related event behaviors. 3. 新增命令`/craftorithm discover <target> <recipe_key_pattern>`和`/craftorithm undiscover <target> <recipe_key_pattern>`，分别用于为玩家解锁、取消在配方书内解锁配方，其中`<recipe_key_pattern>`支持正则表达式 | Added commands `/craftorithm discover <target> <recipe_key_pattern>` and `/craftorithm undiscover <target> <recipe_key_pattern>`, which respectively unlock and lock recipes in the recipe book for players. The `<recipe_key_pattern>` supports regex. 4. 修复触发器中`sound`函数在遇到无法解析的声音时会报错的问题 | Fixed an issue where the `sound` function in triggers would throw an error when encountering an unparseable sound. 5. 修复`/craftorithm display`命令的补全内容中只含有插件自己的配方的问题 | Fixed an issue where tab completion for `/craftorithm display` only listed the plugin's own recipes. 6. 修复1.21.3以上Minecraft版本环境下锻造台配方在一些情况下无法将材料放入对应位置的问题 | Fixed an issue on Minecraft versions 1.21.3 and above where smithing table recipes could not place ingredients in the correct slots in some cases. 7. 优化代码结构和性能 | Optimized code structure and performance.

### 更新内容 | Update Contents 1. 脚本语法大幅度更改，现在不再支持形如 `tell "hello world"` 这样的简单写法，必须使用 `tell("hello world")` 这样的完整语法写法 | The script syntax has undergone major changes. The shorthand format like `tell "hello world"` is no longer supported; you must now use the full function syntax, e.g., `tell("hello world")`. 2. 对调酿造配方创建/编辑UI里材料和输入的位置 | Swapped the positions of the ingredient and input fields in the brewing recipe creation/editing UI. 3. 修复26.1版本酿造配方无法正确得到结果的bug | Fixed a bug where brewing recipes would not produce the correct result on version 1.26.1. 4. 修复酿造配方结果刷新在一些情况下无法刷新所有槽位和覆盖结果数量的问题 | Fixed an issue where brewing recipe result refreshing would sometimes fail to update all slots or correctly override the result stack size.

### 更新内容 | Update Contents 1. 更改set_inv_item函数行为，现在其会在容器对应位置已经存在物品时尝试将物品放在其他位置或丢出物品 | Changed the behavior of the `set_inv_item` function; it will now attempt to place the item in another slot or drop it if the target slot already contains an item. 2. 现在script默认不再允许裸参数语法，必须开启`enable_script_bare_args`配置项才能使用 | The script now disallows bare argument syntax by default; the `enable_script_bare_args` config option must be enabled to use it. 3. 添加EmakiItem插件物品源适配 | Added compatibility for EmakiItem plugin item sources. 4. 修复铁砧配方在更改物品名字时，不能正确显示出结果的问题 | Fixed an issue where anvil recipes did not correctly display the result when renaming items. 5. 修复附魔复制规则未使用base更高附魔等级的问题 | Fixed an issue where the enchantment copying rule did not use the higher base enchantment level. 6. 修复铁砧配方中带数量的tag材料解析错误的问题 | Fixed a parsing error with tagged materials that have quantities in anvil recipes. 7. 修复1.21以下版本铁砧在配方不再匹配时NPE的问题 | Fixed a NullPointerException (NPE) issue with anvils on versions below 1.21 when the recipe no longer matches. 8. 修复配方展示图标编辑点击时自定义动作执行两次的问题 | Fixed an issue where custom actions were executed twice when clicking to edit the recipe display icon. 9. 修复因为未将1.21.11的配方注册器实现打包导致的1.21.11的spigot端无法注册配方的问题 | Fixed an issue where Spigot 1.21.11 could not register recipes because the recipe registry implementation for 1.21.11 was not packaged. 11. 优化代码结构和性能表现 | Optimized code structure and performance.

### 更新内容 | Update Contents 1. 修复1.20.1-1.20.2酿造配方创建报错的问题 | Fixed brewing recipe creation errors on minecraft 1.20.1–1.20.2. 2. **修复在1.21以上版本，特定摆放方式下，多个材料的无序配方可以绕过部分材料检测，使用非法物品进行合成的bug | Fixed a bug in 1.21+ where shapeless multi‑ingredient recipes could bypass checks and accept invalid items in certain slot arrangements**

### 更新内容 | Update Contents 1. 修复存在trim类型的锻造配方时,打开所有配方的recipe book页面会报错的问题 | Fixed an issue where opening the recipe book menu for all recipes would cause an error when trim type smithing recipes were present 2. 修复酿造配方展示页面无法正确打开的问题 | Fixed an issue where the brewing recipe display menu could not be opened correctly 3. 修复folia环境下，command和console函数会报错的问题 | Fixed an issue where the command and console functions would cause errors in the folia environment

### 更新内容 | Update Contents 1. 修复disable命令无法正确禁用特殊配方的问题 | Fixed the issue where the disable command could not correctly disable special recipes 2. 优化插件内存占用 | Optimized plugin memory usage

### 更新内容 | Update Contents 1. 现在除1.21.3以上的切石机配方外，所有配方的材料判断都通过ID进行判断，不会再出现加了个附魔、改了个名字就不能合成的情况 | Except for stonecutter recipes on versions above 1.21.3, all recipe ingredients checks are performed by item ID. This means that adding enchantments or renaming items will no longer prevent crafting. 2. 修复SmithingTrimRecipe无法正确使用的问题，现在锻造纹饰配方在1.21.5以上必须设置trim_pattern | Fixed an issue where SmithingTrimRecipe could not be used correctly. For versions above 1.21.5, the trim_pattern must now be specified for smithing trim recipes 3. 新增配方注册、材料识别等相关api | Added new APIs for recipe registration and material identification 4. 优化插件重载性能，修复插件重载时卡网络、卡客户端的问题 | Optimized plugin reload performance, and fixed network lag and client-side stuttering that occurred during reload 5. 修复无序配方创建页面会创建出null物品材料的问题 | Fixed an issue where shapeless recipe creation pages could create null item materials 6. 优化UI文本显示 | Improved UI text display 7. script命令现在可以在控制台执行 | The `script` command can now be executed from the console 8. 兼容VaultUnlocked | Added compatibility with VaultUnlocked

### 更新内容 | Update Contents 1. 修复recipe_list菜单的排序按钮文本解析错误的问题 | Fixed the issue where the sorting button text in the recipe_list menu was not parsed correctly 2. recipebook命令支持传入all类型以查看所有的配方 | The recipebook command now supports passing all as an argument to view all recipes 3. tag现在支持tag:<命名空间>:<key>的写法以支持读取数据包新增的tag | Tags now support the tag:<namespace>:<key> syntax to allow reading tags added by data packs

### 更新内容 | Update Contents 1. tag现在支持tag:<命名空间>:<key>的写法,以支持读取数据包中新增的物品tag | The tag syntax now supports tag:<namespace>:<key> to allow reading newly added item tags from datapacks 2. 触发器的conditions现在支持两种写法: 简单表达式和完整脚本 | Now the trigger's conditions supports two writing styles: simple expressions and full scripts 3. 脚本模块新增int函数和float函数,用于强制某数字类型变量为整形或浮点型 | Added int and float functions to the script module for forcing a numeric variable to integer or float type 4. 修复https://github.com/YufiriaMazenta/Craftorithm/issues/124 | Fixed issue #124 5. 修复更新检测报错的问题 | Fixed an error with update checking

### 更新内容 | Update Contents 1. 修复 BackIcon 在无父级页面时使用异步关闭页面导致异常报错的问题 | Fixed an issue where BackIcon would throw an error when asynchronously closing a page with no parent page. 2. script 模块新增一些数学运算的函数 | Added several math-related functions to the script module. 3. 优化更新检测的方式 | Optimized the update checking mechanism.

### 更新内容 | Update Contents 1. 新增script函数`set_inv_item`, 用于设置玩家打开容器指定位置的物品 | Added script function `set_inv_item` for setting the item at a specified slot in a container opened by a player 2. 现在合成事件相关触发器上下文中会包含合成材料的ID和数量本次事件一次性合成的次数 | Now the crafting event-related trigger context includes the IDs and counts of crafting ingredients, as well as the number of times the crafting is performed in a single event 3. 如果配方的某个触发器正在冷却，那么本次合成以及所有相关触发器将被阻止 | If a trigger of a recipe is on cooldown, this crafting and all related triggers will be blocked 4. 优化recipebook命令的参数解析,现在的使用格式为`/craftorithm recipebook [--player <name>] [--type <type>]` | Optimized argument parsing for the recipebook command; the current usage format is `/craftorithm recipebook [--player <name>] [--type <type>]` 5. 修复RecipeDisplayIcon的lore会重复的问题 | Fixed the issue where the lore of RecipeDisplayIcon would duplicate

### 更新内容 | Update Contents 1. 修复ProtocolLib挂钩在某些情况下会抛出异常的问题 | Fixed an issue where ProtocolLib hooks would throw exceptions in certain situations

## 兼容性提醒 | Compatibility Notes - **最低Minecraft版本提升**: 最低支持版本从 1.19 提升至 **1.20** | **Minimum Minecraft version raised**: Minimum supported version raised from 1.19 to **1.20** - **配方文件格式变动**: 配方文件会自动转换, 但`random_cooking`类型的配方在新版本已经去除 | **Recipe file format changes**: Recipe files will be auto-converted, but `random_cooking` type recipes have been removed - **脚本系统**: 旧版脚本系统已移除, `function.yml`文件已失去作用 | **Script system**: Legacy script system removed, `function.yml` file is no longer functional - **packetevents / ProtocolLib**: 配方更新导致客户端卡顿的优化和虚拟配方预览功能需要安装其中之一才能生效 | **packetevents / ProtocolLib**: Optimization for client lag caused by recipe updates and virtual recipe preview require one of these to be installed --- ## 全新插件文档 | New Plugin Documentation https://yufiriamazenta.github.io/Craftorithm-Docs/ --- ## 新增功能 | New Features ### 全新脚本引擎 | New Script Engine - 新增完整的 DSL 脚本引擎: 词法分析 → AST → 编译器 → 栈式虚拟机 | Full DSL script engine: Lexer → AST → Compiler → Stack-based VM - 支持条件判断 (`if/elseif/else`)、算术运算 (`+` `-` `*` `/` `%`)、字符串拼接、取反运算 (`!`) | Supports conditionals (`if/elseif/else`), arithmetic operators (`+` `-` `*` `/` `%`), string concatenation, negation (`!`) - 支持变量 (`set`/`get`)、延迟执行 (`delay`)、日志输出 (`log`)、播放音效 (`sound`) | Supports variables (`set`/`get`), delayed execution (`delay`), logging (`log`), sound playback (`sound`) - 内置条件函数: `game_mode`、`permission`、`item`、`compare` 等 | Built-in condition functions: `game_mode`, `permission`, `item`, `compare`, etc. - 内置动作函数: `tell`、`give`、`run_cmd`、`take_item`、`play_sound` 等 | Built-in action functions: `tell`, `give`, `run_cmd`, `take_item`, `play_sound`, etc. - 新增 `/craftorithm script` 子命令用于执行脚本 | New `/craftorithm script` subcommand for executing scripts ### 全新触发器系统 | New Trigger System - 新增 Trigger 模块, 支持数十种触发器类型, 可监听配方合成、物品使用等多种事件 | New Trigger module supporting dozens of trigger types, monitoring recipe crafting, item usage, and more ### UI优化 | UI Improvements - 优化配方列表页面: 配方列表页面、配方类型选择菜单、支持按时间/名称排序, 通过`/craftorithm recipebook` 命令打开 | Enhanced recipe list page: recipe list, type selection menu, sort by time/name, opened via `/craftorithm recipebook` - 配方创建器 UI 重写 | Recipe creator UI rewritten - 配方编辑器 UI 重写 | Recipe editor UI rewritten - 配方展示页面改为可自定义, 支持通过 YAML 配置文件自定义布局和图标 | Recipe display pages are now customizable via YAML config files for layout and icons - 新增自定义菜单功能, 通过 YAML 配置文件创建自定义界面 | New custom menu feature, create custom interfaces via YAML config files - 菜单按钮支持按点击类型绑定脚本动作 (`actions` 配置) | Menu buttons support binding script actions by click type (`actions` config) - 菜单按钮支持 `item_model` 字段 | Menu buttons support `item_model` field ### 其他新功能 | Other New Features - 新增旧配方格式自动转换功能 (`LegacyRecipeMigrator`) | Automatic legacy recipe format conversion (`LegacyRecipeMigrator`) - 基于 packetevents 或 ProtocolLib 的虚拟配方预览功能 | Virtual recipe preview based on packetevents or ProtocolLib - 新增 `main_command_aliases` 配置项, 用于设置主命令别名 | New `main_command_aliases` config option for setting main command aliases - 新增分 tick 加载功能, 将配方加载分散到多个 tick 以减少卡服 | New tick-batched loading, distributes recipe loading across multiple ticks to reduce lag - 新增 `ItemPack` 物品包功能, 用于一个材料槽位允许多种物品, 类似原版tag | New `ItemPack` item pack feature, allowing a ingredient slot to accept multiple items, similar to vanilla tags - 新增 SX-Item 挂钩 | New SX-Item hook - 新增适用于铁砧配方和锻造台配方的物品组件复制系统 (`copy_components_rules`), 支持以下规则: `all`、`item_name`、`item_model`、`trim`、`unbreakable`、`tool`、`hide_tooltip`、`fire_resistance`、`custom_model_data_component`、`display_name`、`lore`、`enchantments`、`attributes`、`item_flag`、`max_stack_size`、`rarity`、`food`、`custom_model_data`、`custom_persistent_data` | New item component copy system for anvil and smithing recipes (`copy_components_rules`), supports: `all`, `item_name`, `item_model`, `trim`, `unbreakable`, `tool`, `hide_tooltip`, `fire_resistance`, `custom_model_data_component`, `display_name`, `lore`, `enchantments`, `attributes`, `item_flag`, `max_stack_size`, `rarity`, `food`, `custom_model_data`, `custom_persistent_data` ### API扩展 | API Extensions - 新增 `RecipeRegisterEvent` 事件 | New `RecipeRegisterEvent` event - 扩展 `CraftorithmAPI` 公开 API (新增物品管理、配方管理、触发器管理等方法) | Expanded `CraftorithmAPI` (new item management, recipe management, trigger management methods) --- ## Bug 修复 | Bug Fixes - 修复服务器配方缓存和禁用配方可能出问题的 bug | Fixed a bug where server recipe cache and disabled recipes could malfunction - 修复 `disable_recipes.yml` 会重复记录的问题 | Fixed `disable_recipes.yml` duplicate recording issue --- ## 优化 | Optimizations - 优化配方更新时客户端的卡顿问题 | Optimized client lag during recipe updates - 优化重载时其他插件监听器的恢复逻辑 | Improved listener restoration logic for other plugins during reload ---

### 更新内容 | Update Contents 1. 新增not_convert_listener_classes,用于配置不进行转化的监听器类 | Added the `not_convert_listener_classes` configuration, which is used to configure listener classes not to be converted 2. 新增动作`give-exp`,现在切石机配方也可以执行actions了 | Added action `give-exp`. Stonecutting recipes can now also execute actions 3. 将原本弃用的配方编辑页面暂时添加回来 | Added back the previously deprecated recipe editor menu 4. 将reload命令拆分成重载其他内容和重载配方，以缓解reload造成服务器过载的问题 | Split the reload command into reloading other content and reloading recipes to mitigate server overload issues caused by reload

### 更新内容 | Update Contents 1. 新增not_convert_listener_classes,用于配置不进行转化的监听器类 | Added the `not_convert_listener_classes` configuration, which is used to configure listener classes not to be converted 2. 新增动作`give-exp`,现在切石机配方也可以执行actions了 | Added action `give-exp`. Stonecutting recipes can now also execute actions 3. 将原本弃用的配方编辑页面暂时添加回来 | Added back the previously deprecated recipe editor menu 4. 将reload命令拆分成重载其他内容和重载配方，以缓解reload造成服务器过载的问题 | Split the reload command into reloading other content and reloading recipes to mitigate server overload issues caused by reload

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

### 更新内容 | Update Contents 1. 新增物品插件挂钩优先级配置项 | Added item plugin hook priority option 2. 添加CraftEngine兼容 | Add CraftEngine compatibility

### 更新内容 | Update Content 1. /craftorithm display命令新增支持指定打开玩家，使用方式：`/craftorithm display <recipe_id> [player_name]` | /craftorithm display command now supports select a player to open the menu. Usage: `/craftorithm display <recipe_id> [player_name]`

### 更新内容 | Update Content 1. 优化注册配方时的性能消耗 | Optimize the performance consumption when registering recipes 2. 修复在一些情况下关闭配方展示页面会报错的bug | Fixed the bug that would cause an error when closing the recipe display menu in some cases 3. 新增对CampfireStartEvent的处理 | Added handling of CampfireStartEvent 4. 新增语言文件西班牙语(es_es.yml) | Add new language file: Spanish(es_es.yml)

### 更新内容 | Update Content - 添加Nexo兼容 | Add Nexo compatibility - 添加AzureFlow兼容 | Add AzureFlow compatibility

### 更新内容 | Update Content - 修复MMOItems无法挂钩的问题 | Fixed MMOItems could not be hooked

### 更新内容 | Update Content - 修复1.10.12版本开始,可能会导致其他插件无法正确挂钩的问题 | Fixed the issue that other plugins may not be hooked correctly starting from version 1.10.12

### 更新内容 | Update Content - 修复了无法使用potion配方创建器的bug | Fixed a bug where potion recipe creator could not be used

### 更新内容 | Update Content - 修复GUI创建配方时无法正确保存物品的问题 | Fixed items could not be saved correctly when creating recipes in recipe creator gui - 修复RegisteredListener相关性能问题 | Fix RegisteredListener related performance issues

### 更新内容 | Update Content - 优化底层加载逻辑 | Optimize plugin loading process - 暂时去除配方编辑页面，将会在下个大版本（1.11）更新自定义UI功能 | Temporarily remove the recipe editor menu, and will update the custom UI in the next major version (1.11) - 优化命令提示 | Optimize command prompt

### 更新内容 | Update Content - 兼容EcoItems和ExecutableItems | Compatible with EcoItems and ExecutableItems - 修复偶发配方原材料展示GUI数量不对的bug | Fixed the bug that the number of recipe ingredients displayed in the GUI was incorrect occasionally

### 更新内容 | Update Content - 优化通过有序配方创建生成的配方文件结构 | Optimize the recipe file structure generated by shaped recipe creator @YufiriaMazenta - 修复item命令会导致StackOverflowError的问题 [#73](https://github.com/YufiriaMazenta/Craftorithm/pull/73) | Fixed the issue where the item command would cause a StackOverflowError [#73](https://github.com/YufiriaMazenta/Craftorithm/pull/73) @Noogear

### 更新内容 | Update Content - 修复[#71](https://github.com/YufiriaMazenta/Craftorithm/issues/71) | Fixed [#71](https://github.com/YufiriaMazenta/Craftorithm/issues/71)

### 更新内容 | Update Content - 再次修复铁砧配方总是出现同一个结果的bug | Fixed anvil recipe always giving the same result - 修复https://github.com/YufiriaMazenta/Craftorithm/issues/69 | Fixed https://github.com/YufiriaMazenta/Craftorithm/issues/69

### 更新内容 | Update Content - 修复铁砧配方总是出现同一个结果的bug | Fixed anvil recipe always giving the same result - 新增debug配置项 | Added debug configuration options

### 更新内容 | Update Content - 锻造台配方现在也支持copy_enchantments（仅复制附魔） | Smithing table recipes now also support copy_enchantments (copy enchantments only) - 修复插件重载时有概率导致服务器网络卡顿的bug | Fixed a bug that caused the network to get stuck when plugin reloading

### 更新内容 | Update Content - 优化铁砧配方的匹配逻辑,新增copy_enchantments（仅复制附魔）选项 | Optimized the logic of anvil recipes, added copy_enchantments (copy only enchantments) option - 新增开关在ItemsAdder重载时一起重载的设置项 | Added a new configuration option switch to reload when ItemsAdder is reloaded - 兼容1.19.4及以上 | Compatible with Minecraft version 1.19.4 and above - 修复一些bug | Fixed some bugs

### 更新内容 | Update Content - 将锻造台配方创建页面的copy_nbt默认值修改为false | Change the copy_nbt default value for the smithing recipe creator menu to false

### 更新内容 | Update Content - 修复服务端不是Paper及其衍生端时烧制物品会报错的问题 | Fixed the issue that an error will occur when smelting items when the server is not Paper or its fork

### 更新内容 | Update Content - 修复`remove_all_vanilla_recipes`配置项没有效果的bug | Fixed a bug where the `remove_all_vanilla_recipes` configuration did not work

### 更新内容 | Update Content - 修复插件内置的物品源加载物品错误的问题 | Fixed the problem of loading wrong items in the plugin's built-in item source - 修复copy_nbt属性实际效果相反的bug | Fixed the bug that the copy_nbt attribute actually had the opposite effect

### 注意事项 | Notes： 此版本开始，插件只适用于1.20.6及以上版本，且旧版插件自带物品功能无法迁移到此版本 | Starting from this version, the plugin is only applicable to version 1.20.6 and above, and the item functions of the old plugin cannot be migrated to this version ### 更新内容 | Update Content 1. 适配1.20.6-1.21 | Completed compatibility with 1.20.6-1.21 2. 添加配方书类型功能，在shaped、shapeless以及cooking类型配方中可使用 | Added recipe book category, which can be used in shaped, shapeless and cooking type recipes ### 配方书类型功能详解 | Detailed explanation of recipe book category 1. 在shaped以及shapless配方中，配方类型可为building（建筑方块）、redstone（红石）、equipment（工具）和misc（物品） 2. 在cooking配方中，配方类型可为food（食物），blocks（方块）和misc（物品） --- 1. In shaped and shapless recipes, the recipe type can be building, redstone, equipment, and misc 2. In cooking recipes, the recipe type can be food, blocks, and misc --- #### 配方书类型配置示例 | Configuration Example： 工作台配方 | Crafting Recipe: ```yaml #配方的类型，一共有shaped(有序)、shapeless(无序)、cooking(烧炼)、smithing(锻造)、stone_cutting(切石机)、random_cooking(随机烧炼) type: 'shaped' result: 'diamond_sword' multiple: true shape: - - 'aaa' - 'bbb' - 'ccc' - - 'dd' - 'ee' source: a: 'bedrock' b: 'command_block' c: 'diamond' d: 'barrier' e: 'chain_command_block' unlock: true sort_id: 1 category: building ``` 烧炼配方 | Smelting Recipe: ```yaml type: cooking result: bedrock multiple: true source: - block: furnace item: command_block exp: 20 time: 100 - block: smoker item: command_block - block: campfire item: command_block - block: blast_furnace item: command_block exp: 10 time: 200 category: blocks ```

- 兼容Paper去除craftbukkit版本 | Compatible with Paper removal craftbukkit version - 修复其他插件干扰配方逻辑的bug | Fixed the bug where other plugins interfered with recipe logic - 修复Folia端下控制台使用item give命令的报错 | Fixed the issue when using the item give command in the console on the Folia side - 修复配方结果无法正确解析可变数值的bug | Fixed the bug that the recipe result could not correctly parse the variable value

- The /cra item give command will now drop items when the player's inventory is full - Fixed the bug where an error would appear when completing the /cra display command

- Add command "/craftorithm display" to view recipe

- Fixed the bug that the experience value in cooking recipe creator gui does not accept floating point numbers. - Fixed the bug that Oraxen's items could not be used as ingredient materials. - Fixed the bug that the recipe file generated by the shaped recipe creator GUI could not correctly delete empty columns.

- Add copy_nbt field to the smithing recipe to control preserve item nbt

- Fixed the bug that the recipe group display gui failed to correctly display the prompt lore. - Fixed the bug that the recipe unlocking option was not refreshed in time when modifying the recipe on the recipe editor gui.

- Fixed the bug that caused incorrect registration due to the case of recipe names. - Fixed the bug that the item nbt could not correctly read the numeric type nbt

- Fixed the bug where mod items cannot be used on the CatServer server

- Fixed compatibility issue with EcoEnchants again

- Fixed a bug that caused the anvil recipe to not work properly due to EcoEnchants

- Fixed the bug that the results of ItemsAdder items were incorrect when used as ingredient for smelting. - Fixed the bug of saving NBT item format error

- Added command to remove custom fuel

- Subdivide list and item command permissions - Add command alias /cra - Add custom fuel features

- Fixed the bug where the ItemsAdder items were used as the result with the wrong amount - Now a recipe group with only one recipe can directly view the recipe

- Fixed the bug where the agent ItemsAdder listener would report NoSuchMethodError when the version was lower than 1.18

- Fixed the bug that the recipe creator GUI could not correctly identify NBT items.

- Fixed the bug that items cannot be correctly identified when there are two ItemsAdder items with the same ID but different namespaces.

- Fixed the bug that ItemsAdder items cannot be used as ingredients in recipes

### Update content - Added recipe editing menu, where you can edit sorting ID, unlocking, smelting time, reward experience, anvil consumption experience, and delete recipes, etc. ### Bug fixes - Fixed the bug of missing parameter prompts and incorrect tab prompts for item-related commands

- Fixed a bug which may can't get item when parse recipe ingredients by processing strings.

- Fixed the bug that vanilla items cannot be parsed tolerantly Anvil recipes can now also execute scripts

- Fixed a bug that allowed illegal recipe names to cause errors when creating recipes

- Updated Japanese translation text to fix some incorrect translations

- The plugin now supports multilingual functionality, displaying preset language text based on the player's client language.

- Optimized the recipe creator GUI

- Rewrite the item loading and recipe loading modules - Added anvil recipe support - Optimize creating recipe gui - Compatible with 1.20.3, 1.20.4 - Optimize command prompt items - Optimize language config structure - fix bugs

- Rewrite recipe creation related gui - Compatible with loading items from NeigeItems - Added automatic update configuration file function - Fix bugs： - Unable to create blast furnace recipe using GUI - Quantity is not recognized correctly when put into GUI using vanilla item as result - After the brewing recipe is deleted, it can still be seen in the craft list command. - The craft item give command is missing prompts

Fixed a bug where an error would be reported when opening the recipe list gui in some cases

- Add command `/craft disable` to disable the recipes of vanilla and other plugin. - Add command `/craft list`,which opens the GUI for viewing recipes - Delete command `/craft show` - Refactor the command `/craft remove`. Its function now is to delete the recipe group added by Craftorithm. For detailed usage, please refer to the wiki. - Added brewing stand recipe support - Temporarily removed unstable anvil recipe support - Add bstats switch - fix bugs

- Optimize the item recognition logic when creating recipes in the GUI - Update CrypticLib version

Fixed the bug where smithing and stonecutter recipes still cannot be created through GUI in versions higher than 1.14