Configuration Reference

Complete reference for RemapIDs configuration. All configuration is done through JSON files placed in config/remapids/remaps/.

JSON Validation

If your remaps aren't taking effect, check for JSON syntax errors. A misplaced comma or missing bracket will cause the file to fail silently. Use a JSON validator to verify your files.

---

File Structure

• Directory: config/remapids/remaps/
• All .json files in this directory are loaded automatically
• Files are processed in alphabetical order
• Each file is independent — organize your remaps however you like (e.g., one file per removed mod, one file per remap type)

---

remaps

The top-level remaps array contains all remap entries for the file.

Type: Array of remap objects

{
  "remaps": [
    {
      "source": "oldmod:copper_ingot",
      "target": "minecraft:copper_ingot",
      "types": ["item", "block"]
    },
    {
      "source": "oldmod:copper_ore",
      "target": "minecraft:copper_ore"
    }
  ]
}

---

remaps[].source

The original namespaced ID to redirect.

Type: String (namespaced ID)

• Must be in namespace:path format (must contain a colon)
• Supports * wildcard for pattern matching (see Wildcards Guide)
• Prefix with # for tag remaps (e.g., "#forge:ingots/gold") — see Tag Remapping Guide

{
  "source": "oldmod:silver_ingot",
  "target": "newmod:silver_ingot"
}

---

remaps[].target

The destination namespaced ID that the source will be redirected to.

Type: String (namespaced ID)

• Same format requirements as source
• If source uses *, target must also use * (and vice versa)
• For registry types, the target must exist in the game's registries — otherwise the remap is skipped with a warning

{
  "source": "oldmod:*",
  "target": "newmod:*"
}

---

remaps[].types

Optionally filter which remap types this entry applies to.

Type: String array (optional) Default: [] (empty = applies to all 7 types)

Value	Category	Requires Restart	Description
block	Registry	Yes	Block registry IDs
item	Registry	Yes	Item registry IDs
fluid	Registry	Yes	Fluid registry IDs
entity_type	Registry	Yes	Entity type registry IDs
tag	Reloadable	No	Tag definitions
recipe	Reloadable	No	Recipe IDs and ingredient/result references
loot_table	Reloadable	No	Loot table ID lookups and item references

Filtered example

Only remap items and blocks — leave tags, recipes, and loot tables unchanged:

{
  "source": "oldmod:silver_ingot",
  "target": "newmod:silver_ingot",
  "types": ["item", "block"]
}

Unfiltered example

Apply to all remap types (block, item, fluid, entity_type, tag, recipe, loot_table):

{
  "source": "oldmod:silver_ingot",
  "target": "newmod:silver_ingot"
}

---

Processing Pipeline

When the game loads, RemapIDs processes config files in this order:

1. Parse — All .json files in the remaps directory are loaded alphabetically
2. Expand wildcards — * patterns are matched against known registry IDs
3. Group by type — Entries are organized by their applicable remap types
4. Flatten chains — Transitive mappings are resolved (A→B + B→C = A→C, max depth 10)
5. Validate — Registry type targets are checked against known IDs (reloadable types skip this)
6. Apply — The final remap configuration is activated

---

Example Config Files

Mod migration

{
  "remaps": [
    {
      "source": "iceandfire:silver_ingot",
      "target": "thermal:silver_ingot",
      "types": ["item"]
    },
    {
      "source": "iceandfire:silver_block",
      "target": "thermal:silver_block",
      "types": ["block", "item"]
    },
    {
      "source": "iceandfire:silver_ore",
      "target": "thermal:silver_ore",
      "types": ["block", "item"]
    }
  ]
}

Tag consolidation

{
  "remaps": [
    {
      "source": "#iceandfire:ingots/silver",
      "target": "#forge:ingots/silver",
      "types": ["tag"]
    },
    {
      "source": "#iceandfire:ores/silver",
      "target": "#forge:ores/silver",
      "types": ["tag"]
    }
  ]
}

---

Next Steps

• Wildcards Guide — Pattern matching for bulk remaps
• Type Filtering Guide — Control which remap types apply
• Tag Remapping Guide — Redirect tag references
• Chain Flattening Guide — Multi-step chain resolution
• Examples — Real-world modpack scenarios