{"id":78667,"date":"2026-06-04T15:54:18","date_gmt":"2026-06-04T12:54:18","guid":{"rendered":"https:\/\/vpesports.com\/minecraft\/mods\/guppycosmetics\/"},"modified":"2026-06-04T15:54:18","modified_gmt":"2026-06-04T12:54:18","slug":"guppycosmetics","status":"publish","type":"mod","link":"https:\/\/vpesports.com\/minecraft\/mods\/guppycosmetics\/","title":{"rendered":"GuppyCosmetics"},"content":{"rendered":"

![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.](https:\/\/i.imgur.com\/Z3M70nH.png)<\/p>\n

\nText Version<\/summary>\n

# GuppyCosmetics
\n**For Minecraft 1.21.4 ONLY**<\/p>\n

A lightweight yet powerful cosmetics plugin featuring custom hats and backblings<\/p>\n

## Features
\n– \u2726 Custom Hats, Backblings & Balloons
\n– \u2726 Resource Pack Support with Custom Model Data
\n– \u2726 Dyeable Cosmetics
\n– \u2726 MiniMessage Format Support
\n– \u2726 Permission-Based System
\n– \u2726 Easy Configuration
\n– \u2726 Persistent Across Server Restarts
\n– \u2726 Tab Completion Support<\/p>\n

## Key Features<\/p>\n

### Custom Cosmetics System
\n– Unique hat, backbling and balloon system
\n– Support for custom 3D models
\n– Dyeable cosmetics for personalization
\n– Position adjustments for backblings
\n– Persistent equip states<\/p>\n

### Modern Text Formatting
\n– Full MiniMessage format support
\n– Gradient colors
\n– Custom hex colors
\n– Hover text effects
\n– Rich formatting options<\/p>\n

### User-Friendly Commands
\n“`
\n\/guppycosmetics spawn – Spawn a cosmetic for yourself
\n\/guppycosmetics give – Give a cosmetic to another player
\n\/guppycosmetics reload – Reload configurations
\n“`<\/p>\n

### Permissions System
\n– guppycosmetics.spawn – Spawn cosmetics
\n– guppycosmetics.give – Give cosmetics to others
\n– guppycosmetics.reload – Reload configurations
\n– guppycosmetics.cosmetics – Access to cosmetics inventory
\n– Custom permission nodes for individual cosmetics<\/p>\n

## Requirements<\/p>\n

**\u26a0\ufe0f Version Requirements**
\n– Minecraft 1.21.4 ONLY – Plugin will not work on other versions
\n– Java 17 or higher
\n– Paper\/Spigot server<\/p>\n

**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.<\/p>\n

## Installation
\n1. Download GuppyCosmetics.jar
\n2. Place in your plugins folder
\n3. Start\/restart your server
\n4. Configure in the generated config files
\n5. Set up your resource pack (see wiki for guide)<\/p>\n

## Configuration<\/p>\n

\nhats.yml<\/summary>\n

“`yaml
\nhat1:
\n material: LEATHER_HORSE_ARMOR
\n name: “Example Hat<\/gradient>”
\n lore:
\n – “A fancy hat with a gradient name”
\n – “<#55FFFF>Custom hex color text”
\n item_model: custom:hats\/hat1
\n overlay: custom:overlay\/hat1-overlay
\n permission: example.permission.node
\n“`
\n<\/details>\n

\nbackbling.yml<\/summary>\n

“`yaml
\nbackbling1:
\n material: LEATHER_HORSE_ARMOR
\n name: “Frost Wings<\/gradient>”
\n lore:
\n – “<#00FFFF>Crystalline wings of pure ice”
\n item_model: custom:backblings\/backbling1
\n permission: example.permission.node
\n position:
\n x: 0.0
\n y: -0.6
\n z: 0
\n“`
\n<\/details>\n

\nballoons.yml<\/summary>\n

“`yaml
\nballoon1:
\n material: LEATHER_HORSE_ARMOR
\n name: “Red Balloon<\/gradient>”
\n lore:
\n – “<#FF6B6B>A bright red balloon that floats”
\n – “Brings joy wherever it goes”
\n – “Party Collection’> Festive Item<\/hover>”
\n item_model: custom:balloons\/ballon1
\n permission: guppycosmetics.balloon.red
\n“`
\n<\/details>\n<\/details>\n","protected":false},"excerpt":{"rendered":"

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.<\/p>\n","protected":false},"featured_media":78668,"template":"","meta":{"_minecraft_slug":"guppycosmetics","_minecraft_project_id":"UeyiYlC4","_minecraft_author":"tenshiku","_minecraft_license":"GPL-3.0-or-later","_minecraft_downloads":136,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"guppycosmetics.zip","_minecraft_size_bytes":1265889,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-15T18:51:45.475302Z","_minecraft_date_created":"2025-03-17T03:40:10.669900Z","_minecraft_date_modified":"2025-03-11T01:20:41.491886Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/guppycosmetics","_minecraft_icon_attachment_id":78668,"_minecraft_imported_at":"2026-06-04T12:54:19+00:00","_minecraft_import_hash":"65985517115dc3d5563a0d884607bbb5","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[88,89,127,867,129],"mod_loader":[132,134],"minecraft_version":[38],"class_list":["post-78667","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-equipment","mod_category-game-mechanics","mod_category-paper","mod_category-social","mod_category-spigot","mod_loader-paper","mod_loader-spigot","minecraft_version-1-21-4"],"yoast_head":"\nGuppyCosmetics - Minecraft<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/vpesports.com\/minecraft\/mods\/guppycosmetics\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"GuppyCosmetics - Minecraft\" \/>\n<meta property=\"og:description\" content=\"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.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/vpesports.com\/minecraft\/mods\/guppycosmetics\/\" \/>\n<meta property=\"og:site_name\" content=\"Minecraft\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"2 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/guppycosmetics\\\/\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/guppycosmetics\\\/\",\"name\":\"GuppyCosmetics - Minecraft\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/guppycosmetics\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/guppycosmetics\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/guppycosmetics-icon-6630609c9ff29e0a6542a9796ad99f32025dccd5_96.webp\",\"datePublished\":\"2026-06-04T12:54:18+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/guppycosmetics\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/guppycosmetics\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/guppycosmetics\\\/#primaryimage\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/guppycosmetics-icon-6630609c9ff29e0a6542a9796ad99f32025dccd5_96.webp\",\"contentUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/guppycosmetics-icon-6630609c9ff29e0a6542a9796ad99f32025dccd5_96.webp\",\"width\":96,\"height\":96},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/guppycosmetics\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Mods\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"GuppyCosmetics\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\",\"name\":\"Minecraft\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"GuppyCosmetics - Minecraft","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/vpesports.com\/minecraft\/mods\/guppycosmetics\/","og_locale":"en_US","og_type":"article","og_title":"GuppyCosmetics - Minecraft","og_description":"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.","og_url":"https:\/\/vpesports.com\/minecraft\/mods\/guppycosmetics\/","og_site_name":"Minecraft","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"2 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/vpesports.com\/minecraft\/mods\/guppycosmetics\/","url":"https:\/\/vpesports.com\/minecraft\/mods\/guppycosmetics\/","name":"GuppyCosmetics - Minecraft","isPartOf":{"@id":"https:\/\/vpesports.com\/minecraft\/#website"},"primaryImageOfPage":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/guppycosmetics\/#primaryimage"},"image":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/guppycosmetics\/#primaryimage"},"thumbnailUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/guppycosmetics-icon-6630609c9ff29e0a6542a9796ad99f32025dccd5_96.webp","datePublished":"2026-06-04T12:54:18+00:00","breadcrumb":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/guppycosmetics\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/vpesports.com\/minecraft\/mods\/guppycosmetics\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/vpesports.com\/minecraft\/mods\/guppycosmetics\/#primaryimage","url":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/guppycosmetics-icon-6630609c9ff29e0a6542a9796ad99f32025dccd5_96.webp","contentUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/guppycosmetics-icon-6630609c9ff29e0a6542a9796ad99f32025dccd5_96.webp","width":96,"height":96},{"@type":"BreadcrumbList","@id":"https:\/\/vpesports.com\/minecraft\/mods\/guppycosmetics\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/vpesports.com\/minecraft\/"},{"@type":"ListItem","position":2,"name":"Mods","item":"https:\/\/vpesports.com\/minecraft\/mods\/"},{"@type":"ListItem","position":3,"name":"GuppyCosmetics"}]},{"@type":"WebSite","@id":"https:\/\/vpesports.com\/minecraft\/#website","url":"https:\/\/vpesports.com\/minecraft\/","name":"Minecraft","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/vpesports.com\/minecraft\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"}]}},"_links":{"self":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod\/78667","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod"}],"about":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/types\/mod"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media\/78668"}],"wp:attachment":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media?parent=78667"}],"wp:term":[{"taxonomy":"mod_category","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_category?post=78667"},{"taxonomy":"mod_loader","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_loader?post=78667"},{"taxonomy":"minecraft_version","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/minecraft_version?post=78667"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}