GuppyCosmetics

!(https://i.imgur.com/Z3M70nH.png) <details> <summary>Text Version</summary> # 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 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 <details> <summary>hats.yml</summary> ```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 ``` </details> <details> <summary>backbling.yml</summary> ```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 ``` </details> <details> <summary>balloons.yml</summary> ```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 ``` </details> </details>