Game Settings

⚙️ Game Instance Settings

Every game in ArenaLegends has its own configuration. You can change these settings in-game using the /al SETTING command or by editing the game's file directly.

🎮 General Settings

Setting	Type	Default	Description
TEAM_SIZE	Integer	1	Number of players per team (e.g., 1 for Solo, 2 for Duos).
MAX_TEAMS	Integer	4	Maximum number of teams in the game.
DISABLED	Boolean	false	If true, players cannot join the game.
RANKED	Boolean	true	If true, the game affects player rating/ELO.
GENERATE_INSTANCES	Boolean	false	If true, creates temporary copies of the map for concurrent games.

🤖 Bot Settings

Setting	Type	Default	Description
FILL_WITH_BOTS	Boolean	false	If true, empty slots will be filled with NPC bots.
AUTO_START_WITH_BOTS	Boolean	false	If true, the game starts automatically once bots fill the lobby.

🎨 Content Settings

Setting	Type	Default	Description
ROUND_BUILDER	String	DEFAULT	The round configuration ID to use (from round-builder.yml).
SOUNDTRACK	String	EMPYREAN	The soundtrack ID to use (from soundtrack.yml).
LOBBY_SCHEMATIC	String		The name of the lobby schematic (e.g., al_lobby_city).
ARENA_SCHEMATICS	String		The name of the arena schematic (e.g., al_arena_forest).

---

🛠 How to Change Settings

Via Command (Recommended)

Use the /al SETTING command to modify settings instantly.

Syntax: /al SETTING <game> <setting> <value>

Examples:

• Set Team Size to 2 (Duos): /al SETTING arena1 TEAM_SIZE 2

• Enable Bots: /al SETTING arena1 FILL_WITH_BOTS true

• Change Soundtrack: /al SETTING arena1 SOUNDTRACK NOXUS

Via File

You can also edit the game's configuration file manually. Location: /ArenaLegends/games/<game-id>.yml (Example path, may vary based on storage).

setting:
  team-size: 2
  max-teams: 4
  ranked: true
  soundtrack: "NOXUS"