Palim
generated · v0.1.19Alpha v0.1.19

The rules as shipped

Generated by cargo xtask specs from the same definitions the game imports. The design document is the vision; this is the truth. The same page as Markdown lives in the repository.

calendar · eras · levels · building kinds · materials · goods and recipes · policy · needs · events · water · settlement · people · job board · damage · villages · war · supply · mines · tunable rule reference · templates · world recipes · climate · styles and lenses · controls ·

Calendar, site and founding

A year is 360 daily ticks; planting is day 70 and harvest day 250. The water model steps every 30 days. The default site is 384 × 160 × 384 metres with the sea at 26; the default city has 20 founders, 14 cities abroad, 800 walking citizens and 140 route searches a day. The founders carry 260 grain and 90 timber, a treasury of 250 and a legitimacy of 0.6000000238418579.

Eras

An era is left when every gate is met; the gates ease off once the calendar is past the era's nominal year (and scale with era_threshold_scale). The last era has no gate.

FoundingMedievalRenaissanceIndustrialModernContemporary
eranominal yearstoreysstorey heightlevel ceilingleaves at: peopletreasuryliteracybuilt voxelsmin years
Founding1,10013224812001,20012
Medieval1,25023384203,0000.1214,00090
Renaissance1,45033561,10012,0000.3245,00080
Industrial1,65043743,00040,0000.6120,00080
Modern1,85093907,000120,0000.85280,00070
Contemporary1,970223100—————
What each era changes.
erafertilitymortalityextractionrecoveryefficiencyliteracy ceilingtrade reach
Founding0.1751.3510.2810.02120
Medieval0.171.21.20.41.120.09320
Renaissance0.1611.450.541.30.26700
Industrial0.1450.852.10.681.60.51,600
Modern0.0850.453.20.8420.84,000
Contemporary0.0520.34.20.942.40.9712,000
The materials an era builds with, and the paving ladder footfall climbs (wear needed → surface).
erapoor wallrich wallframeroofwindowcivicpaving
Foundingdaubtimbertimberthatchairrough stone60 → packed dirt
Medievaldaubrough stonetimberthatchaircut stone60 → packed dirt; 400 → gravel; 1200 → cobble
Renaissancedaubbricktimbertileglasscut stone60 → packed dirt; 300 → gravel; 900 → cobble
Industrialsooted brickbrickironslateglasscut stone50 → packed dirt; 250 → gravel; 700 → cobble; 1800 → setts
Modernconcretebricksteelconcreteglassconcrete40 → gravel; 200 → cobble; 600 → setts; 1500 → asphalt
Contemporaryconcretecurtain wallsteelconcreteglasscurtain wall40 → gravel; 200 → cobble; 600 → setts; 1500 → asphalt

Levels

Every building carries a level from 0 to 100, read off its fabric and capped by the calendar (from 8 in 1100 to 100 in 2000) and by the era.

yearcalendar ceiling
1,1008
1,25023
1,45043
1,65064
1,85084
1,97096
2,000100

Building kinds and crafts

kindcivicworksdefenceland
heapnononono
hutnononono
housenononono
tenementnononono
farmsteadnononoyes
stock pennononoyes
plantationnononoyes
granaryyesnonono
warehousenononono
workshopnoyesnono
sawmillnoyesnono
quarrynoyesnono
millnoyesnono
forgenoyesnono
factorynoyesnono
marketyesnonono
town hallyesnonono
churchyesnonono
schoolyesnonono
hospitalyesnonono
towernononono
palisadeyesnoyesno
wallyesnoyesno
gateyesnoyesno
garrisonyesnoyesno
bridgeyesnonono

The eight crafts that learn to build them: shelter, keeping, making, defence, husbandry, winning, assembly, crossing.

Materials

Durability is the years a course stands before it is more patch than fabric.

grass
220 y
dirt
220 y
sand
220 y
clay
220 y
stone
220 y
iron ore
220 y
coal
220 y
water
220 y
trunk
220 y
leaves
220 y
crop
220 y
packed dirt
220 y
gravel
220 y
cobble
220 y
setts
220 y
asphalt
220 y
timber
90 y
plank
65 y
thatch
30 y
daub
60 y
rough stone
280 y
cut stone
400 y
tile
170 y
brick
200 y
slate
170 y
glass
100 y
plaster
60 y
iron
130 y
sooted brick
200 y
steel
160 y
concrete
160 y
curtain wall
100 y
rubble
220 y
scaffold
65 y
ash
220 y
town flag
220 y
banked fire
220 y
ice
1 y
snow
1 y
firn
1 y
glacier ice
1 y
dark timber
90 y
pale timber
90 y
ochre wash
60 y
rose wash
60 y
blue wash
60 y
green wash
60 y
red paint
65 y
green paint
65 y
blue paint
65 y
ruby glass
100 y
cobalt glass
100 y
amber glass
100 y
emerald glass
100 y
gilt
130 y
materialdurabilityflammabilitystructuralbuiltsolidroadburns tocollapses tomade ofsalvages to
grass2200nonoyesnograssgrass——
dirt2200nonoyesnodirtdirt——
sand2200nonoyesnosandsand——
clay2200nonoyesnoclayclay——
stone2200yesnoyesnostonestone——
iron ore2200nonoyesnoiron oreiron ore——
coal2200nonoyesnocoalcoal——
water2200nonononowaterwater——
trunk2200.3nonoyesnoashtrunk——
leaves2200.5nonononoairleaves——
crop2200.6nonononoaircrop——
packed dirt2200yesyesyesyespacked dirtpacked dirt——
gravel2200noyesyesyesgravelgravel0.30000001192092896 × stone0.25 × stone
cobble2200yesyesyesyescobblecobble0.699999988079071 × stone0.6000000238418579 × stone
setts2200yesyesyesyessettssetts0.699999988079071 × stone0.6000000238418579 × stone
asphalt2200noyesyesyesasphaltasphalt1 × concrete0.6000000238418579 × stone
timber900.7noyesyesnoashair1 × timber0.800000011920929 × timber
plank650.7noyesyesnoashair1 × timber0.800000011920929 × timber
thatch300.95noyesyesnoairair0.07999999821186066 × grain—
daub600.35noyesyesnorubbleair0.4000000059604645 × clay0.30000001192092896 × clay
rough stone2800yesyesyesnorough stonerubble1 × stone1 × stone
cut stone4000yesyesyesnocut stonerubble1.399999976158142 × stone1.2000000476837158 × stone
tile1700noyesyesnotileair0.800000011920929 × clay0.5 × clay
brick2000yesyesyesnobrickrubble1 × brick0.8999999761581421 × brick
slate1700noyesyesnoslateair0.800000011920929 × stone0.699999988079071 × stone
glass1000noyesyesnoglassair1 × glass0.699999988079071 × glass
plaster600.1noyesyesnorubbleair0.5 × clay0.30000001192092896 × clay
iron1300yesyesyesnoironiron1 × iron0.949999988079071 × iron
sooted brick2000yesyesyesnosooted brickrubble1 × brick0.8999999761581421 × brick
steel1600yesyesyesnosteelsteel1 × steel0.949999988079071 × steel
concrete1600yesyesyesnoconcreteconcrete1 × concrete0.6000000238418579 × stone
curtain wall1000noyesyesnocurtain wallair1 × glass0.699999988079071 × glass
rubble2200yesyesyesnorubblerubble—0.5 × stone
scaffold650.7noyesyesnoashscaffold1 × timber0.800000011920929 × timber
ash2200nonoyesnoashash——
town flag2200noyesyesnotown flagtown flag0.5 × cloth—
banked fire2200noyesyesnobanked fireair0.20000000298023224 × timber—
ice10nonononoiceice——
snow10nonoyesnosnowsnow——
firn10nonoyesnofirnfirn——
glacier ice10nonoyesnoglacier iceglacier ice——
dark timber900.7noyesyesnoashair——
pale timber900.7noyesyesnoashair——
ochre wash600.1noyesyesnorubbleair——
rose wash600.1noyesyesnorubbleair——
blue wash600.1noyesyesnorubbleair——
green wash600.1noyesyesnorubbleair——
red paint650.7noyesyesnoashair——
green paint650.7noyesyesnoashair——
blue paint650.7noyesyesnoashair——
ruby glass1000noyesyesnoruby glassair——
cobalt glass1000noyesyesnocobalt glassair——
amber glass1000noyesyesnoamber glassair——
emerald glass1000noyesyesnoemerald glassair——
gilt1300noyesyesnogiltair——

Goods and recipes

goodbase valuebulkavailable fromperishable
grain10.5Foundingyes
fish1.20.4Foundingyes
timber1.40.5Foundingno
stone1.80.9Foundingno
clay0.90.9Foundingno
brick2.60.9Medievalno
charcoal2.20.5Foundingno
coal1.90.9Industrialno
iron60.3Foundingno
steel110.3Industrialno
cloth50.12Foundingno
tools80.12Foundingno
glass90.12Renaissanceno
concrete3.40.9Modernno
ale20.4Foundingyes
luxuries220.05Foundingno
recipeinputsoutputfrom eralabour (worker-days)
kiln2 × clay, 0.5 × charcoal1.600000023841858 × brickMedieval1
charcoal burning3 × timber1 × charcoalFounding1.2
brewery2 × grain, 0.10000000149011612 × timber1.5 × aleFounding0.8
weaving0.6000000238418579 × grain, 0.10000000149011612 × timber1 × clothFounding1.6
smithy1 × iron, 1.2000000476837158 × charcoal1 × toolsMedieval2
glassworks1 × clay, 1.5 × charcoal1 × glassRenaissance2.2
blast furnace2 × iron, 2.5 × coal1.600000023841858 × steelIndustrial2.4
cement works2 × stone, 1 × coal2.200000047683716 × concreteModern1.4
manufactory1 × cloth, 0.6000000238418579 × coal0.5 × luxuriesIndustrial2

Policy

The levers a governor has, their defaults and how far they go. Friction is what the citizens resent per year.

leverdefault
allow_densityyes
conservationno
fire_brigadeno
fire_codeno
flood_worksno
garrison0.1
grain_reserve_years0.5
guidance0, 0, 0, 0, 0, 0, 0, 0, 0, 0
public_works0.25
relief0.05
schoolingno
tariff0
tax_rate0.1
tribute0
rulevalue
friction_conservation0.04
friction_fire_code0.05
friction_floor-0.12
friction_relief1.4
friction_tariff0.4
garrison_max0.6
grain_reserve_max4
public_works_max0.9
purchase_legitimacy0.05
purchase_price220
relief_max0.5
step_garrison0.02
step_grain_reserve0.25
step_lean0.5
step_public_works0.05
step_relief0.02
step_tariff0.05
step_tax0.02
step_tribute10
tariff_max1.5
tax_max0.6

Needs

What the city wants per head before it studies a shortage.

rulevalue
church_per_head0.08
garrison_per_threat0.2
housing_slack4
production_per_head0.15
school_per_head0.15
shortage_gate0.2
storage_min120
storage_years2.5
study_required24

Events

The shapes of fire, plague, earthquake and the gate a war has to pass before a city marches. The base chances are tunables.

rulevalue
campaign_seasonsspring and summer, as the weather has them
fault_scatter12
fire_dryness_max1.5
fire_dryness_min0.45
fire_dryness_pivot1.6
fire_exposure_floor0.3
fire_unbuilt0.2
flood_runoff0.25
flood_storm4
hazard_mean_days360
hearth0.4
hearth_below_c4
news_arrival3
plague_arrival4
plague_crowding_cap3
plague_hunger1.5
plague_severity0.06, 0.34
plague_standing_water1
plague_years1, 4
quake_brittle_new0.7
quake_brittle_old1.25
quake_fires4
quake_harm0.7
quake_legitimacy0.08
quake_liquefaction0.4
quake_min_harm0.03
quake_radius_base24
quake_radius_per110
quake_shed160
quake_shed_masonry1
quake_shed_steel0.15
quake_shed_timber0.4
quake_vents90
rebound0.5, 1.5
sanitation_industrial0.8
sanitation_modern0.12
seismic_floor0.05
siege_blockade_grain0.35
spread_calm0.52
spread_wind0.2
tinder_days20
tinder_floor0.5
tinder_rain_mm1
tinder_span1
war_cap0.3
war_min_population150
war_min_threat1.1

Water

Floods and what the town does about them; the bank heights are tunables.

rulevalue
bank_greening_per_year120
bank_recovery_dry_days360
drainage_per_year45
embankment_eraRenaissance
embankment_treasury400
flood_harm_base0.22
flood_harm_drained0.35
flood_harm_per_course0.12
flood_min_voxels40
freeze_days7
height_band_courses16
height_bands8
river_freeze_c-8
river_freeze_days14
step_days30
thaw_days4

Settlement and peoples

rulevalue
max_cultures12
max_expedition24
min_community3
min_expedition8
min_organizers8
traffic_cell4

People: skills, kits and minds

Each finished piece of work closes practice of the gap to mastery (times apprentice for a youth beside a master); an unused skill loses forget a year down to forget_floor. Output is (ability_base + aptitude × ability_aptitude + skill × ability_practice) × kit, the kit being kit_bare + (quality − kit_bare) × √wear. The value model steps learning_rate towards each job's pay, tries something else explore of the time and adds duty × the town's need. homeless_leave of the grown homeless leave each year, unless another village of the town has an empty bed, which they walk to instead; births scale with housing places over people, down to crowded_fertility. See people.

rulevalue
ability_aptitude0.5
ability_base0.9
ability_practice0.6
apprentice2
boom_fertility2
childhood13
crowded_fertility0.25
explore0.06
forget_floor0.1
founder_main0.35
founder_other0.12
homeless_leave0.25
inherit0.25
kit_bare0.75
kit_mend_timber0.1
kit_mended_quality0.97
kit_mended_wear0.85
kit_quality_by_eraFounding, 1, Medieval, 1.06, Renaissance, 1.12, Industrial, 1.22, Modern, 1.32, Contemporary, 1.38
kit_replace_below0.4
kit_wear_per_job0.0025
learning_rate0.08
master0.6
roofless_crowded0.42
roofless_crowded_at150
roofless_fertility0.72
skillsfarming, forestry, quarrying, mining, building, carrying, making, arms, letters
soften0.5
tools_per_kit0.5
value_clamp3

The job board

How much the town wants each kind of work before anybody's preferences, and what finished work pays before prices.

rulevalue
going_rate0.02
hunger_memory0.35
hunger_memory_years12
hungry_year0.8
need_build1
need_farm0.2
need_farm_hunger1.5
need_gather_floor0.25
need_gather_short0.75
need_make0.3
need_make_tools0.9
need_road0.5
pay_haul_share0.3
pay_per_acre0.2
pay_per_voxel0.3
pay_road1.5

Damage and repair

What a flood's water, a winter's snow and a fire watch do and cost; and how long an unbuilt line stays in the street plan without being asked for again.

rulevalue
cave_in0.6
collapse_share0.3
drowning_depth2
fast_water12
fire_watch_wage6
flood_remembered_years25
grain_loss_floor0.04
plan_lapse_years5
store_loss0.8
wash_daub0.6
wash_thatch0.8
wash_timber0.22
weak_roof0.5

Villages

When a village sets out a green, builds its granary, workshop and chapel, and fences itself.

rulevalue
chapel_at45
granary_at28
green_at12
green_radius3
lane_reach30
palisade_at26
palisade_height3
palisade_houses4
palisade_timber20
raid_memory40
workshop_at40

War

How a war goes once a city marches or a village raids. The chance of a war is a tunable; see war.

rulevalue
ally0.75
ally_help0.0015
breach_stakes_days8
breach_stone_days24
break0.3
embassy300
embassy_warmth0.5
expedition_max120
expedition_min8
fight0.08
garrison_share0.5
home_ground1.15
loot_grain0.5
man0.6
man_arms0.8
march14
muster_range40
palisade1.6
raiders0.6
rout0.4
sack_fires3
siege_days75
vendetta-0.4
vendetta_chance0.3
wall2.5
wall_fire0.02

Quarries, pits and woods

Nobody digs on the town's ground: near the market place, inside the wall, or within building_margin of any building. Outside it the town keeps up to open_at_once workings per material, the rich ground the most people can reach within work_reach first, and closes one when fewer than worked_out faces can still be worked or the town grows over it. Once there is a square, no working is opened nearer the middle of the town than its built-up edge and growth_margin past it, so the town keeps the ground it will grow into; a stone quarry leans to a hill (hill_rise) rather than the flat, and an old working the town grows out to is filled back in with earth, at most fill_per_year columns a year, and grassed over. No course is taken that would leave anybody within way_out without a one-course step out, so a working goes down as a bowl its quarrymen can still walk into. A tree felled on ground the town has not taken for a house, a field or a street stands again after coppice_years. Once the next age waits on money (time aside), or on learning with no school paid for, the town buys abroad for its houses only, and for them only what its own hands won none of last year, and its public works buy only grain, until the money is in the chest.

rulevalue
building_margin12
coppice_years12
fill_per_year400
growth_margin16
hill_rise24
keep_clear30
keep_clear_hamlet14
open_at_once2
planting_max90
quarry_radius9
square_margin10
timber_per_trunk1.6
way_out20
work_reach96
worked_out12
worth_opening30
worth_opening_clay8

Mines

One mouth a deposit, no other within spacing: an adit driven level into the hillside, or on flat ground a stair down until there is min_cover of rock over its roof. Behind it the drifts follow the ore with a rib of rock between two passages, send a cross-cut off every branch_every columns where the ore runs to the side (up to max_headings faces), give a face up after barren_run columns without ore, and go down level_drop to the next level when one is worked out. The roof comes in when more than rock_holds of the ground round a passage is dug out under rock (earth_holds under earth): rubble fills the chamber, a shallow working (under crown_cover) sinks into a crown hole, and a town that has lost a mine leaves its ore as pillars from then on (pillar_margin).

rulevalue
barren_run7
branch_every4
buried_under0.7
crown_cover5
earth_holds0.4
level_drop4
max_columns160
max_descent8
max_headings4
min_cover3
pillar_margin0.08
rock_holds0.62
spacing24
thin_cover2
thin_roof0.1
timber_per_set10

Tunable rule reference

Every dial the tuning page, a preset in assets/tunables/ or the browser build can turn, with the default the rule always had.

time

dialdefaultminmaxstepwhat it does
turns_per_day11641The world's pace against the people's: how many working turns the people get in one calendar day. Walking, hauling, building, farming and fighting happen every turn; the weather, the water, the crops, the months and the years move once a day. One is the old clock, where a turn was a day; eight lets a winter last eight times as many turns, so a town lives through its three months of cold rather than past them. Sixty-four stretches a season over a working lifetime of turns.
days_per_turn1181The other way round, when a day holds one turn: calendar days to each of the people's turns. Above one the world runs ahead of the people. They take a turn every so many days and sit the days between out, while the weather, the crops, the months and the years (the market, the births and the deaths) keep to the calendar. At four a year goes by in a quarter of the people's turns, and the town gets a quarter as much walked, carried, sown and built in it.

water

dialdefaultminmaxstepwhat it does
stream_drain_days9013601Days for an unsupported stream to drain from its head to its outlet.
thaw_erosion1.6140.1How much faster meltwater cuts frost-loosened soil than rain cuts summer ground: the thaw is when a valley's streams do their work.
bank_erosion0.35010.05Share of a stream's cutting spent on the bank straight ahead of it at a bend rather than on its bed: what makes a channel wander across its valley over the centuries. Nought keeps every stream in its first bed.
flood_bank_natural1.250.540.05How far over bank-full the river must run before it is in the town.
flood_bank_embanked0.55030.05What an embankment adds to that.
flood_bank_works0.25030.05What the flood-works policy adds to that.
flood_chance_per_over1.1040.1A month's chance of a flood per unit the river stands over its bank, capped at 0.85, spent on the days the rain, the melt and the storms bring the water down.

climate

dialdefaultminmaxstepwhat it does
snow_drift_share0.05010.01Maximum share of loose snow redistributed downhill into sheltered neighboring ground per month; wind increases exposure up to this cap.

ground

dialdefaultminmaxstepwhat it does
slump_budget40005,00050Courses of loose earth that may slide in a day, valley-wide, once the ground has been left steeper than it stands: the pace of a landslip, which plays out over days above it. Nought turns the ground's own movement off.
undermine_harm0.15010.05Condition a building loses for each column of earth that slides from under its walls: at the default a wall undermined along a few columns is holed and shored up, along many it comes down.

events

dialdefaultminmaxstepwhat it does
quake_landslides1030.5Courses of repose an earthquake's full shaking takes off the loose slopes within its reach, less further out: the landslides a shock brings down with it. Nought leaves the hillsides standing.
fire_base_chance0.03500.30.005Yearly base chance of a fire breaking out, scaled by how much of the standing town still burns and how dry the year was.
fire_code_factor0.350.0510.05What a fire code does to the town's exposure: thatch banned, tile in.
plague_base_chance0.01200.20.002Yearly base chance of plague, scaled by crowding and the age's sanitation.
plague_crowding_per9001005,00050People per unit of crowding in the plague roll; a town this size is as crowded as it gets before the ceiling of three.
quake_base_chance0.00200.10.001Yearly earthquake chance on a site that shakes at all.
quake_per_seismicity0.0200.50.005Yearly earthquake chance added per unit of the site's seismicity.
war_chance_per_threat0.35010.05Chance of war per unit of threat above one, once the town is worth marching on.
market_shock_chance0.0500.50.01Yearly chance of a market shock abroad.

war

dialdefaultminmaxstepwhat it does
expedition0.0500.20.01Share of a foreign city's army it sends against the town, within the war's `expedition_min` and `expedition_max` men.
loot_treasury0.6010.05Share of the town's treasury carried off in a sack.
massacre0.0600.30.01Share of the people who did not fight killed in a sack.

damage

dialdefaultminmaxstepwhat it does
drowning_per_course0.1200.50.02Chance per course of flood water over the drowning depth that it takes somebody standing in it, doubled for the very young and the old.
roof_load_mm1505040010Lying snow, in millimetres of water, that a sound roof carries without complaint: at the default about half a metre of settled snow.

settlement

dialdefaultminmaxstepwhat it does
settlement_separation48162004Cells between one village core and the next, leaving room for fields.
founding_population3244004People a settlement needs before it counts as a village of its own.
founding_camp_years50301Years the founders keep their camp together while they build: until then nobody walks off for want of a roof and no party is sent to found another village. A town at one day a turn has housed its founders by its fourth or fifth year.

peoples

dialdefaultminmaxstepwhat it does
branch_years3513005Years a daughter village must stand before it can take its own name.
branch_population3444002People a daughter village must hold before it can take its own name.

people

dialdefaultminmaxstepwhat it does
food_per_head0.85040.05Grain one person eats in a year, in stock units.
practice0.0040.0010.020.001Share of the gap to mastery one finished piece of work closes, for a person of middling aptitude: at the default a novice is a journeyman in a couple of years of steady work and a master in about ten.
forget0.0400.20.01Share of a skill lost in a year it was never used, down to what any grown-up who has seen it done keeps.
duty1.2030.1How much the town's need counts against a person's own estimate of what a kind of work pays them.

eras

dialdefaultminmaxstepwhat it does
era_threshold_scale10.150.1Multiplies every era's population, treasury, literacy and building gates: below one the city advances early, above one it lingers.

economy

dialdefaultminmaxstepwhat it does
tax_friction_free0.1200.60.01The tax rate nobody resents; friction starts above it.
tax_friction_slope2.20100.1Friction per unit of tax above the free rate.

Building templates

A template is a kind of building as slots with options; a level is one step of it. The chooser picks, the compiler draws, the city measures. Browse them.

templatekindcraftmin footprintlevelsslots
houseHouseShelter5 × 6hut → cottage → house → townhousewalls (daub, timber, stone, brick, plaster, concrete); roof (gable, hip, flat); storeys (1, 2, 3, 4); chimney (none, one, two); windows (few, many, none); porch (none, front); annex (none, lean-to, tower); yard (open, fenced, walled); trim (plain, dressed); flag (no, yes)
hutHutShelter5 × 6hutwalls (daub, timber, stone, brick, plaster, concrete); roof (gable, hip, flat); storeys (1, 2, 3, 4); chimney (none, one, two); windows (few, many, none); porch (none, front); annex (none, lean-to, tower); yard (open, fenced, walled); trim (plain, dressed); flag (no, yes)
tenementTenementShelter6 × 6lodgings → tenement → blockwalls (daub, timber, stone, brick, plaster, concrete); roof (gable, hip, flat); storeys (1, 2, 3, 4); chimney (none, one, two); windows (few, many, none); porch (none, front); annex (none, lean-to, tower); yard (open, fenced, walled); trim (plain, dressed); flag (no, yes)
forgeForgeMake4 × 4smithy → forge → ironworkswalls (daub, timber, stone, brick, plaster, concrete); roof (gable, hip, flat); storeys (1, 2, 3, 4); chimney (none, one, two); windows (few, many, none); porch (none, front); annex (none, lean-to, tower); yard (open, fenced, walled); trim (plain, dressed); flag (no, yes); hearth (open, oven)
millMillMake4 × 4mill → tall millwalls (daub, timber, stone, brick, plaster, concrete); roof (gable, hip, flat); storeys (1, 2, 3, 4); chimney (none, one, two); windows (few, many, none); porch (none, front); annex (none, lean-to, tower); yard (open, fenced, walled); trim (plain, dressed); flag (no, yes); wheel (side, none)
workshopWorkshopMake4 × 4shed → workshop → workswalls (daub, timber, stone, brick, plaster, concrete); roof (gable, hip, flat); storeys (1, 2, 3, 4); chimney (none, one, two); windows (few, many, none); porch (none, front); annex (none, lean-to, tower); yard (open, fenced, walled); trim (plain, dressed); flag (no, yes)
granaryGranaryStore4 × 4store → granarywalls (daub, timber, stone, brick, plaster, concrete); roof (gable, hip, flat); storeys (1, 2, 3, 4); chimney (none, one, two); windows (few, many, none); porch (none, front); annex (none, lean-to, tower); yard (open, fenced, walled); trim (plain, dressed); flag (no, yes); raised (staddles, ground)
warehouseWarehouseStore5 × 5warehouse → bonded storewalls (daub, timber, stone, brick, plaster, concrete); roof (gable, hip, flat); storeys (1, 2, 3, 4); chimney (none, one, two); windows (few, many, none); porch (none, front); annex (none, lean-to, tower); yard (open, fenced, walled); trim (plain, dressed); flag (no, yes)
churchChurchCivic5 × 7chapel → church → minsterwalls (daub, timber, stone, brick, plaster, concrete); roof (gable, hip, flat); storeys (1, 2, 3, 4); chimney (none, one, two); windows (few, many, none); porch (none, front); annex (none, lean-to, tower); yard (open, fenced, walled); trim (plain, dressed); flag (no, yes); tower (low, tall, none)
marketMarketCivic5 × 5market cross → market hallwalls (daub, timber, stone, brick, plaster, concrete); roof (gable, hip, flat); storeys (1, 2, 3, 4); chimney (none, one, two); windows (few, many, none); porch (none, front); annex (none, lean-to, tower); yard (open, fenced, walled); trim (plain, dressed); flag (no, yes); sides (open, stalls)
town hallTownHallCivic5 × 5moot hall → town hallwalls (daub, timber, stone, brick, plaster, concrete); roof (gable, hip, flat); storeys (1, 2, 3, 4); chimney (none, one, two); windows (few, many, none); porch (none, front); annex (none, lean-to, tower); yard (open, fenced, walled); trim (plain, dressed); flag (no, yes)
schoolSchoolCivic5 × 5schoolroom → schoolwalls (daub, timber, stone, brick, plaster, concrete); roof (gable, hip, flat); storeys (1, 2, 3, 4); chimney (none, one, two); windows (few, many, none); porch (none, front); annex (none, lean-to, tower); yard (open, fenced, walled); trim (plain, dressed); flag (no, yes)
garrisonGarrisonDefend4 × 4guardhouse → garrisonwalls (daub, timber, stone, brick, plaster, concrete); roof (gable, hip, flat); storeys (1, 2, 3, 4); chimney (none, one, two); windows (few, many, none); porch (none, front); annex (none, lean-to, tower); yard (open, fenced, walled); trim (plain, dressed); flag (no, yes)
farmsteadFarmsteadGrow5 × 6croft → farmsteadwalls (daub, timber, stone, brick, plaster, concrete); roof (gable, hip, flat); storeys (1, 2, 3, 4); chimney (none, one, two); windows (few, many, none); porch (none, front); annex (none, lean-to, tower); yard (open, fenced, walled); trim (plain, dressed); flag (no, yes)

World recipes and features

recipefeaturesdescription
plain valleyThe site exactly as terrain generation makes it.
karst valleyCaves, Cliffs, BasinLimestone country: cave systems under the hills, a sink basin, a few cliff bands.
alpine gorgeGorge, Cliffs, PlateauA Schlucht cut from the river's head into the mountain, stepped cliffs above it, a high plateau.
terraced highlandsTerraces, Ridge, CavesGentle farm terraces up the valley sides, a ridge across the head, caves in the ridge.
featurewhat it does
cavesWorm tunnels under the hills, each with a mouth on a slope, kept above the tide.
cliffsSteep ground stepped into rock bands: an escarpment where the hill was a slope.
gorgeA deep, narrow U-shaped cut along a wandering line between two anchors.
terracesHeights quantised to a step between two elevations, for farm terraces.
plateauA mesa with a flat top and a steep rim.
basinA hollow the water model turns into a lake if the rain allows.
ridgeA spine between two points.
craterA bowl with a raised rim.

Climate epochs and snow

scenarioenabledglacial periodglacial amplitudesecular periodsecular amplitudedrift / centurykeyframes
natural cyclesyes9002.61100.90—
little ice ageyes9002.61100.90y0 +0.4000000059604645 °C ×1; y180 +0.4000000059604645 °C ×1; y230 -1.600000023841858 °C ×1.149999976158142; y330 -1.399999976158142 °C ×1.100000023841858; y380 +0 °C ×1; y520 +0.30000001192092896 °C ×1; y640 +1.7999999523162842 °C ×0.949999988079071
ice ageyes90011100.90y0 -3.5 °C ×1.2000000476837158; y250 -4.5 °C ×1.25; y400 -1 °C ×1.0499999523162842; y600 +1 °C ×0.949999988079071
steadyno9002.61100.90—
The cryosphere's defaults: degree-day factors in mm per degree-day, thresholds in mm of water.
rulevalue
albedo_c1.5
aspect0.8
enabledyes
fells_trees_mm900
firn_ddf2.2
firn_to_ice_mm1,000
first_layer_mm60
flow_rate0.1
flow_threshold_mm2,500
footfall_keep0.6
ground_relax0.003
hardpack_paint0.38
ice_ddf1.3
ice_share0.4
lapse0.32
layer_mm250
max_half_layers16
orographic0.015
orographic_max2
permafrost_days720
pile_reach6
rain_melt0.35
scour0.0002
snow_ddf2.8
snow_drift_share0.05
tread_min_mm8
tread_steps3

Styles, scale and lenses

styleunitdescription
palim1The simulation's own colours, a metre a unit, drawn as runtime pixel art.
sprite2Retro game colours: jade meadows, violet stone and golden roofs in crisp, chunky pixels.
picturesque pixels1Sunlit hand-drawn pixels: light meadow greens, warm stone and softly interlocking edges.
vivid1Saturated, strongly grained, a meadow of tall grass and flowers.
miniature0.5A pastel clay model: mint hills, coral roofs, cream stone and clean matte surfaces.
cyanotype1A blue-and-ivory print: cobalt land, pale architecture and ink-blue water.

The render unit runs from 0.25 to 4 per simulated metre (default 1); material is stored at 32 voxels per metre. Playground maps: height, change, snow and ice, fertility, water. Scheduler lanes: realtime, background, idle.

lenswhat it shows
materialWhat every voxel is made of: the material colour of the top of each column.
eraThe era that laid each built voxel; untouched ground is greyed. The palimpsest itself.
waterStanding water, saturated soil and the river: what the water model holds this month.
culturesTown ground in the colour of the people who hold the nearest settlement.
territoriesTown ground by settlement number, whoever lives there.
fertilityHow well each column grows things, one being the site's ordinary ground.
snowSnow, firn and glacier ice lying on the ground as voxels.
trafficWhere people actually walk: crossings this decade, and the wear they leave.
migrationWhich towns are gaining or losing people: arrivals less departures over the last ten years as a share of each settlement, blue losing through gold steady to red gaining.

Controls

keydoesgroup
up / downchoose a settinglauncher
left / rightchange it; hold shift for a bigger steplauncher
Rroll a new seedlauncher
Enterfound the citylauncher
Escclose inspection or menus, then return to the launcher; quit from the launcherlauncher
F1the city: calendar, age, people, purse, legitimacy, threatviews
F2the works: what is standing, levels, the building programme, streets, the wallviews
F3people: headcount, what everybody is doing, the year's demography, tradesviews
F4the ground: what is left in the site, salvage, what can be walked toviews
F5the sky: the season, the weather, the year's rain, the lakes, the flood plainviews
F6economy: treasury, the fields, stores and prices, the year's productionviews
F7the world outside: the trade ledger, who the city deals with, the dangerviews
F8learning: the study in hand, the last survey, how good each craft has gotviews
F9chronicle: the city's own memory, newest firstviews
F12the peoples: who lives here, where they came from, how they get onviews
Gopen or close the engine panel: entities, design, terrain, playground, climate, style, taskspanels
Tabhide the whole frame and give the city the windowpanels
Spacepause and runtime
Ctrl + Ssave the valley to saves/, to carry on later with --loadtime
1 to 5speed: 16, 60, 180, 360, 720 of the people's turns a secondtime
Shift + 1 to 5seasons: longest, long, normal, short, shortest; 16 or 4 turns a day, a turn a day, or 2 or 4 days a turntime
right-dragorbitcamera
wheelzoomcamera
W A S D / arrowspancamera
Q / Eraise and lowercamera
, / .turn the camera one step left or rightcamera
one-finger dragorbit, on a touch screencamera
pinch / two-finger slidezoom / pan, on a touch screencamera
tap a building or roadinspect it, as a left-click doescamera
Mswitch between material colour and colour by the era that laid itlenses
Vturn pixel art on or offlenses
Pshow or hide the citizenslenses
Zshow or hide quiet building labelslenses
Xtoggle the X-ray cutawaylenses
[ / ]lower or raise the cutaway layer; hold to repeat, shift moves eightlenses
\show all caves and excavated holes togetherlenses
F10toggle settled-territory outlines and village markerslenses
F11toggle field boundaries: green planted, gold fallowlenses
left-click a building or roadinspect it in the world; Edit structure opens its voxel blueprint editor; Buy it out is compulsory purchaseeditor
Alt + left-clickremove one 3.125 cm voxel under the pointereditor
Alt + Shift + left-clickadd one voxel of the pointed material against that faceeditor
Shift + click (editor)erase a cell of the drafteditor
Esc (editor)discard the draft and return to the cityeditor