CustomCrafterAPI
What is CustomCrafterAPI
Section titled “What is CustomCrafterAPI”CustomCrafterAPI is a foundation plugin for Minecraft plugin developers to add custom crafting recipes from 1×1 up to 6×6 in size to their servers.
From simple recipes that check only the item type — just like vanilla recipes — to advanced ones that inspect enchantments, potion effects, and other metadata, or even determine the output by querying an external database or API, CustomCrafterAPI supports a wide range of implementations.
Key Features
Section titled “Key Features”Variable Recipe Sizes Define recipes with any arrangement from 1×1 to 6×6. Both shaped and shapeless recipe types are supported.
Rich Item Conditions Specify conditions beyond just the Material type — enchantments, stored enchantments, potion effects, and custom metadata are all supported.
Async Search Support Asynchronous recipe search using Java 21 virtual threads ensures that large numbers of recipes or heavy predicates do not impact server TPS.
Highly Extensible By implementing the provided interfaces with your own classes, you can build recipes that query databases or external APIs, or craft UI designs that vary per player.
Versioning
Section titled “Versioning”Download the latest release or add it as a dependency from the following sources:
| Source | Purpose |
|---|---|
| Modrinth | Download the plugin jar |
| GitHub Releases | Download the plugin jar |
| Maven Central | Add as a library dependency |
Use the provided scope in Maven or compileOnly in Gradle.
Documentation Overview
Section titled “Documentation Overview”| Page | Contents |
|---|---|
| Getting Started | Installation and core concepts |
| CustomCrafterAPI Object | Recipe registration, removal, and settings |
| Search API | Recipe search and async search |
| Recipe | How to use CMatter, CRecipe, and ResultSupplier |
| Implementations | Detailed reference for standard implementation classes |
| Events | Events fired by CustomCrafterAPI |