Reference

Configuration

Everything is in plugins/StrikeBoards/config.yml. Your edits are never overwritten by updates, and new default keys are added automatically. Apply changes with /sb reload, no restart needed.

Cache and performance#

cache:
  full-sweep-interval-minutes: 5
  online-refresh-seconds: 30
  status-refresh-seconds: 5
  names-per-tick: 1000
  batch-size: 100
  batch-delay-ms: 400

A full sweep reads every known player in small async batches so the main thread never lags. Lower the interval for fresher boards at the cost of more database load. Online players and players whose fight just ended are re-read every online-refresh-seconds.

Web server#

web:
  enabled: true
  port: 8123
  bind-address: "0.0.0.0"
  base-path: "/"
  threads: 2
  behind-proxy: false
  public-url: ""
  ssl:
    enabled: false
    keystore: "keystore.jks"
    keystore-password: "changeit"
  api-key: ""
  rate-limit:
    enabled: true
    requests-per-minute: 120

Skins#

  skins:
    enabled: true
    provider: "https://mineskin.eu/head/{name}/100"
    fallback-providers:
      - "https://minotar.net/helm/{name}/100"
      - "https://mc-heads.net/avatar/{name}/100"
    body-provider: "https://mineskin.eu/armor/body/{name}/100.png"

Lookup is by name first, so offline-mode servers and proxies work. Disable skins for a fully offline site; a built-in fallback face is used.

History and ELO chart#

history:
  enabled: true
  max-matches: 100
  per-player: 50

elo-history:
  enabled: true
  max-points: 90

history records duel results and powers Recent fights, match history, recent form and head-to-head records. elo-history records each player's Global ELO when it changes and powers the profile chart, Trending this week and %strikeboards_elo_week%.

Live fights#

live:
  enabled: true
  poll-seconds: 5

Extra StrikePractice events#

bridge:
  extra-fight-end-events: []

DuelEndEvent and FightEndEvent are hooked automatically. If your StrikePractice build has another fight end event, add its fully qualified class name so stats refresh right after those fights. Unknown classes are skipped with a console warning.

Other site options#

  • site.page-title: browser tab title, {server} is replaced with the server name.
  • site.footer-text and site.links.website, discord, store: footer and hero links.
  • site.refresh-seconds: how often open pages refresh.
  • site.custom-css-url and site.custom-js-url: your own CSS or JS injected into every page.
  • commands.top-size: rows shown by /sb top.

Updater#

updater:
  enabled: true
  check-on-startup: true
  check-interval-hours: 24
  auto-download: false
  notify: true
  shared-token: ""
  resource-id: ""