Rounds

🧭 Overview

The Round Builder controls the progression of each game. You can define what happens on a round-by-round basis, including gold distribution, health penalties, and special events like augment rolls.

The entire configuration is located in plugins/ArenaLegends/gameplay/round-builder.yml.

---

⚙️ Game Modes & Settings

The round builder is structured around Game Modes. The default mode is named DEFAULT, but you can create custom modes (e.g., TURBO, HARDCORE) by copying the DEFAULT structure and giving it a new name.

• Progression: Define as many rounds as you like (e.g., 1, 2, 3).

• Looping: If a game lasts longer than the number of rounds you have defined, it will reuse the settings from the last defined round.

• Default Fallback: You can optionally add a default section at the end of a game mode. If present, it will be used for all rounds that are not explicitly defined, instead of the last defined round.

To create a new game mode, simply copy the entire DEFAULT block in round-builder.yml, paste it at the end of the file, and rename DEFAULT to your desired mode name (e.g., SOLO_MODE:).

---

💎 Event Types

You can assign any of these events to a specific round number.

Key	Type	Description
health-penalty	integer	Damage taken by players who lose the round.
gold-given	integer	Amount of gold awarded to all players at the start of the round.
roll-augment	string	Triggers an augment selection. You can specify tiers: "SILVER,GOLD".
roll-mythic	boolean	If true, offers a mythic item selection.
roll-anvil	boolean	If true, offers an anvil stat upgrade.
high-stakes	boolean	If true, marks the round with a special visual/audio cue.

---

💡 Example

This is a shortened example of the DEFAULT game mode configuration.

# gameplay/round-builder.yml
DEFAULT:
  1:
    health-penalty: 15
    gold-given: 500
    roll-augment: "SILVER,GOLD,PRISMATIC"
  2:
    health-penalty: 15
    gold-given: 500
  3:
    health-penalty: 15
    gold-given: 1000
    roll-mythic: true
  5:
    health-penalty: 25
    gold-given: 2500
    high-stakes: true
    roll-augment: "SILVER,GOLD,PRISMATIC"
  7:
    health-penalty: 25
    gold-given: 2500
    roll-anvil: true
  default:
    health-penalty: 55
    gold-given: 2500

Full Default Configuration

DEFAULT:
  1:
    health-penalty: 15
    gold-given: 500
    roll-augment: "SILVER,GOLD,PRISMATIC"
  2:
    health-penalty: 15
    gold-given: 500
  3:
    health-penalty: 15
    gold-given: 1000
    roll-mythic: true
  4:
    health-penalty: 15
    gold-given: 1500
  5:
    health-penalty: 25
    gold-given: 2500
    high-stakes: true
    roll-augment: "SILVER,GOLD,PRISMATIC"
  6:
    health-penalty: 25
    gold-given: 2500
  7:
    health-penalty: 25
    gold-given: 2500
    roll-anvil: true
  8:
    health-penalty: 25
    gold-given: 2500
    roll-augment: "SILVER,GOLD,PRISMATIC"
  9:
    health-penalty: 45
    gold-given: 2500
    high-stakes: true
  10:
    health-penalty: 45
    gold-given: 2500
    roll-anvil: true
  11:
    health-penalty: 45
    gold-given: 2500
    roll-augment: "SILVER,GOLD,PRISMATIC"
  12:
    health-penalty: 45
    gold-given: 2500
  default:
    health-penalty: 55
    gold-given: 2500