Text Version
GuppyCosmetics
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
/guppycosmetics spawn <item-id> - Spawn a cosmetic for yourself
/guppycosmetics give <player> <item-id> - Give a cosmetic to another player
/guppycosmetics reload - Reload configurations
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
- Download GuppyCosmetics.jar
- Place in your plugins folder
- Start/restart your server
- Configure in the generated config files
- Set up your resource pack (see wiki for guide)
Configuration
hats.yml
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
backbling.yml
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
balloons.yml
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
