Resource Pack

🎵 Resource Pack

The Soundtrack System allows you to create immersive, theme-based audio experiences for your arenas. Each game can use a different soundtrack, and players automatically receive the resource pack containing all music and sound effects.

Soundtracks are fully customizable and can be switched dynamically using commands — no server restart required.

---

⭐ Features

• 🎧 Automatic download prompt when joining the game

• 📦 No manual resource pack installation required

• 🎨 Fully customizable textures and sounds to match your theme

• 🔁 Dynamic soundtrack switching between game environments (e.g., Empyrean, Noxus)

---

⚙️ Configuration

resource-pack:
  # Enable or disable the custom resource pack (textures and sounds).
  enabled: true
  # Send the resource pack to players when they join.
  send-on-join: true
  # Kick players who decline to accept the resource pack.
  kick-if-declined: true
  # Direct download URL for the resource pack file.
  download-url: "https://bit.ly/42aQEGD"
  # SHA-1 hash to verify the integrity of the resource pack file.
  sha-1-hash: "dcf3f58801afad1f3950550de0406dcbc6b2ad8a"

---

🎶 Soundtrack

Each soundtrack entry defines the music for different game phases, team outcomes, and rounds.

EMPYREAN:
  game:
    lobby:
      - "arena_music_empyrean_lobby"
    intro:
      - "arena_music_empyrean_intro"
    phase:
      - "arena_music_empyrean_prep_1"
      - "arena_music_empyrean_prep_2"
      - "arena_music_empyrean_prep_3"
    end:
      - "arena_music_empyrean_end_1"
      - "arena_music_empyrean_end_2"
  team:
    win:
      - "arena_music_empyrean_fight_win"
    loss:
      - "arena_music_empyrean_fight_loss"
  round:
    1:
      - "arena_music_empyrean_fight_1"
    2:
      - "arena_music_empyrean_fight_2"
      - "arena_music_empyrean_fight_3"
      - "arena_music_empyrean_fight_4"
      - "arena_music_empyrean_fight_5"
      - "arena_music_empyrean_fight_6"

---

🛠 Changing a Soundtrack

You can change a game’s active soundtrack at any time using the following command:

/al gamesetting soundtrack <game ID> soundtrack ID>

Example:

/al gamesetting soundtrack testarena EMPYREAN

This command updates the currently used soundtrack for that game. The change takes effect immediately, allowing you to:

• Switch between different themed packs (e.g., Noxus → Empyrean)

• Test new soundtracks during development

• Assign unique music per map or game mode

• Each soundtrack name (e.g., EMPYREAN, NOXUS) corresponds to a section in your config.

• Sound identifiers (like arena_music_empyrean_fight_1) must exist in your resource pack’s sounds.json.

• You can include multiple variations per round — one is chosen randomly.

• The system automatically handles music transitions between phases (lobby, intro, rounds, victory/defeat, etc.).