ModsFinder

CompatLayer

by McJty

CompatLayer is a Forge library from McJty that eases porting mods between Minecraft 1.10.2 and 1.11.2, covering names, events and world access.

ForgeClient and serverMIT LicenseOpen source1.10.2 – 1.11.2

What it does

Its main job is to help a mod written for one of these versions also run on the other. Resource names, including lang files, model names, JSON files and texture files, are lowercased so they load the same way on both. Mod ids are lowercased too, and a handler for the FMLMissingMapping event lets worlds saved with older block or item names still load.

Code changes for the 1.11 API are covered as well. Calls to tileEntity.worldObj are replaced by tileEntity.getWorld, and entityPlayer.worldObj by entityPlayer.getEntityWorld, so a single codebase can build a jar that runs on both versions. Installed on the client and on the server, the library is a small toolset rather than a full compatibility framework, and the author notes that some parts are not complete yet.

CompatLayer is released under the MIT License and is open source. Its files cover 1.10.2, 1.11 and 1.11.2, with 1.11.2-0.3.1 for 1.11.2 as the latest build, published on 2023-01-26.

Key features

  1. Lowercase resource names

    Resource names such as lang files, model names, JSON files and texture files are converted to lowercase.

  2. Missing mapping handler

    An FMLMissingMapping event handler lets worlds saved with older names load without errors.

  3. Lowercase mod ids

    Mod ids are converted to lowercase so they match across versions.

  4. Method replacement helpers

    Helpers replace tileEntity.worldObj with tileEntity.getWorld and entityPlayer.worldObj with entityPlayer.getEntityWorld.

Compatibility

Latest build for each game version and loader.

1.11.21.11.2-0.3.1
1.111.11-0.1.7
1.10.21.10-0.3.1
ReleaseBetaAlphaNot available

Only full game releases are shown. This mod publishes no snapshot builds.

Required by 1 mod

CombatHelp1.9 – 1.11.2

Use cases

Porting a mod to 1.11

A mod author can use the library to carry an existing 1.10.2 mod toward 1.11 with fewer manual renames.

Sharing one jar across versions

A mod built with the helpers can produce a single jar that runs on both 1.10.2 and 1.11.2.

Who it’s for: Forge mod developers who maintain a mod for both 1.10.2 and 1.11.2, and server owners who need a dependency for a mod that uses this library.

Questions

Does CompatLayer need to be installed on both sides?

Yes. Installation covers the server and each player's game.

Which mods require CompatLayer?

CombatHelp is listed as a mod that requires CompatLayer.

Which game versions does CompatLayer support?

Its files cover 1.10.2, 1.11 and 1.11.2, and the latest Forge build is 1.11.2-0.3.1 for 1.11.2.

In the catalog

CompatLayer is one of 3,514 Library mods on ModsFinder, and one of 1,576 Library mods for Forge. 528 mods support Minecraft 1.11.2.

Library mods3,514Forge modsMods for 1.11.2528

More from McJty

All projects
The Lost Cities1.10.2 – 26.2In Control!1.10.2 – 26.2McJtyLib1.7.10 – 1.21.1RFTools Base1.14.3 – 1.21.1RFTools Utility1.14.4 – 1.21.1The One Probe1.9 – 26.2

Similar mods

Just Enough Items (JEI)1.8 – 26.3Bookshelf1.7.10 – 26.3GlitchCore1.10.2 – 26.3BisectHosting Server Integration Menu1.7.10 – 26.3CraftPresencea1.0.17_04 – 26.3AzureLibb1.7.3 – 26.3

What the author says

This small mod/library has some tools that can help to make mods binary compatible between 1.10 and 1.11. If you make sure you use the api in this mod correctly it is possible to make a mod jar that runs on both versions. A few things that you should do in addition to what this library does: - Make all resource names…
McJty, on the Modrinth page

Official listing

Owner
McJty
Published
2023-01-26
Updated on Modrinth
2023-01-26
Facts verified
2026-10-15

Tags

Library
Open on ModrinthCompare