
Pearity
Did you ever wish to be able to pick which mod’s version of an item you actually use? This mod lets you dynamically create recipes to transform certain items into others!
About this Mod
Modded worlds grow duplicates the way stone grows moss. Boats, planks, tools—same idea, different mods, different IDs. Functionally identical, mechanically divided. This mod exists to dissolve that friction.
It lets you define shapeless item transformation recipes that convert one item into another based purely on identifiers. No overrides. No hard replacements. Just clean, intentional translation between equivalent items.
Mods that override vanilla mechanics such as TerraFirmaCraft benefit most from Pearity, especially if other mods are present that require vanilla blocks in their recipes.
Spoiler
At its simplest, you can define a direct conversion:
minecraft:oak_boat -> tfc:wood/boat/oak
With this rule, a vanilla oak boat can be crafted directly into its TerraFirmaCraft counterpart.
Need true interchangeability? Use a bidirectional rule:
minecraft:oak_boat <-> tfc:wood/boat/oak
Now the transformation works both ways. Neither item is privileged.
Where the mod truly opens up is pattern-based matching. Two wildcards are supported:
? : a match wildcard that captures variable parts of an ID
- : a broad wildcard that matches across namespaces or paths
For example:
minecraft:?_boat <-> tfc:wood/boat/?
This single rule links every vanilla boat variant (oak, birch, spruce, and more) to its corresponding TFC version.
Think of it like "Match ids minecraft:something_boat with tfc:wood/boat/something"
Push it further:
:?_boat <-> tfc:wood/boat/?
Now any conventionally named boat from any mod (namespace) becomes interchangeable with its TFC equivalent.
Notice how "" can be replaced with anything, but "?" have to match.
Keep in mind these are just examples. You can always match any two item IDs, creating progression-breaking recipes. For example, this:
minecraft:dirt -> minecraft:diamond
Self explanatory
or this:
minecraft:egg -> create:*
Now you can automate the entire create catalog by having a single chicken
or a slightly more sensible one like this:
minecraft:_sapling -> minecraft:_sapling
You can now technically begin with any sapling and grow any tree
All recipe generation rules are managed in-game through a dedicated GUI, accessible via a configurable hotkey (Insert by default). Recipe generation rules can be added, edited, or removed live, without restarting the world or server. Ideal for rapid iteration while building or tuning a modpack.
Available Versions
How to Install Pearity on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set neoforge Loader
In the panel under "Egg", select the neoforge loader and matching Minecraft version (1.21.1).
Install Mod
Open the mod browser in the dashboard and search for "Pearity". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
1.21.1
Server-side
✓ RequiredRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
Pearity server crashes on startup – what to do?
Most common cause: wrong neoforge version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (1.21.1). You can switch loaders with one click in the panel.
Is Pearity compatible with neoforge?
Pearity officially supports neoforge for Minecraft 1.21.1. The Mado dashboard automatically detects incompatible loader combinations.
Server lagging with Pearity – how to optimize performance?
Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if Pearity consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.
Similar Mods
Rent Modded Server
Install Pearity with just one click on your server.