Craftorithm

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