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 - Spawn a cosmetic for yourself
/guppycosmetics give - 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
```yaml
hat1:
material: LEATHER_HORSE_ARMOR
name: "Example Hat"
lore:
- "A fancy hat with a gradient name"
- "Custom hex color text"
item_model: custom:hats/hat1
overlay: custom:overlay/hat1-overlay
permission: example.permission.node
```
backbling.yml
```yaml
backbling1:
material: LEATHER_HORSE_ARMOR
name: "Frost Wings"
lore:
- "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
```yaml
balloon1:
material: LEATHER_HORSE_ARMOR
name: "Red Balloon"
lore:
- "A bright red balloon that floats"
- "Brings joy wherever it goes"
- "Party Collection'> Festive Item"
item_model: custom:balloons/ballon1
permission: guppycosmetics.balloon.red
```
暂无评论，抢个沙发吧~