![[1.21.4] GuppyCosmetics ✨ Custom Hats, Backblings and Balloons | Dyeable Cosmetics](https://www.spigotmc.org/data/resource_icons/121/121681.jpg?1741570031){kind=icon}
ModsJava
[1.21.4] GuppyCosmetics ✨ Custom Hats, Backblings and Balloons | Dyeable Cosmetics
Spoiler: Text version
Features
✦ Custom Hats, Backblings & Balloons
✦ Resource Pack Support with Custom Model Data
✦ Dyeable Cosmetics
✦ MiniMessage Format Support
✦ Permission-Based System
✦ Easy Configuration
✦ Persistent Across Server Restarts
✦ Tab Completion Support
Custom Cosmetics System
• Unique hat, backbling and balloon system
• Support for custom 3D models
• Dyeable cosmetics for personalization
• Position adjustments for backblings
• Persistent equip states
Modern Text Formatting
• Full MiniMessage format support
• Gradient colors
• Custom hex colors
• Hover text effects
• Rich formatting options
User-Friendly Commands
Permissions System
• guppycosmetics.spawn - Spawn cosmetics
• guppycosmetics.give - Give cosmetics to others
• guppycosmetics.reload - Reload configurations
• guppycosmetics.cosmetics - Access to cosmetics inventory
• Custom permission nodes for individual cosmetics
Requirements
⚠️ Version Requirements
• Minecraft 1.21.4 ONLY - Plugin will not work on other versions
• Java 17 or higher
• Paper/Spigot server
Note: This plugin is specifically designed for and only compatible with Minecraft 1.21.4 due to changes in the resource pack system. It will not function on earlier or later versions.
Installation
1. Download GuppyCosmetics.jar
2. Place in your plugins folder
3. Start/restart your server
4. Configure in the generated config files
5. Set up your resource pack (see wiki for guide)
Configuration
Support
• Check the Wiki for detailed guides
• Report issues on our Discord
Support the Development
If you enjoy GuppyCosmetics, consider:
• Rating the plugin
• Providing feedback
• Reporting bugs
• Suggesting features
GuppyCosmetics
For Minecraft 1.21.4 ONLY
A lightweight yet powerful cosmetics plugin featuring custom hats and backblings
For Minecraft 1.21.4 ONLY
A lightweight yet powerful cosmetics plugin featuring custom hats and backblings
Features
✦ Custom Hats, Backblings & Balloons
✦ Resource Pack Support with Custom Model Data
✦ Dyeable Cosmetics
✦ MiniMessage Format Support
✦ Permission-Based System
✦ Easy Configuration
✦ Persistent Across Server Restarts
✦ Tab Completion Support
Key Features
Custom Cosmetics System
• Unique hat, backbling and balloon system
• Support for custom 3D models
• Dyeable cosmetics for personalization
• Position adjustments for backblings
• Persistent equip states
Modern Text Formatting
• Full MiniMessage format support
• Gradient colors
• Custom hex colors
• Hover text effects
• Rich formatting options
User-Friendly Commands
Code (Text):
/guppycosmetics spawn <item-id> - Spawn a cosmetic for yourself
/guppycosmetics give <player> <item-id> - Give a cosmetic to another player
/guppycosmetics reload - Reload configurations
/guppycosmetics give <player> <item-id> - Give a cosmetic to another player
/guppycosmetics reload - Reload configurations
• guppycosmetics.spawn - Spawn cosmetics
• guppycosmetics.give - Give cosmetics to others
• guppycosmetics.reload - Reload configurations
• guppycosmetics.cosmetics - Access to cosmetics inventory
• Custom permission nodes for individual cosmetics
Requirements
⚠️ Version Requirements
• Minecraft 1.21.4 ONLY - Plugin will not work on other versions
• Java 17 or higher
• Paper/Spigot server
Note: This plugin is specifically designed for and only compatible with Minecraft 1.21.4 due to changes in the resource pack system. It will not function on earlier or later versions.
Installation
1. Download GuppyCosmetics.jar
2. Place in your plugins folder
3. Start/restart your server
4. Configure in the generated config files
5. Set up your resource pack (see wiki for guide)
Configuration
Spoiler: hats.yml
Code (YAML):
hat1:
material : LEATHER_HORSE_ARMOR
name : “<gradient:yellow:gold>Example Hat</gradient>“
lore :
- “<gray>A fancy hat with a gradient name”
- “< #55FFFF>Custom hex color text”
item_model : custom:hats/hat1
overlay : custom:overlay/hat1-overlay
permission : example.permission.node
material : LEATHER_HORSE_ARMOR
name : “<gradient:yellow:gold>Example Hat</gradient>“
lore :
- “<gray>A fancy hat with a gradient name”
- “< #55FFFF>Custom hex color text”
item_model : custom:hats/hat1
overlay : custom:overlay/hat1-overlay
permission : example.permission.node
Spoiler: backbling.yml
Code (YAML):
backbling1:
material : LEATHER_HORSE_ARMOR
name : "<gradient:blue:aqua>Frost Wings</gradient>"
lore :
- "<#00FFFF>Crystalline wings of pure ice"
item_model : custom:backblings/backbling1
permission : example.permission.node
position:
x : 0.0
y : -0.6
z : 0
material : LEATHER_HORSE_ARMOR
name : "<gradient:blue:aqua>Frost Wings</gradient>"
lore :
- "<#00FFFF>Crystalline wings of pure ice"
item_model : custom:backblings/backbling1
permission : example.permission.node
position:
x : 0.0
y : -0.6
z : 0
Spoiler: balloons.yml
Code (YAML):
balloon1:
material : LEATHER_HORSE_ARMOR
name : "<gradient:#FF0000:#FF6B6B>Red Balloon</gradient>"
lore :
- "<#FF6B6B>A bright red balloon that floats"
- "<italic><gray>Brings joy wherever it goes"
- "<hover:show_text:'<red>Party Collection'> Festive Item</hover>"
item_model : custom:balloons/ballon1
permission : guppycosmetics.balloon.red
material : LEATHER_HORSE_ARMOR
name : "<gradient:#FF0000:#FF6B6B>Red Balloon</gradient>"
lore :
- "<#FF6B6B>A bright red balloon that floats"
- "<italic><gray>Brings joy wherever it goes"
- "<hover:show_text:'<red>Party Collection'> Festive Item</hover>"
item_model : custom:balloons/ballon1
permission : guppycosmetics.balloon.red
Support
• Check the Wiki for detailed guides
• Report issues on our Discord
Support the Development
If you enjoy GuppyCosmetics, consider:
• Rating the plugin
• Providing feedback
• Reporting bugs
• Suggesting features
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft version listed: 1.21
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Spigot — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
[1.21.4] GuppyCosmetics ✨ Custom Hats, Backblings and Balloons | Dyeable Cosmetics is a free Minecraft Java mod. Compatible with Minecraft 1.21. Downloaded 882 times (via Spigot). Download it and open it directly in the game.