EmakiCooking | Seven Cooking Stations

Changed

- Actions use a new syntax, and you do not have to rewrite anything yourself. On first startup CoreLib rewrites the config files of every Emaki plugin under plugins/, once only. Each edited file keeps the original beside it with a .legacy-backup suffix. A line that cannot be converted leaves your config untouched and goes into a separate .v2-failed file, with the file and line listed in the console. - The seven nutrition actions are the only ones you need to rename by hand; automatic rewriting does not cover them. Underscores now separate the words: - emakicookingaddnutrition → cooking_add_nutrition - emakicookingremovenutrition → cooking_remove_nutrition - emakicookingsetnutrition → cooking_set_nutrition - emakicookingclearnutrition → cooking_clear_nutrition - emakicookingresetnutrition → cooking_reset_nutrition - emakicookingrechecknutritionthreshold → cooking_recheck_nutrition_threshold - emakicookingrunrecipereward → cooking_run_recipe_reward - Nutrition loops need editing by hand too: loopsync/cancelloop become start_task/stop_task, %player_name% becomes %caster.uuid%, mode=replace becomes on_conflict=replace, and stop_if_offline becomes stop_when_offline. The comments in the nutrition threshold section of config.yml already show the new format. The repeat count of start_task is capped by CoreLib action.pipeline.max_repeat_times (default 100). - The juicer inspect action is right_click in the new config.yml. If you keep your old config file, change inspect under stations.juicer, or the juicer block cannot be mined. - For developers: EmakiCookingApi.available(), apiVersion(), pluginName() and isReady() are replaced by EmakiCookingApi.status(), which returns ApiStatus. EmakiCookingApiProvider is removed; call the static methods on EmakiCookingApi directly. New nutrition(), catalog() and operations() accessors return no-op implementations when the plugin is absent instead of throwing. EmakiCookingApi.Bridge is now @ApiStatus.NonExtendable.

Fixed

- Stations breaking down for good after a while (chopping board, wok, grinder, juicer): a wok that finished cooking but could not be served, ingredients vanishing or being overwritten by the next ones added, a chopping board that would neither cut nor return items, a grinder with a frozen progress bar. One flaw caused all of it: a counter on the station's saved record climbed on every read, and once a save failed the station looked empty to the plugin with no way back. The counter no longer climbs and a failed save rolls back. - The pipeline jamming when a dish moves between stations, on Folia servers. An error mid-transfer blocked that station and everything queued behind it until a restart; it now recovers on its own. - Items being taken even when a recipe condition failed, on the wok and juicer. The bowl or container was removed before the condition was checked, so a failure had already cost the item and still reported success. The check now happens first, and only the on_fail actions run. - Items sometimes taken at odd moments. Recipes pulling ingredients from a player's inventory retried forever when they could not find them, so items could disappear after the player walked away or swapped items. Capped at 5 attempts, then the station is released without taking anything. - The juicer block being impossible to break while it held liquid, because inspect took over left click in survival and creative. - A flood of error messages when serving from the juicer without a container in hand. - Floating text and displayed items left in the world after removing a station, on all seven types, when the plugin could not read the station's contents.

Removed

- JS scripting, including .js reward scripts in recipes. There is no automatic conversion, so rewrite those rewards using config actions. The bundled scripts/examples/cooking_reward.js sample is gone as well. - Two config options that never did anything: stations.juicer.drop_completed_result_on_break and stations.fermentation_barrel.require_sealed. They sat in the config file but were never read, so no value ever had an effect. Delete them from your own config whenever you like.

Notes

- Update EmakiCoreLib to 4.7.0 first. - Back up your whole plugins/EmakiCooking/ folder before upgrading. - Three things need doing by hand: renaming the seven nutrition actions, rewriting JS reward scripts as config actions, and converting nutrition loops to start_task/stop_task. Everything else is rewritten for you. - Player nutrition data and stations already placed in the world are unaffected and need no migration. The action syntax inside recipe files is rewritten automatically; the recipe structure itself has not changed.

Emaki Cooking v4.1.0

MineBBS 更新日志

【必读】升级前必须完成的两件事

- 不处理会静默清空玩家营养数据。 营养数据键由 values: 改为 nutrition:，没有兼容旧键的回退读取，也没有提升数据版本号，因此旧的 data/nutrition/<uuid>.yml 会被判定为空并按各营养类型默认值重建。升级前必须先备份 `data/nutrition/`，并把每个玩家文件中的 `values:` 段改名为 `nutrition:`，否则所有玩家营养数据都会丢失。 - 营养动作短别名已移除。 ecaddnutrition、cookingaddnutrition、ecremovenutrition、ectakenutrition、cookingremovenutrition、ecsetnutrition、cookingsetnutrition 全部不再存在，只保留 emakicookingaddnutrition、emakicookingremovenutrition、emakicookingsetnutrition。*升级前必须检索所有配置与脚本，把短别名替换为完整的 `emakicooking` 动作名**，否则使用短别名的动作链会报动作未注册。

工位数据未被破坏

- 工位状态存储主体迁移到方块 PDC，但旧的 YAML 仍会被扫描并自动归档到 data/stations-legacy-backup/；没有方块实体的方块继续走 YAML 回退。 - 配方文件、stations.* 结构与权限键均未改变。

破坏性变更：移除 Web Console

- 浏览器端 Web Console 层已整体移除，包含 web-console.yml、GUI 界面的网页扩展与配套前端项目；原先依赖该网页界面完成的运维操作需要改用配置文件或命令。

世界黑名单与工位占位符

- 新增全局与按工位的世界黑名单：station.disabled_worlds: [] 与 stations.<type>.disabled_worlds: []。在黑名单世界中，插件不接管相关事件，保留原版方块行为。 - 新增工位占位符族 %emakicooking_station_*%，解析玩家最近交互的工位：type、type_name、world、x、y、z、location、block、heat_block、burning、burning_seconds、heat、moisture、steam、input、input_source、input_amount、ingredient_count、recipe、recipe_id、progress、progress_target、progress_percent、completed、fluid、fluid_amount、player。另有 station_<name>_<field> 形式用于指定某一工位类型。 - 新增公开的工位交互事件，第三方插件可以据此做联动。

命令、动作与预检

- 新增命令 /ecooking station reindex（需要 emakicooking.admin），用于重建工位状态索引。 - 新增 /ecooking inspect block（此前只有 inspect hand），可查看工位类型、来源、方块、方块状态、是否为方块实体、存储后端、PDC 状态、索引状态、索引后端、是否存在旧版 YAML，以及是否被世界黑名单禁用交互。 - 新增营养动作：emakicookingclearnutrition、emakicookingresetnutrition、emakicookingrechecknutritionthreshold、emakicookingrunrecipereward。 - 配置预检新增配方目录与工位状态目录提示，并按工位给出存储后端提示。 - 新增本地化工位名称与错误提示键。

修复

- 修复工位悬浮文本丢失原版物品译名的问题：此前文本会被拍平成旧式字符串，客户端无法本地化可翻译组件。现在保留组件结构，原版物品名按客户端语言显示。 - 修复默认 config.yml 中示例动作行无效、从不触发的问题：它们使用了未注册的动作 id。默认值已修正，开箱示例（砧板、炒锅、研磨机、蒸锅、烤炉、榨汁机、发酵桶的音效与粒子反馈，以及营养过量反馈）现在可以真正生效。

其他改进

- 插件描述文件由 plugin.yml 更名为 paper-plugin.yml，改用结构化依赖（必需 EmakiCoreLib；可选 PlaceholderAPI / CraftEngine / ItemsAdder / Nexo / Oraxen / PacketEvents / MMOItems / NeigeItems）。全部 25 个权限键及其默认值保持不变；/ecooking（别名 ec）改为代码注册，别名保留。 - 工位状态主要存放在方块 PDC 并带版本账本，配合索引恢复与完成事务恢复，崩服或强制关服后工位进度与产出更不容易丢失或重复发放。 - 消息前缀更换为新的品牌渐变样式。 - 第三方物品 / 家具接入范围保持不变。

升级说明

- 需要 EmakiCoreLib 4.6.0。 - 升级前请依次完成：备份 `data/nutrition/`，把各玩家文件的 `values:` 改名为 `nutrition:`，再检索配置与脚本替换全部营养动作短别名。 - api-version 由 1.21 提升到 1.21.8，构建基线由 spigot-api 改为 paper-api；folia-supported: true 与 Java 25 目标保持不变。 - 新增配置键 station.disabled_worlds 与按工位的 disabled_worlds 默认为空列表，即不禁用任何世界，不填写则行为不变。 - 升级后建议用 /ecooking inspect block 抽查若干已放置工位，确认存储与索引状态正常，并检查一次玩家营养数值是否符合预期。

SpigotMC Update Log

[CENTER][SIZE=6][B]◆ Emaki Cooking v4.1.0 Release ◆[/B][/SIZE][/CENTER] [CENTER]Two mandatory pre-upgrade steps for nutrition data and nutrition action aliases, plus world blacklists, station placeholders, PDC-backed station state, and removal of the Web Console.[/CENTER] [CENTER][B]━━━━━━━━━━━━━━━━━━━━[/B][/CENTER] [LIST] [*]MANDATORY STEP 1 - player nutrition dat

Added

- World blacklists, global and per station: station.disabled_worlds: [] plus stations.<type>.disabled_worlds: []. In a blacklisted world the plugin does not take over events and vanilla block behavior is preserved. - Station placeholder family %emakicooking_station_*% resolving the player's most recent interacted station: type, type_name, world, x, y, z, location, block, heat_block, burning, burning_seconds, heat, moisture, steam, input, input_source, input_amount, ingredient_count, recipe, recipe_id, progress, progress_target, progress_percent, completed, fluid, fluid_amount, player. A station_<name>_<field> form also exists to target a specific station type. - Public station interaction event so third-party plugins can react to station interactions. - New command /ecooking station reindex (requires emakicooking.admin) to rebuild the station state index. - /ecooking inspect block (previously only inspect hand), reporting station type, source, block, block state, whether it is a tile state, storage backend, PDC state, index state, index backend, whether legacy YAML exists, and whether interaction is disabled by the world blacklist. - New nutrition actions: emakicookingclearnutrition, emakicookingresetnutrition, emakicookingrechecknutritionthreshold, emakicookingrunrecipereward. - Config precheck messages for the recipe directory and station state directory, plus storage backend hints per station. - New localized station names and error keys.

Changed

- Descriptor renamed from plugin.yml to paper-plugin.yml with structured dependencies (EmakiCoreLib required; PlaceholderAPI / CraftEngine / ItemsAdder / Nexo / Oraxen / PacketEvents / MMOItems / NeigeItems optional). All 25 permission keys and their defaults are unchanged; /ecooking (alias ec) registers in code with the alias preserved. - Station state now primarily lives in block PDC with a version ledger, plus index recovery and completion transaction recovery, so station progress and output are less likely to be lost or double-granted after a crash or hard shutdown. Legacy YAML is still scanned and automatically archived to data/stations-legacy-backup/, and blocks without a tile state fall back to YAML. - Message prefix switched to a new brand gradient. - The third-party item/furniture integration set is unchanged. - api-version raised from 1.21 to 1.21.8 and the build base moved from spigot-api to paper-api; folia-supported: true and the Java 25 target are unchanged.

Fixed

- Station floating text lost vanilla item translation names: the text was flattened to a legacy string, so translatable components could not be localized by the client. Components are now preserved and vanilla item names render in the client's own language. - The sample action lines in the default config.yml were invalid and never fired because they used ids that were not registered. The defaults are corrected, so the out-of-the-box examples now work: chopping board, wok, grinder, steamer, oven, juicer, fermentation barrel sound and particle feedback, and nutrition overeating feedback.

Removed

- Player nutrition data will be silently reset unless you act first. The nutrition data key changed from values: to nutrition: with no fallback read and no schema version bump, so old data/nutrition/<uuid>.yml files are treated as empty and rebuilt from per-type defaults. Back up data/nutrition/ and rename the values: section to nutrition: in each player file before upgrading, otherwise all player nutrition is lost. - Short nutrition action aliases are removed. ecaddnutrition, cookingaddnutrition, ecremovenutrition, ectakenutrition, cookingremovenutrition, ecsetnutrition, and cookingsetnutrition are gone; only emakicookingaddnutrition, emakicookingremovenutrition, and emakicookingsetnutrition remain. Any action chain using a short alias will report an unregistered action, so search your configs and scripts and replace them with the full emakicooking* names. - The browser-based Web Console layer, including web-console.yml, the GUI surface web extension, and the web-console/ frontend project.

Notes

- Requires EmakiCoreLib 4.6.0. - Before upgrading, in order: back up data/nutrition/, rename values: to nutrition: in each player nutrition file, then search configs and scripts and replace every short nutrition action alias with its full emakicooking* name. - Station state data is not broken: recipe files, the stations.* structure, and permission keys are unchanged. The new config keys station.disabled_worlds and the per-station disabled_worlds default to empty lists, meaning nothing is disabled, so leaving them out changes nothing. After upgrading, spot-check a few placed stations with /ecooking inspect block and verify player nutrition values look correct.

Added

- Recent-station placeholders and a public station interaction event. - Nutrition reset, nutrition threshold recheck, and recipe reward actions. - PDC-first station storage for block-entity stations, with YAML fallback where needed. - Manifest v2 Web Console integration for Cooking configs and GUI editing.

Fixed / Improved

- Fixed vanilla item names in station text displays being flattened to server-side English. - Improved station restore flow through coordinate indexes plus PDC/YAML state reads. - Improved /ecooking inspect and storage precheck details. - Command suggestions now appear after /ecooking .

Notes

- Update with the matching CoreLib release. - Requires Paper-family 1.21.8+ behavior. - .idx coordinate indexes are still used for fast station restore lookup; they are not the main block-entity state body. - Breaking: Action aliases were removed; use canonical action IDs. - Back up Cooking data before updating.

Added

- Nutrition (diet-style) system, enabled by default: customizable nutrition types, food sources, and edge-triggered single/combo thresholds. - Nutrition gain via vanilla, CraftEngine, ItemsAdder, Nexo, Oraxen foods, plus MMOItems and NeigeItems consumables. - Nutrition actions, /ecooking nutrition command, new permissions, and PlaceholderAPI placeholders; nutrition is persisted (configurable save interval). - Oraxen support for cooking station blocks and furniture. - Public events: PlayerNutritionConsumeEvent (cancellable), NutritionThresholdChangeEvent, CookingRecipeCompleteEvent (cancellable, result-editable). - JavaScript extensions for cooking result rules and completion hooks via emaki.module("cooking"). - Config precheck on startup and reload.

Fixed

- Fixed potential lag when closing cooking station containers on Folia.

Notes

- Breaking: recipe conditions only read availability_condition; migrate legacy root-level condition fields. - Nutrition adds optional softdepends (Oraxen, MMOItems + MythicLib, NeigeItems); missing ones are skipped. - Nutrition is on by default; disable via nutrition.enabled.

Added

- Cooking script module access through emaki.module("cooking"). - result.<branch>.outputs/actions recipe result structure. - input.amount for chopping board recipes. - Updated Web Console registration.

Fixed

- Fixed unclear chopping board amount semantics. - Fixed custom block station matching consistency. - Fixed legacy result output/action field confusion. - Fixed Cooking GUI editor old slot fields.

Refactored

- Static facade + Bridge API model. - Recipe result parsing. - Station interaction and runtime item handling.

Improved

- Better default recipes. - Better item return/drop handling. - Better Web Console editing for Cooking configs.

Cooking v3.2.0 is a cleanup and integration update. It keeps Cooking aligned with the new CoreLib script and runtime model.

Highlights

- Cooking script module access through emaki.module("cooking"). - Cooking-owned script examples.

Improved

- Better shared item source display behavior through CoreLib. - CoreLib-aligned bStats, runtime dependency handling, and versioned resource notices.

EmakiCooking v3.1.0

Workstation text displays, wok stir-fry animation, configurable effects, and Web console support.

---

New Features

#### Workstation Text Display Cooking stations now support floating text displays above them, providing clear visual feedback on the current processing status. Choose between Bukkit and PacketEvents display backends depending on your server setup. #### Wok Stir-fry Animation The wok station now features a stir-fry animation effect, adding visual flair to the cooking process. #### Station Effect System A new configurable particle and sound effect system lets you add custom visual and audio feedback during station operation. #### Cooking Animation Improvements Cooking animations have been optimized to support arbitrary rotation angles, removing the previous fixed-direction limitation. #### Recipe Completion Conditions Cooking recipes now support the core library's recipe completion condition system, enabling post-completion logic and actions. #### Web Console Integration EmakiCooking is now accessible through the built-in Web management console, allowing you to edit recipes and configurations directly in your browser.

Bug Fixes

- Fixed ingredient source resolution during recipe matching, which could cause incorrect ingredient consumption. - Fixed wok failure output using incorrect item source format.

Improvements

- All station GUI interfaces have been optimized and updated. - Example recipe files have been improved for better clarity and ease of use. - Language files have been significantly expanded with translations for all new features.

EmakiCooking 3.0.0 Release

This release adds three new cooking stations (Oven, Juicer, Fermentation Barrel), a virtual display entity system, and heat source ignition, significantly expanding cooking gameplay.

New Features

- Oven: Temperature-sensitive cooking station. Players control heat by adding fuel; supports perfect bake, normal bake, and burnt results based on temperature management. - Juicer: Press-based cooking station. Players press multiple times to extract fluid (measured in ml), then collect with a container. Supports fluid mode and direct output mode. - Fermentation Barrel: Long-duration fermentation station. Supports early collection (partial product), normal completion, and over-fermentation (spoiled product). Progress persists across server restarts. - Display Entity System: Cooking stations show floating item display entities above them. Three backends: auto, packet_events (virtual entities, no entity ID usage, better performance), bukkit (real ItemDisplay). Configurable view distance and refresh interval. - Heat Source Ignition: Wok and steamer support ignite_heat_source to automatically light/extinguish heat source blocks when ingredients are added/removed. Works with CraftEngine, ItemsAdder, and Nexo custom blocks. - PAPI Placeholders: %emakicooking_recipe_count% (total recipes) and %emakicooking_recipe_count_<station>% (per-station count).

Improvements

- Config and language files auto-merge new keys on upgrade. - Fermentation barrel state uses dirty-flag batch persistence to reduce disk IO. - All stations auto-drop contents when the block is broken.

Breaking Changes

- Station block sources changed from single block_source to list block_item_sources. - Tool/spatula/heat source fields unified to *_item_sources list format. - Steamer moisture rules renamed from moisture_sources to moisture_rules with updated sub-fields. - All recipe input.source → input.item_sources (list), result.output.source → result.output.item_sources (list). - Old built-in recipes removed; each station directory now has example_recipe.yml.

Upgrade Notes

- New station GUI templates and recipe directories are auto-created. - PacketEvents display backend requires Minecraft 1.19.4+; auto-falls back to Bukkit on older versions. - Config version updated to 4.0.0 with new station and display_entities configuration sections. - Existing recipes must migrate source fields to item_sources list format — refer to each station's example_recipe.yml. [View Full Documentation](https://jiuwu02.github.io/Emaki_Series/) | [Join Discord Community](https://discord.gg/FV4GFQbvCM) | [QQ Group](https://qm.qq.com/q/GqGrzHp0wU)

EmakiCooking 2.3.0 Release

This release overhauls cooking station interactions and adds PlaceholderAPI support. - Added unified station interaction handling for left/right/shift clicks. - Added configurable interaction behavior for cooking stations. - Improved wok, chopping board, steamer, and grinder runtime flows. - Added StoredItemCodec for safer stored item serialization. - Improved recipe, item source, numeric, and default value parsing. - Added PlaceholderAPI as a soft dependency. - Removed deprecated conversion and cleanup language entries.

Upgrade Notes

- Review the new config.yml interaction settings. - Retest custom stations and recipes after updating. [View Full Documentation](https://jiuwu02.github.io/Emaki_Series/) | [Join Discord Community](https://discord.gg/FV4GFQbvCM) | [QQ Group](https://qm.qq.com/q/GqGrzHp0wU)

EmakiCooking 2.2.0 Dev Update

This dev update adds ItemsAdder and Nexo custom block station support, and adds CraftEngine custom block event listeners. - ItemsAdder custom block stations: CookingBlockMatcher now supports ITEMSADDER source type (itemsadder-namespace:id). - Nexo custom block stations: new NEXO source type (nexo-block_id). - CraftEngine event listener: new CraftEngineCookingStationListener for CustomBlockInteractEvent and CustomBlockBreakEvent. - Soft dependency expansion: ItemsAdder and Nexo added to plugin.yml. - Better steamer interaction: empty-hand interaction opens the steamer GUI. - Heat source support: blast furnaces are now recognized. - Permission cleanup: Cooking permission constants are centralized with no node rename.

Upgrade Notes

No upgrade notes. [View Full Documentation](https://jiuwu02.github.io/Emaki_Series/) | [Join Discord Community](https://discord.gg/FV4GFQbvCM) | [QQ Group](https://qm.qq.com/q/GqGrzHp0wU)

EmakiCooking 2.1.0

EmakiCooking 2.1.0 keeps the current world-station cooking model focused around chopping boards, woks, grinders, and steamers. The old conversion command path has been removed, while config and language files now follow the unified version field style used across the newer Emaki suite. - Legacy import removal: /ecooking convert old dryrun|apply and the old import service are no longer part of the current runtime. - Focused commands: help, reload, and inspect hand remain the current command surface. - Unified version fields: default config and language files use version. - Current station resources: recipes continue using the current source, output, permission, and action structure. - Steamer maintenance: GUI, moisture, fuel, steam rules, and sample resources were kept aligned with the active runtime. - Runtime cleanup: settings, rewards, station state storage, utilities, and exception paths were refined.

Upgrade Notes

- Use Java 25. - Remove old conversion instructions from admin-facing docs. - Keep custom config on the version field. - Keep item and block sources on the current shorthand syntax. - Re-test each station type after upgrading. [View Full Documentation](https://jiuwu02.github.io/Emaki_Series/) | [Join Discord Community](https://discord.gg/FV4GFQbvCM) | [QQ Group](https://qm.qq.com/q/GqGrzHp0wU)

优化 | Optimize

- 运行更流畅: 减少插件频繁读写文件的次数，降低服务器CPU占用，蒸锅、研磨机等持续运行的设备，在高负载下也能更轻便 Smoother operation: Reduced the frequency of the plugin reading and writing files frequently, lowered the server CPU usage. Continuously running devices such as steamers and grinders run more lightly even under high load. - 适配新版环境: 更新了插件启动/停止的运行逻辑，解决了系统弹出的警告提示，后续也能兼容新版运行环境 Adaptation to the new version environment: Updated the running logic of plugin startup/stop, resolved the warning prompts popped up by the system, and will be compatible with the new version of the running environment in the future. - 操作更稳定: 优化砧板、炒锅、蒸锅等设备的交互体验，减少卡顿或状态出错的情况；道具展示的特效实体也更稳定，不容易出现异常 More stable operation: Optimized the interactive experience of equipment such as cutting boards, woks, and steamers, reducing stutters or status errors; the special effect entities for item display are also more stable and less prone to abnormalities. - 数据更安全: 调整数据保存方式，玩家操作、关闭界面、破坏方块等关键场景会及时保存数据，日常运行时批量保存，既减少服务器负担，又避免数据丢失 More secure data: Adjusted the data saving method. Data is saved in a timely manner in key scenarios such as player operations, interface closure, and block destruction, and saved in batches during daily operation, which not only reduces server burden but also avoids data loss. 如果存在无法运行该插件的情况，请下载最新开发版 [PySpigot](https://ci.magicmq.dev/job/PySpigot/) 以获取支持 If the plugin fails to run, please download the latest development version of [PySpigot](https://ci.magicmq.dev/job/PySpigot/) for support.

修复 | Fixed

- 修复研磨机配置文件中 Setting.Grinder.Drop 选项设为 false 时，研磨机无任何输出的问题 Fixed the issue where the grinder had no output when the Setting.Grinder.Drop option was set to false in the configuration file.

新增 | New Added

- 为炒锅新增 Drop 配置项，用于控制成品是否掉落至指定的机器位置 Added a Drop configuration item for the wok to control whether the product drops to the specified machine location. - 炒锅的 Output、RAW、BURNT 类型均支持配置为 command 选项 The Output, RAW, and BURNT types of the wok now support configuration as command options. - 为蒸锅新增 Drop 配置项，用于控制成品是否掉落至指定的机器位置 Added a Drop configuration item for the steamer to control whether the product drops to the specified machine location. - 蒸锅的 Output 类型支持配置为 command 选项 The Output type of the steamer now supports configuration as command options.

调整 | Adjustments

- 当 command 作为奖励触发时，若未找到指定玩家，将默认选取附近的玩家作为执行对象 When command is triggered as a reward, if the specified player is not found, it will default to selecting a nearby player as the execution target.

修复 | Fixed

- 修复取下物品/破坏方块后数据残留问题 Fixed the issue of data residue after taking items/destroying blocks - 修复空手右键砧板直接破坏方块问题 Fixed the issue where right-clicking the cutting board with an empty hand directly destroys the block - 修复物品偏移量过大导致无法定位物品问题 Fixed the issue where excessive item offset leads to inability to locate items

调整 | Adjusted

- 砧板/炒锅数据存储新增Input字段 (自动生成，无需手动配置)，用于精准计算物品位置 Added the Input field (automatically generated, no manual configuration required) to the data storage of cutting boards/woks for accurately calculating item positions - 重构砧板交互逻辑: 右键取物流程更合理，支持空手/手持物品两种取物场景 Refactored the interaction logic of the cutting board: the right-click item retrieval process is more reasonable, supporting two item retrieval scenarios (empty hand/holding items) - 优化方块破坏时的数据清理逻辑，确保数据100%清理无残留 Optimized the data cleanup logic when blocks are destroyed to ensure 100% cleanup of data without residue

修复 | Fixed

- 修复 "蒸锅" 配置文件中 OpenInventory 配置项内 "Slot" 被误写为 "Solt"，导致 CHEST 类型 GUI 槽位始终固定为 9 的问题 Fixed the issue where "Slot" in the OpenInventory configuration key of the "Steamer" configuration file was incorrectly spelled as "Solt", resulting in the CHEST GUI type slot always being 9 - 修复所有厨具在 v1.3.10 版本更新后，其 Minecraft 命名空间被强制转为全小写的问题 Fixed the problem that all kitchen utensils' Minecraft namespaces were forced to be lowercase after the v1.3.10 update - 修复 "蒸锅" 配置文件中 "HeatControl" 配置项在填写 Minecraft 命名空间物品时强制要求大写的问题，现已支持大小写不敏感匹配 Fixed the issue where "HeatControl" in the "Steamer" configuration file required forced uppercase when filling in Minecraft namespace items; now case insensitivity is supported

优化 | Optimized

- 优化 I/O 操作逻辑，减少文件读取频次 Optimized I/O operation logic to reduce the frequency of file reads

修复 | Fixed

- 修复了 "蒸锅" 中 "Moisture" 配置项的默认值遗漏修改问题，该问题源于往期版本更新中，先尝试移除 "minecraft" 命名空间准则后又重新强制加回的操作 Fixed the issue where the default value of the "Moisture" configuration option in the Steamer was not updated. This problem occurred because the "minecraft" namespace guideline was first attempted to be removed and then forcibly reintroduced in previous version updates.

Moisture:
  - minecraft WATER_BUCKET & minecraft BUCKET & 120
  - minecraft POTION & minecraft GLASS_BOTTLE & 40

调整 | Adjusted

- 移除了 "炒锅" 中以 "minecraft" 命名空间为核心的独立大小写兼容机制，现所有厨具的 "minecraft" 命名空间物品ID均忽略大小写限制 Removed the independent case-sensitive compatibility mechanism centered on the "minecraft" namespace in the Wok. Now, the item IDs under the "minecraft" namespace for all kitchen utensils ignore case restrictions.

修复 | Fixed

- 修复了炒锅中启用 "碗" 选项时，若使用的自定义物品其原材料也为碗，该操作会被误判为盛取食材的问题 Fixed the issue where when the "Bowl" option is enabled in the Wok, using a custom item whose ingredient is also a Bowl would be misjudged as an action of scooping ingredients. - 修复了炒锅中禁用 "碗" 选项时，空手盛取食材会取出原材料而非成品的问题 Fixed the issue where when the "Bowl" option is disabled in the Wok, scooping ingredients with bare hands would take out the ingredients instead of the finished product.

修复 | Fixed

- 修复了当展示实体存在时，所有方块被错误判定为砧板方块的问题 Fixed the issue where all blocks are incorrectly identified as cutting board blocks when a display entity is present. - 修复了炒锅中食材翻炒次数过多时，不会输出烧焦食物的问题 Fixed the issue where overcooking ingredients in the wok does not produce burnt food.

调整 | Adjusted

- 取消了炒锅中 Minecraft 命名空间物品的大小写限制，现在所有物品均可使用 Removed the case sensitivity restriction for items in the Minecraft namespace in the wok; all items can now be used.

修复 | Fixed

- 修复了当砧板奖励是Minecraft标识符物品时，不发放物品的问题 Fixed the issue where the cutting board reward does not grant items when it is a Minecraft identifier item.

添加 | Added

- 添加了错误日志，有助于更好地分析错误反馈 Added some error logs to help with better error analysis.

修复 | Fixed

- 修复了物品奖励中 CraftEngine 插件物品无法正确生效的问题 Fixed an issue where CraftEngine plugin items in rewards did not function correctly. - 修复了当玩家背包有空位时，物品奖励未进入背包的问题 Fixed an issue where item rewards were not added to the inventory despite available empty slots.

修复 | Fixed

- 修复了重载命令对新创建的蒸锅配方无效的问题<br> Fixed the issue where overloading commands were ineffective for newly created steamer recipes.

修复 | Fixed

- 修复了炒锅在烹饪失败后，未能正确输出失败品的问题<br> Fixed the issue where the wok failed to correctly output failed dishes after cooking.

新增 | Added

- 新增了对 NeigeItem 插件的支持，现在使用命名空间 "neigeitems" 便可直接使用相关功能 Added support for the NeigeItem plugin, now items can be used via the namespace "neigeitems".

修复 | Fixed

- 修复了原版命名空间物品在判定是否为工具时无法正确识别的问题 Fixed an issue where vanilla namespace items could not be correctly identified as tools.

修复 | Fixed

- 修复了因为重复注册事件导致的启动错误的问题 Fixed the issue of startup errors caused by duplicate registration events

新功能 | New Function

- 为蒸锅添加了破坏事件（此功能在上个版本中被遗漏） Added destruction event for the steamer (this feature was missed in the previous version)

修复 | Fixed

- 回滚了 minecraft 命名空间的操作 Reverted the operation on the minecraft namespace

更新日志 | Change Log v1.3

新厨具: 蒸锅 | New Kitchenware: Steamer

- 全新蒸锅厨具：新增蒸锅方块，支持蒸汽烹饪玩法，玩家可放置食材进行蒸煮<br> New Steamer Kitchenware: Added steamer block, supporting steam cooking gameplay, allowing players to place ingredients for steaming. - 热源依赖：蒸锅需要下方有热源方块 (如熔炉、高炉等) 才能启动工作<br> Heat Source Dependency: The steamer requires a heat source block below (e.g., furnace, blast furnace) to start working. - 燃料与水份管理：玩家可向热源添加燃料延长燃烧时间，并向蒸锅添加水份产生蒸汽<br> Fuel and Moisture Management: Players can add fuel to the heat source to extend burn time, and add moisture to the steamer to generate steam. - GUI 操作界面：潜行右键蒸锅打开库存界面，直观管理食材和查看烹饪进度<br> GUI Operation Interface: Sneak-right-click the steamer to open the inventory interface, intuitively managing ingredients and viewing cooking progress. - 蒸汽烹饪机制：食材通过消耗蒸汽自动烹饪，支持自定义食谱配置输入、输出和蒸汽需求<br> Steam Cooking Mechanism: Ingredients are automatically cooked by consuming steam, supporting custom recipe configurations for input, output, and steam requirements. - 状态提示系统：集成 ActionBar 实时显示燃烧时间、水份值、蒸汽量和烹饪进度<br> Status Prompt System: Integrated ActionBar to real-time display burn time, moisture value, steam amount, and cooking progress. - 兼容性扩展：支持 CraftEngine 和 MMOItems 自定义方块/物品，增强插件联动性<br> Compatibility Extension: Support for CraftEngine and MMOItems custom blocks/items, enhancing plugin interoperability.

调整 | Adjustments

现在原版物品取消了标识符 minecraft，原版物品不再需要标识符 Vanilla items no longer require the minecraft identifier; vanilla items are now identifier-free.

修复 | Fixed

- 修复了配置文件中存在的拼写错误 - Fixed spelling errors in the configuration file

功能增强 | Feature Enhancements

- 新增功能：在创建展示实体时，可通过添加自定义物品来设置独特的偏移与旋转配置。若未进行配置，则继续使用默认的 ITEM 和 BLOCK 偏移旋转设置<br> Added feature: When creating display entities, custom items can be added to achieve unique offset and rotation configurations. If not configured, the default ITEM and BLOCK offset and rotation settings are used. - 为菜板添加了延迟设置<br> Added delay settings for the choppingboard - 现在每个厨具可以拥有多个工具，不再局限于一个<br> Now each kitchen utensil can have multiple tools, not limited to one per utensil

调整 | Adjustments

- 将 Wiki 地址从 GitLab 迁移至 GitHub<br> Changed the Wiki address from GitLab to GitHub

功能增强 | Feature Enhancements

- 重构砧板与研磨机的输出奖励系统，新增执行命令奖励类型，详情请查看 Wiki 奖励页面<br> Refactored output reward system for anvil and grinder, added command execution reward type, please check the Wiki rewards page for details

错误修复 | Issues Fixed

- 修复了厨具交互时权限验证时机过早的问题<br> Fixed premature permission checks during kitchenware interactions

功能增强 | Feature Enhancements

- 新增权限系统对 OP 权限的绕过检测功能<br> Added bypass detection for OP permissions in the permission system

功能改进 | Functional improvement

- 所有配方选项均已添加权限键，现在可为每个配方单独设置权限<br> Permission keys have been added to all recipe options, allowing individual permission settings for each recipe - 为所有交互操作添加了专属权限，详情请参阅 Wiki 权限页面<br> Specific permissions have been added for all interactions, please check the permissions page on the Wiki for details - 砧板配方新增独立 Damage 选项: 若配方中包含该选项，将不再使用 Config 中的 Damage 设置<br> Added standalone Damage option to anvil recipes: when included in a recipe, it will override the Damage setting in Config - 重构砧板配方配置体系: 取消 OutputAmount 选项，改为与研磨机一致的列表式配方结构，请查看 Wiki 最新示例<br> Refactored anvil recipe configuration: removed OutputAmount option and adopted list-based recipe format consistent with the grinder, please see the latest examples on the Wiki

功能改进 | Functional improvement

- 增加了研磨机被破坏的时候将输入物掉落出来的功能<br> Added functionality for the Grinder to drop input items when destroyed - 修复了重载命令对研磨机配方无效的问题<br> Fixed the issue where the reload command did not affect Grinder recipes - 修复了炒锅在输出物品时显示正确的配方但无法正确输出成品食材以及清除展示实体的问题<br> Fixed the issue where the Wok displayed the correct recipe but failed to output the correct food products and clear display entities when outputting items 如果存在无法清除展示实体的问题，请提前告知我这个问题，我会及时的进行修复，并且会告知你使用命令 /jk clear 进行清除<br> If you encounter any issues with display entities not being cleared, please inform me of this problem in advance. I will promptly address it and advise you to use the command /jk clear for clearance.

感谢 EtingPotatos 提出的错误问题<br>

Thank you for the error issue raised by EtingPotatos

功能改进 | Functional improvement

* 修改了研磨机播放声音的逻辑，从原有的播放玩家改为当前位置播放<br> Changed the logic of grinding machine playing sound from the original player to the current position * 修改了默认配置中研磨机使用 BLOCK 粒子无法播放粒子的问题，现在改为了 GLOW 粒子，原因是因为 BLOCK 粒子需要提供粒子数据，但我没有做对粒子数据的支持<br> Changed the problem that the particle of grinding machine using BLOCK particle cannot play the particle, now it is changed to GLOW particle, because BLOCK particle needs to provide particle data, but I did not do the support for particle data

主要更新：研磨机系统 | Main Update: Grinder System

全新的研磨机现已加入厨房！可将食材研磨成粉，解锁全新食谱<br> The brand new Grinder has been added to the kitchen! Grind ingredients into powder and unlock new recipes.

核心功能 | Core Features

放入食材*：潜行+左键点击研磨机即可开始研磨<br> Add Ingredients: Sneak + Left-click the grinder to start grinding 耗时制作*：每种食材有独立的研磨时间，需要耐心等待<br> Time-Consuming Process: Each ingredient has independent grinding time, requiring patience 随机产出*：支持设置产出数量和概率，每次研磨都有惊喜<br> Random Output: Supports setting output quantity and probability, every grind brings surprises 全兼容支持*：支持原版方块 (默认砂轮) 和CraftEngine自定义方块<br> Full Compatibility: Supports vanilla blocks (default: GRINDSTONE) and CraftEngine custom blocks

配置选项 | Configuration Options

产出方式*：可配置完成后掉落或直接给予玩家<br> Output Method: Configurable to either drop items or give directly to players 交互设置*：可调整是否需要潜行状态交互<br> Interaction Settings: Adjust whether sneaking is required for interaction 检测频率*：可调整研磨进度检查的间隔<br> Check Frequency: Adjust the interval for grinding progress checks

其他优化 | Other Optimizations

* 修复了一些已知问题，提升插件稳定性<br> Fixed several known issues, improved plugin stability

温馨提示 | Friendly Reminder

更新后将自动生成 Grinder.yml 配方文件，请根据服务器特色自定义研磨食谱！<br> The Grinder.yml recipe file will be auto-generated after update, please customize grinding recipes according to your server characteristics! 祝您烹饪愉快！ Happy Cooking!

问题修复 | Bug Fixes

* 修复了炒锅在识别错误配方时未能正确消耗碗的问题<br> Fixed an issue where the Wok would not properly consume bowls when recognizing invalid recipes

代码优化 | Code Optimization

* 优化了粒子效果生成的代码逻辑<br> Optimized the code logic for spawning particle effects

问题修复 | Issues Fixed

* 修复了使用重载命令时，重载无效的问题<br> Fixed an issue where reload commands would not work * 修复了使用斧头的时候对砧板右键去皮操作后，将去皮原木破坏后展示实体无法清掉的问题，现在如果放置了食材则无法去皮原木<br> Fixed an issue where the right-click operation of the axe on the planks would not clear the entity after the planks were broken, now if the material is prevented from being chopped, the planks cannot be chopped

功能改进 | Functional improvement

* 给配置文件添加了搜索展示实体半径的功能，现在可以自己配置需要搜索展示实体的范围了<br> Added a search radius option to the config file, now you can set the search radius for entities * 添加了对方块类型的物品材料单独的展示实体配置，现在可以对方块类材料与物品类材料分别设置偏移量，旋转角度，缩放半径了<br> Added a separate configuration for block-type items, now you can set the offset, rotation, and scale for block-type items and item-type items separately * 添加了所有工具在使用的时候都会扣除 1 点耐久度的功能<br> Added a function that all tools will consume 1 durability when used

问题修复 | Issues Fixed

* 修复了碗被异常消耗的问题<br> Fixed an issue where bowls were being consumed unexpectedly * 修复了砧板与炒锅在事件交互上的一些问题<br> Fixed some issues with event interactions for cutting boards and woks

代码重构 | Code Refactoring

* 重构了整个砧板与炒锅的代码<br> Refactored the entire codebase for cutting boards and woks * 重构了整个交互事件与破坏事件的代码，为以后添加新的厨具做准备<br> Refactored all interaction and block break event code to prepare for new kitchenware additions * 删除了很多的冗余代码，提高了代码的可读性以及可维护性<br> Removed redundant code to improve code readability and maintainability * 优化了整个配置文件结构，提高了磁盘的读写效率<br> Optimized the configuration structure to improve disk I/O efficiency

新增功能 | New Features

* 为炒锅在烹饪的过程中添加了更多的动作栏消息<br> Added more action bar messages during wok cooking processes ---

注意事项 | Important Note

每一次的代码重构都会带来很多的问题，所以请遇到问题时及时联系我，以便我及时修复<br> Code refactoring may introduce new issues, please report any problems promptly for immediate fixes

功能修复 | Bug Fixes

问题修复 | Issues Fixed

* 修复了空手交互炒锅的时候无法破坏炒锅方块的问题 Fixed an issue where empty-handed interaction with the wok block failed to break it * 修复了砧板切割食材输出物品数量不对的问题 Fixed an issue where the cutting board was producing incorrect item quantities * 修复了声音无法正常播放的问题 Fixed an issue where sound effects were not playing correctly

代码重构 | Code Refactoring

* 重构了整个配置文件代码，使其更加简洁 Refactored the entire configuration system for improved simplicity

新增功能 | New Features

* 对砧板和炒锅新增了粒子效果 Added particle effects to cutting boards and woks

功能修复 | Bug Fixes

问题修复 | Issues Fixed

* 修复了厨具无法正常使用的问题 Fixed an issue where kitchen utensils were not functioning correctly

功能优化 | Feature Optimization

新增功能 | New Features

* 重构了整个 AdventureAPI 的代码 Refactored the entire Adventure API implementation

性能优化 | Performance Optimization

* 优化了部分读取磁盘的代码，现在可以不那么频繁的读取磁盘了 Optimized disk I/O operations to reduce frequent file access * 优化了部分代码体积，现在的代码没那么臃肿了 Reduced code footprint to optimize plugin performance * 增加了搜索展示实体的范围 (0.1 -> 0.25) Increased entity detection range (0.1 -> 0.25) for search operations

代码质量 | Code Quality

* 优化了整个代码结构，现在更清晰了 Improved codebase structure for better maintainability

功能优化 | Feature Optimization

配置文件优化 | Configuration File Optimization

* 修改了所有配置文件的路径，将原来的 plugins\PySpigot\configs\SimpleKitchen 改为了 plugins\PySpigot\configs\JiuWu's Kitchen Modified the path of all configuration files, changed from plugins\PySpigot\configs\SimpleKitchen to plugins\PySpigot\configs\JiuWu's Kitchen

操作优化 | Operation Optimization

* 砧板的交互与炒锅的交互，从原来的 右键点击 改为了 左键点击，炒锅信息查看从原来的 左键点击 改为了 右键点击，这样可以拥有更好的交互动作 The interaction with the anvil and wok has been changed from Right-Click to Left-Click, and viewing wok information has been changed from Left-Click to Right-Click, providing a better interaction experience

新增功能 | New Features

* 为炒锅翻炒食材增加延迟与消息 Added delay and message notifications for stirring ingredients in the wok

砧板修复 | Chopping Board Fix

错误修复 | Bug Fixes

修复了因砧板交互数据保存错误导致的交互功能异常 Fixed an issue where incorrect data storage during chopping board interaction caused functional failures

优化 | Optimizations

清除了未使用但被误导入的依赖库 Removed unused but mistakenly imported dependencies

后续更新重点 | Future Update Focus

将重点优化代码体积，减少运行时性能占用 Focus on optimizing code volume and reducing runtime performance overhead

炒锅功能更新 | Wok Feature Update!

权限系统完善 | Permission System Improvement

- 命令权限节点添加 | Command Permission Nodes Added: - /jiuwukitchen reload 新增权限节点: jiuwukitchen.command.reload /jiuwukitchen reload added permission node: jiuwukitchen.command.reload - /jiuwukitchen clear 新增权限节点: jiuwukitchen.command.clear /jiuwukitchen clear added permission node: jiuwukitchen.command.clear - 命令优化 | Command Optimization: - 移除了遗留的 test 子命令 Removed legacy test subcommand

功能完善 | Feature Improvement

- 炒锅食物掉落机制 | Wok Food Drop Mechanism: - 新增炒锅烹饪完成后的食物掉落功能 Added food drop feature after wok cooking completion - 可通过配置文件 Setting.Wok.Drop 选项控制是否启用 Can be enabled/disabled via Setting.Wok.Drop config option - 热源兼容性扩展 | Heat Source Compatibility Extension: - 炒锅热源方块现已支持 CraftEngine 自定义方块 Wok heat source now supports CraftEngine custom blocks

BUG修复 | BUG Fixes

- 物品消耗问题 | Item Consumption Issue: - 修复了炒锅中使用碗盛装食材时碗未被消耗的问题 Fixed issue where bowls weren't consumed when used to serve wok ingredients - 现在使用碗盛装成品时会正确消耗碗物品 Bowls are now correctly consumed when serving finished dishes

炒锅大更新！| WOK UPDATE!

本次更新为厨房带来全新的烹饪体验！我们隆重推出炒锅功能，让你体验更真实、更有策略的中式烹饪。以下是详细更新内容: This update brings a brand new cooking experience to the kitchen! We are proud to introduce the wok feature, allowing you to experience more authentic and strategic Chinese cooking. Here are the detailed update contents:

全新内容: 炒锅系统 | New Content: Wok System

核心功能 | Core Features

添加食材*: 现在你可以将食材放入炒锅中进行翻炒 Add Ingredients*: You can now place ingredients into the wok for stir-frying 自定义顺序*: 食材的放入顺序会影响最终成品的质量 Customizable Order*: The order in which ingredients are added will affect the final dish's quality 控制火候*: 每个食材可设置独立的翻炒次数，翻炒不足或过度将影响食物状态(如过生或烧焦) Control Heat*: Each ingredient can have an independent stir-fry count; under or over-stirfrying affects its state (e.g., too raw or burnt) 容错机制*: 可配置是否给予玩家一定容错空间，避免因轻微失误导致食物烧焦 Fault Tolerance*: Configurable option to give players some leeway, preventing food from burning due to minor mistakes 热源等级*: 每个配方可设置所需的热源等级，增加烹饪的策略性 Heat Source Level*: Each recipe can set a required heat source level, increasing strategic depth in cooking

配置选项 | Configuration Options

* 无效配方处理: 可设置当玩家使用无效配方时的默认返还食材 * Invalid Recipe Handling: Can set default ingredient return when players use an invalid recipe * 事件系统: * Event System: * 可启用/禁用炒锅烫伤玩家事件 * Enable/disable wok burning player events * 可配置概率性事件发生几率 * Configurable probability for chance-based events * 信息查看: 使用锅铲左键点击炒锅可查看锅中所有食材信息 * View Information: Left-click the wok with a spatula to view all ingredient information in the wok

通用更新 | General Updates

显示优化 | Display Optimizations

* 对砧板和炒锅的显示实体进行了视觉升级 * Visual upgrades for the display entities of cutting boards and woks * 新增Z轴随机旋转功能，每次放入食材都会产生自然随机的旋转效果，提升视觉效果 * Added random rotation on the Z-axis; each time an ingredient is placed, it generates a natural and random rotation effect, enhancing the visual experience

音效增强 | Sound Enhancements

* 新增可配置的声音选项，让烹饪体验更加沉浸 * Added configurable sound options for a more immersive cooking experience

重要变更 | Important Changes

移除功能 | Removed Features

* 不再支持CraftEngine插件的家具系统: 为确保厨具的稳定性和一致性，所有厨具都将转为方块实体形式 * No longer supports the furniture system of the CraftEngine plugin: To ensure the stability and consistency of kitchenware, all kitchen tools will be converted to block entity form

配置调整 | Configuration Adjustments

* 重构了配置文件结构: 请删除旧配置文件，重新生成新配置文件 * Refactored the configuration file structure: Please delete the old configuration files and regenerate new ones

已知事项 | Known Issues

* 炒锅的热源方块暂不支持 CraftEngine 的方块，敬请期待后续更新 * The wok's heat source block currently does not support CraftEngine blocks; please look forward to future updates * 炒锅烹饪完成的食物掉落形式尚未实装 (对应 Config.yml 中 Setting.Wok.Drop 选项) * The drop form for food completed in the wok has not yet been implemented (corresponds to the Setting.Wok.Drop option in Config.yml) 温馨提示: 为确保正常使用，请务必删除旧配置文件并重新生成！ Friendly reminder: To ensure normal usage, be sure to delete the old configuration files and regenerate new ones! 祝您烹饪愉快！ Happy Cooking!