Skip to content

IndustrialCraft 2: Refactored — Add-on API

Welcome to the documentation for IC2 Refactored (IC2 Rebranded) on Minecraft 1.21.1 with NeoForge!

This documentation provides everything you need to create custom add-ons: custom machines, generators, energy storage, electric tools, nano/quantum armor, flying jetpacks, machine upgrades, and recipes.

Quick Navigation

Resource Description
Add-on Creation Guide Master overview and 9 numbered guide chapters covering registration, machines, generators, tools, armor, upgrades, and pipes.
IndustrialJS & KubeJS Guide Complete guide for modpack authors: zero-code JSON balancing, recipe creation, KubeJS server script bindings, and master API reference.
Energy System & FE Interop Deep dive into Energy Units (EU), Voltage Tiers (LV to EV), cable loss, and the automatic Forge Energy (FE) cross-mod bridge.
Complete Example Add-on A full, copy-pasteable reference mod template (ExampleAddonMod.java) demonstrating all core features in one place.
API Reference A concise index of all verified helper classes, interfaces, and methods in ic2.api.*.

Guide Chapters at a Glance

  1. Registration & Setup: 1-line content registration with Ic2AddonContent, creative tabs, and materials.
  2. Custom Machines: Building EU-consuming machines with AddonMachineBlockEntity and AddonWrenchableBlock.
  3. Custom Generators: Creating solid-fuel, fluid, and solar generators with dynamic block lighting (litWhenActive).
  4. Energy Storage Blocks: Building battery accumulators (BatBox, CESU, MFE) with charge and discharge slots.
  5. Electric Tools & Weapons: Drills, chainsaws, wrenches, and nanosabers using AddonElectricTool and ElectricItem.manager.
  6. Electric Armor & Jetpacks: Quantum/Nano armor suits, wearable Lappacks, and flying jetpacks with hover and boost keys.
  7. Machine Upgrades: Overclock/speed, storage buffer, and transformer voltage upgrades using AddonUpgradeItem.
  8. Recipes & DataGen: Programmatic recipe generation with AddonRecipeBuilder and circuit tag conventions.
  9. Fluid Pipes & Pump Covers: Bronze and Steel fluid pipes (Tiny, Small, Medium, Large), LV–EV pump covers, cauldron fluid extraction, and wrench controls.

Why Develop for IC2 Rebranded?

  • 1-Line Registration: With Ic2AddonContent, you can register blocks, items, block entities, menus, recipes, and creative tabs without managing dozens of separate DeferredRegister objects.
  • Built-in Wrench Support: AddonWrenchableBlock automatically provides rotation, dismantle drops, and facing states compatible with IC2 wrenches.
  • Dynamic Lighting: Generators and furnaces automatically emit block light when actively operating with AddonEnergyBlock.litWhenActive(...).
  • Automatic Forge Energy (FE) Bridge: Every add-on energy machine and generator can connect seamlessly to modern tech mods (Mekanism, Thermal, Ender IO) with 1 line of code (1 EU = 2 FE).
  • Data-Driven Machine Recipes: Generate recipes for Macerators, Compressors, Extractors, and Blast Furnaces programmatically using AddonRecipeBuilder.

Getting Started in 3 Steps

  1. Check out the Getting Started Guide to configure your build.gradle and neoforge.mods.toml.
  2. Follow Chapter 1: Registration with Ic2AddonContent to register your first items and blocks.
  3. Explore the Complete Example Add-on Mod to copy a full working template.