MasterCosmetics

- MasterCosmetics - Trigger-based cosmetics plugin for Paper/Purpur 1.20.6–1.21.x. It integrates with MythicMobs to execute custom skills in response to in-game events. No GUI — everything is configured via config.yml. Admins assign cosmetics to players with a command; players can toggle them on and off independently. - - Commands - - /mc list — shows the cosmetics you have equipped. - /mc equip <id> — toggles a cosmetic on or off. Works only if you own the cosmetic. - /mc unequip <id> — removes a specific cosmetic. - /mc unequipall — removes all active cosmetics at once. - /mc give <player> <id> (admin) — assigns a cosmetic to a player. Without this command, the player cannot equip it. - /mc remove <player> <id> (admin) — revokes a cosmetic from a player and unequips it if active. - /mc reload (admin) — reloads the config without restarting the server. - - Aliases: /mc, /cosm. - Permissions: mastercosmetics.use for players, mastercosmetics.admin for admins. - - Triggers - - Each cosmetic has a list of triggers that define when the MythicMobs skill is executed. Multiple triggers can be combined on the same cosmetic. - - ALWAYS — the skill repeats every N ticks continuously while the cosmetic is equipped. Use interval: N to control frequency (20 ticks = 1 second). - ON_SPAWN — triggers when the player joins the server or respawns after death. - ON_DEATH — triggers when the player dies. - ON_KILL_PLAYER — triggers when the player kills another player. - ON_KILL_MOB — triggers when the player kills any mob. - ON_HIT_PLAYER — triggers every time the player hits another player. - ON_HIT_MOB — triggers every time the player hits a mob. - ON_JUMP — triggers once per jump. - ON_FLY_TICK — triggers every N ticks while the player is flying (elytra or creative flight). Use interval: N. - ON_WALK — triggers every N ticks while the player is walking on the ground. Stops when the player stops moving. Use interval: N. - ON_IDLE — triggers every N ticks while the player is standing still on the ground. Stops when the player moves. Use interval: N. - Pet - - Each cosmetic can have a pet: section that spawns a companion mob. The owner can never damage their own pet. - - mob-type — type of mob to spawn. Use Bukkit EntityType names: PANDA, WOLF, FOX, BEE, COW, etc. - name — name displayed above the pet. Supports & color codes and the {player} placeholder (replaced with the owner’s name). - scale — size of the mob. 0.5 = half, 1.0 = normal, 2.0 = double. Requires Paper/Purpur 1.20.5+. - follow-distance — distance (in blocks) at which the pet starts moving toward the player. - immune — if true, the pet is invulnerable to all damage sources: fire, falls, explosions, attacks from players or mobs. - move-speed — movement speed of the pet. Default 0.3. Typical range: 0.15 (slow) → 0.35 (normal) → 0.70 (fast). - always-skill — MythicMobs skill executed periodically by the pet, independent of player triggers. - always-interval — how many ticks between executions of always-skill. Default 40 (2 seconds). - always-caster — who executes always-skill. "pet" = effects appear around the pet, "player" = effects appear around the player. - trigger-skill — MythicMobs skill executed when one of the defined pet triggers activates. - trigger-caster — same as always-caster, but for trigger-skill. - triggers — list of triggers that activate trigger-skill on the pet. Uses the same names as player triggers (e.g., ON_KILL_MOB, ON_HIT_PLAYER). - Database - - By default, data is stored in YAML files at playerdata/<uuid>.yml. To use MySQL, set database.enabled: true in the config and fill in the connection fields. - - database.enabled — false = YAML files, true = MySQL. - database.host — MySQL server address. - database.port — port. Default 3306. - database.name — database name. - database.username / database.password — credentials. - database.table-prefix — table prefix. Default mc_. The mc_player_data table is created automatically. - database.pool-size — number of simultaneous connections in the pool. Default 5. - database.connection-timeout — connection timeout in milliseconds. Default 30000. - - If the MySQL connection fails at startup, the plugin automatically falls back to YAML files without crashing. The MySQL driver is already included in Paper/Purpur 1.20+ — nothing extra is required. - - General Config - settings.debug — if true, logs every executed skill, every applied pet attribute, and every pathfinding attempt. Should be false in production. - settings.prefix — chat message prefix. Supports & color codes. - - All messages in the messages: section are customizable and support & color codes and placeholders such as {name}, {player}, {id}, {category}.