stdlib

This does not alter game by itself. It's purpose it to make other modders' lives easier.

Here is a glimpse of how this could be used. See full docs on Github.

Usage

Do some random stuff

// Make local aliases for std namespaces

local Rand = ::std. Rand, Re = ::std. Re, Str = ::std. Str, Text = ::std. Text,

Debug = ::std. Debug.with({prefix = "mymod: "});

// Choose a random weapon

local weapon = Rand.choice(["scramasax" "ancient/khopesh" "falchion"]);

actor.m. Items.equip(::new("scripts/items/weapons/" + weapon));

// Same but with different weights

local weapon = Rand.choice(["scramasax" "ancient/khopesh" "falchion"], );

// Dropping loot for a wolf

local n = 1 + Rand.poly(2, ::World. Assets.getExtraLootChance());

local items = Rand.choices(n, ["werewolf_pelt_item" "adrenaline_gland_item"], );

foreach (item in items) {

local loot = ::new("scripts/items/misc/" + item);

loot.drop(_tile)

Strings and Text

local short = Str.cutprefix(name, "Ancient ");

if (Str.startswith("background.legends_", this.getID())) ...

Str.join("_", split(id, "."))

local romanNumber = Re.find(this.getName(), " (+)$");

local versionNums = Re.all("1. 4. 25", @"\d+"); // ["1", "4", "25"]

// Patch tooltip text, add 5 to chance to hit, and make it green color

local tooltip = getTooltip();

tooltip.text = Re.replace(tooltip.text,

@"(\d+)(% chance to hit)",

@(x, end) Text.positive(x.tointeger() + 5) + end);

Debug things

// Log that, accepts arbitrary nested data structure

Debug.log("loot for wolf", items);

// Outputs: mymod: loot for wolf = ["werewolf_pelt_item", "adrenaline_gland_item"]

// Only show keys that contain "Level"

Debug.log("bro", _player, "Level");

// bro = {m = {Level = 13, LevelUps = 0, LevelUpsSpent = 13, ...}, ...}

// Same but go deeper

Debug.log("bro", _player, {filter = "Level", depth = 4});

//     human = {

//         actor = {m = {LevelActionPointCost = 1, LevelFatigueCost = 4, ...}, ...}

//         ...

//     m = {Level = 13, LevelUps = 0, LevelUpsSpent = 13, ...}

Manipulate player:

// Roll weighted talent stars

foreach (i in Rand.take(3, , weights)) {

local w = weights;

_player.m. Talents = Rand.choice(, );

// Add one more talent, but not in attributes excluded by background