Configuration

plugins/MoJoins/config.yml holds the settings, and the texts live in language files. Every key has a default, so you can delete the ones you don’t change, and a config from an older version keeps loading. /mojoins reload applies changes without a restart.

A broken config.yml doesn’t stop the plugin: it logs the error, runs on the defaults, and /mojoins reload says “reloaded with errors”.

General

Key	Default	What it does
enabled	true	false turns the plugin off, and the vanilla join and quit lines come back
debug	false	true logs how each player’s language was picked
metrics	true	false turns bStats off for Mo’Joins

Languages: locales

Key	Default	What it does
default	en	The language for players nothing else matches, and for the console
sources	[ ip, client ]	Where a player’s language comes from, tried in order
countries	see below	Language → the ISO 3166 country codes that get it

countries:
  ru: [ RU, BY, KZ, KG, TJ, UZ, AM, AZ, MD, GE, TM ]
  es: [ ES, MX, AR, CO, CL, PE, VE, EC, GT, CU, BO, DO, HN, PY, SV, NI, CR, PA, UY, PR, GQ ]
  pt: [ BR, PT, AO, MZ, CV, GW, ST, TL ]
  de: [ DE, AT, CH, LI, LU ]

How a player gets their language explains the order.

Country database: geoip

Key	Default	What it does
enabled	true	false downloads nothing and skips the ip source
url	DB-IP’s monthly file	A MaxMind-format country database, plain or gzipped. {year} and {month} fill in the current month
refresh_days	30	Downloads a new file once the one on disk is this old

When this month’s file isn’t out yet, the plugin tries last month’s.

Who reads what: broadcast

Key	Default	What it does
join	true	join to everyone when a player comes back
first_join	true	first_join to the newcomer and first_join_broadcast to everyone else
quit	true	quit to everyone else
vanilla_log	true	Writes “ joined the game” and “ left the game” to the server log, for tools that read it

Sounds: sounds

sounds:
  join: { enabled: true, key: "minecraft:entity.experience_orb.pickup", volume: 1.0, pitch: 1.0 }
  first_join: { enabled: true, key: "minecraft:entity.player.levelup", volume: 1.0, pitch: 1.0 }

Only the player who joined hears it. key takes any sound id.

Particles: particles

particles: { enabled: true, type: "minecraft:happy_villager", radius: 1.5, points: 12 }

A ring of points particles (4 to 64) at radius blocks around the player who joined. Particles that need extra data, like dust, don’t fit, and the log says so.

Firework: firework

Key	Default	What it does
enabled	false	Launches a rocket over the player who joined
power	1	Flight height, 0 to 3
type	BALL	BALL, BALL_LARGE, STAR, BURST, or CREEPER
flicker, trail	true	The burst’s look
colors	[ "#FFD54F", "#FFFFFF" ]	#RRGGBB, r,g,b, rgb(r, g, b), or a name
fade_colors	[ "#FFA000" ]	The colors it fades to
damage	false	Whether its blast hurts players nearby

Color names: white, black, red, green, blue, yellow, aqua, fuchsia, orange, lime, pink, purple, navy, teal, sky, gold.

Potion effects: effects

effects: [ { name: resistance, duration: 10, amplifier: 1 } ]

Every join gives these effects. duration is in seconds, and amplifier 0 is level I. The list is empty by default.

Bad values

A bad sound, particle, or effect id logs a warning and drops out. The rest of the config still works.

Next: PlaceholderAPI