Leaderboard Merger: Difference between revisions

From SlimLukeGames Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 2: Line 2:


The device operates independently from the arcade machines and periodically synchronizes data according to the selected connection scenario.
The device operates independently from the arcade machines and periodically synchronizes data according to the selected connection scenario.
== Machine List Configuration ==
Leaderboard Merger requires a configuration file containing a list of machine serial numbers. Only machines listed in this file will be queried for leaderboard data.
This mechanism allows precise control over which machines participate in the merged leaderboard (for example: machines located in a single venue, hall, or event zone).


== Connection Scenarios ==
== Connection Scenarios ==
Line 21: Line 16:
In the local scenario, the Leaderboard Merger and all arcade machines must be connected to the same local wireless network (WLAN).
In the local scenario, the Leaderboard Merger and all arcade machines must be connected to the same local wireless network (WLAN).


* No internet connection is required
* No internet connection is required.
* Data refresh interval is 5 seconds.
* Data refresh interval is 5 seconds.
* This mode is recommended for on‑site installations such as arcades, bars, or events.
* This mode is recommended for on‑site installations such as arcades, bars, or events.
Line 33: Line 28:


In the global scenario, the Leaderboard Merger and arcade machines communicate over the internet.
In the global scenario, the Leaderboard Merger and arcade machines communicate over the internet.
In this scenario Leaderboard Merger requires a configuration file containing a list of machine serial numbers. Only machines listed in this file will be queried for leaderboard data.
This mechanism allows precise control over which machines participate in the merged leaderboard (for example: machines located in a single venue, hall, or event zone).


Key characteristics:
Key characteristics:


* Each device connects to an internet‑enabled WLAN
* Each device connects to an internet‑enabled WLAN.
* Devices do not need to be on the same local network
* Devices do not need to be on the same local network.
* Data is retrieved via remote servers
* Data is retrieved via remote server.
* Configuration file is required.
* Data refresh interval is 60 seconds.
* Data refresh interval is 60 seconds.
* This mode is suitable for aggregating leaderboards from geographically distributed locations.
* This mode is suitable for aggregating leaderboards from geographically distributed locations.
* Typical use cases: chain locations, distributed tournaments, global or regional rankings
* Typical use cases: chain locations, distributed tournaments, global or regional rankings.

Revision as of 13:01, 16 December 2025

Leaderboard Merger is a standalone hardware device responsible for collecting leaderboard data from a defined set of arcade machines, merging those results into a single ranking, and presenting the combined leaderboard on its own display.

The device operates independently from the arcade machines and periodically synchronizes data according to the selected connection scenario.

Connection Scenarios

Leaderboard Merger supports two operating modes:

  • Local
  • Global

Each scenario defines how the device communicates with arcade machines and how frequently the data is refreshed.

Local Scenario

In the local scenario, the Leaderboard Merger and all arcade machines must be connected to the same local wireless network (WLAN).

  • No internet connection is required.
  • Data refresh interval is 5 seconds.
  • This mode is recommended for on‑site installations such as arcades, bars, or events.
  • Typical use cases: single venue, event installation, temporary locations without internet access

Notice: If no existing WLAN is available at the location, the Leaderboard Merger can be configured to create its own wireless access point. In this setup:

  • Leaderboard Merger acts as the Wi‑Fi access point
  • Arcade machines connect directly to this network

Global Scenario

In the global scenario, the Leaderboard Merger and arcade machines communicate over the internet.

In this scenario Leaderboard Merger requires a configuration file containing a list of machine serial numbers. Only machines listed in this file will be queried for leaderboard data. This mechanism allows precise control over which machines participate in the merged leaderboard (for example: machines located in a single venue, hall, or event zone).

Key characteristics:

  • Each device connects to an internet‑enabled WLAN.
  • Devices do not need to be on the same local network.
  • Data is retrieved via remote server.
  • Configuration file is required.
  • Data refresh interval is 60 seconds.
  • This mode is suitable for aggregating leaderboards from geographically distributed locations.
  • Typical use cases: chain locations, distributed tournaments, global or regional rankings.