Simulating your Game

Introduction

Configuring a game alone isn't enough - it also has to be simulated to ensure correct functionality.

Simulating your game is quite simple:

const game = createSlotGame({ /* ... */ })

game.configureSimulation({
  simRunsAmount: {
    base: 100_000,
    bonus: 100_000,
  },
  concurrency: 16,
})

game.runTasks({
  doSimulation: true,
})

Simulation time can range from a few seconds to several minutes, depending on game modes, simulation count, thread concurrency, and your hardware.

Output Files / Publish Files

The output will be written to the __build__/publish_files directory. Those are the final files that can be uploaded to Stake Engine as the "math" part.

books_<gameMode>.jsonl.zst

For each game mode a books file is generated which contains a list of all books (simulations). That file is compressed using Zstandard compression, because book files tend to get quite large the more events you have.

{"id":1,"payoutMultiplier":780,"events":[{"index":1,"type":"test","data":{"test":123}}]}
{"id":2,"payoutMultiplier":1000,"events":[{"index":1,"type":"test","data":{"test":123}}]}
{"id":3,"payoutMultiplier":0,"events":[{"index":1,"type":"test","data":{"test":123}}]}
...

index.json

An overview of all simulated game modes and their corresponding file names.

lookUpTable_<gameMode>_0.csv

The lookup table contains a list of all book IDs, a weight, and the payout multiplier (scaled by 100).

A book's weight determines the probability of that outcome being selected by the Stake RGS when resolving a bet.

By default, all results have an equal probability of being selected.

ID, weight, payout
1,1,780
2,1,1000
3,1,0
...

Since every outcome has the same weight, initial game RTP will likely be too high or too low - this is completely normal. You will use optimization to automatically redistribute weights to achieve a specific target RTP with high precision.

FAQ / Common Issues