Configuration

The Duels and Scaffold config files on lobby and game servers, and every setting in settings.yml, common-settings.yml and scaffold.yml.

Files

Folder	Files
`plugins/DuelsLobby/`	`settings.yml`, `messages.yml`, `menus.yml`, `common-settings.yml`, `common-messages.yml`, `common-menus.yml`
`plugins/DuelsGame/`	`settings.yml`, `messages.yml`, `menus.yml`, `common-settings.yml`, `common-messages.yml`, `common-menus.yml`
`plugins/Scaffold/`	`scaffold.yml`, `settings.yml`, `messages.yml`, `menus.yml`

settings.yml holds timings, limits and sounds.
messages.yml holds every chat line, title and scoreboard line. & codes, hex colours like &#FFAA00 and MiniMessage tags all work. <primary> and <secondary> are the server colours from Kernel. Words in braces are filled in by the plugin, and each message's comment lists the ones it gets.
menus.yml holds menu titles, items, slots and the lobby hotbar.
The common- files hold text and settings used by both plugins. Each plugin reads its own copy, so change them on the server that runs the feature.

Every file is commented. Saving a file reloads it. Delete a line to get its default back.

Kits, maps, the lobby spawn, ranked settings and tiers are not in these files. They are stored in MongoDB and changed in game.

DuelsLobby settings.yml

Key	Default	Meaning
`queue.casualSound`	`block.note_block.chime`, volume 0.8, pitch 1.4	Played when the casual queue opens.
`queue.rankedSound`	`block.beacon.power_select`, volume 0.8, pitch 0.9	Played when the ranked queue opens.
`queue.matchFoundSound`	`minecraft:block.trial_spawner.about_to_spawn_item`, volume 100, pitch 0.2	Played when a match is found.
`queue.matchFoundSoundTicks`	`55`	How long the match found sound plays before it is cut off, in ticks.
`lobby.reviewRequiredPlays`	`100`	Duels a player must have played before `/stasis`.
`editor.moveLimit`	`1.5`	Blocks a player may move before the kit editor saves and closes.
`editor.doubleSneakMillis`	`1500`	Time between the two sneaks that leave the creative kit editor.
`editor.titleFadeMillis`	`250`	Fade time of the creative editor title.
`editor.titleStayMillis`	`1500`	How long the creative editor title stays.
`editor.kitsMenuSound`	`item.book.page_turn`, volume 0.7, pitch 1.1	Played when staff open the kit list.
`duel.requestExpiry`	`60`	Seconds a duel or party duel request stays valid.
`party.ffaMin`	`3`	Fewest online members for Party FFA.
`party.ffaMax`	`16`	Most players in a Party FFA.
`party.redRoverMin`	`3`	Fewest online members for Red Rover.
`party.teamFightsMin`	`2`	Fewest online members for Team Fights.

Lobby sounds have sound, volume and pitch keys and use Minecraft sound keys.

DuelsGame settings.yml

Key	Default	Meaning
`match.endDelay`	`100`	Ticks the arena stays open after a casual match.
`match.rankedEndDelay`	`200`	Ticks the arena stays open after a ranked match.
`match.killCreditSeconds`	`10`	How long after a hit the attacker still gets the kill.
`match.countdownTitleStay`	`900`	Milliseconds each countdown number stays on screen.
`match.countdownTitleFadeOut`	`150`	Milliseconds each countdown number takes to fade.
`match.countdownSound`	`BLOCK_NOTE_BLOCK_HAT`	Played on every second of the countdown.
`match.roundStartSound`	`ENTITY_FIREWORK_ROCKET_BLAST`	Played when a round starts.
`match.killSound`	`BLOCK_NOTE_BLOCK_PLING`, pitch 3.0	Played to a player who gets a kill.
`match.winnerBannerTicks`	`100`	How long the winner hologram stays.
`match.victoryEffectTicks`	`80`	How long the skull and particle shower last.
`match.roundScoreTicks`	`50`	How long the round score stays after a round.
`match.outcomeTitleTicks`	`60`	How long the VICTORY or DEFEAT title plays.
`match.deathDropTicks`	`100`	How long the fake item drops on death stay visible.
`match.deathDropItems`	`8`	Most items shown as fake drops.
`match.autoGgDelay`	`2`	Auto-gg delay in seconds when a player has not picked one.
`match.autoGgMaxDelay`	`10`	Longest auto-gg delay a player may pick.
`match.highRankAlertDivisions`	`3`	Top divisions whose ranked matches are announced. 0 turns it off.
`rating.celebration`	`true`	Plays the rank-up animation on promotion.
`rating.celebrationDelay`	`25`	Ticks before the rank-up animation starts.
`rating.placementStepSound`	`BLOCK_NOTE_BLOCK_BIT`	Played as the placement bar fills.
`rating.placementDoneSound`	`ENTITY_EXPERIENCE_ORB_PICKUP`	Played when the placement bar stops.
`rating.placementVolume`	`0.35`	Volume of both placement sounds.
`replay.skipSeconds`	`5`	How far rewind and forward jump.
`spectate.doubleSneakWindow`	`1500`	Milliseconds for the double sneak that leaves the camera view.

Game sounds use Bukkit sound names. Match sounds have sound, volume and pitch keys; an empty sound plays nothing.

common-settings.yml

Key	Default	Read by	Meaning
`review.flagThreshold`	`3.0`	DuelsGame	Weighted guilty votes before a player is flagged to staff.
`review.closeVotes`	`7`	DuelsGame	Votes after which a review closes without a flag.
`replayRetentionDays`	`30`	DuelsGame	Days a replay is kept.
`startingEffectsSound`	`ENTITY_SPLASH_POTION_BREAK`	DuelsGame	Played when a kit's starting effects are applied.

Scaffold scaffold.yml

Key	Default	Meaning
`gameServer`	`true`	Whether this server hosts games. Keep it `true` on game and replay servers.
`mirror`	`false`	Cross-region 1v1 matches with Mirror. Overridden by the `SCAFFOLD_MIRROR` environment variable. Needs a restart.

Scaffold settings.yml

Key	Default	Meaning
`game.abandonSeconds`	`60`	How long a waiting game may stay empty before it closes.
`game.fastForwardSeconds`	`10`	When a game fills up, the countdown drops to this if it is higher.
`game.waitingSound`	`block.note_block.hat`	Played when the countdown stops because players left.
`game.waitingSoundPitch`	`0.5`	Pitch of `waitingSound`.
`game.fireballCooldownMillis`	`500`	Time between two fire charge throws by one player.
`queue.maxQueues`	`4`	Queues one player may be in at once.
`queue.eloRange`	`10`	Starting rating search range.
`queue.eloRangeLimit`	`2000`	Largest search range.
`queue.eloRangeGrowth`	`1.5`	How much the range grows each step.
`queue.eloRangeIntervalMillis`	`1500`	How often the range grows.
`queue.sendDelayTicks`	`60`	Delay between a match being found and the players being sent.
`party.maxSize`	`30`	Most members in a party.
`party.inviteExpirySeconds`	`300`	How long a party invite stays valid.
`party.disconnectGraceSeconds`	`15`	How long a member may be offline before removal.
`party.createSound`	`item.goat_horn.sound.1`	Played when a party is created.
`party.disbandSound`	`block.anvil.land`	Played when a party is disbanded.

Scaffold sounds use Minecraft sound keys without minecraft:. Leave a sound empty for none.