🐀 Rats — Unofficial Port for 1.21.1 and 26.x

📜 Original mod

This is an unofficial port of Rats 8.1.3 by Alexthe666 and GizmoTheMoonPig (Minecraft 1.20.1, Forge). Original source: github.com/AlexModGuy/Rats, license LGPL-3.0, which allows derivative works. All credit for the mod's ideas, models, textures and sounds goes to the original authors.

Please report bugs of this port to us, not to the original authors.

How this port differs from the original

• New Minecraft versions and loaders: 1.21.1, 26.1.2, 26.2 and 26.3, each for NeoForge and Fabric (the original: Forge 1.20.1 only).
• Citadel replaced by Rampart, our open library with the model and animation code Rats needs. It does not conflict with Citadel.
• 17 open issues of the original fixed, each with an automatic test:
  • tamed rats stuck holding cheese (#838);
  • rats stop working after a while: lumberjacks, farmers, carriers (#818, #844, #887, #920, #902);
  • rats stop when the owner is offline or the world is open to LAN (#850, #945);
  • rat tubes work again (broken since 1.14): rats path through tube networks and climb shafts (#907);
  • the ethereal rat phases through blocks again (#871);
  • bee rats fight on Follow Me, the Flying Dutchrat melees (#822, #848);
  • patrol paths survive a restart, no more NoSuchElementException crash with the Plague Doctor, no fall damage after teleporting to the owner, the bucket upgrade no longer plays its sound every tick, the "disable plastic" option is back (#787, #827, #847, #870, #864).
• Less server lag (#867): 300 cells of working rats cost about +2.2 ms per tick.
• Fixed bugs the original never reported: its own mixins (the idol upgrade with piglins, the sculked upgrade with wardens) were not registered; the global loot modifiers (cat gifts, charged creeper chunks, tiny coins) did not run.
• More languages: German, Spanish and Brazilian Portuguese added; Russian and Ukrainian completed. English, Japanese, Swedish, Turkish and Chinese from the original are kept.
• 1.20.1 worlds keep their rats and items (item NBT moves to 1.21 data components on load).

✨ Features

Everything of Rats 8.1.3:

• Rats: wild rats and garbage piles, taming with cheese, commands (wander, follow, stay, harvest, gather, hunt, transport, patrol), 235 upgrades (lumberjack, miner, farmer, fisherman, crafting, flight, ethereal, mounts and many more), the rat crafting table, rat tubes, cages, holes and traps.
• Cheese: milk cauldrons, cheese, blue and nether cheese, the curdling station, cheese ore, chunky cheese tokens.
• Plague: plagued rats, plague doctors and their trades, the Black Death, plague beasts and clouds, the Pied Piper in raids.
• Ratlantis: the dimension of marbled cheese with its bosses (the Ratlantean Automaton, the Neo-Ratlantean, the Flying Dutchrat, the Rat Baron), pirats, oratchalcum and Ratlantean gear; the Rat King.

📦 Versions and requirements

• 26.3: NeoForge 26.3.0.94+ or Fabric Loader 0.19.5+, Java 25
• 26.2: NeoForge 26.2.0.93+ or Fabric Loader 0.19.5+, Java 25
• 26.1.2: NeoForge 26.1.2+ or Fabric Loader 0.19.5+, Java 25
• 1.21.1: NeoForge 21.1.197+ or Fabric Loader 0.16.14+, Java 21

Every version needs Rampart for the same Minecraft version and loader; Fabric also needs Fabric API.

🔧 Installation

• Single player: put Rats, Rampart (and Fabric API on Fabric) into mods.
• Server: the same jars on the server and on every client.
• Ratlantis is a built-in datapack and is on by default; a new world lists it under More → Data Packs.

🤝 Compatibility

• JEI shows the rat crafting, cauldron and upgrade recipes (both loaders).
• Item and fluid storages work with other mods: NeoForge capabilities, Fabric's transfer API. Energy (the Ratlantis reactor) is NeoForge only.

🧪 Testing

On each Minecraft version and both loaders: a self-test on a dedicated server (45 checks, 44 on 1.21.1, among them a gameplay scenario for every fixed issue), a client scene with all 28 mobs, the blocks and the inventory, and a check that no server class loads client code.

🔗 Links

• Source and bug reports: github.com/Vladeezyy/rats-1.21
• Details of every fix: PORTLOG.md
• Original mod: Rats on CurseForge, source

📄 License

LGPL-3.0-only, like the original. Copyright © Alexthe666, GizmoTheMoonPig and Vladeezyy. Forks and modified versions must stay open under the same license and credit the authors.