If you are looking to clone this repository, either for contributing or for personal use, you might want to check out this guide

<div align="center"> <img src="README-assets/icon.png" width="150">

Entity Texture Features

</div>

🤔 What does this mod do?

ETF is a Fabric (Quilt compatible) & Forge mod that adds many new Entity Texture Features, including entity and player skin features!
This way, ETF achieves more OptiFine parity on the Fabric mod loader. If you want more OptiFine features on Fabric, you can either check this list, made by LambdaAurora, or you can use the Fabulously Optimized modpack, which includes all the OptiFine parity mods!

Featuring:

• 🎲 Custom & random entity textures with the OptiFine format, including even more properties!
• 💡 Emissive/glowing entity textures with the OptiFine format
• 😑️ Blinking mobs
• 🎨 Player skin features

Compatibility

• OptiFine's random/custom or emissive entity resource packs - <img src="https://emojipedia-us.s3.amazonaws.com/source/skype/289/check-mark-button_2705.png" alt="✅" width="15"> Fully compatable
• Entity Model Features - <img src="https://emojipedia-us.s3.amazonaws.com/source/skype/289/check-mark-button_2705.png" alt="✅" width="15"> Fully compatible
• Sodium - <img src="https://emojipedia-us.s3.amazonaws.com/source/skype/289/check-mark-button_2705.png" alt="✅" width="15"> Fully compatible
• Iris Shaders - <img src="https://emojipedia-us.s3.amazonaws.com/source/skype/289/check-mark-button_2705.png" alt="✅" width="15"> Fully compatible<br />(Support varies depending on the shader)
• Mod added entities - <img src="https://emojipedia-us.s3.amazonaws.com/source/skype/289/check-mark-button_2705.png" alt="✅" width="15"> Compatible<br />(Only if the mod creator used the vanilla rendering code to render their mobs)

<div align="center"> <details><summary><h1>Wiki & guides [click to open]</h1></summary> <div align="left">

🎲 Random / Custom entities

</div> <img src="README-assets/random-mobs.png" alt="Random / custom entities" width="450"> <div align="left">

• For custom & random entity textures you can use a resource pack that supports the OptiFine format. ETF supports all OptFine custom and random entities, including all the properties and even more added by ETF!

</div>

-> Random / custom entity textures guide <-

<div align="left">

💡 Emissive entities

</div> <img src="README-assets/emissives.png" alt="Emissive entities" width="450"> <div align="left">

• For emissive & random entity textures you can use a resource pack that supports the OptiFine format and includes emissive entity textures.

</div>

-> Emissive entity textures guide <-

<div align="left">

🎨 Player skin features

</div>

<img src="README-assets/skins1.png" alt="Skin1" width="450"><br/> <img src="README-assets/skins2.png" alt="Skin2" width="450"><br/> <img src="README-assets/skins3.png" alt="Skin3" width="450"><br/> <img src="README-assets/jacket.png" alt="Jacket" width="450"><br/> <img src="README-assets/villager-nose.png" alt="Vllager Nose" width="275">

<div align="left">

• Player skins can use emissive, blinking, enchanted, transparency texture features, as well as other cosmetics like jackets, dress extensions and more
• They are 100% optional, controlled by the skin file you upload to Mojang and options to prevent abuse of features in PvP

</div>

-> Player skin features guide <-

<div align="left">

😑 Blinking textures

</div> <img src="README-assets/blink.png" alt="Blinking textures" width="450"> <div align="left">

• Allows resource packs to add textures in order to make mobs blink over a customizable period of time.
• Mobs will blink periodically if they have a texture named TEXTURE_blink.png
• Optionally you can also use a texture named TEXTURE_blink2.png with the eyes half closed to achieve a smoother animation for large eyes
• Random blinking frequency can be altered in settings
• Sleeping mobs will have their eyes closed if possible
• Mobs with the blindness potion effect will have either their eyes closed or half closed depending on what is available
• Blinking is supported on the player skin features
• Resource packs can set specific blinking length and frequency per texture via properties files next to the blinking texture:

</div> <img src="README-assets/blink-properties.png" alt="Blinking properties" width="280"> </details> </div>

Examples

<div align="center"> <a href="https://www.curseforge.com/minecraft/texture-packs/entity-texture-features-example-pack"> <img src="README-assets/example_pack.png" alt="example" width="450"> </a><br> <a href="https://www.planetminecraft.com/texture-pack/creepers-plus-optifine-required/"> <img src="README-assets/example_creep.png" alt="example" width="450"> </a><br> <a href="https://www.curseforge.com/minecraft/texture-packs/tissous-zombie-pack-optifine-1-7x-1-19"> <img src="README-assets/example_zomb.png" alt="example" width="450"> </a> </div>

Settings & configuration

• Settings can be changed in-game using Mod Menu, the settings button in the resource pack screen, or by editing the config file, located under config/entity_texture_features.json
• A few of these options can also be changed via the Puzzle mod

<div align="center"> <img src="README-assets/options.png" alt="Options" width="450"> </div>

Mod support

• This mod should be compatible with any mod added entities as long as they extend LivingEntityRenderer class for rendering and utilise it correctly
• Any mod displaying an entity in a custom GUI can force the default texture by having the entity.getblockstate set to either return null or VOID_AIR, the same can be achieved by settings the display mob's UUID to UUID.nameUUIDFromBytes(("GENERIC").getBytes()).

FAQ

My entities are invisible/broken!

• Custom Entity Models is not a feature provided by ETF. If your entities are invisible or look corrupted you'll need to install my other mod EMF (this includes resource packs such as Fresh Animations). Keep in mind that EMF is still in beta development and issues may still occur.

Blocks and items are not emissive!

• ETF does not support emissive block and item texture, for that you'll need to install Continuity.

My game is lagging, help!

• If you are experiencing lag please check your most recent log file to see if any errors are being logged, sometimes an incorrectly written properties file or missing textures may lag the system.

It doesn't work!

• Check if any issues are not actually a problem in the properties file, a few packs seem to be pointing to a texture that doesn't exist.
• So far all mob entities support random & emissive textures, but there may still be some quirks. If you find bugs you can either report them in GitHub or get support in the Discord server (linked on the top of the page).

Emissives are broken with Complimentary shaders, what do I do?

• Complimentary shaders has its own in-built emissive textures that usually work fine but will conflict with some resource packs. You can either disable Complimentary's emissives or ETF's emissives to fix this.

My question isn't here!

• Feel free to check ETF's Discord to ask your questions or check the FAQ there :)

Changelog

The changelog is available (for v4.1.1 & prior) on CHANGELOG.md.

License

This mod is under the GNU Lesser General Public License, v3.0.