Minecraft-plugin UltraCosmetics

🔌 About UltraCosmetics

UltraCosmetics is a Spigot/Paper Minecraft plugin that adds a wide range of player cosmetics and visual effects to a server. It provides a GUI-based menu and systems for pets, mounts, gadgets, particle effects, projectile effects, death effects, emotes, hats, morphs, suits and treasure chests. The project is open-source and maintained on GitHub.

🎯 Purpose

UltraCosmetics is designed to give server owners a modular cosmetics system that lets players access and equip cosmetic items and effects through an in-game menu. It solves the need for non-gameplay cosmetic customisation and monetizable cosmetic content while keeping functionality separated from core gameplay mechanics.

⚙️ Features

• GUI menu for browsing and equipping cosmetics.
• Cosmetic categories including Pets, Mounts, Gadgets, Hats, Particle Effects, Projectile Effects, Death Effects, Emotes, Morphs and Suits.
• Treasure chest functionality for granting cosmetic unlocks.
• Configurable storage for unlocked cosmetics (player data files or an SQL backend as supported by the project).
• Translation support (multiple languages maintained via the project).

🧩 Who It Is For

Server owners and administrators who want to add cosmetic content to their Spigot or Paper servers: public minigame/lobby servers, SMP networks that offer cosmetic shops, and any server that wants player-facing cosmetic customization without changing core gameplay.

🏗️ Example Use Cases

• Provide a lobby cosmetics menu so players equip pets and particle effects.
• Give staff or players access to special gadgets or emotes via commands or the GUI.
• Use treasure chests to grant random cosmetic rewards to players.
• Store player cosmetic unlocks in the server’s data files or a connected SQL database when configured.

⌨️ Commands

(Note: this command syntax is taken from the project documentation that describes treasure chest usage.)

🔐 Permissions

⚙️ Installation

📥 Setup

• Download the official plugin JAR from the project’s official distribution pages.
• Place the JAR into the server plugins/ directory for a Spigot or Paper server.
• Restart the server and check console logs to confirm the plugin loaded.

📦 Dependencies

• No required third-party dependencies are declared by default in the project README. (Only include external dependencies if explicitly configured.)

🧾 Configuration

• The plugin uses configuration and data files; by default unlocked cosmetics are stored in player data files or in a connected SQL database when configured.
• A project wiki and quick start guide provide setup options and configuration details.

🧠 Technical Notes

• Officially supports Spigot and Paper server software.
• The project provides compatibility notes for different project versions; consult the project documentation for exact supported Minecraft ranges per release.
• Source code is published under the GNU Affero General Public License v3.0.
• Issue reporting and development are handled through the project repository.

🤝 When This Plugin Is Useful

If you need a maintained, GUI-driven cosmetics system for a Spigot or Paper server that supports many cosmetic categories and configurable storage for unlocked items, UltraCosmetics provides an open-source option with in-repo documentation and community support.