CustomAvatars-0.0.1.jar
1 Feb 2026
Client Not supported Server Required Dependencies No extras listed Listed on Project page
Check the setup Back to mods 
CurseForge · Hytale mod
Custom Avatars
Custom Avatar Mod is a Hytale server plugin that automatically applies custom player models as player avatars when entering the world.
Choose a version Pick your version below, then grab the matching file.
Quick answer
Which Custom Avatars release should I use?
Latest stable file CustomAvatars-0.0.1.jar
Game version Not listed
Mod system Built-in Hytale mod system
Custom Avatars CustomAvatars-0.0.1.jar targets Hytale. Do not install it as a separate client mod. Enable it on the world host—the local server in singleplayer or the dedicated server in multiplayer. No required dependencies listed for this file.
Where it goes
Where should Custom Avatars be installed in Hytale?
Do not install it as a separate client mod. Enable it on the world host—the local server in singleplayer or the dedicated server in multiplayer.
Separate client mod Not supported
World host / dedicated server Required
Mod system for this release Built-in Hytale mod system
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume
Put Hytale mods on the world host or dedicated server. Singleplayer runs a local server too; Hytale does not use separate client mods.
What else does Custom Avatars CustomAvatars-0.0.1.jar need?
CustomAvatars-0.0.1.jar. Change the file and its required mods may change too.
This file does not list any required mods. Do not add a library just because a different file uses it.
This file does not list any required or optional project dependencies. Check the creator notes before changing an existing world.
Before you install it
Add Custom Avatars without breaking your instance.
Built for Custom Avatars CustomAvatars-0.0.1.jar. Pick another file and the loader, install side or required mods may change.
- 01
Stick to this file
Use CustomAvatars-0.0.1.jar. It targets Hytale; another release may target a different game build or dependency set.
- 02
Bring the mods it needs
This file does not list any required mods. Do not add a library just because a different file uses it.
- 03
Enable it on the world host
Do not install it as a separate client mod. Enable it on the world host—the local server in singleplayer or the dedicated server in multiplayer.
- 04
Pick the file you checked
Use the “Get this file” button beside CustomAvatars-0.0.1.jar. It opens that exact file at the source.
About this project
What does Custom Avatars add?
Custom Avatar Mod is a server-side plugin that brings personalized avatar customization to your Hytale server. When players join, the plugin automatically applies custom 3D models matching their display names, creating a unique visual identity for each player.
Core Features:
- 🎭 Automatic Avatar Application - Models are automatically applied when players join the server
- 📁 Name-Based Model Matching - Uses exact case-sensitive player names to find corresponding models
- 🔄 Easy Reset System - Simple command to restore default appearance
How It Works:
When a player joins, the plugin checks for a ModelAsset with an ID matching their exact display name (case-sensitive)
If found, the player's original model is safely stored and replaced with the custom model
Players can use
/clearavatarat any time to restore their original appearance
Model Setup:
To assign a custom model to a player:
Create your 3D model in Hytale's Asset Editor
Set the ModelAsset ID to the exact player name (case-sensitive)
Example: For player "Steve", name your model asset "Steve"
For player "Alex123", name your model asset "Alex123"
The plugin will automatically detect and apply the model when that player joins
Need help getting started? Check out this comprehensive video tutorial by OrionGplays which covers everything from basic modeling to exporting for this plugin 📺
Don't have time to model? If you want a high-quality, professional look without the work, OrionGplays is currently open for Custom Avatar Commissions! Get a unique identity designed specifically for your character. 🐦 Check out Commission Info on Twitter.
Available Commands:
/clearavatar- Resets your avatar to the default model/applyavatar- Manually applies a custom avatar to yourself
Perfect For:
- Roleplay servers with character-specific appearances
- Creative servers offering personalized avatars
- Community servers wanting unique player identities
Requirements:
- Hytale server with plugin support
- Models created in Hytale's Asset Editor
- ModelAsset IDs matching player display names exactly
⚠️ CRITICAL REQUIREMENT: This plugin does nothing by itself - you must provide ModelAsset packs with models named after player display names. Without these external model assets, the plugin will simply pass through players with their default appearance.
🔗 Links:
Project description from CurseForge.
Recent files
Custom Avatars releases and Hytale builds
Looking for an older file? The official CurseForge project page is in Resources.