Caloric Flux (Beta)

Caloric Flux is a technical energy generation mod for NeoForge 1.21.1 that brings the laws of thermodynamics to your Minecraft world.

---

How it works

The core of the mod is the Heat-Difference Generator. Instead of just burning fuel, it produces FE (Flux Energy) based on the temperature difference between its two sides. The greater the delta, the more power you get!

Energy & Logistics

• Passive Output: Without any modules, the generator acts as a simple passive device, outputting only 5 FE/t to adjacent cables or machines.
• I/O Processing: Installing a Logistics I/O Processor unlocks the generator's true potential, increasing the output limit to 500 FE/t and allowing full side configuration.
• Efficiency Balance: Every module installed has a small passive energy drain, requiring you to balance high-speed output with net generation.

Key Features

• Dynamic Thermal Logic: Balance extreme heat (Lava) against extreme cold (Blue Ice, Packed Ice) to maximize efficiency.
• Realistic Degradation: Blocks aren't infinite. Ice melts into water, lava cools, and even torches eventually burn out into sticks.
• Immersive Visuals: Features custom ambient particles (smoke and snowflakes), a fully animated fan, and a detailed industrial GUI with real-time temperature tracking.
• JEI Integration: Full support for Just Enough Items, showing all thermal recipes and degradation paths.

Dependencies & Integrations

• GeckoLib (Required) — Powers the smooth animations of the generator's fan. The mod will crash on startup without it!
• GuideME (Highly Recommended) — Unlocks the guidebook with component lists, and recipes.
• Just Enough Items (JEI) (Optional, but Recommended) — Essential for viewing exact thermal reactions and custom housing assembly recipes directly in your inventory.

Technical Documentation for Modpacks

Caloric Flux is fully data-driven. You can add your own thermal sources or machine assembly steps via Datapacks.

1. Thermal Recipes (caloricflux:thermal)

Define how blocks affect the generator. Example JSON:

{
  "type": "caloricflux:thermal",
  "ingredient": "minecraft:blue_ice",
  "temperature": -50.0,
  "degrade_result": "minecraft:packed_ice",
  "degrade_multiplier": 0.3,
  "drop_result": "minecraft:stick"
}

• ingredient: Block or fluid ID that acts as a source.
• temperature: Target temperature (positive for heat, negative for cold).
• degrade_result: The block it transforms into after "wearing out".
• degrade_multiplier: Speed of degradation (higher values mean faster consumption).
• drop_result (Optional): Item that drops when the block degrades.

2. Housing Assembly (caloricflux:housing_assembly)

Used for step-by-step machine frame construction. Example for Stage 0:

{
  "type": "caloricflux:housing_assembly",
  "stage": 0,
  "ingredient": { "item": "minecraft:iron_ingot" },
  "base_block": "caloricflux:thermalloy_block",
  "result_block": "caloricflux:thermalloy_housing",
  "reverse_tool": { "tag": "minecraft:axes" },
  "reverse_drop": "minecraft:iron_ingot"
}

• stage: Current construction step index.
• ingredient: Item required to advance to the next stage.
• base_block / result_block: Logic for block transformation at this step.
• reverse_tool / reverse_drop: Defines how to deconstruct the frame and what is returned to the player.

Getting Started

1. Craft Thermalloy components to build your first generator.
2. Place a heat source on one side and a coolant on the other.
3. Install a Logistics I/O Processor to start exporting energy to your machines or cables.