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>

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!

✨ Collect companions. Customize your adventure. Never travel alone.