MasterCosmetics
ModrinthSpigotMCCreate cosmetics and pets with custom effects using the skills of MythicMobs.
20 загрузок обновлено 3mo ago
последняя v1.0.0 Modrinth
- 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
— toggles a cosmetic on or off. Works only if you own the cosmetic. - /mc unequip
— removes a specific cosmetic. - /mc unequipall — removes all active cosmetics at once.
- /mc give
(admin) — assigns a cosmetic to a player. Without this command, the player cannot equip it. - /mc remove
(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/
.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}.
Комментарии 0
Пока нет комментариев. Будь первым, кто поделится мнением.