@v12-engine/create 0.1.0 → 0.4.0

package/starters/examples/src/examples/nature/maps.ts

@@ -0,0 +1,370 @@
+/**
+ * The nature examples' maps, each made in code (`./land.ts`): a forest round a glade, a meadow of every style of grass,
+ * a lake under a waterfall, rolling hills, a misty valley, a village, and a dry field by a wood. Where each puts its
+ * trees, worked out from the map so that a command can plant them again where they stood
+ */
+import { exactMath } from '@v12-engine/engine'
+import type { GameMap } from '@v12-engine/engine'
+
+type Rgb = [number, number, number]
+import { STYLE } from './grass'
+import { type At, band, blob, distanceToLine, field, grow, mow, noise, paint, place, pour, raise, scatter, sculpt, smooth } from './land'
+
+/** Ground that rolls a little, `amount` high: the field's 1 as its middle */
+const rolling =
+	(amount: number, scale = 14, seed = 3) =>
+	(x: number, z: number) =>
+		1 + (noise(x, z, scale, seed) - 0.5) * 2 * amount
+
+// ---- a forest round a glade
+
+/** The glade in the forest's middle, and the path that leads into it from the south */
+export const GLADE: At = { x: 32, z: 32 }
+const FOREST_PATH: At[] = [
+	{ x: 30, z: 64 },
+	{ x: 33, z: 52 },
+	{ x: 30, z: 42 },
+	{ x: 32, z: 33 }
+]
+
+/** A forest of 64 cells a side round a glade of meadow and flowers, a path winding in from the south */
+export function forestMap(): GameMap {
+	const map = field('Forest', 64)
+	sculpt(map, rolling(0.8, 16))
+	const glade = blob(GLADE, 10, 2.5, 4)
+	const path = band(FOREST_PATH, 2.2, 0.4)
+	paint(map, 'darkGrass', (x, z) => !glade(x, z))
+	paint(map, 'dirt', (x, z) => !glade(x, z) && noise(x, z, 5, 9) > 0.68)
+	paint(map, 'grass', glade)
+	grow(map, STYLE.meadow, glade)
+	grow(map, STYLE.flowers, (x, z) => glade(x, z) && noise(x, z, 4, 12) > 0.6)
+	grow(map, STYLE.tallGrass, (x, z) => !glade(x, z) && noise(x, z, 7, 13) > 0.62)
+	grow(map, STYLE.thicket, (x, z) => blob(GLADE, 12.5, 1.5, 4)(x, z) && !glade(x, z) && noise(x, z, 3, 14) > 0.5)
+	paint(map, 'dirt', path)
+	mow(map, path)
+	for (const [i, at] of [
+		{ x: 27, z: 29 },
+		{ x: 37, z: 35 },
+		{ x: 35, z: 27 }
+	].entries())
+		place(map, `forest/rock_medium_${i + 1}.glb`, at, { yaw: i * 2.1, scale: 0.9 })
+	return map
+}
+
+/** Where the forest's trees stand: everywhere but the glade and the path, thicker away from the glade */
+export const forestTrees = (map: GameMap): At[] =>
+	scatter(map, (x, z) => !blob(GLADE, 11, 2.5, 4)(x, z) && distanceToLine(FOREST_PATH, x, z) > 2.2 && noise(x, z, 6, 21) > 0.22, 1.7, 11)
+
+// ---- a meadow of every style
+
+/** The meadow's walkers' two sides: they cross from one to the other through the grass */
+export const MEADOW_WEST = 10
+export const MEADOW_EAST = 46
+
+/** A meadow of 56 cells a side, each style of grass in a field of its own, a pond with reeds, trees along its edges */
+export function meadowMap(): GameMap {
+	const map = field('Meadow', 56)
+	sculpt(map, rolling(0.5, 18))
+	const pond = blob({ x: 41, z: 15 }, 4.2, 1, 6)
+	pour(map, pond, blob({ x: 41, z: 15 }, 2.8, 0.8, 6))
+	paint(map, 'sand', blob({ x: 41, z: 15 }, 5.4, 1, 6))
+	grow(map, STYLE.meadow, (x, z) => x > 6 && x < 50 && z > 6 && z < 50)
+	// the fields, west to east across the middle where the walkers cross
+	grow(map, STYLE.wheat, (x, z) => x > 14 && x < 23 && z > 20 && z < 36 && noise(x, z, 3, 7) > 0.15)
+	grow(map, STYLE.tallGrass, blob({ x: 28, z: 28 }, 4.5, 1.2, 7))
+	grow(map, STYLE.flowers, blob({ x: 37, z: 31 }, 4, 1.5, 8))
+	grow(map, STYLE.dryGrass, blob({ x: 35, z: 42 }, 4.5, 1.5, 9))
+	grow(map, STYLE.thicket, blob({ x: 20, z: 43 }, 3, 1, 10))
+	grow(map, STYLE.reeds, (x, z) => blob({ x: 41, z: 15 }, 5.6, 1, 6)(x, z) && !blob({ x: 41, z: 15 }, 3.4, 0.8, 6)(x, z))
+	mow(map, pond)
+	paint(
+		map,
+		'dirt',
+		band(
+			[
+				{ x: 0, z: 9 },
+				{ x: 56, z: 7 }
+			],
+			1.6
+		)
+	)
+	mow(
+		map,
+		band(
+			[
+				{ x: 0, z: 9 },
+				{ x: 56, z: 7 }
+			],
+			1.6
+		)
+	)
+	return map
+}
+
+/** The meadow's trees: a ring round its edge */
+export const meadowTrees = (map: GameMap): At[] => scatter(map, (x, z) => (x < 6 || x > 50 || z < 5 || z > 50) && noise(x, z, 5, 4) > 0.3, 1.9, 12)
+
+// ---- a lake under a waterfall
+
+/** The lake's middle, and where the falls come down into it */
+export const LAKE: At = { x: 33, z: 40 }
+export const FALLS: At = { x: 32, z: 22 }
+const UPPER_RIVER: At[] = [
+	{ x: 26, z: 0 },
+	{ x: 29, z: 8 },
+	{ x: 31, z: 15 },
+	{ x: 32, z: 22 }
+]
+const LOWER_RIVER: At[] = [
+	{ x: 40, z: 44 },
+	{ x: 48, z: 47 },
+	{ x: 55, z: 45 },
+	{ x: 64, z: 49 }
+]
+
+/**
+ * A lake of 64 cells a side: a plateau (a cliff level up) across the north with a river on it that spills over the
+ * cliff into a pool, a lake below with a sandy shore and reeds, and a river out of it to the east. The waterfalls
+ * are found where the water spills from the plateau, by the client (`WaterLook.falls`)
+ */
+export function lakeMap(): GameMap {
+	const map = field('Lake', 64)
+	sculpt(map, (x, z) => rolling(0.6, 12)(x, z) + smooth(10, 0, z) * 1.5)
+	const plateau = (x: number, z: number) => z < 21 + (noise(x, 0, 6, 5) - 0.5) * 3 || (z < 23 && Math.abs(x - FALLS.x) < 4)
+	raise(map, 1, plateau)
+	const lake = (x: number, z: number) => blob(LAKE, 10, 2, 3)(x, z) || (z >= 21 && z < 32 && Math.abs(x - FALLS.x) < 4.5 + (z - 21) * 0.3)
+	const upper = band(UPPER_RIVER, 3.2, 0.3, 4)
+	const lower = band(LOWER_RIVER, 2.6, 0.3, 5)
+	pour(
+		map,
+		(x, z) => (plateau(x, z) ? upper(x, z) : lake(x, z) || lower(x, z)),
+		(x, z) => (plateau(x, z) ? band(UPPER_RIVER, 1.8)(x, z) : blob(LAKE, 7, 1.5, 3)(x, z))
+	)
+	paint(map, 'dirt', (x, z) => !plateau(x, z) && blob(LAKE, 12.5, 2, 3)(x, z))
+	paint(map, 'sand', (x, z) => !plateau(x, z) && blob(LAKE, 11, 2, 3)(x, z) && noise(x, z, 3, 11) > 0.45)
+	paint(map, 'rock', (x, z) => plateau(x, z) && noise(x, z, 4, 8) > 0.6)
+	paint(map, 'darkGrass', (x, z) => noise(x, z, 9, 6) > 0.6)
+	grow(map, STYLE.meadow, (x, z) => !blob(LAKE, 12.5, 2, 3)(x, z) && noise(x, z, 8, 3) > 0.3)
+	grow(map, STYLE.reeds, (x, z) => !plateau(x, z) && blob(LAKE, 12, 2, 3)(x, z) && !blob(LAKE, 10.5, 2, 3)(x, z) && noise(x, z, 3, 2) > 0.45)
+	grow(map, STYLE.flowers, (x, z) => noise(x, z, 5, 15) > 0.72)
+	mow(map, (x, z) => map.water[Math.floor(z) * map.width + Math.floor(x)] > 0)
+	place(map, 'forest/rock_medium_2.glb', { x: 27.5, z: 24 }, { scale: 1.4, yaw: 1 })
+	place(map, 'forest/rock_medium_3.glb', { x: 37.5, z: 25 }, { scale: 1.2, yaw: 2.5 })
+	place(map, 'village/fantasy_house_2.glb', { x: 48, z: 34 }, { yaw: -2.2, scale: 0.9, blocks: true })
+	return map
+}
+
+/** The lake's trees: in woods round it, on the plateau too, never on the shore */
+export const lakeTrees = (map: GameMap): At[] =>
+	scatter(
+		map,
+		(x, z) =>
+			!blob(LAKE, 13.5, 2, 3)(x, z) &&
+			distanceToLine(UPPER_RIVER, x, z) > 3 &&
+			distanceToLine(LOWER_RIVER, x, z) > 3 &&
+			exactMath.hypot(x - 48, z - 34) > 4.5 &&
+			noise(x, z, 7, 22) > 0.45,
+		1.8,
+		13
+	)
+
+// ---- rolling hills, for the clouds
+
+/** Hills of 96 cells a side, woods in their hollows: what clouds' shadows are seen running over */
+export function hillsMap(): GameMap {
+	const map = field('Hills', 96)
+	sculpt(map, (x, z) => 1 + noise(x, z, 22, 2) * 5 + noise(x, z, 7, 3) * 0.8)
+	paint(map, 'darkGrass', (x, z) => noise(x, z, 12, 4) > 0.55)
+	paint(map, 'rock', (x, z) => noise(x, z, 22, 2) > 0.78)
+	grow(map, STYLE.meadow, (x, z) => noise(x, z, 22, 2) < 0.7)
+	grow(map, STYLE.flowers, (x, z) => noise(x, z, 6, 9) > 0.75)
+	return map
+}
+
+/** The hills' woods */
+export const hillsTrees = (map: GameMap): At[] => scatter(map, (x, z) => noise(x, z, 12, 4) > 0.58, 1.9, 14, 900)
+
+// ---- a misty valley
+
+/** The line the valley winds along, south to north */
+const VALLEY: At[] = Array.from({ length: 9 }, (_, i) => ({ x: 40 + exactMath.sin(i * 0.9) * 9, z: i * 10 }))
+
+/** A valley of 80 cells a side between steep hills, a stream along its floor: the mist lies in it */
+export function valleyMap(): GameMap {
+	const map = field('Valley', 80)
+	sculpt(map, (x, z) => {
+		const away = distanceToLine(VALLEY, x, z)
+		return 0.6 + smooth(4, 22, away) * 9 + noise(x, z, 10, 6) * 1.6 * smooth(4, 12, away)
+	})
+	const stream = band(VALLEY, 2.4, 0.4, 7)
+	pour(map, stream, band(VALLEY, 1, 0.2, 7))
+	paint(map, 'dirt', (x, z) => distanceToLine(VALLEY, x, z) < 3)
+	paint(map, 'darkGrass', (x, z) => distanceToLine(VALLEY, x, z) > 12)
+	paint(map, 'rock', (x, z) => distanceToLine(VALLEY, x, z) > 9 && distanceToLine(VALLEY, x, z) < 16 && noise(x, z, 4, 3) > 0.5)
+	grow(map, STYLE.tallGrass, (x, z) => distanceToLine(VALLEY, x, z) < 7 && noise(x, z, 5, 4) > 0.4)
+	grow(map, STYLE.reeds, (x, z) => distanceToLine(VALLEY, x, z) < 3)
+	mow(map, stream)
+	return map
+}
+
+/** The valley's trees: up its sides, pines high */
+export const valleyTrees = (map: GameMap): At[] =>
+	scatter(map, (x, z) => distanceToLine(VALLEY, x, z) > 4 && noise(x, z, 6, 30) > 0.35, 1.8, 15, 1200)
+
+/** A point on the valley's floor, `share` of the way up it */
+export const valleyAt = (share: number): At => {
+	const i = Math.min(VALLEY.length - 2, Math.floor(share * (VALLEY.length - 1)))
+	const t = share * (VALLEY.length - 1) - i
+	return { x: VALLEY[i].x + (VALLEY[i + 1].x - VALLEY[i].x) * t, z: VALLEY[i].z + (VALLEY[i + 1].z - VALLEY[i].z) * t }
+}
+
+// ---- a village, for the weather and the time of day
+
+/** The village square's middle */
+export const SQUARE: At = { x: 32, z: 32 }
+
+/** Where the village's lamps stand: torches round the square, each a light of the map too (`MapEnvironment.lights`) */
+export const LAMPS: At[] = [
+	{ x: 27, z: 27 },
+	{ x: 37, z: 27 },
+	{ x: 27, z: 37 },
+	{ x: 37, z: 37 },
+	{ x: 32, z: 22 },
+	{ x: 32, z: 44 },
+	{ x: 20, z: 32 },
+	{ x: 44, z: 32 }
+]
+
+/** A village of 64 cells a side: houses round a square with a well and a fire, roads out, fields and woods about */
+export function villageMap(): GameMap {
+	const map = field('Village', 64)
+	sculpt(map, rolling(0.5, 14))
+	const roads = [
+		band([{ x: 32, z: 0 }, { x: 31, z: 20 }, SQUARE, { x: 33, z: 46 }, { x: 32, z: 64 }], 2.4, 0.3, 3),
+		band([{ x: 0, z: 31 }, { x: 18, z: 33 }, SQUARE, { x: 46, z: 31 }, { x: 64, z: 34 }], 2.4, 0.3, 4)
+	]
+	const square = blob(SQUARE, 6.5, 0.6, 2)
+	grow(map, STYLE.meadow, (x, z) => noise(x, z, 9, 2) > 0.25)
+	grow(map, STYLE.wheat, (x, z) => x > 42 && x < 56 && z > 40 && z < 54)
+	grow(map, STYLE.wheat, (x, z) => x > 8 && x < 20 && z > 8 && z < 19)
+	grow(map, STYLE.flowers, (x, z) => noise(x, z, 4, 8) > 0.74)
+	paint(map, 'road', (x, z) => square(x, z) || roads.some((road) => road(x, z)))
+	mow(map, (x, z) => square(x, z) || roads.some((road) => road(x, z)))
+	const houses: [string, At, number][] = [
+		['village/fantasy_house.glb', { x: 24, z: 22 }, 0.6],
+		['village/fantasy_house_2.glb', { x: 41, z: 22 }, -0.7],
+		['village/fantasy_inn.glb', { x: 42, z: 41 }, -2.4],
+		['village/fantasy_house_3.glb', { x: 22, z: 41 }, 2.3],
+		['village/fantasy_house.glb', { x: 15, z: 27 }, 1.5],
+		['village/mill.glb', { x: 50, z: 17 }, -1],
+		['village/fantasy_stable.glb', { x: 15, z: 44 }, 2]
+	]
+	for (const [model, at, yaw] of houses) {
+		mow(map, blob(at, 3.2, 0.5))
+		place(map, model, at, { yaw, blocks: true })
+	}
+	place(map, 'village/well.glb', { x: 34.5, z: 30 }, { scale: 1.1 })
+	place(map, 'village/bonfire.glb', { x: 30, z: 34 }, { scale: 1.6, name: 'fire' })
+	place(map, 'village/market_stand.glb', { x: 28, z: 29 }, { yaw: 0.8 })
+	place(map, 'village/cart.glb', { x: 36, z: 36 }, { yaw: 2.4 })
+	place(map, 'village/barrel.glb', { x: 38.6, z: 25.8 })
+	place(map, 'village/hay.glb', { x: 46, z: 38 }, { yaw: 1 })
+	for (const at of LAMPS) place(map, 'dungeon-kit/torch.glb', at, { scale: 1.2 })
+	// a light at each torch's flame and at the fire, on always (a game without a day has no night to come on at); how
+	// bright all of them are is the map's lamps (`MapEnvironment.lamps`), which the time of day turns up at dusk
+	map.environment = {
+		...map.environment,
+		lights: [
+			...LAMPS.map((at, i) => ({
+				id: i + 1,
+				name: `torch ${i + 1}`,
+				...at,
+				height: 1.7,
+				color: [1, 0.68, 0.38] as Rgb,
+				intensity: 1.5,
+				range: 8,
+				flicker: 0.12,
+				halo: 0.3,
+				when: 'always' as const
+			})),
+			{
+				id: 20,
+				name: 'fire',
+				x: 30,
+				z: 34,
+				height: 0.9,
+				color: [1, 0.55, 0.25],
+				intensity: 2.2,
+				range: 11,
+				flicker: { amount: 0.3, speed: 1.4 },
+				when: 'always'
+			}
+		],
+		fx: [
+			{ id: 1, name: 'fire', fx: 'campfire', x: 30, z: 34, scale: 1.3 },
+			...LAMPS.map((at, i) => ({ id: i + 2, name: `torch ${i + 1}`, fx: 'torch', ...at, height: 1.55, scale: 0.8 }))
+		]
+	}
+	return map
+}
+
+/** The village's trees: woods round its edge, a few in it */
+export const villageTrees = (map: GameMap): At[] =>
+	scatter(
+		map,
+		(x, z) =>
+			(exactMath.hypot(x - SQUARE.x, z - SQUARE.z) > 26 || noise(x, z, 5, 3) > 0.82) &&
+			exactMath.hypot(x - SQUARE.x, z - SQUARE.z) > 9 &&
+			noise(x, z, 6, 40) > 0.3,
+		1.9,
+		16
+	).filter((at) => !onRoadOrHouse(at))
+
+/** Whether a place is a road, the square or a house's ground: trees keep off */
+function onRoadOrHouse({ x, z }: At): boolean {
+	return (
+		Math.abs(x - 32) < 3 ||
+		Math.abs(z - 32) < 3 ||
+		[
+			{ x: 24, z: 22 },
+			{ x: 41, z: 22 },
+			{ x: 42, z: 41 },
+			{ x: 22, z: 41 },
+			{ x: 15, z: 27 },
+			{ x: 50, z: 17 },
+			{ x: 15, z: 44 }
+		].some((house) => exactMath.hypot(x - house.x, z - house.z) < 5)
+	)
+}
+
+// ---- a dry field by a wood, to burn
+
+/** Where the fire is lit: the dry field's west end */
+export const FIRE_START: At = { x: 14, z: 30 }
+
+/** A field of 64 cells a side: dry grass in the west, meadow in the middle, a wood in the east, a road across */
+export function fireMap(): GameMap {
+	const map = field('Dry field', 64)
+	sculpt(map, rolling(0.5, 16))
+	paint(map, 'dirt', (x, z) => noise(x, z, 6, 3) > 0.6)
+	grow(map, STYLE.dryGrass, (x, z) => x < 30 && noise(x, z, 8, 4) > 0.2)
+	grow(map, STYLE.meadow, (x, z) => x >= 26 && noise(x, z, 8, 4) > 0.25)
+	grow(map, STYLE.tallGrass, (x, z) => x > 22 && x < 40 && noise(x, z, 6, 5) > 0.6)
+	grow(map, STYLE.wheat, (x, z) => x > 28 && x < 38 && z > 6 && z < 20)
+	const road = band(
+		[
+			{ x: 0, z: 52 },
+			{ x: 30, z: 50 },
+			{ x: 64, z: 54 }
+		],
+		2.2
+	)
+	paint(map, 'road', road)
+	mow(map, road)
+	place(map, 'village/fantasy_house.glb', { x: 22, z: 56 }, { yaw: 3, blocks: true })
+	return map
+}
+
+/** The fire's wood: east of the middle, and a few trees out in the field */
+export const fireTrees = (map: GameMap): At[] =>
+	scatter(map, (x, z) => z < 48 && ((x > 38 && noise(x, z, 6, 7) > 0.25) || (x > 10 && noise(x, z, 4, 8) > 0.86)), 1.7, 17)

package/starters/examples/src/examples/nature/skies.ts

@@ -0,0 +1,324 @@
+/**
+ * Skies for the nature examples: the look of the world at any hour of the day, and named looks to cross-fade between.
+ * Looks of the map (`MapEnvironment`) as data: given to `client.setEnvironment` they are one screen's, to
+ * `world.setEnvironment` every player's. The engine alone, so a map or the rules may take them too
+ */
+import { exactMath } from '@v12-engine/engine'
+import type { MapEnvironment } from '@v12-engine/engine'
+
+type Rgb = [number, number, number]
+
+// ---- the time of day
+
+/** The world at an hour: what the sun, the sky, the light, the mist and the lamps are */
+interface HourLook {
+	hour: number
+	sky: Rgb
+	sun: number
+	sunColor: Rgb
+	ambient: number
+	ambientColor: Rgb
+	ground: Rgb
+	clouds: Rgb
+	fog: Rgb
+	mist: number
+	lamps: number
+}
+
+/** The day, hour by hour: night, dawn, morning, noon, afternoon, golden hour, dusk, night. Between two, mixed */
+const DAY: HourLook[] = [
+	{
+		hour: 0,
+		sky: [0.03, 0.05, 0.12],
+		sun: 0.32,
+		sunColor: [0.55, 0.65, 1],
+		ambient: 0.22,
+		ambientColor: [0.35, 0.42, 0.75],
+		ground: [0.08, 0.08, 0.14],
+		clouds: [0.2, 0.22, 0.32],
+		fog: [0.06, 0.08, 0.16],
+		mist: 0.3,
+		lamps: 1
+	},
+	{
+		hour: 4.5,
+		sky: [0.06, 0.08, 0.18],
+		sun: 0.3,
+		sunColor: [0.55, 0.65, 1],
+		ambient: 0.24,
+		ambientColor: [0.38, 0.44, 0.75],
+		ground: [0.08, 0.08, 0.14],
+		clouds: [0.24, 0.26, 0.36],
+		fog: [0.08, 0.1, 0.2],
+		mist: 0.35,
+		lamps: 1
+	},
+	{
+		hour: 6,
+		sky: [0.75, 0.55, 0.55],
+		sun: 0.75,
+		sunColor: [1, 0.55, 0.35],
+		ambient: 0.4,
+		ambientColor: [0.75, 0.65, 0.85],
+		ground: [0.2, 0.17, 0.18],
+		clouds: [1, 0.7, 0.6],
+		fog: [0.8, 0.62, 0.6],
+		mist: 0.45,
+		lamps: 0.6
+	},
+	{
+		hour: 8,
+		sky: [0.6, 0.72, 0.88],
+		sun: 1.15,
+		sunColor: [1, 0.85, 0.68],
+		ambient: 0.5,
+		ambientColor: [0.85, 0.88, 1],
+		ground: [0.3, 0.28, 0.25],
+		clouds: [1, 0.95, 0.9],
+		fog: [0.75, 0.78, 0.82],
+		mist: 0.15,
+		lamps: 0
+	},
+	{
+		hour: 12,
+		sky: [0.46, 0.66, 0.92],
+		sun: 1.45,
+		sunColor: [1, 0.97, 0.9],
+		ambient: 0.6,
+		ambientColor: [0.92, 0.96, 1],
+		ground: [0.35, 0.33, 0.3],
+		clouds: [1, 1, 1],
+		fog: [0.72, 0.8, 0.9],
+		mist: 0,
+		lamps: 0
+	},
+	{
+		hour: 16,
+		sky: [0.5, 0.66, 0.88],
+		sun: 1.35,
+		sunColor: [1, 0.92, 0.78],
+		ambient: 0.55,
+		ambientColor: [0.9, 0.92, 1],
+		ground: [0.33, 0.3, 0.27],
+		clouds: [1, 0.97, 0.92],
+		fog: [0.75, 0.78, 0.85],
+		mist: 0,
+		lamps: 0
+	},
+	{
+		hour: 18,
+		sky: [0.85, 0.58, 0.42],
+		sun: 1.05,
+		sunColor: [1, 0.62, 0.32],
+		ambient: 0.42,
+		ambientColor: [0.85, 0.65, 0.65],
+		ground: [0.25, 0.18, 0.15],
+		clouds: [1, 0.68, 0.48],
+		fog: [0.85, 0.6, 0.48],
+		mist: 0.15,
+		lamps: 0.4
+	},
+	{
+		hour: 19.5,
+		sky: [0.32, 0.25, 0.42],
+		sun: 0.5,
+		sunColor: [0.85, 0.45, 0.45],
+		ambient: 0.3,
+		ambientColor: [0.5, 0.42, 0.7],
+		ground: [0.12, 0.1, 0.14],
+		clouds: [0.6, 0.42, 0.52],
+		fog: [0.3, 0.24, 0.36],
+		mist: 0.3,
+		lamps: 0.9
+	},
+	{
+		hour: 21,
+		sky: [0.05, 0.07, 0.16],
+		sun: 0.32,
+		sunColor: [0.55, 0.65, 1],
+		ambient: 0.22,
+		ambientColor: [0.35, 0.42, 0.75],
+		ground: [0.08, 0.08, 0.14],
+		clouds: [0.2, 0.22, 0.32],
+		fog: [0.06, 0.08, 0.16],
+		mist: 0.3,
+		lamps: 1
+	},
+	{
+		hour: 24,
+		sky: [0.03, 0.05, 0.12],
+		sun: 0.32,
+		sunColor: [0.55, 0.65, 1],
+		ambient: 0.22,
+		ambientColor: [0.35, 0.42, 0.75],
+		ground: [0.08, 0.08, 0.14],
+		clouds: [0.2, 0.22, 0.32],
+		fog: [0.06, 0.08, 0.16],
+		mist: 0.3,
+		lamps: 1
+	}
+]
+
+const mix = (a: number, b: number, t: number) => a + (b - a) * t
+const mixRgb = (a: Rgb, b: Rgb, t: number): Rgb => [mix(a[0], b[0], t), mix(a[1], b[1], t), mix(a[2], b[2], t)]
+
+/** Where the sun (or by night the moon) stands at an hour: degrees round from north, and up from the horizon */
+function sunAt(hour: number): { around: number; up: number } {
+	const day = (hour - 6) / 12
+	if (day >= 0 && day <= 1) return { around: 90 + day * 180, up: Math.max(4, exactMath.sin(day * Math.PI) * 68) }
+	// the moon: across the sky the other way, never as high
+	const night = (((hour - 18 + 24) % 24) / 12) % 1
+	return { around: 90 + night * 180, up: Math.max(12, exactMath.sin(night * Math.PI) * 45) }
+}
+
+/** The look of the world at an hour, 0 to 24: the sun's place and colour, the sky, the clouds, the mist and the lamps */
+export function lookAtHour(hour: number): Partial<MapEnvironment> {
+	const h = ((hour % 24) + 24) % 24
+	const next = DAY.findIndex((each) => each.hour > h)
+	const a = DAY[Math.max(0, next - 1)]
+	const b = DAY[next < 0 ? DAY.length - 1 : next]
+	const t = b.hour > a.hour ? (h - a.hour) / (b.hour - a.hour) : 0
+	const sun = sunAt(h)
+	return {
+		sky: mixRgb(a.sky, b.sky, t),
+		clouds: { cover: 0.35, color: mixRgb(a.clouds, b.clouds, t) },
+		light: {
+			sunAround: sun.around,
+			sunUp: sun.up,
+			sun: mix(a.sun, b.sun, t),
+			sunColor: mixRgb(a.sunColor, b.sunColor, t),
+			ambient: mix(a.ambient, b.ambient, t),
+			ambientColor: mixRgb(a.ambientColor, b.ambientColor, t),
+			ground: mixRgb(a.ground, b.ground, t),
+			// the glow at dawn and dusk is the table's own
+			glow: false
+		},
+		fog: { start: 50, end: 170, color: mixRgb(a.fog, b.fog, t) },
+		mist: { ground: { base: 0, top: 1.8, density: mix(a.mist, b.mist, t), color: mixRgb(a.fog, b.fog, t) } },
+		lamps: { brightness: mix(a.lamps, b.lamps, t) }
+	}
+}
+
+/** How much the lamps are lit at an hour, 0 to 1 */
+export const lampsAtHour = (hour: number): number => (lookAtHour(hour).lamps?.brightness as number) ?? 0
+
+/** An hour as a clock shows it */
+export const clock = (hour: number): string => {
+	const h = ((hour % 24) + 24) % 24
+	return `${String(Math.floor(h)).padStart(2, '0')}:${String(Math.floor((h % 1) * 60)).padStart(2, '0')}`
+}
+
+// ---- named looks, to cross-fade between
+
+/** Looks of the world by name: what the looks example picks from. Each says all of what it changes, so any follows any */
+export const LOOKS: Record<string, Partial<MapEnvironment>> = {
+	'Summer noon': {
+		...lookAtHour(12),
+		clouds: { cover: 0.3 },
+		cloudLayer: { height: 22, cover: 0.3, opacity: 0.5, shadows: 0.4 },
+		wind: { around: 100, strength: 0.3, gusts: 0.3 },
+		weather: { kind: 'rain', amount: 0 },
+		water: { shallow: [0.3, 0.62, 0.6], deep: [0.05, 0.2, 0.3], waves: { strength: 0.6 } }
+	},
+	'Golden hour': {
+		...lookAtHour(17.6),
+		light: { ...lookAtHour(17.6).light, sun: 1.35, ambient: 0.55 },
+		clouds: { cover: 0.45, color: [1, 0.72, 0.5] },
+		cloudLayer: { height: 24, cover: 0.35, opacity: 0.55, shadows: 0.35, color: [1, 0.8, 0.65] },
+		wind: { around: 80, strength: 0.2, gusts: 0.2 },
+		weather: { kind: 'rain', amount: 0 },
+		water: { shallow: [0.5, 0.6, 0.6], deep: [0.12, 0.2, 0.3], waves: { strength: 0.5 } }
+	},
+	'Blue night': {
+		...lookAtHour(0.5),
+		clouds: { cover: 0.2, color: [0.25, 0.28, 0.4] },
+		cloudLayer: { height: 22, cover: 0.2, opacity: 0.3, shadows: 0.2 },
+		wind: { around: 80, strength: 0.15, gusts: 0.2 },
+		weather: { kind: 'rain', amount: 0 },
+		water: { shallow: [0.12, 0.2, 0.32], deep: [0.02, 0.04, 0.1], waves: { strength: 0.4 } }
+	},
+	'Grey storm': {
+		sky: [0.24, 0.27, 0.32],
+		clouds: { cover: 0.95, speed: 2.5, color: [0.4, 0.42, 0.46] },
+		cloudLayer: { height: 14, cover: 0.85, opacity: 0.75, shadows: 0.6, scale: 18 },
+		light: {
+			sunUp: 35,
+			sunAround: 200,
+			sun: 0.45,
+			sunColor: [0.75, 0.82, 1],
+			ambient: 0.4,
+			ambientColor: [0.6, 0.66, 0.8],
+			ground: [0.15, 0.15, 0.17],
+			glow: false
+		},
+		wind: { around: 120, strength: 0.95, gusts: 0.9 },
+		weather: { kind: 'rain', amount: 1, splashes: 1, size: 1.2, speed: 1.3 },
+		fog: { start: 25, end: 95, color: [0.3, 0.33, 0.38] },
+		mist: { ground: { base: 0, top: 2.5, density: 0.4, color: [0.4, 0.43, 0.5] } },
+		lamps: { brightness: 0.8 },
+		water: { shallow: [0.25, 0.32, 0.34], deep: [0.06, 0.09, 0.12], waves: { strength: 1, length: 2.2, speed: 2 } }
+	},
+	'Winter morning': {
+		sky: [0.78, 0.82, 0.9],
+		clouds: { cover: 0.7, color: [0.95, 0.95, 0.98] },
+		cloudLayer: { height: 20, cover: 0.5, opacity: 0.45, shadows: 0.3 },
+		light: {
+			sunUp: 18,
+			sunAround: 120,
+			sun: 1,
+			sunColor: [1, 0.9, 0.8],
+			ambient: 0.75,
+			ambientColor: [0.85, 0.9, 1],
+			ground: [0.5, 0.52, 0.56],
+			glow: false
+		},
+		wind: { around: 60, strength: 0.25, gusts: 0.3 },
+		weather: { kind: 'snow', amount: 0.55, settle: 1 },
+		fog: { start: 40, end: 140, color: [0.86, 0.88, 0.92] },
+		mist: { ground: { base: 0, top: 2, density: 0.3, color: [0.92, 0.93, 0.96] } },
+		lamps: { brightness: 0.3 },
+		water: { shallow: [0.55, 0.68, 0.72], deep: [0.15, 0.25, 0.32], waves: { strength: 0.25 } }
+	},
+	'Autumn haze': {
+		sky: [0.85, 0.7, 0.52],
+		clouds: { cover: 0.5, color: [1, 0.85, 0.7] },
+		cloudLayer: { height: 24, cover: 0.3, opacity: 0.4, shadows: 0.25, color: [1, 0.9, 0.75] },
+		light: {
+			sunUp: 28,
+			sunAround: 230,
+			sun: 1.15,
+			sunColor: [1, 0.75, 0.48],
+			ambient: 0.5,
+			ambientColor: [0.95, 0.8, 0.65],
+			ground: [0.3, 0.22, 0.15],
+			glow: false
+		},
+		wind: { around: 220, strength: 0.35, gusts: 0.5 },
+		weather: { kind: 'rain', amount: 0 },
+		fog: { start: 25, end: 120, color: [0.85, 0.66, 0.46] },
+		mist: { ground: { base: 0, top: 3, density: 0.35, color: [0.9, 0.72, 0.52] } },
+		lamps: { brightness: 0.2 },
+		water: { shallow: [0.45, 0.48, 0.35], deep: [0.12, 0.15, 0.12], waves: { strength: 0.4 } }
+	},
+	'Eerie green': {
+		sky: [0.2, 0.3, 0.22],
+		clouds: { cover: 0.8, color: [0.45, 0.6, 0.45] },
+		cloudLayer: { height: 16, cover: 0.6, opacity: 0.6, shadows: 0.5, color: [0.6, 0.8, 0.6] },
+		light: {
+			sunUp: 30,
+			sunAround: 300,
+			sun: 0.7,
+			sunColor: [0.7, 1, 0.7],
+			ambient: 0.4,
+			ambientColor: [0.5, 0.8, 0.55],
+			ground: [0.1, 0.16, 0.1],
+			glow: false
+		},
+		wind: { around: 0, strength: 0.1, gusts: 0.6 },
+		weather: { kind: 'rain', amount: 0 },
+		fog: { start: 15, end: 90, color: [0.25, 0.38, 0.26] },
+		mist: { ground: { base: 0, top: 3.5, density: 0.6, color: [0.4, 0.6, 0.42] } },
+		lamps: { brightness: 1 },
+		water: { shallow: [0.22, 0.4, 0.2], deep: [0.04, 0.1, 0.05], waves: { strength: 0.2 } }
+	}
+}