Overview

SimpleCosmetics is a lightweight, easy-to-use plugin that lets your players equip stylish particle trails. With a clean, intuitive GUI, players browse and manage their cosmetics with ease. It's built to be efficient and user-friendly, a fun addition to any server without hurting performance.


✨ What's Enhanced

Compared to Refrac's original, the Enhanced fork adds:

• Full RGB/Hex color support (&#hex)
• Editable GUI slots, material, item names, and adjustable menu rows (1 to 6)
• Multiple lore lines per item
• A unified /cosmetics command with subcommands and tab completion
• Self-updating config that merges new keys without touching your edits
• Broader version support (1.18 to 1.20.4) on Spigot, Paper, Purpur, and Pufferfish

Features

• Particle Trails: players choose from a variety of cool particle effects that follow them as they walk.
• RGB/Hex Support: use modern hex colors anywhere, in the form &#hex.
• Easy-to-Use GUI: a clean menu (/cosmetics) lets players browse and equip trails, with a configurable 1 to 6 row layout.
• Permission-Based: control which trails players can use, each has its own node (simplecosmetics.trails.<trailname>).
• Highly Configurable: customize messages, menu layout (slots, material, names, rows, multi-line lore), and trail details in config.yml, with helpful comments on every key.
• Self-Updating Config: powered by boosted-yaml, future updates merge new keys into your file without overwriting your edits or comments.
• Update Checker: an optional SpigotMC version check, toggleable in the config.

Commands

All functionality lives under /cosmetics, with tab completion on every subcommand (admin-only ones are hidden from non-admins).

• /cosmetics or /cosmetics menu open the cosmetics menu (simplecosmetics.use)
• /cosmetics clear remove your active trail (simplecosmetics.use)
• /cosmetics help list the commands (simplecosmetics.use)
• /cosmetics reload reload the configuration (simplecosmetics.admin)
• /cosmetics update check for a new version (simplecosmetics.admin)
• /cosmetics version show the plugin version (simplecosmetics.admin)

Custom command aliases can be defined in config.yml and register on startup.


Trail Permissions

simplecosmetics.use (open the menu) now defaults to true, so non-op players can use cosmetics out of the box.

• simplecosmetics.trails.flame Flame trail
• simplecosmetics.trails.heart Heart trail
• simplecosmetics.trails.slime Slime trail
• simplecosmetics.trails.smoke Smoke trail
• simplecosmetics.trails.critical Critical trail
• simplecosmetics.trails.notes Notes trail
• simplecosmetics.trails.lava Lava trail
• simplecosmetics.trails.water Water trail
• simplecosmetics.trails.cloud Cloud trail

Compatibility

• Minecraft: 1.18 to 1.20.4
• Server software: Spigot, Paper, Purpur, Pufferfish
• Java: 17 or higher

Installation

1. Drop the jar into your plugins/ folder.
2. Start the server once to generate config.yml (plus a config.yml.example and readme.txt reference for RGB hex colors).
3. Edit your trails, menu rows, and messages, then run /cosmetics reload.

Metrics

This plugin uses bStats to collect anonymous usage stats. Opt out anytime by setting BStats.Enabled to false in the config, or in plugins/bStats/config.yml.