⚙️ Utility Core

A library mod that resolves crafting conflicts and prevents damage crashes.

✨ Overview

Utility Core provides shared utilities for NeoForge modpacks. When multiple crafting recipes match the same ingredients, a selection widget lets you pick the output. Negative damage from mod interactions is automatically clamped to zero, preventing server crashes.

🎯 Features

🔀 Recipe Conflict Resolution

When multiple crafting recipes match the same inputs, a selection widget appears in the crafting table and inventory 2x2 grid. The selected recipe is highlighted in green, and alternatives are shown with a white background. Click any alternative to instantly change the output.

• Server-side: Detects matching recipes, stores the player’s selection via attachments, syncs the output list to the client
• Client-side: Renders a recipe selector grid, sends selection changes back to the server
• Instant update: The result slot updates immediately when clicking an alternative recipe

🛡️ Damage Safety

Negative damage values from mod interactions (e.g., Apothic Attributes critical strikes + Tombstone’s Decrepitude effect) are automatically clamped to 0, preventing IllegalArgumentException: Damage cannot be negative crashes that would otherwise crash the server.

⚰️ Corail Tombstone Compatible

Automatically suppresses incompatible mixin errors from Tombstone 9.x without breaking functionality. GUI scale is restored after opening Tombstone menus.

⚙️ Configurable

All features can be configured via the in-game config screen or the config file:

• Enable/disable the crafting recipe selector
• Maximum number of alternative recipes displayed

💻 Developer API

Other mods can integrate with the recipe selection system using the provided PolymorphApi class.

📋 Requirements

🎮 How to Use

1. Install the mod on both client and server.
2. Open a crafting table and place items that match multiple recipes.
3. A selector grid appears — click an alternative recipe to choose your output.
4. Configure via Mods menu > Utility Core > Config or config/utility_core-common.toml.

Known Incompatibilities

Fast Workbench (fastbench): This mod conflicts with the recipe selection system. Remove it to use this feature.

🔧 For Developers

// Access the API
PolymorphApi api = PolymorphApi.getInstance();

// Get all recipes matching a specific input
List<RecipeHolder<CraftingRecipe>> recipes = api.getRecipesFor(
    recipeManager, RecipeType.CRAFTING, craftingInput, level
);

// Get player recipe selection data
PlayerRecipeData data = api.getPlayerRecipeData(player);

// Clear player recipe selection data
api.clearPlayerRecipeData(player);

🙏 Credits

Developed by Stalking Dragons.

https://codex.skdragons.com/
Codex Stalking Dragons — Minecraft Modding