Cosmetic Companion

✨ Bring your adventures to life with animated floating companions that follow you wherever you go!

Cosmetic Companion is a Forge 1.20.1 mod that adds adorable, fully animated 3D companions to Minecraft. These companions are purely cosmetic—they don't fight, collect items, or change gameplay—but they'll always be by your side with smooth animations and beautiful models powered by GeckoLib.

Whether you're exploring caves, building your dream base, or battling bosses, your favorite companion will accompany you every step of the way.

Features

🐾 Animated 3D Companions

Start with five unique companions:

🔥 Fire Companion – A tiny dragon that radiates warmth.
💧 Water Companion – A floating magical energy cube.
🌿 Nature Companion – A cheerful forest spirit.
🌑 Shadow Companion – A mysterious hooded traveler.
✨ Light Companion – A friendly floating mimic chest.

Each companion includes:

Smooth GeckoLib animations
Floating movement
Automatic player following
Unique appearance and personality

Companion Menu

Press G to open the Companion Menu.

From here you can:

Browse all unlocked companions
View animated 3D previews
Read each companion's lore
Equip or unequip companions instantly
See ownership status

The interface automatically scales to your screen resolution and is designed to feel like vanilla Minecraft.

Persistent Progress

Your companion collection is saved automatically.

Companions remain unlocked after:

Player deaths
Server restarts
Dimension changes
Rejoining the world

Server Friendly

Cosmetic Companion is fully multiplayer compatible.

Server administrators can manage player companions using built-in commands.

Commands

/companion give <player> <id>
/companion remove <player> <id>
/companion equip <player> <id>
/companion unequip <player>
/companion list <player>

Only Server operators can use these commands.🤖

Perfect for:

Survival servers
RPG servers
Adventure maps
Events and giveaways

Configurable

The included configuration file allows server owners to customize:

Follow distance
Hover height
Movement speed
Teleport distance
Companion names
Companion descriptions

Custom names and lore automatically sync to every connected player.

Planned Features

This is only the beginning!

Future updates will introduce:

More companions
Seasonal companions
Companion rarity system
Special visual effects
Companion animations
Additional customization options

Requirements

Minecraft 1.20.1
Forge
GeckoLib

FAQ

Do companions give buffs?

No. Cosmetic Companion is designed to be 100% cosmetic and does not affect gameplay balance.

Can I have multiple companions equipped?

Currently, one companion can be equipped at a time.

Does it work on servers?

Yes! Both single-player and multiplayer are fully supported.

Support

If you encounter any issues or have suggestions for new companions, feel free to leave a comment on the CurseForge page. Feedback is always appreciated!