README.md

Faithful fancy fashion features for fuzzy folk.

The GitHub repository for Ears is now a mirror of the Gitea repository. GitHub-side issues will still be responded to.

Ears is a player model customization mod available for a dizzying number of Minecraft versions.

Get it and/or learn more at CurseForge, Modrinth, or Glass Repo.

Check out the Manipulator!

Mappings Notice: Ears platform ports use a variety of mappings, including Plasma, Yarn, MCP, and Mojmap. References to these mappings are made even in common code. Viewer discretion is advised.

Using the API

Ears provides an API (identical for all ports) that allows forcing Ears features to not render, or to change whether or not Ears thinks the player is wearing some kinds of equipment or has elytra equipped, what Ears features a player has set, etc.

You can add it to your mod like so (it's the same for Fabric or Forge):

repositories {
	maven {
		url "https://repo.unascribed.com"
		content {
			includeGroup "com.unascribed"
		}
	}
}

dependencies {
	implementation "com.unascribed:ears-api:1.4.5"
}

You can see examples of usage of both current APIs in real code in Fabrication and Yttr. Fabrication uses a state overrider to add support for its /hidearmor system, and Yttr uses the inhibitor system to force things not to render when the diving suit is worn.