Random

trigscript/random is chance in the words a map maker uses: one time in four, a number from 1 to 3, one of a list.

import { chance, range, pick, weighted } from "trigscript/random";

const BOSSES = [units.ZergUltralisk, units.ZergDefiler, units.ZergQueen];

program(async () => {
  let wave = 1;
  while (wave <= 10) {
    createUnit(P8, units.ZergZergling, range(4, 8), locations.Spawn);
    if (chance(25)) createUnit(P8, pick(BOSSES), 1, locations.Spawn);
    const tier = weighted([70, 25, 5]);              // 0 most of the time, 2 rarely
    setResources(P1, "add", 50 * (tier + 1), "ore");
    wave += 1;
    await sleep(seconds(30));
  }
});

The functions draw on the game's own random numbers, which every player's game draws alike, so a game of several players never goes out of step. Random is a generator of your own, seeded: the same seed gives the same numbers in every game. That is what a level made from a seed, or a code a player types to get the same map again, needs.

import { Random } from "trigscript/random";

program(() => {
  const rng = new Random(1234);
  const lanes = [0, 1, 2, 3];
  rng.shuffle(lanes);
  print(`Lanes in order: ${lanes.join(", ")}, first gap at ${rng.range(5, 20)}`);
});