CurseForge · Minecraft mod
Linkwright
Stops "requires version X" crashes by verifying the real code links between mods and patching the gaps.
Quick answer
Which Linkwright release should I use?
linkwright-1.1.0.jar targets 1.17.1, 1.21.2-Snapshot, 1.21 with Forge, NeoForge. The project page does not say whether this file belongs on the client, dedicated server, or both. No extra mods listed for this file.
Where it goes
Is Linkwright required on the client, server, or both?
The project page does not say whether this file belongs on the client, dedicated server, or both.
The source does not explicitly classify this release as client-only or server-only.
What else does linkwright-1.1.0.jar need?
linkwright-1.1.0.jar. Change the file and its required mods may change too.
This file does not list any required mods. Do not add a library just because a different file uses it.
This file does not list any required or optional mods.
Before you install it
Add Linkwright without breaking your instance.
Built for linkwright-1.1.0.jar. Pick another file and the loader, install side or required mods may change.
- 01
Stick to this file
Use linkwright-1.1.0.jar. It targets 1.17.1, 1.21.2-Snapshot, 1.21 with Forge, NeoForge; another release may have different loader, side or dependency requirements.
- 02
Bring the mods it needs
This file does not list any required mods. Do not add a library just because a different file uses it.
- 03
Put it on the correct side
The project page does not say whether this file belongs on the client, dedicated server, or both.
- 04
Pick the file you checked
Use the “Get this file” button beside linkwright-1.1.0.jar. It opens that exact file at the source.
About this project
What does Linkwright add?

Linkwright
Your pack won't start because one mod wants version 1.3 of another, and you have 1.2? Linkwright fixes that.
Many mods only accept one exact version range of another mod. When that mod updates, the game refuses to start, even if nothing important changed.
Linkwright checks whether the two mods still fit together. If they do, it lets the game start. If something small changed, it adapts it while the game loads.
It never edits any mod files. On Forge and NeoForge you just drop it in. Fabric needs one extra step, explained below.
Works on Forge, NeoForge and Fabric, from Minecraft 1.7.10 to 26.x.
How It Works
Every time the game starts, Linkwright:
- Finds mod version rules that aren't met.
- Checks every class, method and field one mod uses from the other, including mixins.
- Adapts small changes, but only when there is exactly one safe way to do it.
- Lets the game start if everything checks out. If not, you get the normal error, plus a report explaining what is missing.
A pack with 300+ mods is checked in about one second.
What It Can Fix
- New parameters: a method gained extra inputs. Linkwright fills them in using values the mod already has.
- Changed types: a value changed type, like a number becoming a bigger number type. Linkwright converts it, as long as nothing is lost.
- Interface changes: a required method changed its types. Linkwright adds the new version and points it at the old one.
- New return values: a method now returns something extra. Linkwright ignores it.
Real Examples
- CBC Aeronautics Missiles + Create: Radars 5: Radars added a new parameter to one method. Linkwright checked the other 124 links and fixed both calls.
- Power Grid + TFMG 1.2: TFMG changed how block positions are stored. Linkwright converts them in both directions.
Safe by Design
- It never guesses. If there is more than one possible fix, or none, it leaves the error in place.
- It respects mod authors. If a mod is marked as incompatible with another on purpose, Linkwright leaves it alone.
- It never loses data. Values are only converted when nothing can be lost.
- It tells you everything. Every decision is written to
logs/linkwright-report.txt.
Which File to Download
- Forge 1.17.1 and newer, or any NeoForge:
linkwright-1.1.0.jar - Forge 1.13.2 to 1.16.5:
linkwright-1.13-1.16.5-1.1.0.jar - Forge 1.7.10 to 1.12.2:
linkwright-1.7.10-1.12.2-1.1.0.jar - Fabric, any version:
linkwright-fabric-1.1.0.jar
The CurseForge app picks the right one for you.
Installing
Put the jar in your mods folder. It works on the client, the server, or both. It doesn't need to match between client and server.
Linkwright starts before other mods, so on some versions it won't show up in the in-game mod list. That is normal.
Note: your client and the server still need the same versions of your other mods to connect.
Fabric: One Extra Step
Fabric checks mod versions before any mod gets to run, so Linkwright has to start a little earlier. You do this by adding one Java argument, once.
Add this argument:
-javaagent:mods/linkwright-fabric-1.1.0.jar
If your file has a different version number, change the name to match. If it doesn't work, use the full path to the file instead, and avoid spaces in the path if you can.
- Prism Launcher or MultiMC: Edit Instance, then Settings, then the Java tab. Tick "JVM arguments" and add it there.
- Minecraft Launcher: Installations, then Edit, then More Options. Add it to the start of JVM Arguments.
- Other launchers: look for "JVM arguments" or "Java arguments" in the profile settings.
- Servers: add it to your start command before
-jar, for examplejava -javaagent:mods/linkwright-fabric-1.1.0.jar -Xmx4G -jar fabric-server-launch.jar nogui
To check it worked, look for lines starting with "Linkwright" in your log. If you see "Linkwright is installed but not active", the argument is missing or the file name doesn't match. The message shows the exact argument to use.
Settings
A settings file is created at config/linkwright.toml. The defaults work for almost everyone.
mode:"auto"fixes and approves (default),"report"only writes the report,"off"does nothing.bridgeCalls: set tofalseto only approve mods that match exactly, with no fixes.ignore: mod pairs to leave alone, written as"modA->modB".forceApprove: mod pairs to allow even when problems are found. This can crash your game.
Limits
- It checks that mods fit together, not what the code does. A method that works differently but looks the same will still pass.
- Removed methods and renamed classes can't be fixed.
Requirements
- Forge for Minecraft 1.7.10 to 26.x
- NeoForge, any version
- Fabric Loader 0.14 or newer, for Minecraft 1.14 to 26.x
- No other mods needed
Quilt is not supported yet.
Found two mods Linkwright should fix but doesn't? Open an issue on GitHub and attach your logs/linkwright-report.txt.
Project description from CurseForge.
Pick your setup
Linkwright by Minecraft version and loader
Choose the version and loader you play, then open the matching release.
26.3-snapshot
3 loader builds26.3
3 loader builds26.2-snapshot
3 loader builds26.2
3 loader builds26.1.2
3 loader builds26.1.1
3 loader builds26.1-snapshot
3 loader builds26.1
3 loader builds1.21.11-snapshot
3 loader builds1.21.11
3 loader builds1.21.10
3 loader buildsShowing the newest 12 of 105 game versions. Older files are in the list below.
Check the dependencies, then try the file in a copied instance before changing a world you care about.
Recent files
Linkwright versions and loaders
linkwright-1.1.0.jar
16 Nov 2026
linkwright-1.13-1.16.5-1.1.0.jar
16 Nov 2026
linkwright-1.7.10-1.12.2-1.1.0.jar
16 Nov 2026
linkwright-fabric-1.1.0.jar
16 Nov 2026
linkwright-1.21.1-neoforge-1.1.0.jar
15 Nov 2026
Looking for an older file? The official CurseForge project page is in Resources.