Skip to content

Configuration files

MRTImposterUs splits its settings into several files in plugins/MRTImposterUs/. They are all merged at runtime into a single configuration view. After editing a file by hand, apply the changes with /iu reload.

File What's inside
config.yml Core: language, debug, admin (match log), sidebar scoreboard, tab (per-match visibility), chat, commands (blocked during a match), messages (small caps, command label), stats (SQLite/MySQL), resource-pack, update-checker, metrics, setup-guide.
lobby.yml Main hub: position (set with /iu setlobby), teleport on join, protection, void level, hub items and their slots.
game.yml Match rules: players, countdown, reveal, impostors, kill cooldown and distance, vision, impostor markers and glow, hidden name tags and skins, anonymous names, ship map, ghosts, knife, rejoin, items, sounds.
tasks.yml Tasks per player (common / long / short), task bar, task markers, minigame tuning.
sabotage.yml Sabotage cooldowns, repair panels, lights, communications, reactor, oxygen and doors.
meeting.yml Discussion and voting time, emergency meetings per player and cooldown, report distance, role reveal on ejection, vote display, Players item and tab list.
roles.yml Optional roles (sheriff, engineer; medic and scientist are planned and not implemented yet).
economy.yml progression (XP and coins, XP per level – global only) and rewards (console commands for winners and kills).
languages/messages_<code>.yml Every text, in MiniMessage. See Language.
arenas/*.yml One file per arena, written by the setup GUI. See Your first arena.

The game, tasks, sabotage, meeting, roles, sounds, rewards and commands sections can be changed per arena: see Per-arena settings.

A YAML error is reported by name

If a file has a YAML error, the console tells you which file it is, and the file is never overwritten.

config.yml

Key Default Meaning
language en en or it (or your own messages_<code>.yml).
debug false Logs the whole internal flow to the console. Keep false in production (/iu debug toggles it until restart).
admin.match-log true Writes a timeline of every match to logs/<arena>-<date>.txt. See Admin tools.
scoreboard.* The plugin's sidebar. See Scoreboard.
tab.per-game-visibility true Each player only sees the players of their own match; players not in a match share the lobby group. Ghosts stay invisible to the living in any case.
chat.* Chat scope, formats, free-play chat mode, prefixes, private messages, moderation. See Chat.
commands.block-in-game true Blocks other commands while in a match or queue (also namespaced forms like essentials:spawn). iu.admin.bypass is exempt; /iu can never be blocked.
commands.allowed [] Commands still allowed to players in a match.
messages.smallcaps true Renders all texts in small caps (tags, hex colours and placeholder values are left unchanged).
messages.command-label auto The command shown in texts: auto (/iu, or /imposterus when another plugin owns /iu), imposterus or iu.
stats.* Database. See Storage.
resource-pack.* Knife pack sending and ItemsAdder copy. See Knife & resource pack.
update-checker.enabled / notify-admins / include-beta true / true / false Modrinth update check. See Admin tools.
metrics true Anonymous bStats usage statistics.
setup-guide.announce-on-join true Offer the setup guide to admins on join while no arena exists.

lobby.yml

Key Default Meaning
lobby.world, x, y, z, yaw, pitch empty The hub. Set it with /iu setlobby, don't type it by hand.
lobby.spawn-on-join true Teleports anyone joining the server to the hub (players rejoining a running match stay where they were).
lobby.protect true No breaking, placing, damage, hunger, item drops or PvP in the hub. iu.admin.build is exempt only in build mode (/iu admin).
lobby.void-level -100 Below this Y a hub player is sent back to the spawn.
lobby.hub-items true Gives the hub items (arena menu, stats) in the hub world, and removes them when leaving it.
lobby.clear-inventory-in-hub false Clears the inventory when the hub items are given. Only for a dedicated hub server.
lobby.items.stats-slot 7 Hotbar slot of the stats item.
lobby.compass.enabled / give-on-join / slot true / true / 4 The compass that opens the arena menu.

protect, void-level and hub-items work only in the world set with /iu setlobby. More in Hub, NPCs & signs.

game.yml

Key Default Meaning
min-players / max-players 4 / 12 Used when the arena doesn't set its own players.min / players.max.
countdown-seconds 30 Countdown once min-players is reached.
reveal-seconds 5 How long the role reveal stays on screen (players are frozen).
auto-start true Start the countdown automatically.
end-delay-seconds 10 End screen before the arena is reset.
impostors 4: 1, 7: 2, 11: 3 Impostors per number of players (the highest threshold reached applies; never more than parity). Ignored if the arena sets a fixed players.impostors.
kill-cooldown-seconds 30 Wait between kills.
first-kill-cooldown-seconds 20 Cooldown at the start of the match.
kill-item-delay-seconds 2 Seconds after the spawn before impostors get the kill item (0 = at once).
kill-distance 3.0 Maximum kill distance in blocks.
impostors-can-kill-each-other false
impostor-night-vision true Impostors see during the lights sabotage.
show-vent-markers true Particles on vents, for those who can use them.
impostor-markers / impostor-marker-range true / 32.0 A crown of red particles above accomplices, visible only to other impostors.
impostor-glow false Impostors glow through walls for other impostors (needs ProtocolLib).
hide-nametags true Names above heads hidden once the match starts.
anonymous-names true Players go by their suit colour everywhere. See Anonymity.
colored-names false Only with anonymous-names: false: names in suit colour in match chat and vote menu.
ship-map / ship-map-tasks / ship-map-offhand true / true / true See Ship map.
ghost-haunt / ghost-see-roles true / false See Ghosts.
disguise-impostor-items true With hidden skins, impostor items look like harmless objects.
knife / knife-visible / kill-animation false / false / true See Knife & resource pack.
show-corpse-names false Victim's name above the corpse.
hide-skins true Players become invisible, only the coloured leather armour is seen.
world-time 6000 Fixed time of the match world.
block-teleport-items true Blocks ender pearls and chorus fruit in a match.
rejoin-grace-seconds 45 Time to rejoin after a disconnect (0 = eliminated at once).
quick-join true /iu join without an arena joins the fullest available match; false opens the menu.

The items section sets the material of every item (tasks, report, player-list, kill, sabotage, kill-disguised, sabotage-disguised, haunt, compass, stats, color, leave). Items are recognised by an internal tag, never by their material, so changing them breaks nothing. A wrong material name gives a console warning and the default is used.

The sounds section has enabled (true) and master-volume (0.0–1.0) for the plugin's own sound effects.

tasks.yml

Key Default Meaning
common / long / short 1 / 2 / 3 Tasks of each type per player.
show-bossbar true Global task bar.
show-markers / marker-radius true / 24.0 Beam and ring on the next station of your tasks, visible only to you.
markers-for-impostors false Show markers to impostors for their fake tasks too.
glow-markers true Glowing outline of the station through walls.
minigames.* Tuning of each minigame. See Tasks.

sabotage.yml

Key Default Meaning
initial-cooldown-seconds 10 Before the first sabotage is available.
cooldown-seconds 30 Before the next one, counted from the repair.
hold-radius 3.0 How far you may move from a panel you're holding.
glow-panels true During a critical sabotage the panels glow red through walls.
lights.*, communications.*, reactor.*, oxygen.*, doors.* Per sabotage. See Sabotages.

meeting.yml

Key Default Meaning
discussion-seconds 30 Discussion only, nobody can vote yet.
voting-seconds 45 Voting; closes earlier if everyone votes.
emergency-per-player 3 Emergency meetings per player for the whole match.
emergency-cooldown-seconds 15 Button cooldown at the start and after every meeting (0 = off).
report-distance 4.0 Maximum distance to report a body.
button-markers true Red halo on the emergency button (grey smoke while blocked by a sabotage).
reveal-role true Reveal the role of whoever is ejected.
show-votes true Show the vote count at the end.
announce-vote-cast true Announce that a player has voted (not for whom).
live-votes true Live counts on the ballot; false = blind voting.
player-list-item / tab-player-list true / true Players item and tab footer list during meetings.

Details in Meetings & voting.

roles.yml

Role Keys What it does
Sheriff enabled: false, chance: 1.0 A single shot: if they shoot a crewmate, they die instead.
Engineer enabled: false, chance: 1.0, can-vent: true Can use vents like the impostors.
Medic enabled: false, chance: 1.0 Not implemented yet: if enabled, it is assigned and announced but plays as a normal crewmate.
Scientist enabled: false, chance: 1.0 Not implemented yet, like the medic.

All roles are on the crew side and count as normal crewmates for the win conditions. chance (0.0–1.0) is the probability the role appears in a match when enabled. Enable one at a time so as not to unbalance the match.

economy.yml

See Stats, levels & rewards.