Skins - MarkusBordihn/BOs-Easy-NPC GitHub Wiki

NPC Skins 🎭

Bring your NPCs to life with unique skins! The skin configuration screen offers plenty of options to make each NPC stand out.

Default Skins 🧑‍🎨

Quickly give your NPCs a fresh look by choosing from a variety of built-in skins. Just select one from the list, and it’s instantly applied.

The available skins vary based on the NPC type. For example, Villager NPCs have more skin options than Humanoid NPCs.

Player Skins 🎮

Want your Humanoid NPCs to wear a Minecraft player's skin? Just enter the player's name, click " Add," and your NPC will mirror their look. Any updates the player makes to their skin will automatically update on the NPC too!

URL Skins 🌐

Add a personal touch with remote URL skins! Paste the URL of any online skin into the configuration screen, click "Add," and watch your NPC transform instantly.

To keep things running smoothly, Easy NPC uses a local cache, so server performance won’t take a hit.

Note: Be cautious with short-lived URLs, like those from Discord. These links can expire, causing the skin to disappear for new players or after some time.

Custom Skins 📂

Unleash your creativity with custom skins! You can use your own images stored locally. Just save your skins in the config/easy_npc/skin folder in your Minecraft directory, with subfolders for each NPC type.

After adding your skins, click "Reload Custom Textures" to see them in-game.

Remember, if you're playing multiplayer, all players need the same skins in the same folders. Otherwise, they’ll see the default skin instead.

Custom skins are perfect for mod packs, making it easy to deploy unique NPC appearances. 🎮

Clearing Skin Cache 🧼

Skins are cached locally to boost performance. If you need to clear the cache, simply stop your Minecraft client and delete the easy_npc/cache folder in your game directory.

Troubleshooting 🔧

Skins are processed on the client side, so if you're having issues, check your client-side logs for errors. Skin errors will also appear as local system messages, so keep an eye out for those.

The mod will retry to load failed skins after a short delay or if the client is restarted.