ItemCore

ItemCore is a technology-focused Minecraft mod that introduces a new way to process, optimize, and automate resources using Cores, Machines, and Upgrades.

🔹 Core System

ItemCore revolves around Core items, which represent condensed forms of vanilla and modded resources.

Cores can be extracted from resources using the Core Extractor.
Each Core has its own processing time, luck value, and output amount.
Supports many vanilla resources and is designed to be easily extendable to modded ones.

🔹 Machines

⚙️ Core Processor

A processing machine that transforms Cores into usable resources.

Input slot for Cores
Output slot for results
Progress-based processing with visual feedback
Fully compatible with automation systems

🛠 Core Extractor

A handheld tool used to extract Cores from raw resources.

Normal and unbreakable variants
Simple right-click interaction
Designed for early-game and progression use

🔹 Upgrades

ItemCore machines can be enhanced using multiple upgrade types:

Speed Upgrades – Reduce processing time
Production Upgrades – Increase output quantity
Output Upgrades – Control output behavior
Void Upgrade – Prevent overflow and manage excess items

Each upgrade has multiple tiers for scalable progression.

🔹 Automation & Compatibility

Works with hoppers and inventories
Designed to integrate smoothly with automation-heavy modpacks
Supports modded resources (Create, Mekanism, EnderIO, and more)

🔹 Why use ItemCore?

Clean and modular resource processing
Automation-friendly machines
Easy datapack and JSON extensibility
Perfect for tech-based and progression modpacks

Adding New Cores in ItemCore

ItemCore allows you to add new cores for both vanilla and modded resources by editing JSON files. Here's how to safely add or modify cores.

1️⃣ Core Definition File

Location: resources/data/itemcore/cores.json

Each core is defined as a JSON object with the following structure:

{
  "name": "Copper",
  "resource": "create:copper_ingot",
  "overlayColor1": "0xFFD1A4",
  "overlayColor2": "0xFFA500",
  "process_time": 120,
  "luck": 30,
  "count": 2
}

name – The display name of the core
resource – The item it represents (vanilla or modded)
overlayColor1 and overlayColor2 – Colors used for the core overlay
process_time – Time (in ticks) required to process the core
luck – Luck factor for extraction/production
count – Number of cores produced

Add your new core object to the JSON array. Make sure the resource exists in the game.

2️⃣ Core Tag File

Location: resources/data/itemcore/tags/items/core.json

This file defines which items are recognized as cores for recipes and automation. Example:

{
  "replace": false,
  "values": [
    "itemcore:coal_core",
    "itemcore:iron_core",
    "itemcore:copper_core"
  ]
}

Add your new cores here to ensure they are correctly recognized by machines and recipes.
The replace field controls whether this file replaces existing tag values (true) or adds to them (false).

⚠️ Important Notes

Do not delete vanilla cores from the tag file unless you fully understand the consequences. Machines and recipes depend on them.
Always double-check the resource exists in the game or the mod you reference.
For modded cores, make sure the mod is loaded; otherwise, the core will fail to register.

Following these steps ensures your custom cores work seamlessly with ItemCore's machines and recipes.

ItemCore is built to be simple to use, powerful to automate, and easy to expand. More features and mod integrations are planned!