Recipe API

Getting Recipes

// Get recipe by NamespacedKey
NamespacedKey key = new NamespacedKey("craftorithm", "my_recipe");
Recipe recipe = api.getRecipe(key);

// Check if recipe exists
boolean exists = api.containsRecipe("craftorithm:my_recipe");

Getting Recipe Collections

// Get all Craftorithm-registered recipes
Map<NamespacedKey, Recipe> recipes = api.getCraftorithmRecipes();

// Get all server recipe keys (including vanilla)
Set<NamespacedKey> allRecipes = api.getServerRecipeKeys();

Getting Recipes by Type

// Get all recipes of a specific type
List<Recipe> shapedRecipes = api.getRecipesByType("vanilla_shaped");

// Get all recipe types (sorted by typeId)
List<RecipeType> types = api.getAllRecipeTypes();

Getting Recipe Type

// Detect type from Recipe
RecipeType type = api.getRecipeType(recipe);

// Get type from typeKey
RecipeType type = api.getRecipeType("vanilla_shaped");

Registering Recipe Type

api.registerRecipeType(new MyCustomRecipeType());

Disabling / Removing Recipes

// Disable a recipe
api.disableRecipe(key, true);  // true = save to config

// Remove a Craftorithm recipe
api.removeCraftorithmRecipe(key, true);  // true = delete file

Filename / Key Mapping

String fileName = api.getRecipeFileNameByKey(key);
NamespacedKey key = api.getRecipeKeyByFileName("my_recipe");

Result Processors

Result processors support registering custom component types. Simply implement the pers.yufiria.craftorithm.resultprocessor.ComponentProcessorFactory interface and register it.

Example:

ResultProcessorManager.INSTANCE.registerFactory(new ComponentProcessorFactory() {
    @Override
    public String componentName() {
        return "custom_component";
    }

    @Override
    public ResultProcessor createProcessor(String type, @Nullable ConfigurationSection data) {
        return new ResultProcessor() {
            @Override
            public String processorName() {
                return componentName();
            }

            @Override
            public void processItem(@Nullable ItemStack sourceItem, @NotNull ItemStack resultItem, @Nullable Player player) {
                // Perform custom processing
            }
        };
    }
});

For existing result processors, you can also add additional handler types:

LoreProcessorFactory.INSTANCE.handlers().put("random_lore", configurationSection -> new ResultProcessor() {
    @Override
    public String processorName() {
        return LoreProcessorFactory.INSTANCE.componentName();
    }

    @Override
    public void processItem(@Nullable ItemStack sourceItem, @NotNull ItemStack resultItem, @Nullable Player player) {
        // Perform custom processing
    }
});

Related Classes

Class	Description
CraftorithmAPI	API entry point
RecipeType	Recipe type interface
RecipeTypeMap	typeId ↔ type mapping
RecipeManager	Recipe manager