Mars Cosmetics

MarsCosmetics is a flexible, modern cosmetics plugin for Paper servers that lets players customize how they appear in chat and when joining or leaving the server.

Designed to be highly configurable, MarsCosmetics includes GUI-based cosmetic selection, dynamic commands, PlaceholderAPI support, CMI integration, gradients, hex colors, configurable messages, and more.

Key Features

• GUI-based cosmetic selection
• Central cosmetics menu
• Custom chat tags
• Custom name colors
• Custom chat colors
• Custom join messages
• Custom leave messages
• Login-safe permission validation
• Automatic removal of cosmetics when permissions are lost
• /marscosmetics updateplayer <player> support
• PlaceholderAPI integration
• CMI join/leave and vanish/fake-message support
• Built-in chat formatting
• Dynamic menu commands
• Dynamic aliases
• Menu aliases
• Configurable close/back/reset buttons
• Configurable messages and message prefix
• Optional close-after-selection/reset behavior
• Selected cosmetic glow
• Hidden enchantments, attributes and additional tooltip data
• Full RGB hex support
• &#RRGGBB color format
• <#RRGGBB> color format
• Gradient support such as <#ffffff:#f6d151>
• Configurable default name color
• Configurable default chat color
• Fully configurable GUI items, materials, names and lore
• Permission-based cosmetics
• Persistent player cosmetic selections
• Reload support without restarting the server

PlaceholderAPI
MarsCosmetics provides placeholders for use in chat formats and other plugins, including:


%marscosmetic_tag%
%marscosmetic_name%
%marscosmetic_message%
%marscosmetic_joinmessage%
%marscosmetic_leavemessage%

Display-name placeholders are also available for selected cosmetics.

Built-in Menu Actions
MarsCosmetics includes configurable menu actions such as:


[OPENMENU]
[RESETTAG]
[RESETNAMECOLOR]
[RESETCHATCOLOR]
[RESETJOIN]
[RESETLEAVE]
[CLOSE]

Chat Formatting
MarsCosmetics can optionally handle chat formatting itself while still allowing chat-filter plugins to cancel messages.

The built-in formatter supports:

• PlaceholderAPI placeholders
• custom name colors
• tags
• chat gradients
• hover text
• click-to-message actions
• legacy colors
• RGB hex colors
• gradients

CMI Support
MarsCosmetics includes support for CMI-based servers, including:

• custom join messages
• custom leave messages
• CMI vanish/fake join and leave messages
• PlaceholderAPI-based join/leave formatting
• optional automatic message handling

Configuration
The plugin is split into clean, readable YAML files for easy configuration:


config.yml
cosmetics.yml
guis.yml
playerdata.yml

Everything from GUI layout to messages, permissions, colors, icons and cosmetic behavior can be customized.

MarsCosmetics is built for server owners who want a clean, premium cosmetics system without being locked into a fixed layout or chat format.