# CustomCrafting v5 Alpha 4 v5 is a complete rewrite and redesign of the entire plugin and recipe structure. It adds features and improvements that were not possible in v4. In recent times, Minecraft has changed a lot, new modding/plugin platforms have emerged or separated themselves from their original project. It's now a major task to make plugins/mods work across various platforms, each with their own different API. With the [removal of obfuscation](<https://www.minecraft.net/en-us/article/removing-obfuscation-in-java-edition>), using and building against the Minecraft internals has become way easier. It is for that reason that with v5 CC focuses on building features on top of the Minecraft internals instead of platform-specific APIs. To keep compatibility, the goal of v5 is to integrate into each platform as best as possible (like Events, Listeners, Third-party Plugins/Mods), while keeping most of its codebase platform-agnostic. That is where scafall comes in. [Scafall](https://github.com/WolfyScript/scafall/releases) allows for the creation of cross-platform APIs, which other mods and plugins may use, and makes it easier to link platform-specific implementations together. However, all of this comes with a variety of new challenges, so going forward, CustomCrafting will only support the latest Minecraft version! #### TLDR * CustomCrafting v5 builds features on top of Minecraft internals directly * **Only supports the latest Minecraft version** * **Requires the scafall library/mod** [See releases here](https://github.com/WolfyScript/scafall/releases) * Provides a cross-platform API # Brand-new Wiki With the release of v5 on Modrinth comes a brand-new wiki, available at: https://wolfyscript.github.io/CustomCrafting/ The new wiki provides many visual improvements and is managed using git now, making it easier to maintain than the old GitHub wiki. # Fabric Server Support v5 introduces support for Fabric servers. Server-side-only mods allow vanilla clients to connect to the Fabric server, so similar to Spigot, players don't need to install any client mods. The Fabric implementation provides many benefits compared to the Spigot/Paper implementation. It integrates custom recipes that have a vanilla counterpart directly into the vanilla recipe mechanism, this means better integration with existing mods and improved recipe book support. # Separate Paper Version Starting with this update, there is going to be a separate customcrafting and scafall jar file for paper specifically. If you are using Paper, you should use that to benefit from the improvements and extra features. Currently, that extra includes only the Stonecutter recipe support, which is missing in the Spigot version. # New Features v5 introduces some major overhauls to the resource loading and recipe structure. ## Configure Resources and Load Order Sources define where resources are loaded from (Local directory, H2, SQLite, MySQL, etc.). Backup destinations define where backups will get saved when created. (local directory or zip file) ## New & Improved Recipes v5 expands the functionality of all recipe types. Especially the ones that had a bit of a lacklustre feature set in v4. > **Tip** > This version adds some default recipes that showcase some of the new features. > They'll get loaded on startup and can be found [here in the v5 branch](https://github.com/WolfyScript/CustomCrafting/tree/v-5/core/api/src/main/resources/com/wolfyscript/customcrafting/resources/default/recipes) ### Improved Anvil Recipes * Rename Options (formatted, pre and suffix, cost, repair cost) * Durability Combination Options (bonus, ratio combination) * Item Repair Options (cost per item, enchants) * Enchanting Options (preserve, upgrade cost, conflict cost, and more...) ### Improved Grindstone Recipes * Enchant Removal Options * Enchant Merge Options * Durability Combination Options * Repair Cost Options ### Improved Recipe Items * Full SNBT support for vanilla item stacks * Support for DataFixerUpper via version property ### Improved Command Result Action * Full command context support * Target Selectors `@p`, `@n`, `@r`, `@a`, `@e`, `@s` * Target Selector arguments * and basically anything else from vanilla commands ## Advanced Ingredients This update introduces new Ingredient options that allow configuring how they are matched and/or consumed. These options are optional and use defaults that make them behave like they do in vanilla. Options all have their own Registry, so third-party plugins/mods can register their custom behaviour for each option type. ### Matching Options These options specify how the Ingredient choices are matched against the source stack in the inventory. ### Consumption Options Specifies how the Ingredient is consuming the source stack when the result is collected or produced. # Error Tracking CustomCrafting uses error tracking to assist in the maintenance of the plugin/mod. The Error tracking integration makes issues/errors more visible and provides insight on how well the plugin/mod functions in production. Which in return enables far quicker bug fixes and improvements than previously possible. More information [on the wiki](https://wolfyscript.github.io/CustomCrafting/bugs_and_errors/).

# CustomCrafting v5 Alpha 4 v5 is a complete rewrite and redesign of the entire plugin and recipe structure. It adds features and improvements that were not possible in v4. In recent times, Minecraft has changed a lot, new modding/plugin platforms have emerged or separated themselves from their original project. It's now a major task to make plugins/mods work across various platforms, each with their own different API. With the [removal of obfuscation](<https://www.minecraft.net/en-us/article/removing-obfuscation-in-java-edition>), using and building against the Minecraft internals has become way easier. It is for that reason that with v5 CC focuses on building features on top of the Minecraft internals instead of platform-specific APIs. To keep compatibility, the goal of v5 is to integrate into each platform as best as possible (like Events, Listeners, Third-party Plugins/Mods), while keeping most of its codebase platform-agnostic. That is where scafall comes in. [Scafall](https://github.com/WolfyScript/scafall/releases) allows for the creation of cross-platform APIs, which other mods and plugins may use, and makes it easier to link platform-specific implementations together. However, all of this comes with a variety of new challenges, so going forward, CustomCrafting will only support the latest Minecraft version! #### TLDR * CustomCrafting v5 builds features on top of Minecraft internals directly * **Only supports the latest Minecraft version** * **Requires the scafall library/mod** [See releases here](https://github.com/WolfyScript/scafall/releases) * Provides a cross-platform API # Brand-new Wiki With the release of v5 on Modrinth comes a brand-new wiki, available at: https://wolfyscript.github.io/CustomCrafting/ The new wiki provides many visual improvements and is managed using git now, making it easier to maintain than the old GitHub wiki. # Fabric Server Support v5 introduces support for Fabric servers. Server-side-only mods allow vanilla clients to connect to the Fabric server, so similar to Spigot, players don't need to install any client mods. The Fabric implementation provides many benefits compared to the Spigot/Paper implementation. It integrates custom recipes that have a vanilla counterpart directly into the vanilla recipe mechanism, this means better integration with existing mods and improved recipe book support. # Separate Paper Version Starting with this update, there is going to be a separate customcrafting and scafall jar file for paper specifically. If you are using Paper, you should use that to benefit from the improvements and extra features. Currently, that extra includes only the Stonecutter recipe support, which is missing in the Spigot version. # New Features v5 introduces some major overhauls to the resource loading and recipe structure. ## Configure Resources and Load Order Sources define where resources are loaded from (Local directory, H2, SQLite, MySQL, etc.). Backup destinations define where backups will get saved when created. (local directory or zip file) ## New & Improved Recipes v5 expands the functionality of all recipe types. Especially the ones that had a bit of a lacklustre feature set in v4. > **Tip** > This version adds some default recipes that showcase some of the new features. > They'll get loaded on startup and can be found [here in the v5 branch](https://github.com/WolfyScript/CustomCrafting/tree/v-5/core/api/src/main/resources/com/wolfyscript/customcrafting/resources/default/recipes) ### Improved Anvil Recipes * Rename Options (formatted, pre and suffix, cost, repair cost) * Durability Combination Options (bonus, ratio combination) * Item Repair Options (cost per item, enchants) * Enchanting Options (preserve, upgrade cost, conflict cost, and more...) ### Improved Grindstone Recipes * Enchant Removal Options * Enchant Merge Options * Durability Combination Options * Repair Cost Options ### Improved Recipe Items * Full SNBT support for vanilla item stacks * Support for DataFixerUpper via version property ### Improved Command Result Action * Full command context support * Target Selectors `@p`, `@n`, `@r`, `@a`, `@e`, `@s` * Target Selector arguments * and basically anything else from vanilla commands ## Advanced Ingredients This update introduces new Ingredient options that allow configuring how they are matched and/or consumed. These options are optional and use defaults that make them behave like they do in vanilla. Options all have their own Registry, so third-party plugins/mods can register their custom behaviour for each option type. ### Matching Options These options specify how the Ingredient choices are matched against the source stack in the inventory. ### Consumption Options Specifies how the Ingredient is consuming the source stack when the result is collected or produced. # Error Tracking CustomCrafting uses error tracking to assist in the maintenance of the plugin/mod. The Error tracking integration makes issues/errors more visible and provides insight on how well the plugin/mod functions in production. Which in return enables far quicker bug fixes and improvements than previously possible. More information [on the wiki](https://wolfyscript.github.io/CustomCrafting/bugs_and_errors/).

# CustomCrafting v5 Alpha 4 v5 is a complete rewrite and redesign of the entire plugin and recipe structure. It adds features and improvements that were not possible in v4. In recent times, Minecraft has changed a lot, new modding/plugin platforms have emerged or separated themselves from their original project. It's now a major task to make plugins/mods work across various platforms, each with their own different API. With the [removal of obfuscation](<https://www.minecraft.net/en-us/article/removing-obfuscation-in-java-edition>), using and building against the Minecraft internals has become way easier. It is for that reason that with v5 CC focuses on building features on top of the Minecraft internals instead of platform-specific APIs. To keep compatibility, the goal of v5 is to integrate into each platform as best as possible (like Events, Listeners, Third-party Plugins/Mods), while keeping most of its codebase platform-agnostic. That is where scafall comes in. [Scafall](https://github.com/WolfyScript/scafall/releases) allows for the creation of cross-platform APIs, which other mods and plugins may use, and makes it easier to link platform-specific implementations together. However, all of this comes with a variety of new challenges, so going forward, CustomCrafting will only support the latest Minecraft version! #### TLDR * CustomCrafting v5 builds features on top of Minecraft internals directly * **Only supports the latest Minecraft version** * **Requires the scafall library/mod** [See releases here](https://github.com/WolfyScript/scafall/releases) * Provides a cross-platform API # Brand-new Wiki With the release of v5 on Modrinth comes a brand-new wiki, available at: https://wolfyscript.github.io/CustomCrafting/ The new wiki provides many visual improvements and is managed using git now, making it easier to maintain than the old GitHub wiki. # Fabric Server Support v5 introduces support for Fabric servers. Server-side-only mods allow vanilla clients to connect to the Fabric server, so similar to Spigot, players don't need to install any client mods. The Fabric implementation provides many benefits compared to the Spigot/Paper implementation. It integrates custom recipes that have a vanilla counterpart directly into the vanilla recipe mechanism, this means better integration with existing mods and improved recipe book support. # Separate Paper Version Starting with this update, there is going to be a separate customcrafting and scafall jar file for paper specifically. If you are using Paper, you should use that to benefit from the improvements and extra features. Currently, that extra includes only the Stonecutter recipe support, which is missing in the Spigot version. # New Features v5 introduces some major overhauls to the resource loading and recipe structure. ## Configure Resources and Load Order Sources define where resources are loaded from (Local directory, H2, SQLite, MySQL, etc.). Backup destinations define where backups will get saved when created. (local directory or zip file) ## New & Improved Recipes v5 expands the functionality of all recipe types. Especially the ones that had a bit of a lacklustre feature set in v4. > **Tip** > This version adds some default recipes that showcase some of the new features. > They'll get loaded on startup and can be found [here in the v5 branch](https://github.com/WolfyScript/CustomCrafting/tree/v-5/core/api/src/main/resources/com/wolfyscript/customcrafting/resources/default/recipes) ### Improved Anvil Recipes * Rename Options (formatted, pre and suffix, cost, repair cost) * Durability Combination Options (bonus, ratio combination) * Item Repair Options (cost per item, enchants) * Enchanting Options (preserve, upgrade cost, conflict cost, and more...) ### Improved Grindstone Recipes * Enchant Removal Options * Enchant Merge Options * Durability Combination Options * Repair Cost Options ### Improved Recipe Items * Full SNBT support for vanilla item stacks * Support for DataFixerUpper via version property ### Improved Command Result Action * Full command context support * Target Selectors `@p`, `@n`, `@r`, `@a`, `@e`, `@s` * Target Selector arguments * and basically anything else from vanilla commands ## Advanced Ingredients This update introduces new Ingredient options that allow configuring how they are matched and/or consumed. These options are optional and use defaults that make them behave like they do in vanilla. Options all have their own Registry, so third-party plugins/mods can register their custom behaviour for each option type. ### Matching Options These options specify how the Ingredient choices are matched against the source stack in the inventory. ### Consumption Options Specifies how the Ingredient is consuming the source stack when the result is collected or produced. # Error Tracking CustomCrafting uses error tracking to assist in the maintenance of the plugin/mod. The Error tracking integration makes issues/errors more visible and provides insight on how well the plugin/mod functions in production. Which in return enables far quicker bug fixes and improvements than previously possible. More information [on the wiki](https://wolfyscript.github.io/CustomCrafting/bugs_and_errors/).

## 🐛 Fixes - fix: paper method call breaking spigot compat ([`details`](https://github.com/WolfyScript/CustomCrafting/commit/1402e68b7f57c4b9598c76b2cdf20e6cf7feb698)) - fix: null player data in gui ([`details`](https://github.com/WolfyScript/CustomCrafting/commit/6224b4c1d96250333f9b92fde254ec45dad602be)) - fix: only need to check lockdown once ([`details`](https://github.com/WolfyScript/CustomCrafting/commit/bda4c705e6901a29498670176c54cf0d62502d66)) - fix: possible npe in CraftListener ItemsAdder fix ([`details`](https://github.com/WolfyScript/CustomCrafting/commit/f25fb66e59e38156ffa601834b2afe883ddfc388)) - fix: make sure lists returned by recipe registry are immutable ([`details`](https://github.com/WolfyScript/CustomCrafting/commit/d44d37a31cab58a2bb45543eefe9f9172eea67d5)) ## ⚙️ Build & CI/CD - build: add 1.21.4 to the modrinth supported versions ([`details`](https://github.com/WolfyScript/CustomCrafting/commit/9754156e1deedca2f75081a8fd640991502e698a))

## 🐛 Fixes - fix: remove outdated protocol recipe packet filter ([`details`](https://github.com/WolfyScript/CustomCrafting/commit/469b484a640dc0553885f875cbd9820c743c1b95)) ## ⚙️ Build & CI/CD - build: remove protocollib dependency ([`details`](https://github.com/WolfyScript/CustomCrafting/commit/3d5c37d72862426b171218b676bfc429cd9db9cd)) - build: trying to get github actions to work... again... ([`details`](https://github.com/WolfyScript/CustomCrafting/commit/6b562f375451ea790c739fc820121be9a3257788)) - build: force gradle v8.13. trying github actions to work... again... again... ([`details`](https://github.com/WolfyScript/CustomCrafting/commit/43d3a3e170677bd65988c6a13247161d930232b0))

## 🐛 Fixes - fix: set default CCPlayerData when not yet available ([`details`](https://github.com/WolfyScript/CustomCrafting/commit/3eb8c826377e5e4239de6a73442faf38e660df7d)) - fix: skip protocollib features when disabled due to errors ([`details`](https://github.com/WolfyScript/CustomCrafting/commit/5c7b10cc61d2d3a649aafe64877c1ab70c862467)) ## ⚙️ CI/CD - ci: fix commit details link pointing to wrong repo ([`details`](https://github.com/WolfyScript/CustomCrafting/commit/461171b7d3a0084fbb6c73260c75a66fcd4b75f3))

## 🚧 Breaking Changes - refactor!: update to WU 4.19 & remove deprecated code ([`details`](https://github.com/WolfyScript/dev-tools/commit/d1c6bbfc47c94f75ac7a32cb9d4c935294223635)) ## 🧪 Tests - test: update test servers to 1.21.5 ([`details`](https://github.com/WolfyScript/dev-tools/commit/13a496d260e0df5368131f108c1c7fdf070a46a4)) ## ⚙️ CI/CD - ci: add changelog generation ([`details`](https://github.com/WolfyScript/dev-tools/commit/00a13958582c61f268a6c9b48b99d4a613ac1676)) - ci: remove misc from changelog ([`details`](https://github.com/WolfyScript/dev-tools/commit/47cc2851ffda702484ed0651e6c1ec0ce27d5a66)) - ci: create release as draft ([`details`](https://github.com/WolfyScript/dev-tools/commit/ae287ee5c7b61bf543c6f05612ceee3cef4d8b58))

## What's Changed * Merge PR by @petulikan1 with Bug Fixes, 1.21.4 Support, and more in [#407](https://github.com/WolfyScript/CustomCrafting/pull/407) * Add first GitHub workflows to start automating the release to Modrinth ## Warning! Versions Before 1.21.4 - Not Supported Anymore! From this update onward, WolfyUtils and CustomCrafting will only support the latest Minecraft version, including drops (minor versions)! This will allow me to keep up with the new Minecraft update schedule, and concentrate on new features/bug fixes instead of compatibility. LTS versions, with backported bug fixes, for the previous Minecraft version will be available to Premium. More info about it soon. ## New Contributors * @petulikan1 made their first contribution in https://github.com/WolfyScript/CustomCrafting/pull/407 **Full Changelog**: https://github.com/WolfyScript/CustomCrafting/compare/v4.17-beta.5...v4.18.5

This backports a fix, from the recent beta version, to fix an invalid file copy action that causes crashes on some systems. **Full Changelog**: [`v4.16.10...v4.16.11`](https://github.com/WolfyScript/CustomCrafting/compare/v4.16.10...v4.16.11)

> ### Warning > ### This update requires the **latest WolfyUtils beta** ! > You can download it from Modrinth: https://modrinth.com/plugin/wolfyutils/version/4.17-beta.4 ## Recipe / Custom Item Loading This update makes a couple of changes to the whole loading process of custom items and recipes. If a recipe or custom item **depends on another plugin, that isn't available**, it will **fail instantly** and will not to attempt to load it any further (like it previously did). No verification or anything is done. If a recipe or custom item **depends on plugins that are available**, then it makes sure the recipe or custom item is **loaded once all its dependencies are available**. Only then it tries to verify the recipe and checks if it is loaded properly. Additionally, information about pending, failed or invalid recipes can be viewed in-game via the new `/recipes info` command. Without any more arguments, this opens a chat interaction menu, that lists all the recipes. The `/recipes info <recipe>` command can be used to get info about a specific recipe. > Note: > The chat menu is still in a very early state, so it does not yet provide all possible information > For example why a recipe failed to load. This and other info can be found in the logs for now. ## Changelog * [#363](https://github.com/WolfyScript/CustomCrafting/pull/363) - Allow Applying Permisson Condition to Smithing Recipes * [#361](https://github.com/WolfyScript/CustomCrafting/pull/361) - Update ru_RU.json by @Pavel-Gornov * [#364](https://github.com/WolfyScript/CustomCrafting/pull/364) - No Longer Display Note About Brewing Stand Recipes * [#373](https://github.com/WolfyScript/CustomCrafting/pull/373) - Fix Smithing Recipes: Duplication & Empty Ingredient Issue * [#372](https://github.com/WolfyScript/CustomCrafting/pull/372) - Implement the WolfyUtils Dependency system * [#369](https://github.com/WolfyScript/CustomCrafting/pull/369) - Update zh_CN.json by @SnowCutieOwO * [`bca3359e`](https://github.com/WolfyScript/CustomCrafting/commit/bca3359ee464fe419e6e56170d7670380dad5406) - Add `data.sync` option that loads the data on the main thread * Required for plugins that use sync events for item creation (e.g. MMOItems) ## New Contributors * [@Pavel-Gornov](https://github.com/Pavel-Gornov) made their first contribution in [#361](https://github.com/WolfyScript/CustomCrafting/pull/361) * [@SnowCutieOwO](https://github.com/SnowCutieOwO) made their first contribution in [#369](https://github.com/WolfyScript/CustomCrafting/pull/369) **Full Changelog**: [`v4.16.9.1...v4.16.10`](https://github.com/WolfyScript/CustomCrafting/compare/v4.16.9.1...v4.16.10)