Back to mods
Linkwright project artwork

CurseForge · Minecraft mod

Linkwright

Fixes "requires version X" errors between mods, or on the loader, by checking the real code links and safely patching the gaps.

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which Linkwright release matches 1.20?

Updated today
Best match for your filters Linkwright 1.3.1 (Fabric)
Game version 1.16.3, 1.17.1, 1.21
Loader Fabric

Linkwright 1.3.1 (Fabric) targets 1.16.3, 1.17.1, 1.21 with Fabric. 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.

Client Source doesn’t say
Dedicated server Source doesn’t say
Loader for this release Fabric
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

The source does not explicitly classify this release as client-only or server-only.

What else does Linkwright 1.3.1 (Fabric) need?

Linkwright 1.3.1 (Fabric) on 1.20. Every mod below is checked against that same setup.

No extra mods listed for this file

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.3.1 (Fabric) on 1.20. Pick another file and the loader, install side or required mods may change.

  1. 01

    Stick to this file

    Use Linkwright 1.3.1 (Fabric). It targets 1.16.3, 1.17.1, 1.21 with Fabric; another release may have different loader, side or dependency requirements.

  2. 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.

  3. 03

    Put it on the correct side

    The project page does not say whether this file belongs on the client, dedicated server, or both.

  4. 04

    Pick the file you checked

    Use the “Get this file” button beside Linkwright 1.3.1 (Fabric). It opens that exact file at the source.

About this project

What does Linkwright add?

Linkwright

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, or of NeoForge, Forge or Fabric Loader itself. When that 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:

  1. Finds version rules that aren't met, between mods or on the loader.
  2. Checks every class, method and field one mod uses from the other, including mixins.
  3. Adapts small changes, but only when there is exactly one safe way to do it.
  4. 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

  • Loader version locks: a mod only accepts an older NeoForge, Forge or Fabric Loader than yours. Linkwright checks everything the mod uses in the loader, and lets it run on your newer one. It also works the other way for small gaps: a mod that asks for NeoForge 21.1.266 when you have 21.1.265 is checked the same way.
  • 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.
  • Removed parameters: a method needs fewer inputs than before. Linkwright leaves out the extra ones.
  • Wrapped values: a value is now handed over inside a wrapper, such as a Supplier, Optional or Holder. Linkwright unwraps it.
  • Fields and getters: a field was swapped for a getter or setter method, or the other way around. Linkwright uses whichever one exists now.
  • Renamed getters: a method like getName() was renamed to name(), or back. Linkwright follows the new name.
  • Moved classes: a class moved to another package in the same mod. Linkwright points the mod at its new home.
  • Static changes: a method became static, or stopped being static. Linkwright adjusts the call to match.
  • Duplicate mods: the same mod is in your mods folder twice, usually an old version left behind after an update. Linkwright keeps the copy you added last, even if it is the older version, and disables the other by renaming it to .jar.disabled. Your launcher shows it as a disabled mod, so you can turn it back on. If Linkwright can't tell which copy came last, it leaves both and tells you.

What It Warns About

Some problems can't be fixed, but Linkwright points them out in your log and in the report, so you know what to change:

  • Wrong Java version: a mod built for a newer Java than the one your game runs on.
  • Duplicate mods it can't sort out: for example on servers that don't record when files were added, or on NeoForge 21.9 and newer, where NeoForge loads the highest version itself.

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 tests every fix first. Each fixed class is checked in memory before the game is allowed to start. If a fix would fail, it is not used, and you get the normal error instead of a crash.
  • 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.3.1.jar
  • Forge 1.13.2 to 1.16.5: linkwright-1.13-1.16.5-1.3.1.jar
  • Forge 1.7.10 to 1.12.2: linkwright-1.7.10-1.12.2-1.3.1.jar
  • Fabric, any version: linkwright-fabric-1.3.1.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.3.1.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 example java -javaagent:mods/linkwright-fabric-1.3.1.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 to false to only approve mods that match exactly, with no fixes.
  • ignore: mod pairs to leave alone, written as "modA->modB" or "modA->neoforge".
  • disableDuplicates: set to false to only warn about duplicate mods instead of disabling the older copy.
  • olderLoaderBuilds: set to false to leave mods alone when they ask for a later build of your loader.
  • 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.
  • Methods that were removed, or renamed to something new, can't be fixed. Moved classes are only followed when they keep their name.
  • If a mod needs a newer release of your loader, such as NeoForge 21.2 when you have 21.1, Linkwright leaves it alone. Update your loader instead. Only later builds of the same release, where just the last number differs, are checked.

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.

227 available setups

Showing 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

8 of 17 releases match
Clear filters

Looking for an older file? The official CurseForge project page is in Resources.