Setup

Why The One Who Watches needs GeckoLib (and how to match it)

What GeckoLib is, why mod versions 1.4.0 and up depend on it, and how to choose the matching file.

Two puzzle pieces joining, one showing an animation skeleton, representing the GeckoLib dependency

The single most common reason The One Who Watches fails to load is a missing or mismatched GeckoLib. The mod's CurseForge description is direct about it: mod versions 1.4.0 and up require GeckoLib. Since the current files are version 1.4.4, that applies to anyone downloading today.

What GeckoLib is

GeckoLib is a separate library mod that other mods use to play smooth, keyframed animations on entities, blocks and items. Instead of each creature mod writing its own animation system, it relies on GeckoLib to handle that work. You never interact with GeckoLib directly; it only needs to be present so the mods that depend on it can load.

For a mod built around a single, unsettling creature, how that creature moves is a large part of the effect. That is why the dependency exists.

Picking the matching file

Three things must line up between GeckoLib and your setup:

CheckWhat it has to match
LoaderForge. A GeckoLib build for Fabric or NeoForge will not satisfy a Forge mod.
Game versionThe same Minecraft version as the mod jar: 1.20.1 with 1.20.1, or 1.19.2 with 1.19.2.
Library versionThe version range the mod expects. The relations tab on the mod's CurseForge page shows which GeckoLib project it depends on.

If you install through the CurseForge app, it normally resolves this automatically. If you install by hand, check the GeckoLib file name before you drop it in; it usually spells out both the loader and the game version.

Recognising a GeckoLib problem

Forge checks dependencies before it finishes loading. When GeckoLib is missing, you typically get an error screen instead of the title menu, saying a mod requires another mod that is not installed, or that the installed version is outside the accepted range. The message names the dependency, which makes this one of the easier problems to diagnose.

Other signs it is GeckoLib-related:

  • The game loaded fine before you added The One Who Watches, and fails right after.
  • You recently updated Minecraft or Forge and left an older GeckoLib in the folder.
  • You have two GeckoLib jars in the mods folder at once. Keep only one.

Fixing it

  1. Open your mods folder and remove every GeckoLib file in it.
  2. Download one GeckoLib build for Forge and your exact game version.
  3. Place it next to The One Who Watches jar and launch again.

If the game still refuses to start, the problem may be elsewhere: a Forge build that is too old, or the wrong Java version. The full troubleshooting guide covers those cases, and the install guide shows the complete setup from scratch.

Will GeckoLib conflict with my other mods?

GeckoLib is a shared library, so many popular creature and armour mods already use it. If another mod in your pack already brought it in, you do not need a second copy, as long as the existing one matches what The One Who Watches expects. When two mods want different GeckoLib ranges, Forge will tell you at launch, and you will need to pick versions of those mods that agree.

Related guides