Go to file
Nolij c5ee5c4747
add getSkyColor mapping to ClientWorld (#2899)
2021-12-04 01:55:45 +00:00
.github/workflows Build fully on Java 17, closes #2670 (#2676) 2021-09-14 21:21:33 +01:00
gradle/wrapper Build fully on Java 17, closes #2670 (#2676) 2021-09-14 21:21:33 +01:00
mappings add getSkyColor mapping to ClientWorld (#2899) 2021-12-04 01:55:45 +00:00
src Barebone javadoc for brain, explains why (#2475) 2021-06-09 00:14:21 +01:00
unpick-definitions Unpick lightmap constants. (#2595) 2021-07-23 13:54:03 +01:00
.editorconfig Unpick biome IDs (#2258) 2021-04-02 19:01:56 +01:00
.gitattributes Use eol=lf on *.mapping files to help Windows users (#493) 2019-03-20 00:14:47 +00:00
.gitignore Update Dependencies (#2343) 2021-04-24 10:07:59 +01:00
CONTRIBUTING.md Add CONTRIBUTING.md, mention mojmap being ARR (#1222) 2020-03-26 14:12:00 +00:00
CONVENTIONS.md Fix English errors in CONVENTIONS.md and README.md (#2414) 2021-05-20 14:20:55 +00:00
HEADER Minor javadoc updates around unpick (#2200) 2021-03-28 20:33:12 +01:00
LICENSE first commit 2016-08-12 15:28:17 +02:00
MAINTAINERS add maintainer list for lgtm 2016-08-19 23:19:08 +02:00
README.md Fix English errors in CONVENTIONS.md and README.md (#2414) 2021-05-20 14:20:55 +00:00
build.gradle Build fully on Java 17, closes #2670 (#2676) 2021-09-14 21:21:33 +01:00
enigma_profile.json The Great Intermediary Update, Part 1 2019-06-28 23:55:20 +02:00
gradle.properties Revert "Use automapped names for documented fields (#2571)" 2021-07-19 21:49:44 +01:00
gradlew Build fully on Java 17, closes #2670 (#2676) 2021-09-14 21:21:33 +01:00
gradlew.bat Use github actions to publish releases 2020-11-06 23:33:17 +00:00
settings.gradle Build javadoc against java 16 2021-05-12 20:59:27 +01:00
unpick-logging.properties Fix unpick log spamming (#2189) 2021-03-25 12:45:12 +00:00



Yarn is a set of open, unencumbered Minecraft mappings, free for everyone to use under the Creative Commons Zero license. The intention is to let everyone mod Minecraft freely and openly, while also being able to innovate and process the mappings as they see fit.

To see the current version being targeted, check the branch name!


To use yarn-deobfuscated Minecraft for Minecraft modding or as a dependency in a Java project, you can use loom Gradle plugin. See fabric wiki tutorial for more information.

To obtain a deobfuscated Minecraft jar, ./gradlew mapNamedJar will generate a jar named like <minecraft version>-named.jar, which can be sent to a decompiler for deobfuscated code.

Please note to run the yarn build script Java 16 or higher is required!


Please remember that copying and pasting mappings from alternate projects under more restrictive licenses (such as MCP, Spigot's or Mojang's obfuscation maps) is completely forbidden without explicit permission from the owners of said mappings to distribute the names under the CC0 license. This includes using the names from those mappings for inspiration. Discussing the naming approaches used in said projects is also not welcome - you have been warned. However, it is a good idea to consult name changes with other people - use pull requests or our community spaces to ask questions!

Please have a look at the naming conventions before submitting mappings.

Getting Started

  1. Fork and clone the repo
  2. Run ./gradlew yarn (Linux, macOS) or gradlew yarn (Windows) to open Enigma, a user interface to easily edit the mappings
  3. Commit and push your work to your fork
  4. Open a pull request with your changes


Yarn uses Gradle to provide a number of utility tasks for working with the mappings.


Setup and download and launch the latest version of Enigma automatically configured to use the merged jar and the mappings.

Compared to launching Enigma externally, the gradle task adds a name guesser plugin that automatically maps enums and a few constant field names.


Same as above, but unpicks the constants and launches Enigma with them. Can be a little bit slower to get going.


Build a GZip'd archive containing a tiny mapping between official (obfuscated), intermediary, and yarn names ("named") and packages enigma mappings into a zip archive..


Builds a deobfuscated jar with yarn mappings and automapped fields (enums, etc.). Unmapped names will be filled with intermediary names.


Decompile the mapped source code. Note: This is not designed to be recompiled.


Downloads the client and server Minecraft jars for the current Minecraft version to .gradle/minecraft


Merges the client and server jars into one merged jar, located at VERSION-merged.jar in the mappings directory where VERSION is the current Minecraft version.