Skip to content

Matches and scoreboard

This page describes a match from the player’s point of view. Use it to explain the feature to your players and to check that your setup behaves as expected.

  1. The player walks up to the bouncer and uses the target option. The option reads Sign up for Fight (or Debug: Start Bot Fight when Config.Debug is true).
  2. A notification confirms the sign-up and says the player is waiting for a challenger.
  3. A second player signs up within MaxOponentSearchTime seconds. The match starts.
  4. If nobody joins in time, the sign-up is cancelled and the player is told no opponent was found.

If a match is already running, a new player gets an “Arena Busy” notification and is not queued. A player who is already signed up cannot sign up twice.

  1. Each fighter’s screen fades out. They are placed at their corner, health is filled, armour is removed, and boxing gloves are attached.
  2. A “ROUND 1” banner shows. Fighters are frozen and cannot be hurt during a 5 second countdown.
  3. The bell sounds and the round timer starts. It runs for RoundDuration minutes.
  4. A round ends in one of two ways:
    • Knockout: a fighter’s health drops to the knockout level. The fighter falls, a “K.O.” banner shows, and the other fighter scores the round.
    • Time: the timer reaches zero. A “ROUND OVER” banner shows and nobody scores.
  5. After a short pause both fighters are placed back in their corners with full health, a new round banner shows, and the countdown starts again.
  6. When the match is decided (see round rules), the winner sees a green “VICTORY” banner and the loser sees a red “DEFEAT” banner. Each gets a matching sound and a notification.
  7. Gloves are removed, fighters are unfrozen and the scoreboard closes. Fighters stay at their corners. They are not moved back to where they signed up.

A fighter who leaves the ring area sees a message counting down from OutSideZoneTimer seconds. Returning to the ring stops the countdown. If the time runs out, the match ends and the opponent wins.

The scoreboard appears at the top center of the screen during a match.

Element What it shows
Fighter cards Name, portrait, rounds won and a health bar for each fighter.
Round title The current round number, for example ROUND 2. Extra rounds keep counting up.
Timer Time left in the round as mm:ss. It shows --:-- before the round starts.
State badge waiting during the countdown, active while fighting, break between rounds.
Countdown A large number overlay that counts down from 5 before each round.

How it behaves:

  • Fighters see the scoreboard for their own match with themselves on the left and the opponent on the right.
  • Spectators see it when they stand inside the spectator area (BoxingSpectate). They see fighter 1 on the left and fighter 2 on the right.
  • A player who walks into the spectator area during a running match sees the current state straight away.
  • Leaving the spectator area closes the scoreboard.
  • Health bars drop as damage is dealt and refill at the start of each round.
  • Between matches the scoreboard is hidden.

Fighter names come from your framework (see Framework support). All fighters show the same default portrait image.

With Config.Debug = true, one player can start a match alone. The opponent is an AI boxer named “AI Boxing Bot”. The match follows the same round rules and shows the same scoreboard. Use this to check your ring setup, then turn debug mode off.