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 #2ECC71Suspicious round: Send true · Colour #E67E22Round waits for review: Send true · Colour #F1C40FReview: counted: Send true · Colour #27AE60Review: discarded: Send true · Colour #C0392BTeam: round stopped: Send true · Colour #9B59B6Team: winner declared: Send true · Colour #9B59B6Team: round paused: Send true · Colour #9B59B6Team: round resumed: Send true · Colour #9B59B6Team: out of the statistics: Send true · Colour #C0392BTeam: counted again: Send true · Colour #27AE60Kit saved: Send true · Colour #3498DBKit deleted: Send true · Colour #E74C3CKits imported: Send true · Colour #3498DBArena published: Send true · Colour #1ABC9CArena deleted: Send true · Colour #E74C3CArena draft discarded: Send true · Colour #95A5A6Duel ban: Send true · Colour #C0392BBan lifted: Send true · Colour #27AE60Statistics reset: Send true · Colour #E67E22Inventory given back: Send true · Colour #3498DBDefaults restored: Send true · Colour #9B59B6Team: 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. |
Menus
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.