Command reference

Race

HeritageBuilder · builder

Command words: race
Permission: Admin

The race command is used to view, edit and create races. All characters have a race, and the race represents something approximating a species (although you can make a more broad paradigm and use ethnicity to control species).

Races are typically very tightly coupled with ethnicities, so you should also see the helpfile for ethnicities.

The syntax to use this command is as follows:

race list - lists all of the races
race edit <which> - begins editing a race
race edit new <name> <bodyproto> [<parent race>] - begins editing a new race
race clone <old> <new> - clones an existing race to a new one
race close - stops editing a race
race show <which> - views information about a race
race show - views information about your currently editing race

Additionally, there are numerous properties that can be set:

Core Properties

race set name <name> - renames the race
race set desc - drops you into an editor to describe the race
race set parent <race> - sets a parent race for this race
race set parent none - clears a parent race from this race
race set body <template> - changes the body template of the race
race set parthealth <%> - sets a multiplier for bodypart HPs
race set partsize <#> - sets a number of steps bigger/smaller for bodyparts

Chargen Properties

race set chargen <prog> - sets a prog that controls chargen availability
race set advice <which> - toggles a chargen advice applying to this race
race set cost <resource> <amount> - sets a cost for character creation
race set require <resource> <amount> - sets a non-cost requirement for character creation
race set cost <resource> clear - clears a resource cost for character creation

Combat Properties

race set armour <type> - sets the natural armour type for this race
race set armour none - clears the natural armour type
race set armourquality <quality> - sets the quality of the natural armour
race set armourmaterial <material> - sets the default material for the race's natural armour
race set canattack - toggles the race being able to use attacks
race set candefend - toggles the race being able to dodge/parry/block
race set canuseweapons - toggles the race being able to use weapons (if it has wielding parts)

Physical Properties

race set age <category> <minimum> - sets the minimum age for a specified age category
race set variable all <characteristic> - adds or sets a specified characteristic for all genders
race set variable male <characteristic> - adds or sets a specified characteristic for males only
race set variable female <characteristic> - adds or sets a specified characteristic for females only
race set variable remove <characteristic> - removes a characteristic from this race
race set variable promote <characteristic> - pushes a characteristic up to the parent race
race set variable demote <characteristic> - pushes a characteristic down to all child races (and remove from this)
race set attribute <which> - toggles this race having the specified attribute
race set attribute promote <which> - pushes this attribute up to the parent race
race set attribute demote <which> - pushes this attribute down to all child races (and remove from this)
race set roll <dice> - the dice roll expression (xdy+z) for attributes for this race
race set cap <number> - the total cap on the sum of attributes for this race
race set bonusprog <which> - sets the prog that controls attribute bonuses
race set corpse <model> - changes the corpse model of the race
race set health <model> - changes the health mode of the race
race set perception <%> - sets the light-percetion multiplier of the race (higher is better)
race set genders <list of genders> - sets the allowable genders for this race
race set butcher <profile> - sets a butchery profile for this race
race set butcher none - clears a butchery profile from this race
race set breathing nonbreather|simple|lung|gill|blowhole - sets the breathing model
race set breathingrate <volume per minute> - sets the volume of breathing per minute
race set holdbreath <seconds expression> - sets the formula for breathe-holding length
race set sweat <liquid> - sets the race's sweat liquid
race set sweat none - disables sweating for this race
race set sweatrate <volume per minute> - sets the volume of sweating per minute
race set blood <liquid> - sets the race's blood liquid
race set blood none - disables bleeding for this race
race set bloodmodel <model> - sets the blood antigen typing model for this race
race set bloodmodel none - clears a blood antigen typing model from this race
race set tempfloor <temperature> - sets the base minimum tolerable temperature for this race
race set tempceiling <temperature> - sets the base maximum tolerable temperature for this race

Eating Properties

race set caneatcorpses - toggles the race being able to eat corpses directly (without butchering)
race set biteweight <weight> - sets the amount of corpse weight eaten per bite
race set material add <material> - adds a material definition for corpse-eating
race set material remove <material> - removes a material as eligible for corpse-eating
race set material alcohol|thirst|hunger|water <amount> - sets the per-kg nutrition for this material
race set optinediblematerial - toggles whether the race can only eat materials from the pre-defined list
race set emotecorpse <emote> - sets the emote for eating corpses. $0 is eater, $1 is corpse.
race set yield - tba

← Back to Command reference