mojang2tiny

Convert Mojang mappings to Tiny format.

Overview

mojang2tiny is a tool that converts Mojang mapping files to the Tiny format, using an intermediary mapping file. It can be used as a command-line tool or as a Java library (API) in your own applications. This is useful for Minecraft modding and tooling workflows that require Tiny mappings.

Features

• Converts Mojang mappings to Tiny format
• Supports multiple mapping files
• Usable as a CLI or as a Java library (API)
• Command-line interface powered by picocli

Requirements

• Java 17 or higher (Java 21 recommended)

Usage

Build

Build the project using Gradle:

gradle build

Run as CLI

You can either download the latest jar from the Releases tab of this GitHub repository, or build it yourself as shown above.

After building (or downloading), you can run the tool from the command line:

java -jar build/libs/mojang2tiny-1.1.0.jar \
  -i <intermediary.tiny> \
  -m <mappings.txt> \
  -o <output-directory>
  -t v2

Arguments

• -i, --intermediary — Path to the intermediary mapping file (Tiny format)
• -m, --mappings — Mojang mapping file to convert
• -o, --output-dir — Output directory for the generated Tiny file
• -t, --tiny-version — Tiny version to use (default: v2, options: v1, v2)

Example (CLI)

java -jar build/libs/mojang2tiny-1.1.0.jar \
  -i intermediary.tiny \
  -m mojang-mappings.txt \
  -o output/
  -t v2

Use as a Java Library (API)

You can also use mojang2tiny programmatically in your own Java applications by calling the static API method:

import com.threadmc.mojang2tiny.Main;
import java.io.File;
import java.util.Arrays;

public class Example {
    public static void main(String[] args) throws Exception {
        File intermediary = new File("intermediary.tiny");
        File mappings = new File("mojang-mappings.txt");
        File outputDir = new File("output");
        String tinyVersion = "v2"; // or "v1"
        
        Main.convert(intermediary, mappings, outputDir, tinyVersion);
    }
}

• Main.convert(File intermediaryFile, List<File> mappingFiles, File outputDir)
• Throws Exception if an error occurs during conversion.

Contributing

See CONTRIBUTING.md for guidelines.

Release Notes

See RELEASE_NOTES.md for the latest changes.

License

This project is licensed under the BSD 3-Clause License. See LICENSE for details.