Configuration

Mo’Afks keeps its settings in plugins/MoAfks/config.yml and its messages in plugins/MoAfks/lang/ (see Languages). Every key has a default, so you can delete the ones you don’t change. Run /moafks reload to apply changes without a restart.

A bad sound or particle id logs a warning and turns off only that effect. The rest of the file still loads.

General

Key	Default	What it does
enabled	true	false turns the plugin off: nobody goes AFK
debug	false	Logs who goes AFK and why, and how each language was picked
metrics	true	false turns bStats off for this plugin
sleep_ignored	true	AFK players don’t keep the night from passing

locales and geoip

Key	Default	What it does
locales.default	en	The language for players nothing else matches, and for the console
locales.sources	[ ip, client ]	Where a player’s language comes from, tried in order
locales.countries	ru, es, pt, de lists	Language → the ISO 3166 country codes that get it
geoip.enabled	true	Downloads and uses the country database
geoip.url	DB-IP’s monthly file	Where the database comes from. {year} and {month} fill in
geoip.refresh_days	30	Downloads a new database once the old one is this old

Languages explains how these work together.

Going AFK

Key	Default	What it does
auto.enabled	true	Idle players go AFK on their own
auto.seconds	300	Seconds without activity before they do
manual.enabled	true	Players may use /afk [reason]
manual.reason_length	64	Longer reasons get cut

limits

Key	Default	What it does
limits.enabled	true	Kicks players who stay AFK too long
limits.seconds	1200	How long they may stay AFK: 20 minutes
limits.warning.enabled	true	Warns them in the action bar before the kick
limits.warning.seconds	[ 60, 30, 10, 5, 4, 3, 2, 1 ]	Seconds before the kick at which the warnings come

protection and gains

Every protection switch is on by default, and both gains switches are off. How AFK works lists what each one covers: damage, void, knockback, collision, projectiles, effects, hunger, mobs, vehicles, raids, vibrations, gains.items, and gains.experience.

anti_abuse

Key	Default	Refuses AFK
combat_seconds	15	Within this many seconds of taking damage or hitting a mob or player. 0 turns it off
falling	true	While falling or gliding
burning	true	While on fire or freezing
liquids	true	In water or lava
targeted	true	While a mob nearby is after the player

exit_triggers

Each switch that’s on ends AFK and restarts the idle timer. All are on by default.

Key	Activity
move, jump, sneak, sprint	The keys
look, look_degrees (30.0)	Turning the camera by more than look_degrees
chat	Chatting
command	Any command but /afk and /moafks
attack	Hitting a mob or a player
interact	Clicking a block, an entity, or the air
blocks	Breaking or placing a block
inventory	Opening a container or clicking in an inventory
drop, swap_hands, held_slot	Dropping an item, swapping hands, changing the held slot

sounds

Four sounds, each with enabled, key, volume, and pitch:

Key	Plays when	Default sound
enter	A player goes AFK	minecraft:block.amethyst_block.chime
exit	A player comes back	minecraft:entity.experience_orb.pickup
declined	/afk is refused	minecraft:entity.villager.no
warning	A limit warning shows	minecraft:block.note_block.pling

effects

Key	Default	What it does
effects.particles	on, minecraft:happy_villager, radius: 1.5, points: 8	A ring of particles around AFK players, every two seconds
effects.nickname.enabled	true	Puts a mark in front of AFK players’ names in the player list
effects.nickname.mark	<gray><italic>[AFK]</italic></gray>	The mark, in MiniMessage

If TAB or another plugin formats the player list, it overwrites the mark. Turn effects.nickname.enabled off and use %moafks_tag% there instead, as Integrations shows.

Next: Languages