Files
siege_deck/Docs/SiegeDeck/Engine/Randomness.md
T
darman 45b246c1d7 docs: Initialize comprehensive project documentation
Migrates existing GDD and engine design notes from HacknPlan into a new Obsidian vault.

This establishes a centralized, version-controlled knowledge base covering engine architecture, game constraints, design decisions, and open questions.
2026-09-24 23:55:48 +02:00

1.1 KiB

tags
tags
engine
rng

Randomness

Goal: the same seed gives the same run (map, rewards, deck shuffles) on Linux and Windows. Combat does not need to replay exactly. See Game Constraints.

Rng

  • Our own PCG32 (or xoshiro) generator, plus our own range and float mapping.
  • Never use std::uniform_int_distribution or std::uniform_real_distribution. Their output is implementation-defined, so libstdc++ and MSVC produce different values from the same seed. Using them would silently break seed reproducibility across platforms.

RngStreams

Independent named streams are derived from the run seed:

Stream Used for
map run map generation
shuffle deck shuffles, draws
rewards card, relic and gold rewards
events map events, shops
combat crits, procs, random targets

Because the streams are independent, extra combat randomness can't shift which rewards a seed gives.

  • Stream states are saved with the run.
  • Scripts get RNG only through bound stream accessors; the language's own random function is removed in the sandbox (see Scripting).