Using it

Branding and themes

Most branding is one command. Changes apply live, with no restart.

/sb set server-name My Server
/sb set server-ip play.myserver.net
/sb set tagline Practice. Fight. Climb.
/sb set theme neon
/sb set primary-color #7c5cff
/sb set logo https://example.com/logo.png
/sb set logo none

Use none or clear to empty a value. Color keys must be a hex value like #7c5cff. When you set a logo or favicon, StrikeBoards checks in the background that the URL really serves an image and tells you if not (hosts like imgur often return a web page instead).

Built-in themes#

esports (default), neon, light, glass, sunset, ocean, midnight, crimson, emerald. Preview one in your own browser by adding ?theme=<name> to the site link. The server theme stays the same for everyone else.

Your own theme#

  1. Create plugins/StrikeBoards/themes/<name>/theme.css.
  2. Add a [data-theme="<name>"] block of --sb-* variables. The built-in web/assets/css/theme.css shows the variables to copy.
  3. Run /sb set theme <name>.
Do not edit the built-in web files

The files in plugins/StrikeBoards/web/ are replaced whenever the jar's website changes. Your custom themes and files you add yourself are kept. Use custom themes, site.custom-css-url or site.custom-js-url for changes instead.

Theme settings in config.yml#

site:
  theme:
    default: "esports"
    allow-toggle: true
    colors:
      primary: ""
      accent: ""
      background: ""
      card: ""
      text: ""
      muted: ""
    gradient-a: ""
    gradient-b: ""
    radius: "14px"
    font: "Inter"
    heading-font: "Chakra Petch"
    background-image: ""
    background-video: ""
  animations:
    enabled: true
    entrance: true
    hover: true
    idle: true
    particles: true
    speed: 1.0
Colors override the theme

Leave the colors entries empty so the selected theme colors everything. A value forces that color across every theme, which also stops the theme switch from changing it.

Fonts are Google Fonts family names. Leave font and heading-font empty to use the system font stack, so the site loads no external fonts. Every word on the website is in the site: section of messages.yml.