Resource Pack

📦 Resource Pack

The Resource Pack system ensures that every player has the necessary textures and sounds for an immersive experience. ArenaLegends can automatically prompt players to download the pack upon joining, handling the entire process without manual installation.

---

⭐ Features

• Auto-Prompt: Automatically asks players to download the pack when they enter a game.

• Integrity Check: Uses SHA-1 hashes to verify the pack version and prompt for updates when changed.

• Kick Policy: Optional setting to ensure all players have the pack before playing.

• Soundtrack Integration: Links directly with the custom music system for phase-based audio.

---

🔧 Configuration

The resource pack settings are located in the main config.yml.

resource-pack:
  # Enable or disable the resource pack system.
  enabled: true
  # Send the download prompt to players when they join.
  send-on-join: true
  # Kick players who refuse to download the pack.
  kick-if-declined: true
  # Direct download URL for the .zip file.
  download-url: "https://example.com/pack.zip"
  # SHA-1 hash of the file. Change this to force a redownload.
  sha-1-hash: "dcf3f58801afad1f3950550de0406dcbc6b2ad8a"

Key	Type	Default	Description
enabled	boolean	true	Enables the resource pack handler.
send-on-join	boolean	true	Prompts player on game entry.
kick-if-declined	boolean	true	Prevents play without the pack.
download-url	string		A direct link to your hosted .zip pack.

---

🎶 Soundtrack

Each game can have its own theme-based music. These are defined in the gameplay/soundtrack.yml (or similar) configuration.

EMPYREAN:
  game:
    lobby: ["music_lobby"]
    intro: ["music_intro"]
    phase: ["music_prep_1", "music_prep_2"]
    end: ["music_win_theme"]
  team:
    win: ["stinger_victory"]
    loss: ["stinger_defeat"]
  round:
    1: ["battle_theme_1"]
    2: ["battle_theme_2"]

🚀 Usage

You can switch a game's soundtrack dynamically without a restart.

Command: /al SETTING <gameId> SOUNDTRACK <soundtrackId>

Example: /al SETTING arena1 SOUNDTRACK NOXUS

---

📝 Notes

• SHA-1 Hash: If you update your resource pack file on your host, you must update the sha-1-hash in the config, otherwise players' clients will continue using the old cached version.

• Sound Identifiers: The names used in the soundtrack config (e.g., music_lobby) must match the identifiers defined in your pack's sounds.json.

• Hosting: Ensure your download link is a direct link (e.g., ending in .zip). Services like Dropbox or Google Drive require specific URL formatting for direct downloads.