Default config.yml

Shipped defaults from SoapsArena 1.0.1. After first run, this file lives in plugins/SoapsArena/.

Updating the jar does not overwrite your live copy. Use this page to compare or reset.

See also: Config Reference · Configuration

# ============================================
#          SoapsArena Configuration
# ============================================

gui:
  # Master switch for inventory menus (hub, kits, editor settings, etc.). Layouts in gui.yml.
  enabled: true
  # Prefer inventory menus for commands that have one (/sar stats, /sar top, /sar list).
  # Chat fallback when false. Does not add per-menu toggles.
  gui-enabled: true

# Optional hooks for other Soaps plugins (no hard dependency)
integrations:
  soapsquest:
    enabled: false
    # Console commands after each match (sync). Placeholders: {room} {winner} {participants} {duel}
    # If a line contains {player} or {uuid}, it runs once per participant with those replaced.
    match-end-commands: []
    # Example (SoapsQuest command placeholders depend on your quest setup):
    # match-end-commands:
    #   - "questadmin progress {player} arena_win 1"

# Public queue: stay in the world until a match is ready, then prepare warning
queue:
  # Seconds to prepare before teleport into the arena
  prepare-seconds: 30
  # Cancel the upcoming match if a participant dies during prepare
  prepare-cancel-on-death: true
  # Prefer rooms that already have someone waiting when using /sar quickjoin
  quickjoin-prefer-waiting: true

# Default room settings (can be overridden per room)
defaults:
  countdown: 5
  destructible: false
  # Time limit in seconds (0 = no limit)
  time-limit: 0
  # Allow fall damage in arenas
  fall-damage: true
  # Allow hunger drain in arenas
  hunger-drain: false

# WorldEdit / FAWE integration
worldedit:
  # Master toggle - only works if WorldEdit or FAWE is installed
  enabled: true
  # Automatically save the arena before game start
  auto-save: true
  # Automatically restore the arena after game ends
  auto-restore: true

# Wand editor settings
wand:
  # Ticks between particle updates (20 ticks = 1 second)
  particle-interval: 10
  # Distance between particles along cuboid edges
  particle-density: 0.5
  # Arena selection particle color (hex)
  arena-particle-color: "#FF6B35"
  # Maximum block distance for wand raycast targeting
  wand-range: 100
  # Show held-tool hints on the action bar while editing
  actionbar-hints: true
  # Ticks between action bar hint refreshes
  actionbar-interval: 40

# Duel settings
duel:
  # Seconds before a duel request expires
  request-timeout: 30

# Game settings
game:
  # Teleport players to exit spawn on death
  teleport-on-death: true
  # Seconds before arena cleanup after game ends
  end-delay: 5
  # Show sidebar scoreboard during games
  scoreboard: true
  # Allow soapsarena.admin to use any command during countdown/fight
  admin-bypass-commands: true

# Sound effects (use Bukkit Sound enum names, empty = disabled)
sounds:
  enabled: true
  countdown-tick: BLOCK_NOTE_BLOCK_PLING
  game-start: ENTITY_ENDER_DRAGON_GROWL
  kill: ENTITY_EXPERIENCE_ORB_PICKUP
  elimination: ENTITY_WITHER_HURT
  win: UI_TOAST_CHALLENGE_COMPLETE