StructureGen
Procedural geometry for the alpine huts and trail props: one builder per kind writes a `Geometry` per material key for a given variant and level of detail. `StructureBake` bakes its output, `StructureCatalog` registers it and `Cabin` lays it out using `SG.DIM`. Games do not call…
StructureGen
Procedural geometry for the alpine huts and trail props: one builder per kind writes a Geometry per material key for a given variant and level of detail. StructureBake bakes its output, StructureCatalog registers it and Cabin lays it out using SG.DIM. Games do not call it at runtime except through the catalog's fallback for an unbaked part.
local SG = require("alpineProps.StructureGen")
local geos = SG.build("logWallSection", 1, 0) -- { [materialKey] = Geometry }
local boxes = SG.colliders("lookout", 1)
- Material keys map to alpineMaterials surfaces through
SG.SURFACE: logWall, woodShingles, roughTimber, stoneWall, slateRoof, ironWrought, lichenGranite, deadwoodSilver, mountainLake,paint(roughTimber with vertex colours for trail paint) andsnow(snowLoad, only drawn with snow). SG.ORDERlists every kind;SG.KINDS[kind].entryits catalog entry.- Units are metres, +Y up; wall parts run along local X with the outside at +Z and the base at y = 0, sized on the 0.5 m grid in
SG.DIM.
Interface
What this asset declares: the schema it conforms to, what it exposes, and the rendered structured payload.
conforms to
zero/source-extract/v2StructureGen: procedural geometry for the alpine huts and trail props. A builder holds one Geometry per material key; every kind writes into it for one variant and one level of detail. StructureBake bakes the result, and StructureCatalog registers it with AlpineProps. local SG = require("~.StructureGen") local geos = SG.build("logWallSection", 1, 0) -- { [key] = Geometry } Material keys (SG.SURFACE maps each to an alpineMaterials surface): logWall woodShingles roughTimber stoneWall slateRoof ironWrought lichenGranite deadwoodSilver mountainLake paint (roughTimber lifted by vertex colours above 1: white / red trail paint, map inks) snow (snowLoad, drawn only when the prop shows snow) Units are metres, +Y up. Wall parts run along local X (-0.5..0.5 for a 1 m section), outside is +Z, base at y = 0. Sizes sit on the 0.5 m grid in SG.DIM.
new(lod: number, seed: number) → Builder
| arg | type | description |
|---|---|---|
| lod | number | |
| seed | number |
G(B: Builder, key: string) → any
| arg | type | description |
|---|---|---|
| B | Builder | |
| key | string |
R(B: Builder, a: number, b: number) → number
| arg | type | description |
|---|---|---|
| B | Builder | |
| a | number | |
| b | number |
vx(g: any, p: { number }, n: { number }, u: number, v: number, c: { number }) → number
| arg | type | description |
|---|---|---|
| g | any | |
| p | { number } | |
| n | { number } | |
| u | number | |
| v | number | |
| c | { number } |
madd(a: ?, b: ?, s: ?) → void
| arg | type | description |
|---|---|---|
| a | ? | |
| b | ? | |
| s | ? |
tint(B: Builder, base: number, spread: number, warm: number?) → void
| arg | type | description |
|---|---|---|
| B | Builder | |
| base | number | |
| spread | number | |
| warm | number? |
yawBasis(yaw: number) → void
Basis rotated about Y by yaw: returns ex, ey, ez.
| arg | type | description |
|---|---|---|
| yaw | number |
quad(B: Builder, key: string, p1: ?, p2: ?, p3: ?, p4: ?, n: ?, col: { number }?, ua: { number }?, va: { number }?, uo: number?) → void
A flat quad (p1..p4 around), normal n, metric UVs along (ua, va) axes.
| arg | type | description |
|---|---|---|
| B | Builder | |
| key | string | |
| p1 | ? | |
| p2 | ? | |
| p3 | ? | |
| p4 | ? | |
| n | ? | |
| col | { number }? | |
| ua | { number }? | |
| va | { number }? | |
| uo | number? |
uv(p: ?) → void
| arg | type | description |
|---|---|---|
| p | ? |
triangle(B: Builder, key: string, p1: ?, p2: ?, p3: ?, n: ?, col: { number }?) → void
| arg | type | description |
|---|---|---|
| B | Builder | |
| key | string | |
| p1 | ? | |
| p2 | ? | |
| p3 | ? | |
| n | ? | |
| col | { number }? |
box(B: Builder, key: string, c: ?, ex: ?, ey: ?, ez: ?, h: { number }, col: { number }?, grain: number?, skip: { [string]: boolean }?) → void
Oriented box: centre c, unit axes ex/ey/ez, half sizes h = {hx,hy,hz}. Wood grain runs along `grain` (1,2,3 = ex,ey,ez; default the longest). `skip` = set of faces to leave out ("+x","-x","+y","-y","+z","-z").
| arg | type | description |
|---|---|---|
| B | Builder | |
| key | string | |
| c | ? | |
| ex | ? | |
| ey | ? | |
| ez | ? | |
| h | { number } | |
| col | { number }? | |
| grain | number? | |
| skip | { [string]: boolean }? |
abox(B: Builder, key: string, x0: ?, y0: ?, z0: ?, x1: ?, y1: ?, z1: ?, col: { number }?, grain: number?, skip: any?) → void
Axis-aligned box from min to max corner.
| arg | type | description |
|---|---|---|
| B | Builder | |
| key | string | |
| x0 | ? | |
| y0 | ? | |
| z0 | ? | |
| x1 | ? | |
| y1 | ? | |
| z1 | ? | |
| col | { number }? | |
| grain | number? | |
| skip | any? |
beam(B: Builder, key: string, p0: ?, p1: ?, w: number, h: number, col: { number }?, up: { number }?, skip: any?) → void
Box between two points (a beam): square section w x h, `up` hint for its height axis.
| arg | type | description |
|---|---|---|
| B | Builder | |
| key | string | |
| p0 | ? | |
| p1 | ? | |
| w | number | |
| h | number | |
| col | { number }? | |
| up | { number }? | |
| skip | any? |
cyl(B: Builder, key: string, p0: ?, p1: ?, rx: number, ry: number, segs: number, col: { number }?, opts: any?) → void
Cylinder / log from p0 to p1, radii rx (side) and ry (up), `segs` around, `rings` along. opts: caps (0 none, 1 start, 2 end, 3 both), capCol, bulge(t, a) -> scale, flat (flatten factor), up.
| arg | type | description |
|---|---|---|
| B | Builder | |
| key | string | |
| p0 | ? | |
| p1 | ? | |
| rx | number | |
| ry | number | |
| segs | number | |
| col | { number }? | |
| opts | any? |
tube(B: Builder, key: string, pts: { { number } }, r: number, segs: number, col: { number }?, closed: boolean?) → void
A tube along a polyline (iron work): points, radius, segments around.
| arg | type | description |
|---|---|---|
| B | Builder | |
| key | string | |
| pts | { { number } } | |
| r | number | |
| segs | number | |
| col | { number }? | |
| closed | boolean? |
stone(B: Builder, key: string, c: ?, h: { number }, yaw: number, col: { number }?, rough: number?) → void
A rough stone: an irregular chamfered box with rounded normals. c centre, h half sizes, yaw.
| arg | type | description |
|---|---|---|
| B | Builder | |
| key | string | |
| c | ? | |
| h | { number } | |
| yaw | number | |
| col | { number }? | |
| rough | number? |
place(local3: ?) → void
| arg | type | description |
|---|---|---|
| local3 | ? |
C(ix: ?, iy: ?, iz: ?) → void
| arg | type | description |
|---|---|---|
| ix | ? | |
| iy | ? | |
| iz | ? |
cor(st: ?) → void
| arg | type | description |
|---|---|---|
| st | ? |
snowStrip(B: Builder, p0: ?, p1: ?, width: number, thick: number, up: { number }?) → void
A soft snow strip lying on a top surface: from p0 to p1 (centre line on the surface), width, thickness.
| arg | type | description |
|---|---|---|
| B | Builder | |
| p0 | ? | |
| p1 | ? | |
| width | number | |
| thick | number | |
| up | { number }? |
snowSheet(B: Builder, o: ?, a: ?, b: ?, la: number, lb: number, thick: number) → void
Snow lying on a sloped plane: origin o (eave-side corner), a (along the eave), b (up the slope), n (normal).
| arg | type | description |
|---|---|---|
| B | Builder | |
| o | ? | |
| a | ? | |
| b | ? | |
| la | number | |
| lb | number | |
| thick | number |
textWidth(text: string) → number
Width (em) of a string laid out in SG.FONT, or nil without the font module.
| arg | type | description |
|---|---|---|
| text | string |
text(B: Builder, key: string, text: string, origin: ?, ex: ?, ey: ?, size: number, col: { number }?) → number
Flat letters on a face: origin (left baseline), ex (reading direction), ey (up), size (em height in metres). Returns the width laid out.
| arg | type | description |
|---|---|---|
| B | Builder | |
| key | string | |
| text | string | |
| origin | ? | |
| ex | ? | |
| ey | ? | |
| size | number | |
| col | { number }? |
textGeometry(text: string, origin: ?, ex: ?, ey: ?, size: number, col: { number }?) → any
Raw text geometry in a frame (for runtime meshes): { positions, normals, uvs, colors, indices }.
| arg | type | description |
|---|---|---|
| text | string | |
| origin | ? | |
| ex | ? | |
| ey | ? | |
| size | number | |
| col | { number }? |
place(B: Builder, src: Builder, yaw: number, offset: { number }) → void
Copy every geometry of `src` into B, turned by yaw about +Y and moved by offset.
| arg | type | description |
|---|---|---|
| B | Builder | |
| src | Builder | |
| yaw | number | |
| offset | { number } |
prism(B: Builder, key: string, origin: ?, a: ?, b: ?, pts2: { { number } }, depth: number, col: { number }?) → void
An extruded flat polygon (convex): pts2 in the (a, b) plane at origin, extruded +-depth/2 along n.
| arg | type | description |
|---|---|---|
| B | Builder | |
| key | string | |
| origin | ? | |
| a | ? | |
| b | ? | |
| pts2 | { { number } } | |
| depth | number | |
| col | { number }? |
P(p: ?, s: ?) → void
| arg | type | description |
|---|---|---|
| p | ? | |
| s | ? |
segsFor(B: Builder, l0: number, l1: number) → number
| arg | type | description |
|---|---|---|
| B | Builder | |
| l0 | number | |
| l1 | number |
courseYs(v: number) → void
log course heights: variant 1 ("A", gable walls) and 2 ("B", side walls, half a course up)
| arg | type | description |
|---|---|---|
| v | number |
logRadius(y: number) → void
| arg | type | description |
|---|---|---|
| y | number |
wallLog(B: Builder, y: number, x0: number, x1: number, z: number, caps: number, alongZ: boolean?) → void
One log of a wall course from x0 to x1 (world x), centre line at (y, z).
| arg | type | description |
|---|---|---|
| B | Builder | |
| y | number | |
| x0 | number | |
| x1 | number | |
| z | number | |
| caps | number | |
| alongZ | boolean? |
bulge(t: ?, a: ?) → void
| arg | type | description |
|---|---|---|
| t | ? | |
| a | ? |
core(B: Builder, key: string, t: number, hole: { number }?, col: { number }, h: number?) → void
the wall core: a slab between the faces, cut around a hole {x0,y0,x1,y1}
| arg | type | description |
|---|---|---|
| B | Builder | |
| key | string | |
| t | number | |
| hole | { number }? | |
| col | { number } | |
| h | number? |
windowFrame(B: Builder, t: number, zf: number, shutters: boolean, w: any?, mullion: boolean?) → void
frame, glass, mullions, sill and opened shutters for a window in a wall of half-thickness t (face at zf)
| arg | type | description |
|---|---|---|
| B | Builder | |
| t | number | |
| zf | number | |
| shutters | boolean | |
| w | any? | |
| mullion | boolean? |
doorLeaf(B: Builder, t: number, zf: number, steps: boolean) → void
a closed plank door with strap hinges and a ring handle, plus stone steps outside
| arg | type | description |
|---|---|---|
| B | Builder | |
| t | number | |
| zf | number | |
| steps | boolean |
wallTypeOf(v: number) → string
| arg | type | description |
|---|---|---|
| v | number |
logWall(B: Builder, v: number, hole: { number }?) → void
the plain wall of each type, around an optional hole
| arg | type | description |
|---|---|---|
| B | Builder | |
| v | number | |
| hole | { number }? |
stoneWallBody(B: Builder, hole: { number }?, lintel: boolean) → void
| arg | type | description |
|---|---|---|
| B | Builder | |
| hole | { number }? | |
| lintel | boolean |
timberWallBody(B: Builder, hole: { number }?) → void
| arg | type | description |
|---|---|---|
| B | Builder | |
| hole | { number }? |
board(a: ?, b: ?, y0: ?, y1: ?) → void
| arg | type | description |
|---|---|---|
| a | ? | |
| b | ? | |
| y0 | ? | |
| y1 | ? |
batten(y0: ?, y1: ?) → void
| arg | type | description |
|---|---|---|
| y0 | ? | |
| y1 | ? |
logWallSection(B: Builder, v: number) → void
| arg | type | description |
|---|---|---|
| B | Builder | |
| v | number |
timberWallSection(B: Builder, _v: number) → void
| arg | type | description |
|---|---|---|
| B | Builder | |
| _v | number |
stoneWallSection(B: Builder, v: number) → void
| arg | type | description |
|---|---|---|
| B | Builder | |
| v | number |
logCorner(B: Builder, v: number) → void
| arg | type | description |
|---|---|---|
| B | Builder | |
| v | number |
eaveOut(y: number) → number
| arg | type | description |
|---|---|---|
| y | number |
wallWindow(B: Builder, v: number) → void
| arg | type | description |
|---|---|---|
| B | Builder | |
| v | number |
wallDoor(B: Builder, v: number) → void
| arg | type | description |
|---|---|---|
| B | Builder | |
| v | number |
gableHW(y: number, drop: number, inset: number) → number
gable half-width at height y above the wall top (under the roof by `inset`)
| arg | type | description |
|---|---|---|
| y | number | |
| drop | number | |
| inset | number |
gableLog(B: Builder, _v: number) → void
| arg | type | description |
|---|---|---|
| B | Builder | |
| _v | number |
gableStone(B: Builder, _v: number) → void
| arg | type | description |
|---|---|---|
| B | Builder | |
| _v | number |
gableTimber(B: Builder, v: number) → void
A-frame gables: v1 front (slot for a 1 m door section at the centre, window above), v2 back (window).
| arg | type | description |
|---|---|---|
| B | Builder | |
| v | number |
hwAt(y: ?) → void
| arg | type | description |
|---|---|---|
| y | ? |
boardY(xx: ?) → void
| arg | type | description |
|---|---|---|
| xx | ? |
piece(y0: number, y1a: number?, y1b: number?) → void
| arg | type | description |
|---|---|---|
| y0 | number | |
| y1a | number? | |
| y1b | number? |
roofSlope(B: Builder, o: any) → void
One roof slope. Ridge along z at x = 0; the slope falls toward +x down to the eave.
| arg | type | description |
|---|---|---|
| B | Builder | |
| o | any |
at(t: number, off: number, z: number) → void
| arg | type | description |
|---|---|---|
| t | number | |
| off | number | |
| z | number |
roofShingle(B: Builder, _v: number) → void
| arg | type | description |
|---|---|---|
| B | Builder | |
| _v | number |
roofSlate(B: Builder, _v: number) → void
| arg | type | description |
|---|---|---|
| B | Builder | |
| _v | number |
aFrameRoof(B: Builder, _v: number) → void
| arg | type | description |
|---|---|---|
| B | Builder | |
| _v | number |
chimneyStone(B: Builder, v: number) → void
| arg | type | description |
|---|---|---|
| B | Builder | |
| v | number |
stoneFoundation(B: Builder, _v: number) → void
| arg | type | description |
|---|---|---|
| B | Builder | |
| _v | number |
porchDeck(B: Builder, v: number) → void
deck boards along x over a frame; z from 0 out to `depth`
| arg | type | description |
|---|---|---|
| B | Builder | |
| v | number |
rail(p0: ?, p1: ?, posts: { { number } }) → void
railings
| arg | type | description |
|---|---|---|
| p0 | ? | |
| p1 | ? | |
| posts | { { number } } |
bench(B: Builder, _v: number) → void
| arg | type | description |
|---|---|---|
| B | Builder | |
| _v | number |
bulge(t: ?, a: ?) → void
| arg | type | description |
|---|---|---|
| t | ? | |
| a | ? |
woodpile(B: Builder, _v: number) → void
| arg | type | description |
|---|---|---|
| B | Builder | |
| _v | number |
bulge(_t: ?, a: ?) → void
| arg | type | description |
|---|---|---|
| _t | ? | |
| a | ? |
waterTrough(B: Builder, _v: number) → void
| arg | type | description |
|---|---|---|
| B | Builder | |
| _v | number |
bulge(_t: ?, a: ?) → void
| arg | type | description |
|---|---|---|
| _t | ? | |
| a | ? |
flatPoly(B: Builder, key: string, pts: { { number } }, z: number, col: { number }, back: boolean?) → void
flat convex polygon on a face at depth z (normal +Z), points in (x, y)
| arg | type | description |
|---|---|---|
| B | Builder | |
| key | string | |
| pts | { { number } } | |
| z | number | |
| col | { number } | |
| back | boolean? |
ellipse(cx: number, cy: number, rx: number, ry: number, nseg: number, wob: number?, seed: number?) → void
| arg | type | description |
|---|---|---|
| cx | number | |
| cy | number | |
| rx | number | |
| ry | number | |
| nseg | number | |
| wob | number? | |
| seed | number? |
signArm(B: Builder, text: string?) → void
one direction arm pointing along +x from a post at the origin, centred on y = 0; text on both faces
| arg | type | description |
|---|---|---|
| B | Builder | |
| text | string? |
armText(B: Builder, key: string, text: string) → void
Dark lettering for a direction arm pointing +x (both faces, each reading left to right), fitted to the board.
| arg | type | description |
|---|---|---|
| B | Builder | |
| key | string | |
| text | string |
post(B: Builder, key: string, half: number, y0: number, y1: number, col: { number }) → void
| arg | type | description |
|---|---|---|
| B | Builder | |
| key | string | |
| half | number | |
| y0 | number | |
| y1 | number | |
| col | { number } |
baseStones(B: Builder, n: number, r: number) → void
| arg | type | description |
|---|---|---|
| B | Builder | |
| n | number | |
| r | number |
signpost(B: Builder, v: number) → void
| arg | type | description |
|---|---|---|
| B | Builder | |
| v | number |
signArm(B: Builder, _v: number) → void
| arg | type | description |
|---|---|---|
| B | Builder | |
| _v | number |
waymarkPost(B: Builder, _v: number) → void
| arg | type | description |
|---|---|---|
| B | Builder | |
| _v | number |
stoneBlock(B: Builder, hx: number, hz: number, y0: number, y1: number, cap: boolean) → void
a rectangular dry-stone block (piers, plinths): faces on all four sides, flat cap stones
| arg | type | description |
|---|---|---|
| B | Builder | |
| hx | number | |
| hz | number | |
| y0 | number | |
| y1 | number | |
| cap | boolean |
footbridge(B: Builder, _v: number) → void
| arg | type | description |
|---|---|---|
| B | Builder | |
| _v | number |
summitCross(B: Builder, _v: number) → void
| arg | type | description |
|---|---|---|
| B | Builder | |
| _v | number |
scroll(cx: number, cy: number, dirx: number, diry: number, side: number) → void
curled trefoil ends: a pair of scrolls at each of the three ends
| arg | type | description |
|---|---|---|
| cx | number | |
| cy | number | |
| dirx | number | |
| diry | number | |
| side | number |
lookout(B: Builder, _v: number) → void
| arg | type | description |
|---|---|---|
| B | Builder | |
| _v | number |
railRun(p0: ?, p1: ?) → void
railings, open on +x where the stair arrives
| arg | type | description |
|---|---|---|
| p0 | ? | |
| p1 | ? |
trailSteps(B: Builder, _v: number) → void
| arg | type | description |
|---|---|---|
| B | Builder | |
| _v | number |
fenceRail(B: Builder, v: number) → void
| arg | type | description |
|---|---|---|
| B | Builder | |
| v | number |
bulge(_t: ?, a: ?) → void
| arg | type | description |
|---|---|---|
| _t | ? | |
| a | ? |
bulge(t: ?, a: ?) → void
| arg | type | description |
|---|---|---|
| t | ? | |
| a | ? |
infoBoard(B: Builder, _v: number) → void
| arg | type | description |
|---|---|---|
| B | Builder | |
| _v | number |
boxC(sx: ?, sy: ?, sz: ?, ox: ?, oy: ?, oz: ?, extra: any?) → any
| arg | type | description |
|---|---|---|
| sx | ? | |
| sy | ? | |
| sz | ? | |
| ox | ? | |
| oy | ? | |
| oz | ? | |
| extra | any? |
roofColliders(pitch: number, ref: number, eave: number, L: number) → void
| arg | type | description |
|---|---|---|
| pitch | number | |
| ref | number | |
| eave | number | |
| L | number |
wallCols( ) → void
lookoutColliders( ) → void
stepsColliders( ) → void
bridgeColliders( ) → void
def(build: any, variants: number, entry: any) → any
| arg | type | description |
|---|---|---|
| build | any | |
| variants | number | |
| entry | any |
colliders(kind: string, variant: number?) → void
Every collider box of a kind's variant: { { shape='box', size, offset, tilt? } } (tilt: radians about local Z).
| arg | type | description |
|---|---|---|
| kind | string | |
| variant | number? |
build(kind: string, variant: number, lod: number) → void
Build one kind's geometry for a variant (1..n) and LOD (0..2): { [materialKey] = Geometry }.
| arg | type | description |
|---|---|---|
| kind | string | |
| variant | number | |
| lod | number |
Builder = { geos: { [string]: any }, lod: number, rng: any }Sub-parts
Everything contained inside this part. Assets are composite children (clickable cards). Files are leaf payloads. Expand any row to view its source.
Problems
Everything affecting this asset right now: its own problems, anything wrong inside it, and problems on its direct dependencies.
agent_score is exposed.+ quality × 0.35
+ performance × 0.25
± compat factor
Usability ratings
Did the part work as advertised when consumers tried to drop it in. Separate from upvotes: those are taste; this is "did it function".
Scoped to this part · feeds back into the world's score.