Logo
GuppyCosmetics
PluginGPL-3.0-or-later

GuppyCosmetics

GuppyCosmetics is a Minecraft plugin for Paper/Spigot servers that adds customizable visual accessories including hats, backblings, and balloons with special effects like camera overlays and physics-based balloon animations.

119
Downloads
0
Followers
1 years ago
Updated
📦
2
Versions
equipmentgame-mechanicssocialpaperspigot
Download Latestv2.3.3View on Modrinth

📖About GuppyCosmetics

Promotional graphic for GuppyCosmetics Minecraft plugin. The dark purple image shows a stylized banner with the plugin name and tagline at the top. The page is organized into sections including Features, Key Features (custom cosmetics system and modern text formatting), User-Friendly Commands with code examples, Permissions System, Requirements (Minecraft 1.21.4 only), Installation steps, Configuration options, and Support information. The design uses orange headings and white text with a cohesive purple-themed background.

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

  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

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