https://github.com/unascribed/ears

Faithful fancy fashion features for fuzzy folk.
https://github.com/unascribed/ears

ears fabricmc minecraft minecraft-mod minecraft-retromod retromod skin tail

Last synced: 1 day ago
JSON representation

Faithful fancy fashion features for fuzzy folk.

• Host: GitHub
• URL: https://github.com/unascribed/ears
• Owner: unascribed
• License: mit
• Created: 2020-10-09T03:58:51.000Z (over 4 years ago)
• Default Branch: trunk
• Last Pushed: 2024-09-02T02:12:45.000Z (5 months ago)
• Last Synced: 2025-01-20T03:17:04.774Z (1 day ago)
• Topics: ears, fabricmc, minecraft, minecraft-mod, minecraft-retromod, retromod, skin, tail
• Language: Java
• Homepage: https://ears.unascribed.com
• Size: 1.47 MB
• Stars: 97
• Watchers: 7
• Forks: 17
• Open Issues: 71
• Metadata Files:
  • Readme: README.md
  • Changelog: change-version.sh
  • License: LICENSE

Awesome Lists containing this project

README

        


  

  
Faithful fancy fashion features for fuzzy folk.


**The GitHub repository for Ears is now a [mirror of the Gitea repository](https://git.sleeping.town/unascribed/Ears).** 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](https://www.curseforge.com/minecraft/mc-mods/ears), [Modrinth](https://modrinth.com/mod/ears),

or [Glass Repo](https://glass-repo.net/repo/mod/ears).

Check out the [Manipulator](https://unascribed.com/ears)!

**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

![Current API version](https://img.shields.io/maven-metadata/v?color=%23FB0&label=current%20api%20version&metadataUrl=https%3A%2F%2Frepo.unascribed.com%2Fcom%2Funascribed%2Fears-api%2Fmaven-metadata.xml)

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):

```gradle

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](https://github.com/unascribed/Fabrication/blob/2.0/1.17/src/main/java/com/unascribed/fabrication/features/FeatureHideArmor.java#L62)

and [Yttr](https://github.com/unascribed/Yttr/blob/trunk/src/main/java/com/unascribed/yttr/compat/EarsCompat.java).

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.