WrapperLib
WrapperLib is a library for serializing data across Fabric, Forge and Quilt, with one API for each supported loader and Minecraft version.
What it does
Mod authors can describe their data once and let the library handle encoding and decoding, so they do not have to write NBT, byte buffer or JSON serialization code by hand. The project is built as a set of modules, and only the parts that need an outside dependency pull one in, so a project can include just what it uses. The library is used for common tasks in mod development, and it covers several platform implementations behind one interface.
Its main uses are sending information between client and server, saving extra information alongside world data, and letting players adjust mod features by editing JSON files. The API is exposed through a builder-style class that needs a short setup step before use. Files exist for Fabric, Forge and Quilt across eight release versions, 1.16.5 – 1.19.3, and the latest file for each loader is 1.1.0+1.19.3 for 1.19.3, dated 2023-01-24. The library runs on client and server, so both sides need it. WrapperLib is open source under the Mozilla Public License 2.0.
Key features
Unified serialization
Data types are encoded and decoded through one interface, so the same code works on each supported loader.
Client and server messaging
Information can be sent between a client and a server without writing packet encoding by hand.
World data storage
Extra values can be saved with world data, keeping mod state in the save alongside vanilla information.
JSON configuration
Mod features can be set by players through JSON files, which the library reads and writes.
Compatibility
Latest build for each game version and loader.
Only full game releases are shown. This mod publishes no snapshot builds.
Use cases
Who it’s for: The library is aimed at mod authors who write data handling for Minecraft Java Edition. Players do not need to work with it directly, though other mods that depend on it will require it to be installed on both sides.
How it compares
Kinecraft is open source under the MIT License, works on client or server with either side optional, and covers 1.16.5 – 1.21.5 on Fabric, Forge, NeoForge and Quilt. CorgiLib is open source under the GNU Lesser General Public License v3.0 only and is required on both client and server, with files for 1.19.2 – 1.21.11 on the same four loaders.
| Mod | Loaders | Game versions | Environment | Updated |
|---|---|---|---|---|
| WrapperLib | Fabric, Forge and Quilt | 1.16.5 – 1.19.3 | Client and server | 2023-01-24 |
| Kinecraft | Fabric, Forge, NeoForge and Quilt | 1.16.5 – 1.21.5 | Client or server, optional | 2025-11-09 |
| CorgiLib | Fabric, Forge, NeoForge and Quilt | 1.19.2 – 1.21.11 | Client and server | 2026-10-10 |
Questions
Which loaders does WrapperLib support?
Does WrapperLib need to be installed on the server?
Do mod authors need to write serialization code themselves?
In the catalog
WrapperLib is one of 3,514 Library mods on ModsFinder, and one of 2,348 Library mods for Fabric. 7,205 mods support Minecraft 1.19.3.
More from lukegrahamlandry
Similar mods
What the author says
A collection of multi-platform implementations of common tasks for developing Minecraft mods.
Official listing
- Modrinth page
- modrinth.com/mod/wrapperlib
- Owner
- lukegrahamlandry
- Published
- 2022-12-06
- Updated on Modrinth
- 2023-01-24
- Facts verified
- 2026-10-15