☰ Contents: MRpvp
For admins

Configuration

Easiest in the browser: with MRadmin under Plugins → MRpvp → Configuration - every setting with an explanation, saving reloads MRpvp right away (permission mradmin.config). Everything is also commented in plugins/MRpvp/config.yml; you apply changes by hand with /mrpvp reload.

Section What for More
general Language of the players (auto = like the Minecraft client), fallback and server language Languages & messages
arena-world · arenas Own world of the arenas, ready copies per arena Arenas
duel · duel-options Reconnecting, allowed commands, choices when challenging How a duel works
stats · review · monitor Count limits per opponent, automatic scoring, detecting stat farming Reviewing suspicious rounds
protection · history Protect the Minecraft statistics, how long combat logs and inventories are kept
discord Discord log Discord log
updates · gui Notice about new versions, menus (e.g. quick-select ban durations)

Every single setting with its default is listed below under All settings.

More files

File Content
plugins/MRpvp/lang/<language>.yml all messages in MiniMessage format - more under Languages & messages
plugins/MRpvp/kits.yml the kits - see Kits
plugins/MRpvp/templates/ the arenas - see Arenas
plugins/MRpvp/mrpvp.db rounds, statistics and saved inventories (SQLite)

All settings

Every setting of config.yml with its default - the same fields as in MRadmin's browser form. The list is generated automatically from the plugin and therefore always matches this version.

General

Language of the texts in game and on Discord.

Setting Default Meaning
general.language Automatic (auto) Language of the players - Automatic = every player gets the language of their Minecraft client.
general.fallback-language English (en) Fallback language - For players whose language has no file of its own.
general.server-language English (en) Language for Discord - Discord logs and suspicious rounds (through MRadmin).

Arena world

MRpvp creates the empty world itself and sets its rules on every start (no mobs, no weather, PvP on).

Setting Default Meaning
arena-world.name mrpvp_arenas Folder name of the world - The old world stays where it is. (needs a restart)
arena-world.difficulty Normal (normal) Difficulty - Peaceful does not work - players would heal during the fight.
arena-world.time 6000 ticks Fixed time of day - 0 = morning, 6000 = noon, 13000 = evening, 18000 = midnight.

Arenas

Ready-built arenas and their limits.

Setting Default Meaning
arenas.pool-per-template 1 Ready per template - That many arenas stand ready - a duel starts without waiting. 0 = build on start. Changeable per arena in the admin menu.
arenas.max-slots 32 At most at the same time - All templates together - further duels wait.
arenas.spacing 1000 blocks Distance between arenas (needs a restart)
arenas.max-width 64 blocks Largest width - Up to 64 × 48 × 64 an arena builds without a noticeable wait.
arenas.max-height 48 blocks Largest height
arenas.headroom 150 blocks Headroom - For elytras and maces - whoever flies higher is reset.

Duels

Invite, countdown and what applies during the round.

Setting Default Meaning
duel.invite-seconds 30 seconds Invite lasts
duel.invite-cooldown-seconds 10 seconds Wait between invites - No wait with mrpvp.bypass.cooldown.
duel.countdown-seconds 3 seconds Countdown before the fight - Players are frozen meanwhile, 0 = right away.
duel.end-delay-seconds 3 seconds Pause after the end - Before both get their things back.
duel.reconnect-seconds 20 seconds Wait for reconnect - Once per match and player, the opponent is frozen meanwhile. 0 = lost right away.
duel.totems on Totems save - Off = whoever triggers a totem counts as defeated.
duel.allowed-commands msg, tell, w, r, reply, report, sc Commands allowed in a duel - Without /. /duel always works (give up), all others are blocked. Exception: mrpvp.bypass.commands.

Choices when challenging

What players can set after picking the kit.

Setting Default Meaning
duel.options.wins 1, 2, 3, 5 Wins to choose from - "First to" - 1 = one round.
duel.options.default-wins 1 Default wins
duel.options.minutes 3, 5, 10, 15 min Time limits to choose from - Per round - then it is a draw.
duel.options.default-minutes 10 minutes Default time limit
duel.options.default-hunger on Hunger on by default - Kits can fix it.
duel.options.default-regen on Natural regeneration on by default - Kits can fix it (e.g. UHC without regeneration).

Statistics

Own duel statistics (K/D, wins, streaks, leaderboard) - apart from the Minecraft statistics.

Setting Default Meaning
stats.min-duration-seconds 10 seconds Shorter rounds without a hit are suspicious
stats.max-counted-per-opponent-per-day 50 Rounds per opponent and day - More within 24 hours is suspicious (statistic farming). 0 = no limit.
stats.quit-counts-as-death on Leaving counts as a death
stats.surrender-counts-as-death on Giving up counts as a death
stats.border-counts-as-kill on Knocking out of the arena counts as a kill
stats.min-games-for-ratio 10 Rounds until K/D and win rate - Only in the leaderboard from that many rounds.

Review

Suspicious rounds wait for a decision (admin menu → Review, web interface). Until then they do not count.

Setting Default Meaning
review.hold farming, limit, short, hit, border, idle Hold back on - Reasons not chosen are only reported - the round counts normally.
review.auto-days 7 days Decide automatically after
review.auto-decision Counts (count) Automatic decision
review.notify on Notify the team - Online admins with mrpvp.admin.review get a message - on joining, how many are waiting.

Protection

What a round should not change in the game world.

Setting Default Meaning
protection.revoke-advancements on No advancements in the arena - E.g. from kit armour - no toast, no message.
protection.restore-statistics on Reset the Minecraft statistics - Damage and jumps back to the state before the round. Deaths and kills never count anyway.

History

Results and numbers of the rounds are always kept for the statistics.

Setting Default Meaning
history.days 30 days Keep the combat log - Combat log, positions (mini map) and inventory at the end.
history.snapshot-days 90 days Keep saved inventories - State when entering. Ones not yet returned are never deleted.

Monitoring

Suspicious rounds in the admin menu, in MRadmin and if wanted in MRadmin's Discord admin log (remembered for 24 hours).

Setting Default Meaning
monitor.enabled on Monitoring on
monitor.farming.rounds 8 Farming: at least rounds - Of the same pair within the time below.
monitor.farming.minutes 60 minutes Farming: within
monitor.farming.winner-percent 90 % Farming: same winner in
monitor.farming.max-loser-damage-percent 20 % Farming: loser deals at most - Share of all damage in these rounds. Even fights between friends are never suspicious.
monitor.max-hit-hearts 20 hearts Suspiciously strong hit from - Except with the mace.
monitor.border-tries 10 Tries to leave the arena
monitor.idle-seconds 90 seconds Suspicious without a hit from

Discord logs

Send events to a Discord channel. Webhook: Edit channel → Integrations → Webhooks → New webhook → copy URL.

Setting Default Meaning
discord.enabled off Send Discord logs
discord.webhook-url empty Webhook URL - Starts with https://discord.com/api/webhooks/
discord.use-mradmin-webhook off Use MRadmin's webhook - Without a webhook URL of its own, the events go to MRadmin's Discord log.
discord.username MRpvp Name in the channel - Empty = setting from Discord.
discord.avatar-url empty Avatar URL - Empty = setting from Discord.
discord.use-embeds on Coloured embeds - Off = plain text messages.
discord.footer Minecraft-Server Footer - E.g. the server name (empty = none).
discord.events Duel ended: Send false · Colour #2ECC71
Suspicious round: Send true · Colour #E67E22
Round waits for review: Send true · Colour #F1C40F
Review: counted: Send true · Colour #27AE60
Review: discarded: Send true · Colour #C0392B
Team: round stopped: Send true · Colour #9B59B6
Team: winner declared: Send true · Colour #9B59B6
Team: round paused: Send true · Colour #9B59B6
Team: round resumed: Send true · Colour #9B59B6
Team: out of the statistics: Send true · Colour #C0392B
Team: counted again: Send true · Colour #27AE60
Kit saved: Send true · Colour #3498DB
Kit deleted: Send true · Colour #E74C3C
Kits imported: Send true · Colour #3498DB
Arena published: Send true · Colour #1ABC9C
Arena deleted: Send true · Colour #E74C3C
Arena draft discarded: Send true · Colour #95A5A6
Duel ban: Send true · Colour #C0392B
Ban lifted: Send true · Colour #27AE60
Statistics reset: Send true · Colour #E67E22
Inventory given back: Send true · Colour #3498DB
Defaults restored: Send true · Colour #9B59B6
Team: reloaded: Send true · Colour #3498DB
Events - Which events are sent and in which colour. The texts are in the language files.

Updates

Look for new versions of MRpvp.

Setting Default Meaning
updates.enabled on Look for updates - On start and regularly afterwards. A notice appears in the console.
updates.source GitHub (github) Source
updates.include-prereleases off Pre-releases too - When a pre-release (0.x) runs they are always reported.
updates.interval-hours 6 hours Check every
updates.notify-on-join on Tell the team on join - Players with mrpvp.admin.update get a notice.

The menus of /duel.

Setting Default Meaning
gui.refresh-ticks 20 ticks Refresh every - 20 ticks = 1 second.
gui.sounds on Click sounds
gui.ban-durations 1d, 7d, permanent Quick choices duel ban - Exactly three durations on MRadmin's player page, "permanent" = forever.

Generated automatically from src/main/resources/web-config.yml + config.yml.

✎ Edit on GitHub·docs/wiki/en/konfiguration.md ↗·View unreleased state