SlimLukeGames Wiki - User contributions [en]

Cyberboxer changelog

2026-03-05T07:44:11Z

Matt: Created page with "== v0.3.0 (2025-02-07)== * first public beta release == v0.4.0 (2025-03-06) == * ServoTravelStopDelay adjustment due to mechanism design * new 06.webp and 07.webp avatars * changing forceFactor automatically resets leaderboard * video quality improvements * antiretension effects for GUI elements * color FX (hue wheel movement) for leaderboard entries * fix for WiFi config crash * adjusted initialAllTimeScores * QR code for leaderboard * sharing location.txt with server..."

== v0.3.0 (2025-02-07)==
* first public beta release

== v0.4.0 (2025-03-06) ==
* ServoTravelStopDelay adjustment due to mechanism design
* new 06.webp and 07.webp avatars
* changing forceFactor automatically resets leaderboard
* video quality improvements
* antiretension effects for GUI elements
* color FX (hue wheel movement) for leaderboard entries
* fix for WiFi config crash
* adjusted initialAllTimeScores
* QR code for leaderboard
* sharing location.txt with server
* avatar opt-out notice improvements

== v0.5.0 (2025-04-18) ==
* asynchronic loading of avatars for quicker boot up
* weight classes logic and GUI

== v0.6.0 (2025-04-24) ==
* weight class GUI improvments
* scoreCounter optimalisation
* fix for euro characters in operator menu

== v0.7.0 (2025-05-07) ==
* QR code link for individual entry
* "rewards" instead of "tickets" in code logic
* "precision" reward strategy
* fakeBrokenScreen triggered by force thresshold instead of point thresshold

== v0.8.0 (2025-05-13) ==
* fix for crash related to camera init
* simplyfied leaderboard server selection
* diagnostic data for server connection
* QR visibility linked with server connection status
* improved handling of timestamps before time is pulled from server
* individual lifetime for scores
* new placeholder for avatars

== v0.9.0 (2025-07-31) ==
* improvement to ball detection logic
* warning in punch ball test
* view markers in camera test
* improvements to background GUI
* support for firmware updates from .slgfw file inside the /Update folder
* new musicLoop.wav SFX file
* option to release punch ball in GPIO test
* improved camera setup
* improved leaderboard logic
* preparation for variable screen orientation

== v0.10.0 (2025-08-01) ==
* new score summary

== v0.11.0 (2025-11-04) ==
* Over-The-Air-Update
* forcing https instead of http
* font change for Leaderboard title
* QR code text and animation improvement
* scoreLifetimeHours: 50 → 24
* anti-retension effects for new UI elements
* preparation for multi-lang support (English + Polish)
* removed too agressive voiceovers

== v0.12.0 (2025-12-08) ==
* new SFX for opening the ball
* sending selected language to remote server
* support for new button layout (Start + 2x Select)

== v0.13.0 (2025-12-18) ==
* improvements to server communication
* improvements to Over-The-Air update logic
* added Spanish language

== v0.14.0 (2026-02-23) ==
* pulseAntiCheat "expo-only" option label
* typo fix
* digital signage feature
* SFX for class selection
* hidden WiFi support
* voiceovers for weight class selection
* option for score lists separated by weight class

== v0.15.0 (2026-02-27) ==
* option for background logo upload
* Portuguese tranlations
* SFX improvements

Leaderboard Merger

2025-12-16T12:46:38Z

Matt: /* Configuration file */

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, how the data is obtained, and how frequently the leaderboard 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).

Key characteristics:

* No internet connection is required.
* All devices must be in the same WLAN.
* Data refresh interval is '''5 seconds'''.
* This mode is recommended for on‑site installations such as arcades, bars, or live events.

Typical use cases:

* Single venue installations
* Event-based setups
* Temporary locations without internet access

=== Global Scenario ===

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

In this mode, the 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 allows precise control over which machines participate in the merged leaderboard (for example: machines belonging to a specific venue, region, or event).

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 a remote server
* Configuration file with machine serial numbers 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

== Settings ==

=== Configuration file ===

Notice: As of 2025-12-16, the configuration file can only be created and deployed by the producer. Operator-side configuration tools are still under development.

File <code>Data/serials.json</code> is required for operation in the Global scenario. It defines the list of arcade machine serial numbers whose leaderboard data will be collected and merged.

Example content of the file:

{
"_version": 1,
"serials": [
"1111222233334444",
"5555666677778888"
]
}

=== Access Point Mode ===

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
* No external network infrastructure is required

Leaderboard Merger

2025-12-16T12:43:22Z

Matt: /* Configuration file */

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, how the data is obtained, and how frequently the leaderboard 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).

Key characteristics:

* No internet connection is required.
* All devices must be in the same WLAN.
* Data refresh interval is '''5 seconds'''.
* This mode is recommended for on‑site installations such as arcades, bars, or live events.

Typical use cases:

* Single venue installations
* Event-based setups
* Temporary locations without internet access

=== Global Scenario ===

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

In this mode, the 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 allows precise control over which machines participate in the merged leaderboard (for example: machines belonging to a specific venue, region, or event).

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 a remote server
* Configuration file with machine serial numbers 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

== Settings ==

=== Configuration file ===

File <code>Data/serials.json</code> is required.

Example content of the file:

{
"_version": 1,
"serials": [
"1111222233334444",
"5555666677778888"
]
}

=== Access Point Mode ===

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
* No external network infrastructure is required

Leaderboard Merger

2025-12-16T12:34:00Z

Matt:

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, how the data is obtained, and how frequently the leaderboard 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).

Key characteristics:

* No internet connection is required.
* All devices must be in the same WLAN.
* Data refresh interval is '''5 seconds'''.
* This mode is recommended for on‑site installations such as arcades, bars, or live events.

Typical use cases:

* Single venue installations
* Event-based setups
* Temporary locations without internet access

=== Global Scenario ===

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

In this mode, the 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 allows precise control over which machines participate in the merged leaderboard (for example: machines belonging to a specific venue, region, or event).

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 a remote server
* Configuration file with machine serial numbers 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

== Settings ==

=== Configuration file ===

TODO

=== Access Point Mode ===

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
* No external network infrastructure is required

Leaderboard Merger

2025-12-16T12:14:31Z

Matt: /* Connection Scenarios */

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, how the data is obtained, and how frequently the leaderboard 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).

Key characteristics:

* No internet connection is required.
* All devices must be in the same WLAN.
* Data refresh interval is **5 seconds**.
* This mode is recommended for on‑site installations such as arcades, bars, or live events.

Typical use cases:

* Single venue installations
* Event-based setups
* Temporary locations without internet access

=== Global Scenario ===

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

In this mode, the 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 allows precise control over which machines participate in the merged leaderboard (for example: machines belonging to a specific venue, region, or event).

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 a remote server
* Configuration file with machine serial numbers 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

== Settings ==

=== Configuration file ===

TODO

=== Access Point Mode ===

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
* No external network infrastructure is required

Leaderboard Merger

2025-12-16T12:11:04Z

Matt:

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, how the data is obtained, and how frequently the leaderboard 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).

Key characteristics:

* No internet connection is required.
* All devices must be in the same WLAN.
* Data refresh interval is **5 seconds**.
* This mode is recommended for on‑site installations such as arcades, bars, or live events.

Typical use cases:

* Single venue installations
* Event-based setups
* Temporary locations without internet access

==== Access Point Mode ====

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
* No external network infrastructure is required

=== Global Scenario ===

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

In this mode, the 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 allows precise control over which machines participate in the merged leaderboard (for example: machines belonging to a specific venue, region, or event).

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 a remote server
* Configuration file with machine serial numbers 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

Leaderboard Merger

2025-12-16T12:02:26Z

Matt: /* Global Scenario */

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.

Leaderboard Merger

2025-12-16T12:01:30Z

Matt:

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.

Leaderboard Merger

2025-12-16T11:46:19Z

Matt:

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.

== 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 ==

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.

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 servers
* 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

Leaderboard Merger

2025-12-16T11:42:18Z

Matt: Created page with "Leaderboard Merger is a standalone hardware device responsible for collecting leaderboard data from a defined set of boxer machines, merging those results into a single ranking, and presenting the combined leaderboard on its own display. The device operates independently from the boxer machines and periodically synchronizes data according to the selected connection scenario. == Machine List Configuration == Leaderboard Merger requires a configuration file containing a..."

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

The device operates independently from the boxer 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 ==

Leaderboard Merger supports two operating modes:

* Local
* Global

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

=== Local Scenario ===

In the local scenario, the Leaderboard Merger and all boxer 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
* Boxer machines connect directly to this network

=== Global Scenario ===

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

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 servers
* 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

Rewards and Reward Strategies

2025-12-16T08:25:35Z

Matt:

This article describes the reward mechanisms used in SlimLukeGames products and the strategies behind their design. Rewards are a core element of player engagement, motivation, and retention.

The concepts described here apply across multiple products and game modes, and may be adapted depending on local regulations, operator preferences, and product configuration.

== Reward Types ==

In SlimLukeGames systems, rewards are not limited to physical items.

Typical reward types include:
* Tickets - virtual or physical ticket equivalents used for redemption systems
* Coins - real currency
* Tokens - non-monetary units used for progression or access
* Coupons - discount or promotional vouchers
* Credits - playable credits
* Other prizes - operator-defined rewards

== Reward Strategies ==

SlimLukeGames products support multiple reward strategies that define how and when rewards are granted.

=== Classic ===

The Classic strategy uses a fixed conversion between score and rewards.

Rewards are calculated using a simple points-to-reward ratio, with an optional guaranteed minimum payout.

Characteristics:

* Simple and transparent
* Familiar arcade-style behavior
* Predictable reward scaling

=== Fixed ===

The Fixed strategy grants a predefined number of rewards for each game, regardless of the achieved score.

Characteristics:

* Fully predictable payouts
* Independent of player skill
* Useful for promotions, testing, or training scenarios

=== Direct ===

The Direct strategy places rewards directly within the game environment, allowing the player to collect them during gameplay.

Collecting rewards is optional and independent of the final score.

Notes:

* A player may achieve a high score while collecting few rewards

* Encourages exploration and decision-making

Characteristics:

* Decouples score from rewards

* Adds an additional gameplay layer

* Increases variability between plays

=== Thresholds ===

The Threshold strategy awards for reaching predefined score milestones.

Each threshold grants a specific number of tickets. Rewards from all achieved thresholds are cumulative.

Example:

* Threshold 1 reached → tickets from threshold 1 awarded
* Threshold 2 reached → tickets from threshold 1 + 2 awarded
* Threshold 3 reached → tickets from threshold 1 + 2 + 3 awarded

Characteristics:

* Strong motivation to reach higher milestones
* Clear performance goals
* Encourages skill improvement

=== Smart ===

The Smart strategy dynamically adjusts reward calculation based on historical game data.

It combines elements of the Fixed and Classic strategies to maintain a target average payout while preserving performance-based rewards.

Operation principle:

* The system calculates the average score from previous games
* Based on this average, it automatically adjusts the points-to-reward ratio
* Future games are rewarded in a way that converges toward a desired average payout

Key properties:

* Each game influences future reward calculations
* The system adapts over time to player behavior
* Maintains controlled ticket output without removing skill influence

Characteristics:

* Self-balancing reward economy
* Suitable for long-term deployments

== Regulatory and Operational Considerations ==

Depending on the region and deployment context:

* Physical prizes may be restricted or regulated
* Ticket-based systems may be undesirable or obsolete
* Digital-only rewards can simplify compliance

[[Category:Game Design]]
[[Category:Reward Systems]]
[[Category:Operator Documentation]]

Rewards and Reward Strategies

2025-12-16T08:22:04Z

Matt: Created page with "This article describes the reward mechanisms used in SlimLukeGames products and the strategies behind their design. Rewards are a core element of player engagement, motivation, and retention. The concepts described here apply across multiple products and game modes, and may be adapted depending on local regulations, operator preferences, and product configuration. == Reward Types == In SlimLukeGames systems, rewards are not limited to physical items. Typical reward t..."

Main Page

2025-12-16T07:37:57Z

Matt:

<strong>Welcome to the official SlimLukeGames documentation portal</strong>

This wiki contains product information, user manuals, service guides, software update instructions, technical specifications, and media resources for SlimLukeGames products.

This documentation is intended for operators, service technicians, and partners.