Yarn Mapping Provider
Yarn Mapping Provider gives Fabric developers a MappingResolver for the Yarn mappings, which translate Minecraft's obfuscated names into readable ones.
What it does
The mod supplies a MappingResolver for Yarn mappings, and the mapping file is fetched automatically when it is needed. A developer can resolve named mappings without setting up a development environment, and the runtime namespace stays the same as before.
Minecraft's codebase is obfuscated, which means class, field and method names are deliberately made hard to read. Yarn is a project that produces human-readable mapping files for that codebase, and these files translate obfuscated names back to their original forms. The obfuscation exists for legal reasons and to discourage cheating in multiplayer, but it also makes the code harder for developers to read and understand.
Yarn Mapping Provider is published for Fabric only, with four release versions covering 1.19 – 1.19.3. Either side can load it, and neither the client nor the server needs it. The mod is licensed as All rights reserved and is not open source, although its source code and issue tracker are public.
Key features
MappingResolver access
The mod provides a MappingResolver that exposes Yarn mappings to other code that needs named names at runtime.
Automatic mapping retrieval
The mapping file is fetched automatically, so developers do not have to place it in the project by hand.
Named mappings without a dev environment
Named mappings can be resolved without using the development environment, which keeps the setup for other tools simpler.
Stable runtime namespace
The runtime namespace remains the same, so existing references that depend on it continue to work.
Compatibility
Latest build for each game version and loader.
Only full game releases are shown. This mod publishes no snapshot builds.
Use cases
Reading obfuscated code
Developers working on Minecraft's code can translate obfuscated class, field and method names into the original names to make the code easier to follow.
Who it’s for: Fabric mod developers who need Yarn mappings resolved in their own tools or builds. Players and server owners do not need to take any action beyond installing the mod where a dependent project requires it.
Questions
Which loader does Yarn Mapping Provider support?
Which game versions have files for Yarn Mapping Provider?
Why does Minecraft need mapping files at all?
More from KrisanaponMeksamoot
What the author says
Yarn mapping is a project that aims to create a human-readable mapping file for the Minecraft codebase. Mapping files are used to translate obfuscated class, field, and method names to their original names. Minecraft's codebase is obfuscated, which means that the names of classes, fields, and methods are…
Official listing
- Modrinth page
- modrinth.com/mod/yarn-mapping-provider
- Owner
- KrisanaponMeksamoot
- Published
- 2023-02-18
- Updated on Modrinth
- 2023-02-19
- Facts verified
- 2026-10-15
