ВЕРСИИ (51)

- 26.3 support - Improved chunk loading logics for paper 1.21.4+ - Improved resource pack optimization speed - Fixed mcmeta not generated when using bbmodels

- 26.3 support - Improved chunk loading logics for paper 1.21.4+ - Improved resource pack optimization speed - Fixed mcmeta not generated when using bbmodels

- Further optimized CraftEngine's handling logic for item packet. Now some client-bound-data will not be applied in certain scenarios, reducing Netty thread pressure without affecting any gameplay content. This is very effective for scenarios where hundreds of players are engaged in PvP simultaneously. - Fixed client bound data not applied to items in shelves on chunk packet sent

- Further optimized CraftEngine's handling logic for item packet. Now some client-bound-data will not be applied in certain scenarios, reducing Netty thread pressure without affecting any gameplay content. This is very effective for scenarios where hundreds of players are engaged in PvP simultaneously. - Fixed client bound data not applied to items in shelves on chunk packet sent

**Important** After updating to this version, please **do not roll back.** This version officially introduces the resource pack workflow design. Please be sure to update your resource pack hosting configuration. Workflows let you control when and how resource packs are generated, packaged, uploaded, and sent. They make it easier to test changes before publishing, integrate tools like PackSquash and BlueMap, and run only the steps you need, while keeping the default setup simple. - Introduced the multi-resource-pack system, resource pack preferences, and resource pack presets. - Introduced the resource pack workflow and added packsquash support. Fixed an issue where overriding vanilla components was ineffective in certain scenarios. - Connected hitboxes will be automatically optimized on the server into merged larger hitboxes, achieving exactly the same effect without affecting any mechanics. Memory usage will be lower. - Optimized CraftEngine's memory allocation on Netty in various aspects. Rewrote the chunk packet processing system; it is now 10–50% faster and uses 95% fewer temporary memory allocations. - Added 3d armor system - Added some useful options for entity culling in config.yml

**Important** After updating to this version, please **do not roll back.** This version officially introduces the resource pack workflow design. Please be sure to update your resource pack hosting configuration. Workflows let you control when and how resource packs are generated, packaged, uploaded, and sent. They make it easier to test changes before publishing, integrate tools like PackSquash and BlueMap, and run only the steps you need, while keeping the default setup simple. - Introduced the multi-resource-pack system, resource pack preferences, and resource pack presets. - Introduced the resource pack workflow and added packsquash support. Fixed an issue where overriding vanilla components was ineffective in certain scenarios. - Connected hitboxes will be automatically optimized on the server into merged larger hitboxes, achieving exactly the same effect without affecting any mechanics. Memory usage will be lower. - Optimized CraftEngine's memory allocation on Netty in various aspects. Rewrote the chunk packet processing system; it is now 10–50% faster and uses 95% fewer temporary memory allocations. - Added 3d armor system - Added some useful options for entity culling in config.yml

- Fixed an issue where players in adventure mode could accidentally right‑click a note block and inadvertently trigger the mining compensation mechanic. - Added tints and player profile support for BetterModel - Fixed some bugs with attributes on folia - Added regex support for item category - Added https://xiao-momi.github.io/craft-e.../attribute/damage-formula#post-damage-effects - https://xiao-momi.github.io/craft-engine-wiki/reference/functions#cast_mythic_skill now supports variables & parameters - Added override_data for vanilla items. You can use it to modify certain attributes of the vanilla items. For example, you may remove the attribute modifiers from vanilla armor pieces to prevent them from interfering with your custom attribute system. - Fixed Paper Adventure Component not got replaced in item name/lore - Added /ce debug item-sources/item-id - Fixed a bug in AsyncResourcePackCacheEvent - Fixed a bug in LuckPermsHook that plugin tried to submit async tasks when closing the server

- Fixed an issue where players in adventure mode could accidentally right‑click a note block and inadvertently trigger the mining compensation mechanic. - Added tints and player profile support for BetterModel - Fixed some bugs with attributes on folia - Added regex support for item category - Added https://xiao-momi.github.io/craft-e.../attribute/damage-formula#post-damage-effects - https://xiao-momi.github.io/craft-engine-wiki/reference/functions#cast_mythic_skill now supports variables & parameters - Added override_data for vanilla items. You can use it to modify certain attributes of the vanilla items. For example, you may remove the attribute modifiers from vanilla armor pieces to prevent them from interfering with your custom attribute system. - Fixed Paper Adventure Component not got replaced in item name/lore - Added /ce debug item-sources/item-id - Fixed a bug in AsyncResourcePackCacheEvent - Fixed a bug in LuckPermsHook that plugin tried to submit async tasks when closing the server

- Added https://xiao-momi.github.io/craft-engine-wiki/reference/commands/#debug-item-component - Improved how falling block works on Folia - Added entity culling support for dynamic block entity elements (Registered through API) - Fixed empty loot entry - Fixed NetworkProtocol issues caused by block tags - Fixed item name not applied on 1.20.5-1.21.4 - Fixed custom items can be traded with villagers

- Added https://xiao-momi.github.io/craft-engine-wiki/reference/commands/#debug-item-component - Improved how falling block works on Folia - Added entity culling support for dynamic block entity elements (Registered through API) - Fixed empty loot entry - Fixed NetworkProtocol issues caused by block tags - Fixed item name not applied on 1.20.5-1.21.4 - Fixed custom items can be traded with villagers

- Added https://xiao-momi.github.io/craft-engine-wiki/configuration/item/settings#prevent_break - Added JavaScript engine for functions and conditions - Fixed interaction removed by mistake - Added https://xiao-momi.github.io/craft-engine-wiki/configuration/loot_source - Added structure support for sapling block behavior - Added bbmodel support for block/item models - Optimized memory allocation for the plugin on Netty, reducing memory consumption during operations such as lore/name replacement. https://xiao-momi.github.io/craft-engine-wiki/configuration/block/behaviors/strippable_block now support custom tools and sound - Fixed <tags> not replaced in translatable components - Improved seat logics - Added https://xiao-momi.github.io/craft-engine-wiki/configuration/item/settings#drag_repair_item - Added https://xiao-momi.github.io/craft-engine-wiki/compatibility/denizen - Improved https://xiao-momi.github.io/craft-engine-wiki/compatibility/skript - Added https://xiao-momi.github.io/craft-engine-wiki/configuration/item/settings#break_power and https://xiao-momi.github.io/craft-engine-wiki/configuration/block/settings#required_break_power - The CEWorld is now injected into the CraftWorld instance, eliminating the need to look it up via a UUID map when accessing it from a Bukkit world. This can improve the world lookup performance by roughly 0.1%. - Improved FAWE compatibility with entity-renderer support - Added grindstone_repair https://xiao-momi.github.io/craft-engine-wiki/configuration/item/settings#repairable - Added https://xiao-momi.github.io/craft-engine-wiki/reference/conditions#equipment - Added https://xiao-momi.github.io/craft-engine-wiki/reference/events#transfer - Added compatibility with UniverseSpigot 26.2 under palette injection mode - Fixed a bug that some items might be eaten by the server when interacting with custom blocks based on noteblocks on 1.21.2+ - Implemented async chunk loader and saver - Improved chunk cache storage performance ~70% faster than before - Fixed custom block destruction overlays not cleared for nearby players - Fixed methods that get eye position not correct since an update on 2026/2/10 - Added blacklist worlds for chunk storage - Fixed custom blocks in spawn chunks sometimes not loading - Added linear region format and it will be used as the default format in future versions - Fixed custom block not getting waterlogged when placed in water - Fixed client bound data not applied to toasts on 26.1+ - Added humanoid_baby equipment layer for 26.1+ - Added command to clear outdated world storage - Added /ce resource search command to search the resource path - Added tag expanding support for block tags - Fixed head component doesn't have layer - Rewrote MiniMessage with my own custom implementation. The parsing speed is now 0.8× to 11× faster than the original, depending on the use case. In all the CraftEngine test cases I designed, it consistently achieves a 1.2× to 2.1× performance improvement. Optimized the expression system by adding extensive pre-parsing and expression caching, while also resolving several potential thread-safety issues in the computation logic. - Added equipment potion effect - Added experimental custom attribute system

- Added https://xiao-momi.github.io/craft-engine-wiki/configuration/item/settings#prevent_break - Added JavaScript engine for functions and conditions - Fixed interaction removed by mistake - Added https://xiao-momi.github.io/craft-engine-wiki/configuration/loot_source - Added structure support for sapling block behavior - Added bbmodel support for block/item models - Optimized memory allocation for the plugin on Netty, reducing memory consumption during operations such as lore/name replacement. https://xiao-momi.github.io/craft-engine-wiki/configuration/block/behaviors/strippable_block now support custom tools and sound - Fixed <tags> not replaced in translatable components - Improved seat logics - Added https://xiao-momi.github.io/craft-engine-wiki/configuration/item/settings#drag_repair_item - Added https://xiao-momi.github.io/craft-engine-wiki/compatibility/denizen - Improved https://xiao-momi.github.io/craft-engine-wiki/compatibility/skript - Added https://xiao-momi.github.io/craft-engine-wiki/configuration/item/settings#break_power and https://xiao-momi.github.io/craft-engine-wiki/configuration/block/settings#required_break_power - The CEWorld is now injected into the CraftWorld instance, eliminating the need to look it up via a UUID map when accessing it from a Bukkit world. This can improve the world lookup performance by roughly 0.1%. - Improved FAWE compatibility with entity-renderer support - Added grindstone_repair https://xiao-momi.github.io/craft-engine-wiki/configuration/item/settings#repairable - Added https://xiao-momi.github.io/craft-engine-wiki/reference/conditions#equipment - Added https://xiao-momi.github.io/craft-engine-wiki/reference/events#transfer - Added compatibility with UniverseSpigot 26.2 under palette injection mode - Fixed a bug that some items might be eaten by the server when interacting with custom blocks based on noteblocks on 1.21.2+ - Implemented async chunk loader and saver - Improved chunk cache storage performance ~70% faster than before - Fixed custom block destruction overlays not cleared for nearby players - Fixed methods that get eye position not correct since an update on 2026/2/10 - Added blacklist worlds for chunk storage - Fixed custom blocks in spawn chunks sometimes not loading - Added linear region format and it will be used as the default format in future versions - Fixed custom block not getting waterlogged when placed in water - Fixed client bound data not applied to toasts on 26.1+ - Added humanoid_baby equipment layer for 26.1+ - Added command to clear outdated world storage - Added /ce resource search command to search the resource path - Added tag expanding support for block tags - Fixed head component doesn't have layer - Rewrote MiniMessage with my own custom implementation. The parsing speed is now 0.8× to 11× faster than the original, depending on the use case. In all the CraftEngine test cases I designed, it consistently achieves a 1.2× to 2.1× performance improvement. Optimized the expression system by adding extensive pre-parsing and expression caching, while also resolving several potential thread-safety issues in the computation logic. - Added equipment potion effect - Added experimental custom attribute system

- When generating JSON for resource packs, a more ordered scheme is now adopted to reduce the compressed JSON file size. - Now `slot` is optional in `equipment` settings - Fixed trim type armor on 1.21.2+ - Added new template syntax `${arg^}` and `${arg^^}` - Added [Shapeless Transform Recipe](https://xiao-momi.github.io/craft-engine-wiki/configuration/recipe/#shapeless-transform-recipe) - Added [Ingredient Predicate](https://xiao-momi.github.io/craft-engine-wiki/configuration/recipe/#predicate)

- When generating JSON for resource packs, a more ordered scheme is now adopted to reduce the compressed JSON file size. - Now `slot` is optional in `equipment` settings - Fixed trim type armor on 1.21.2+ - Added new template syntax `${arg^}` and `${arg^^}` - Added [Shapeless Transform Recipe](https://xiao-momi.github.io/craft-engine-wiki/configuration/recipe/#shapeless-transform-recipe) - Added [Ingredient Predicate](https://xiao-momi.github.io/craft-engine-wiki/configuration/recipe/#predicate)

- Fixed optimize-item-codec bugs in some cases

- Fixed optimize-item-codec bugs in some cases

- Fixed folia compatibility broken since last update

- Fixed folia compatibility broken since last update

- Allows you to register your own custom protection implementation - Added /ce feature toast - Added totem_animation function - Fixed issues with loading super large pack versions - Improved s3 host with more optional parameters - Compatibility with servers have Lithium mod patches

- Allows you to register your own custom protection implementation - Added /ce feature toast - Added totem_animation function - Fixed issues with loading super large pack versions - Improved s3 host with more optional parameters - Compatibility with servers have Lithium mod patches

- Added 26.2 support, requires paper 26.2#build40+ - Added custom break stages system - Added Axiom custom display item support

- Now you are allowed to create block models with a texture list - Fixed plugin not enabling in some special classloaders - Fixed data version not saved in some furniture/block behaviors

- Fixed an issue where the vanilla_loots syntax was not taking effect. - Fixed the default spear configuration recipe loading on versions below 1.21.11.

- Added spawn_light_requirement for crop_block - Improved the compatibility of custom block hardness with other plugins - All colors now support hex format - All numbers now support expressions - Added spear and mace model generation

- Added `shaped_transform` recipe type - Introduced config factory - Default pack has been divided into three packs default_templates default_assets and default_feature_populator - Improved how furniture transformation works. Now it won't flicker when variant changes - Bug fixes

- Getting ready for the upcoming release of the CraftEngine proxy. - Added `test_flag` condition - Added conditions option for `range_mining_item`

- Added a command to individually configure certain world settings - Added automatic IP retrieval for self-host - Fixed some bugs

- This version fixes numerous bugs present in the initial release of 26.5. - Additionally, we have introduced a brand-new projectile system—please check the [wiki](https://xiao-momi.github.io/craft-engine-wiki/configuration/item/settings/#projectile) for details.

## CraftEngine 26.5 – A Big Update! This is a major update for CraftEngine. From now on, versions will follow a `year.month.revision` format. We’ve made over 80,000 lines of code changes and more than 600 commits, so instead of a long changelog, please check the wiki to see what’s new. ## A few important things to know: - `stem_block` now has a filter for the block below it. Check the [wiki](https://xiao-momi.github.io/craft-engine-wiki/configuration/block/behaviors/stem_block) to update your settings, or use the new default config to fix melon stem issues. - The feature placer changed a lot back in version 26.1. If you want to keep using the default feature config, please extract the updated default config file. - There are many API changes in this update – and they’re stable enough to support updates for the next whole year. ## Need help updating? If you have an open-source project that needs to work with the latest CraftEngine, or a plugin that works with the old version but not the new one – we’re happy to help for free. Just reach out on GitHub Issues or Discord.

New Features: - Added support for Minecraft version 1.21.11. - Introduced the Feature Placer, enabling the generation of trees, ores, features, and more in the world. - Added a wide range of external item sources. - New block behaviors: `multi_high_block`, `item_frame_block`, and `spreading_block`. - New item behavior: `range_mining_item`. - Added numerous new number types. - New condition: `is_bedrock_player`. - Added furniture setting: `hit-times`. - Added image of type `reference`. - Added `profile` item data type. - Added debug command: `/ce debug auto-state` Optimizations & Improvements: - Allowed folder format usage in the `exclude` option for optimizing resource packs. - The glow color feature is now fully packet-based. - Completely revamped and standardized the language file format. - Network text formats now fully support parameter passing. - The image tag now supports custom format parameters. - Optimized potential block mining interruption issues under high latency. - Furniture display elements now support the `conditions`. - Enhanced how `client-bound-models` work on armor. - Optimized Atlas merging logic. - Added legacy color code support to certain configuration areas. - When using simple model generation, default values are now set for tintable items. - Component-based armor now supports custom paths. Bug Fixes: - Fixed compatibility issues with ASP on certain versions. - Fixed potential thread safety issues with ClientCustomBlockPacket in version 1.20.1. - Fixed various issues caused by NPC-triggered events. - Fixed issues with object text component processing. - Fixed NullPointerException caused by other plugins modifying the system proxy. - Fixed various issues on Folia servers. - Fixed an issue in versions 1.20 to 1.20.2 where returning multiple resource packs would result in only the last one being applied. - Fixed concurrent modification exceptions during lighting updates. - Fixed issue where HashedStack unexpectedly broke container components. - Fixed errors caused by other plugins sending packets at incorrect times. - Fixed issue where block entity changes did not mark the chunk as dirty. - Fixed incorrect collision box positioning for furniture of `custom` type. API Changes: - Most factory classes now require a generic parameter. Reduced visibility for most factory classes. - `ItemDataModifier` has been renamed to `ItemProcessor`. - Added the `craft-engine-adventure` API module for easier use of the relocated Adventure library. - Merged the loot condition system with the event condition system. - Added EntityCullingAPI. - Custom item settings now support configuring ItemProcessor.

- Fix the issue where, in extremely rare cases, custom blocks from datapacks fail to be applied in one chunk due to asynchronous paper chunk generation. - Fixed some translateable components not displaying correctly on 1.20.2-1.21.4 - Added debug optimize-furniture-structure command to optimize the furniture saved in structure nbt files - Added some methods to improve compatibility with plugins that using old furniture API

New Features: - Refactored the furniture system, including some API changes, introducing furniture variants and ray tracing, while adding more furniture rendering element types and options. - Simplified model texture configuration for some common items. - Improved the order of tintable leaves in auto-state allocation. - Enhanced snbt reading logic. - Improved block entity state switching logic to effectively reduce visual issues. - Enhanced template value parameter types, default values, and related processing logic. - Added entity culling feature for better client performance. - Added command to control entity rendering distance. - Added strict UUID verification and intelligent download rate limiting for self-hosting. - Added new function types: `set_exp`, `set_level`, `play_totem_animation`, `close_inventory`, `clear_item`, `if_else`, `when`, `damage_item`, `cycle_block_property`. - Added new condition type: `inventory_has_item`. - Added new item settings: `hat-height`, `keep-on-death-chance`, `destroy-on-death-chance`, `drop-display`, `glow-color`. - Added new item behaviors: `liquid_collision_furniture_item`, `ceiling_block_item`. - Added new smithing recipe post-processor: `keep_custom_data`. - Added new block behavior: `drop_exp_block`. - Added category display conditions and all-item categories. - Added `custom-model-data/image` debug command. - Added `item clear` command to remove CraftEngine items. - Added `%checkceitem_%` placeholder variable. - Added more direct datapack generation support, allowing direct calls to CraftEngine block IDs and generating multi-state blocks. - Added support for Z-axis rotation in block models and removed the 90-degree limit. - Added hardcoded property name `rotation` to support creating 8-16 directional blocks like banners. - Added `to-inventory` parameter to support `drop-loot` directly dropping into inventory. Bug Fixes: - Fixed issue where messages from some chat plugins could not apply custom image tags. - Fixed errors caused by interacting with seat block behavior after reloads. - Fixed issue where sometimes container doors in `simple_storage_block` could not close properly. - Fixed issue where server spawn chunks did not correctly apply datapack custom blocks. - Fixed issue where `consume-replacement` could not properly handle stacked items. - Fixed startup errors caused by other plugins holding custom disc items. - Fixed mining interruption issues caused by other plugins. - Fixed incorrect eye height retrieval while riding entities. - Fixed issues with ModelEngine block entity rendering.

New Features: - Enhanced interaction experience with improved handling for various scenarios - Added support for various resource pack features in 1.21.9+ - Implemented various text component support for 1.21.8+ - Added `ingredient-substitute` option to allow custom items to equivalently replace vanilla items in vanilla recipes - Added `client-bound-data/material` support for shulker boxes, bundle bags, and block entities - Added `block-state` item data type to improve block placement experience - Added `transparent` parameter for quick transparent model generation - Improved `auto-state` parameters with ID assignment for consistent results - Added magma plant example - Added `disable-item-operations` option in config.yml for network optimization - Added `default-material` configuration option in config.yml - Model sections now support direct file path specification - Added `deceive-bukkit-material` option in config.yml - Added `shadow-radius` and `shadow-strength` options for furniture and entity rendering - Synced internal assets for 1.21.10 - Added `has_player` condition type - Added `visual-result`, `functions`, and `conditions` support for smithing recipes - Added `craft-remainder` option for items - Added `l10n` tag for packet-level translation - Command feedback now uses l10n system with personalized responses per player locale - Added `merchant_trade`, `remove_entity`, `update_block_property`, and `transform_block` functions - Added `pick_up` trigger for items - Added extended YAML value format - Added `item` chain parameter for `entity` - Added `tintable/non-tintable leaves` for auto-state option - Added `if_else` and `when` conditions - Added `optimization` section for resource pack in config.yml - Added `seat_block` behavior Optimizations: - Improved auto ID allocation speed (reduced from 3-5ms to 0.5ms in test environment) - Optimized network performance for chunk data remapping (~30% faster) - Optimized network performance for text component replacement in 1.20.2+ (~15% faster) - Enhanced `visual result` and `functions` handling for shift clicks in crafting/smithing - Comprehensively optimized crafting-type recipe efficiency by avoiding Bukkit API mirror objects - Improved performance of updating lights during chunk loading - Enhanced seat functionality for furniture Bug Fixes: - Fixed `sounds.land` not being triggered after 0.0.63.8 update - Improved merging of legacy override-based models - Fixed custom payload network issue on 1.21.8+ - Fixed crafter block outputs visual results incorrectly - Fixed other components not applying when using `visual-result` for smithing recipes - Fixed condition bypass issue when both `conditions` and `visual-result` were enabled - Added validation for equipment textures and sounds - Improved compatibility with UniverseSpigot 1.21.8+

- Fixed `reed` not properly loaded since the previous update - Fixed sha256 not generated for some s3 host providers

Celebrating the release of v0.0.63! 🎉 This version introduces the concept of block entities for the first time. However, I sincerely apologize that the furniture refactoring originally planned for v0.0.63 has been postponed to v0.0.64. After the comprehensive furniture refactoring in v0.0.64, I expect to launch the second part of the block entity update in v0.0.65. Please note that the current tick functionality of block entities does not work properly on Folia, and block entity rendering is incompatible with FastAsyncWorldEdit operations. These issues will be addressed and improved in v0.0.65. New Features - Added block behaviors: `change_over_time_block`, `simple_storage_block`, `toggleable_lamp_block`, `bouncing_block`, `liquid_flowable_block` - Added item behavior: `wall_block_item` - Added block entity types: `simple_storage`, `simple_particle`, `wall_torch_particle` - Added visual recipe result options - Added Gaussian distribution number type - Added `max-damage` item data - Added block settings: `friction`, `jump-factor`, `speed-factor` - Added `worldguard:region` condition type - Added function types: `teleport`, `toast` - Added default configurations: `safe_block`, `amethyst_torch`, `sofa` - Added option for strict player UUID validation Bug Fixes - Fixed errors caused by `keep_components` in smithing recipes - Fixed player head item display errors for clients below 1.21.4 during obfuscation - Fixed model display issues for block-based items for clients below 1.21.4 during obfuscation - Fixed block sounds not emitting from the center of the block in some cases - Fixed missing recipes for default configuration palm door - Fixed mismatched keys in some language files - Fixed `BlockBreakEvent` still dropping vanilla loots when item drops were cancelled by other plugins - Fixed incorrect matching of `onPlace` in block behaviors for some versions - Fixed model generation errors when using `item_model` component in specific paths on version 1.21.2 - Fixed potential death from falling anvil issues with netherite anvils - Fixed `concrete_block` not solidifying immediately upon contact with liquid surfaces - Fixed issues with using `minecraft:component` properties in `minecraft:condition` type item models - Fixed errors when using workbench to repair tools on 1.20-1.20.4 Optimizations - Optimized server-side item placement handling when players click the recipe book - Optimized chunk and world read/write performance and thread safety - `<global>` now supports use in other plugins - Slightly adjusted the position of some options in `config.yml` - Improved random ID generation logic for `attribute-modifiers` - Improved the `enchantable` option, now also prevents items from being enchanted on anvils - Improved the `command` function, added `as-event` and `as-op` options - Improved the `match_block_property` condition to support vanilla block state matching - Improved judgment logic for `liquid_collision_block_item` - Improved lighting system tick logic, added option for asynchronous lighting updates - Improved `external-item` construction logic, detecting potential circular build issues - `category` now supports adding duplicate item IDs Compatibility & Integration - Added item source support for: `Zaphkiel`, `Slimefun`, `SX-Item`, `HeadDatabase` - Compatible with the latest `lobfile` API - Re-compatible with MythicMobs item generation to support variable parsing Refactoring & API - Refactored the client mod, please update your client mod and server plugin promptly - Refactored the recipe system for higher performance and more accurate judgment (the only drawback is that all recipe performance consumption will be counted as generated by this plugin in `spark` :<) - Reorganized the file structure of default configurations for better clarity - Strictly divided dependency scope class loaders to avoid non-API related libraries being referenced by other plugins - Added `isFirstReload` method to `CraftEngineReloadEvent` - Added methods to `CraftEngineBlocks/Items/Furniture` to retrieve all loaded configurations - Added APIs for block entity rendering, ticking, and storage - Added `AsyncResourcePackCacheEvent` to support other plugins caching their own resource packs in CraftEngine and participating in resource pack generation

This version is the last stable release prior to the "Furniture Refactoring and Block Entity" update. It primarily includes several major bug fixes and minor feature updates. New Features - Added default examples for chessboard blocks - Added compatibility with fake players from the Leaves server - Added overwritable-item-name and overwritable-lore features - Added direct PDC (Persistent Data Container) data type support - Added item updater functionality Bug Fixes - Fixed an issue where the unbreakable data type was not working properly - Fixed an error caused by the smithing table post-processor - Fixed an issue where the client-bound-model of items could not override global settings - Fixed a network protocol error caused by the global palette - Fixed an issue where the function to remove vanilla recipes stopped working after the recipe refactoring in version 0.0.61 - Fixed display issues for Endermen holding custom blocks and custom block minecarts - Fixed an issue where stackable method updates did not send block update packets to nearby players - Fixed errors caused by WorldEdit usage during the startup phase by some plugins - Fixed dropbox cache writing issues Optimizations - Adjusted the model orientation of flower baskets in the default configuration - Updated the wiki links in the comments of config.yml - Improved ID matching for namespaces when using get/give commands - Added pre-parsing for item names and descriptions to improve overall item construction performance - Improved handling of mining speed with incorrect tools - Improved GUI click performance

New Features - Added support for 1.21.8 - Added brewing recipe UI - Allowed using items from other plugins in recipes - Added tag support in item settings `correct-tools` - Added recipe result post-processor - Added `double_high_block_item` item behavior - Added lore data for items with separator and custom priority support - Added MythicMobs skill casting support - Added recipe option `show-notification` to control recipe discovery messages - Added support for using craftengine items in vanilla datapacks Bug Fixes - Fixed craft-remaining-item not working in crafter - Fixed incorrect recipe results showing in crafter - Fixed Folia-related exceptions when giving items - Fixed double-block placement on snow - Fixed rare cases of client-bound-data/material handling - Fixed interactions between certain items and entities Optimizations - Improved hide-tooltip implementation logic - Added resource pack language file merging functionality - Improved the speed of reloading recipes ## ⚠️ Important Compatibility Changes In the 0.0.61 update, we introduced the `double_high_block_item` behavior to fix some weird behaviors when placing double high blocks for instance doors. To fix that just replace the `block_item` with `double_high_block_item`.

New Features - Added support for 1.21.7 - Added Russian (ru_ru) localization - Added new item data types: attribute-modifiers and hide-tooltip - Implemented trim based custom armor support (compatible from 1.20 to latest) - Added brewing and smithing_trim recipe types - Added warnings for unset template parameters - Added client-bound-data support for advancements and recipe books - Added vanilla item model override support - play_sound function now supports target selectors Bug Fixes - Fixed world generation failing to correctly detect fluids - Fixed compatibility issues with the latest BetterModel - Fixed explosion-related processing errors - Fixed select-type models incorrectly accepting non-matching parameter types - Fixed block lighting issues in versions 1.20–1.21.1 - Fixed block/item ID mismatch causing key retrieval errors in 1.20–1.21.3 - Fixed button interactions sometimes failing and incorrectly placing blocks - Fixed pressure plates not updating signals properly after breaking in 1.20–1.21.4 - Fixed creative mode breaking top doors dropping incorrect items - Fixed client block tags being erroneously updated due to recipe reloading - Fixed item frame entity data ID mismatch in 1.21.6–1.21.7 Optimizations - Resource pack validator is now 200% faster - Optimized resource pack sending system ## ⚠️ Important Compatibility Changes In the 0.0.59.9 update, we introduced the smithing_trim recipe type. Because of this, some existing armor sets (like the default topaz set) now need the minecraft:trimmable_armor tag—otherwise, they won’t work with the smithing table for applying armor trims after this update. ```diff templates: default:armor/topaz: material: chainmail_${part} custom-model-data: 1000 data: item-name: <!i><#FF8C00><i18n:item.topaz_${part}> tooltip-style: minecraft:topaz settings: tags: - default:topaz_tools + - minecraft:trimmable_armor equipment: asset-id: default:topaz $$>=1.21.2: slot: ${slot} model: template: default:model/armor_trim ``` We've added checks for missing template parameters in this update, so you might see some console warnings now. No worries though – just set default values for your templates or provide the missing parameters, and the warnings will go away. ```diff appearances: type=top,waterlogged=false: state: ${base_block}[type=top,waterlogged=false] model: path: ${model_top_path} - generation: ${model_top_generation} + generation: ${model_top_generation:-null} ```

New Features - Added support for special model type player_head - Added resource pack atlas validation function; console will now display missing texture warnings - Added German localization file (Thanks to TamashiiMon for the contribution) - Expanded equippable component to support more equipment_layer types - Implemented support for "::" region separator syntax in YAML files - Added debug option to view configuration files after template application - Added support for dyed firework star furniture Bug Fixes - Fixed false positives in texture existence checks caused by unapplied atlas paths - Fixed incorrect application of equippable component in plugins for versions 1.21.2-1.21.3 - Fixed abnormal operation of Folia delayed scheduler - Fixed smithing transform recipe not being registered in version 1.20.1 - Fixed furniture still being dyed when dye application was disabled - Completely fixed waterlogged block behavior during piston movement; now achieves 100% vanilla parity Optimizations - Refactored resource pack obfuscated atlas generation algorithm - Optimized block behavior handling logic through BlockState injection - Refactored block drop system; now directly injects server-side logic instead of Bukkit events - Improved default value parsing rules for template parameters Changes - Removed deprecated blockstates.yml configuration file - Improved merge logic for JSON files under blockstates (now intelligently merges instead of overwriting) ## ⚠️ Important Compatibility Changes **Door Block Drop Configuration Update** Default plam_door configuration in v0.0.58 contained flaws. To avoid double drops, you must add and reference the new template: ```yml default:loot_table/door: pools: - rolls: 1 entries: - type: item item: ${__NAMESPACE__}:${__ID__} conditions: - type: match_block_property properties: half: lower ``` **Head Model Configuration Migration Guide** Due to rendering changes in 1.21.6, update old configurations as follows: ```diff model: - type: minecraft:head - kind: player + type: minecraft:player_head ```

New Features - Added support for **Minecraft 1.21.6** - Implemented **happy_ghast** collision type - Added **Redstone API** for custom signal sources - Introduced **spectral arrow-based custom arrows** - Added new block behaviors: - `trapdoor_block`, `door_block`, `fence_gate_block` - `slab_block`, `stairs_block`, `pressure_plate_block` - `sturdy_base_block`, `stackable_block` - New item settings: - `compost-probability` (composting chance) - `oversized-in-gui` (1.21.6+) - `hand-animation-on-swap` (hand animation when swapping) - `color-when-undyed` (default color for undyed items) - Added YAML **version conditional syntax** (e.g., `"$$>=1.20"`) - Resource pack enhancements: - `resource-pack.exclude-core-shaders` option - Improved handling of hidden directories (ignores `.prefix` folders) - Added configurations for: - Palm wood based doors, trapdoors, stairs, slabs, fence_gate, pressure_plate - Cap - Pebble blocks - Custom tridents (1.20-1.21.3) Improvements - Enhanced `waterlogged` block behavior: - Now works properly with dispensers - Fixed visual glitches - Optimized `migrate-templates` command - Sound options now support value ranges (e.g., `volume: 0.9~1.0`) - Template system upgrades: - Unspecified parameters now return `null` instead of parameter names - Fixed `map` type parameter shortcuts - FAWE compatibility: - Fixed `mask` application issues - Linux support: - Added symbolic link resolution Bug Fixes - Fixed projectile-related issues from previous optimizations: - Custom arrows not functioning - Loyalty tridents missing return animation - Eliminated console warnings for vanilla loyalty tridents - Fixed block lighting issues (1.20-1.21.1) - Corrected barrier item ID display issues in /ce GUI (1.20.1-1.20.4) - Fixed `strippable_block` behavior in 1.21.5+: - Now properly recognizes offhand items with `block_attack` component - Resolved Folia chunk loading issues: - Furniture collision volumes now initialize correctly - Addressed `client-bound-data` problems in 1.21.5+: - Fixed client-side cursor item desync - Corrected enchantment table option synchronization - Fixed template parameter parsing edge cases - Resolved JSON formatting causing resource pack validation failures

Bug Fixes - Fixed flint and steel making no sound when igniting custom blocks. - Fixed interaction priority issue with decorated_pot when used by items with block_item behavior. - Fixed plugin compatibility issues caused by Paper's plugin classloader isolation. - Fixed hard collision not affecting other entities in 1.20.1-1.20.6. - Fixed right_click events not triggering when interacting with entities. - Fixed furnace failing to use correct recipes when conflicting with vanilla recipes. - Fixed NPE in Skript expressions when referencing non-existent IDs. - Fixed block break state sync conflicts with some NPC plugins. New Features - Added new item settings types: `invulnerable`, `craft-remaining-item`, `consume-replacement`, `food`((for 1.20.1-1.20.4)). - Added `client-bound-material` option for items. - Added new item data types: `dyed-color` - Experimental Resource Pack Validator (checks for missing textures/models). - YAML parser now detects and reports duplicate keys with their line numbers (helps debug config errors). - Optimized network performance by reducing packet count for custom projectiles. - Optimized packet handling for custom block lighting. - Added MythicMobs drops/items support Improvements - Improved item construction speed by fully bypassing Bukkit API. - Refactored the template system to make it more powerful - Ensured thread-safe for furnace recipe handling - Optimized config reload system - now completes `/ce reload` in 5ms (tested on i9-13900K) ## ⚠️ Breaking Changes You Must Know New Template Syntax: Changed parameter format to `${param:-default}` (adds $ prefix and supports :-default_value) Migration is Required: Run `/ce debug migrate-templates` to convert existing template configs **Note: Migration isn't perfect - minor errors may occur with "{}" formatted config sections (should be easy to fix manually)** We apologize for the config format change caused by previous design limitations

Bug Fixes - Resolved null pointer exception when interacting with custom cactus-based blocks using empty hand - Corrected improper relocation path for imaging libraries - Added template and example configuration files for custom elytra implementation New Features - Removed dependency on Ignite mod - CraftEngine now functions as a standalone solution Changes - Fabric mod module will be migrated to a dedicated repository to ensure comprehensive version support

- Fixed error handling ClientboundSetPlayerInventoryPacket - Fixed FAWE issues on incompatible FAWE versions - Fixed DropBox not working in some cases - Fixed `right_click` event lacking `position` argument - Fixed 1.21.5 ignite mod

Breaking API Changes: - CustomBlock and CustomFurniture classes have been converted to interfaces. - LoadedFurniture in the craft-engine-bukkit module has been renamed to BukkitFurniture and now implements the Furniture interface. Breaking Configuration Changes: - Due to the new support for combined block behaviors, default configurations will be affected by this update. sugar_cane_block has been replaced with vertical_crop_block. For detailed default configuration changes, please refer to this commit: [3128fe3](https://github.com/Xiao-MoMi/craft-engine/commit/3128fe355122e2856fb5727fcccc4b68f35cf14d). Fixed Bugs: - Fixed client-side light remaining after breaking certain custom blocks. - Fixed collision shapes not syncing with the client for some block types (e.g., cactus). - Reimplemented self-host using Netty for improved stability. - Fixed custom projectiles in always-loaded chunks not applying models correctly after restart. - Fixed custom block tags causing water blocks to lose gravity and lava to appear as water in 1.20.5-1.21.1. - Fixed torches and similar blocks placed on furniture breaking immediately (furniture was not designed to have support shape). - Fixed container opening issues in early Paper 1.21.4 builds. - Fixed replaceable blocks being able to replace themselves. - Fixed debug stick not functioning properly. New Features: - Added support for combined block behaviors, allowing creation of new block types through customization. - client-bound-data no longer requires server-side mods and now supports <arg> and <papi>. - Enhanced <global> variable functionality, now supporting parameter passing within tags. - <image> can now be used with other items and won't cause irreversible item corruption in creative mode (not guaranteed to work with ViaVersion). - Added support-shape block setting. - Added lamp_block behavior and redstone-related APIs. - Added more condition and function types. - Shift-clicking in the CE menu now directly gives items. - Any item can now be used as a totem animation (requires 1.21.2+). - Added legacy-model configuration for resource pack models compatible with 1.21.3 and below. - Added support for merging external ZIP resource packs. - Added blacklist for file extensions during resource pack merging. - Refactored dependency downloads to further reduce plugin size. - Added default configuration for copper_coil. - Added blacklist configurations for bush_block and hanging_block.

- Introduced a memory-based resource pack generation system instead of a real file system, achieving approximately 300% faster pack generation speed. - Implemented configuration file caching, improving configuration loading speed by approximately 20% compared to before. - Added custom projectile item setting - Improved item model generation for 1.21.2 - Added an option to allow dye recipes for some items - Added original item storage for furniture - Implemented custom data API for furniture - Added client bound block tags for vanilla blocks - Fixed item components not loaded on 1.20.5-1.20.6 - Refactored context system again

- Added full FAWE (FastAsyncWorldEdit) compatibility. - Removed the deprecated delayed-serialization option, now replaced by the new cache-system. - Added configurable injection method—choose between LevelChunkSection or Palette. - Improved dependency management—dependencies are now downloaded only when required. - Added full 1.21.5 component support - Fixed team packet handling on 1.21.5 - Fixed using bone meal with dispenser on 1.21.5 - Fixed middle clicks on 1.21.5 - Fixed chunk data desync - Refactored context system - Block entity system implementation

- Optimized chunk system again by implementing fast injection and dirty flags. - Added warning logs for potential errors in most configuration files to improve debugging. - Resolved CraftBukkit compatibility issue caused by block-entity-based custom blocks. - Fixed sound mappings generation by handling duplicate sound keys properly. - Added grass_block behavior

- Improved chunk system performance by introducing a cache system - Added Skript support - Added legacy AdvancedSlimePaper support of 1.20-1.21.3 - Some small bug fixs and improvements

- Refactored item sytem for the thrid time to make item operations faster. - Fixed some known bugs. See github commits for more.

- New hosting system - Better furniture system

**New Features** - Better adventure mode experience - Client bound item data **Format Changes** https://mo-mi.gitbook.io/xiaomomi-plugins/craftengine/plugin-wiki/craftengine/misc/config-format-changelog#id-0.0.48