Description
# RemapIDs
**Remap any item, block, fluid, or entity ID to another — data-driven, zero-config code.**
RemapIDs is a utility mod for **modpack developers** that lets you redirect registry IDs throughout the entire game using simple JSON files. Unify duplicate ores across mods, replace deprecated items, or migrate worlds between mod versions — all without writing a single line of code.
## Features
**Registry Remapping**
Remap across 7 registry types:
- Blocks, Items, Fluids, Entity Types
- Tags, Recipes, Loot Tables
Remaps are applied deeply — recipes, loot tables, tags, NBT data in inventories and containers are all automatically rewritten.
**Data-Driven Configuration**
Drop JSON files into `config/remapids/remaps/` and you're done:
```json
{
"remaps": [
{
"source": "iceandfire:silver_ingot",
"target": "othermod:silver_ingot",
"types": ["item", "recipe", "loot_table"]
}
]
}
```
**Wildcard Patterns**
Bulk-remap entire families of items with a single rule:
```json
{
"source": "iceandfire:silver_*",
"target": "othermod:silver_*"
}
```
**Tag-to-Item Recipe Conversion**
Replace tag ingredients in recipes with specific items:
```json
{
"source": "#forge:ingots/silver",
"target": "othermod:silver_ingot",
"types": ["recipe"]
}
```
**Smart Chain Resolution**
If A remaps to B and B remaps to C, the mod automatically flattens this to A→C. Circular dependencies are detected and rejected.
**Live Reloading**
Tag, recipe, and loot table remaps are reapplied on `/reload` — no restart needed.
**Zero Runtime Overhead**
Block, item, fluid, and entity remaps are applied as registry aliases at startup. After that, there's no performance cost.
## Supported Versions
| Minecraft | Loader |
|-----------|--------|
| 1.20.1 | Forge |
| 1.20.1 | Fabric |
| 1.21.1 | NeoForge |
| 1.21.1 | Fabric |
## Use Cases
- **Ore unification** — Redirect all silver ingots from 5 different mods to one canonical ID
- **Mod migration** — Swap out a removed mod's items for replacements without breaking existing worlds
- **Loot/recipe cleanup** — Rewrite loot tables and recipes to use the items you want
- **World upgrades** — Items already in inventories and containers are remapped via NBT on load
## Getting Started
1. Install the mod for your loader
2. Create `config/remapids/remaps/` if it doesn't exist
3. Add any number of `.json` files with your remap definitions
4. Launch the game — remaps are applied automatically
