magik6k / pomf

Publicly Open Mapping Files: Libre Minecraft mappings, free to use for everyone. No exceptions.

Publicly Open Mapping Files

POMF 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.

The current version targets Minecraft version 16w33a.

Contributing

Please remember that copying and pasting mappings from alternate projects under more restrictive licenses (such as MCP) is completely forbidden without explicit permission from the owners of said mappings. It is also good to consult name changes with other people - use pull requests or our IRC (#fabric @ irc.esper.net) to ask questions!

WIP mapping guidelines are available here. Feel free to contribute.

Getting Started

1. Fork and clone the repo
2. Run ./gradlew pomf (macOS and Linux) or gradlew pomf (Windows)
3. Profit

Gradle

POMF uses Gradle to provide a number of utility tasks for working with POMF.

download

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

mergeJars

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

setupPomf

download and mergeJars

pomf

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