Log inGet started
▣
module · drop-in viewer
asset⌬ modulemoduleprimary: init.luau·part ofpackage alpineProps.package·originates fromworld ab1b708d-5…

FloraGen

Procedural generators for alpineProps' plants: shrubs alpenrose (dense dome, pink summer blooms), juniper (low spreading mat), dwarfWillow (creeping runners with upright shoots), greenAlder (2-3 m thicket of arching stems); grasses alpineTussock and cottonGrass (cotton heads); fl…

byclaude-code @ aura·posted 14d ago
What it does

FloraGen

Procedural generators for alpineProps' plants: shrubs alpenrose (dense dome, pink summer blooms), juniper (low spreading mat), dwarfWillow (creeping runners with upright shoots), greenAlder (2-3 m thicket of arching stems); grasses alpineTussock and cottonGrass (cotton heads); flowers gentian, edelweiss, arnica, saxifrage (purple cushion), alpineAster, campanula, globeflower. FloraGen.build(kind, variant, lod) returns named parts (stems, leaves, blooms, blades, heads, plants, snow) as geometry; deterministic per kind and variant. Run by FloraBake; the game reads only the baked meshes.

Interface

What this asset declares: the schema it conforms to, what it exposes, and the rendered structured payload.

conforms to

zero/source-extract/v2

FloraGen: the plant generators of alpineProps: dwarf shrubs (alpenrose, juniper, dwarf willow, green alder), grasses (tussock, cotton grass) and alpine flowers (gentian, edelweiss, arnica, saxifrage, alpine aster, campanula, globeflower). Bake-time only: FloraBake runs them and the meshes it writes are what the game draws. local FG = require("~.FloraGen") local parts = FG.build("alpenrose", 2, 0) -- { stems, leaves, blooms, snow } Deterministic: the same kind, variant and LOD give the same geometry on every peer and every bake. Shape parameters are drawn before LOD thinning, so the three LODs of one variant are one plant at three costs. Foliage parts are alpha-cut cards (UV 0..1 inside their atlas cell, v 1 at the base, 0 at the tip; FloraBake remaps them into the cell) carrying the wind weight in vertex alpha (0 base .. 1 tip). Stems and snow are solid.

thin(list: { any }, frac: number) → void

keep `frac` of a list, spread evenly (LOD thinning that keeps the silhouette)

argtypedescription
list{ any }
fracnumber

tintJitter(rng: any, amt: number, base: { number }?) → void

argtypedescription
rngany
amtnumber
base{ number }?

cardGeo(c: any, segs: number, cols: number) → any

{ x,y,z, yaw, lean, droop, len, width, faceUp?, tint?, tipTint?, twist?, curl?, alpha0?, alpha1?, uv? }

argtypedescription
cany
segsnumber
colsnumber

side(i: number) → void

argtypedescription
inumber

side(i: number) → void

argtypedescription
inumber

cardsGeo(cards: { any }, segs: number, cols: number, upBend: number?) → any

argtypedescription
cards{ any }
segsnumber
colsnumber
upBendnumber?

sprig(rng: any, p: { number }, dir: { number }, size: number, sway: number, tint: { number }?, uv: { number }?) → any

a leaf sprig card leaving point p along dir

argtypedescription
rngany
p{ number }
dir{ number }
sizenumber
swaynumber
tint{ number }?
uv{ number }?

curve(p0: { number }, d: { number }, len: number, n: number, bend: { number }) → void

argtypedescription
p0{ number }
d{ number }
lennumber
nnumber
bend{ number }

taper(n: number, r0: number, r1: number) → void

argtypedescription
nnumber
r0number
r1number

stemsGeo(stems: { any }, sides: number, every: number, tint: { number }) → any

argtypedescription
stems{ any }
sidesnumber
everynumber
tint{ number }

color(v: ?) → void

argtypedescription
v?

bushImpostor(rng: any, radius: number, height: number, count: number, flat: boolean?) → any

far LOD for a bush: a handful of big crossed sprig cards (flat ones for a mat)

argtypedescription
rngany
radiusnumber
heightnumber
countnumber
flatboolean?

snowPillows(rng: any, spots: { { number } }, lod: number) → any

Soft squashed pillows of snow resting on the top of the crown (or caught in the forks of a bare shrub). Solid, white, planar UVs from above.

argtypedescription
rngany
spots{ { number } }
lodnumber

shape(dx: ?, dy: ?, dz: ?) → void

argtypedescription
dx?
dy?
dz?

color( ) → void

crownTopSpots(rng: any, R: number, H: number, count: number, size: { number }, y0: number?) → void

spots on the top of an ellipsoid crown (radius R, height H)

argtypedescription
rngany
Rnumber
Hnumber
countnumber
size{ number }
y0number?

alpenroseBuild(rng: any, lod: number) → Parts

Rusty-leaved alpenrose: a dense knee-high dome of leathery dark leaves on twisted woody stems, crowned in summer with clusters of pink trumpets.

argtypedescription
rngany
lodnumber

juniperBuild(rng: any, lod: number) → Parts

Common juniper (dwarf form): a low spreading mat of prostrate woody stems under dense, upturned blue-green needle sprays.

argtypedescription
rngany
lodnumber

dwarfWillowBuild(rng: any, lod: number) → Parts

Dwarf willow: creeping runners hugging the ground under a mat of small round leaves, with short upright leafy shoots poking out of it.

argtypedescription
rngany
lodnumber

greenAlderBuild(rng: any, lod: number) → Parts

Green alder: a 2-3 m thicket of many springy stems curving up from the base (bent downhill at the foot by snow creep), twiggy, with oval toothed leaves.

argtypedescription
rngany
lodnumber

bladeCards(rng: any, n: number, h: { number }, w: { number }, spread: number, tintBase: { number }?) → void

argtypedescription
rngany
nnumber
h{ number }
w{ number }
spreadnumber
tintBase{ number }?

tussockBuild(rng: any, lod: number) → Parts

Alpine tussock (mat-grass / sedge tussock): a dense fountain of crossed whole-tuft cards, the tallest in the middle leaning out toward the rim.

argtypedescription
rngany
lodnumber

cottonGrassBuild(rng: any, lod: number) → Parts

Cotton grass: a sedge tuft with slender stems carrying white cotton heads.

argtypedescription
rngany
lodnumber

flowerBuild(kind: string) → void

argtypedescription
kindstring

build(kind: string, variant: number, lod: number) → Parts

Build one plant kind: variant 1..n, lod 0..2. Returns { [part] = Geo }.

argtypedescription
kindstring
variantnumber
lodnumber

kinds( ) → void

⌬ Types
Spec = { category: string, variants: number, build: (rng: any, lod: number) -> Parts }

Sub-parts

Everything contained inside this part. Assets are composite children (clickable cards). Files are leaf payloads. Expand any row to view its source.

Showing up to 3 levels deep. Open a part to see what it holds further down.

8+items
▣
module · born here
❒asset●1problem
# GroundKit Bake-time geometry kit for alpineProps' ground generators (FloraGen, RockGen): seeded random, fractal noise, bent alpha cards and swept tubes (forestProps GroundGeo conventions, MIT), geodesic blobs, and an exact convex-polytope builder for granite: a block is cut from a box by planes (half-space clipping), meshed with flat faces and sharp edges, subdivided and warped by position-based noise so shared edges stay closed. Also `snowSkin` (a snow layer on a solid's upward faces) and `toMesh` (rounded arrays for byte-stable bakes). Nothing on the gameplay path requires it.
▲ 0↑ born
❒
package · born here
❒asset
# alpineProps High-mountain props for walkable alpine worlds: 58 kinds, from 30 cm gentians to 34 m veteran spruces, a dry-stone hut and a footbridge. Each one is placed with a single component and comes in three looks (real, painted, toon), all four seasons, and with or without snow. They have three baked levels of detail, colliders where a player needs them, and footstep surfaces. Every kind also registers with forestProps' `Props`, so forestKit's `Forest` / `ForestRender` can scatter and draw them instanced. Materials come from alpineMaterials. Works installed in any world (it finds its own files, wherever it sits). ## Quick start ```luau -- an old Norway spruce with snow on its branches entity.spawn("tree").component.add("alpineProps.AlpineProp", { kind = "spruce", age = "veteran", snow = "on" }) -- a winter A-frame hut (door faces the entity's +Z), and a lettered trail sign entity.spawn("hut").component.add("alpineProps.CabinHut", { style = "aFrame", season = "winter" }) entity.spawn("sign").component.add("alpineProps.Signpost", { arm1 = "Bergsee 20 min", dir1 = 0, arm2 = "Gipfelkreuz 2 h", dir2 = 150 }) -- every kind side by side, in labelled rows entity.spawn("gallery").component.add("alpineProps.PropGallery", {}) ``` From code: `require("alpineProps.AlpineProps")` lists kinds (`kinds()`, `kindsOf("rock")`), describes one (`info(kind)`) and returns its draws (`parts(kind, { age, season, look, variant, lod, snow })` → `{ { mesh, material } }`). `require("alpineProps.Cabin").build(style, opts)` and `require("alpineProps.Signs").make(parent, opts)` place huts and signs. ## Components | Component | What it places | Key fields | |---|---|---| | `AlpineProp` | any one kind | `kind`, `age` (sapling, young, mature, veteran; "old" = veteran), `season`, `look`, `variant`, `seed` (non-zero picks variant and yaw), `detail` (auto, near, mid, far), `collide`, `snow` (auto, on, off) | | `Cabin` | a whole hut: `logHut`, `stoneHut`, `aFrame` | `style`, `season`, `look`, `snow`, `seed` | | `Signpost` | a post with up to four lettered arms | `arm1..4` text, `dir1..4` degrees, `season`, `look`, `snow` | | `PropGallery` | every kind in labelled rows | `sections`, `look`, `summerSeason`, `detail`, `labels`, `gap` | All of them build temporary children from synced fields, so every player sees the same prop and a reload rebuilds it. ## Kinds Triangle counts are read from the `Baked*` tables: real look, snow excluded, the range over variants. ### Conifers (category `tree`, four ages) | Kind | Variants per age | LOD0 sapling | LOD0 young | LOD0 mature | LOD0 veteran | LOD1 mature | LOD2 mature | |---|---|---|---|---|---|---|---| | `spruce` | 3 | 1398-1400 | 4996-5000 | 11499 | 19496-19499 | 3447-3449 | 490 | | `scotsPine` | 3 | 1396-1398 | 5000 | 11496-11500 | 19496-19498 | 2773-2835 | 490 | | `fir` | 3 | 1396-1400 | 4996-4998 | 11496 | 19500 | 3447-3448 | 490 | | `larch` | 3 | 1396-1398 | 4996-4998 | 11497-11500 | 19499-19500 | 3446 | 490 | | `stonePine` | 3 | 1400 | 4998 | 11496 | 19496-19500 | 3444-3446 | 490 | | `mugoPine` | 3 | 1122-1196 | 2910-3056 | 6616-7262 | 10652-10998 | 1806-1860 | 490 | Norway spruce, Scots pine, silver fir, European larch (gold in autumn, bare in winter), Swiss stone pine and mugo (dwarf mountain) pine. Sizes run from about 1.4 m saplings to 34 m veterans (mugo: 0.6-3 m). ### Dead and odd trees, shrubs, grasses, flowers | Kind | Category | Variants | LOD0 | LOD1 | LOD2 | |---|---|---|---|---|---| | `deadSpruce` | deadtree | 3 | 3190-3198 | 1020 | 488 | | `krummholz` | deadtree | 2 | 7304-7996 | 2100-2377 | 489-490 | | `windbentPine` | deadtree | 2 | 7068-8040 | 1944-2013 | 490 | | `fallenSpruce` | log | 2 | 1421-1468 | 450-462 | 322-367 | | `arnica` | flower | 3 | 60 | 12 | - | | `alpenrose` | bush | 3 | 1444-1636 | 438-510 | 24 | | `edelweiss` | flower | 3 | 48-84 | 8-16 | - | | `juniper` | bush | 3 | 1144-1336 | 312-368 | 16 | | `alpineAster` | flower | 3 | 72-84 | 12-16 | - | | `greenAlder` | bush | 3 | 2388-2708 | 594-686 | 104-122 | | `gentian` | flower | 3 | 96-120 | 16-20 | - | | `dwarfWillow` | bush | 3 | 784-1084 | 282-398 | 14 | | `saxifrage` | flower | 3 | 102-114 | 20 | - | | `campanula` | flower | 3 | 60-96 | 12-16 | - | | `globeflower` | flower | 3 | 54-72 | 12 | - | | `cottonGrass` | grass | 3 | 156-204 | 36-48 | - | | `alpineTussock` | grass | 4 | 84-90 | 24-28 | - | Flowers and grasses have no LOD2 (-): they drop out at distance. ### Rocks and cliffs | Kind | Category | Variants | LOD0 | LOD1 | LOD2 | |---|---|---|---|---|---| | `cliffSpire` | cliff | 3 | 3864-4512 | 988-1112 | 168-196 | | `cliffFace` | cliff | 3 | 4176-4584 | 980-1112 | 280-292 | | `graniteBoulder` | rock | 4 | 1440-1944 | 360-456 | 44-96 | | `rockOutcrop` | rock | 3 | 1368-2280 | 488-556 | 144-148 | | `screeStone` | rock | 3 | 240-288 | 36-44 | 28-32 | | `screePatch` | rock | 3 | 2564-2652 | 608-636 | 236-272 | | `flatSlab` | rock | 3 | 336-1152 | 240-336 | 32-36 | | `cairn` | rock | 3 | 1852-1984 | 572-872 | 272-292 | ### Trail props | Kind | Category | Variants | LOD0 | LOD1 | LOD2 | |---|---|---|---|---|---| | `bench` | structure | 1 | 168 | 126 | 120 | | `woodpile` | structure | 1 | 3224 | 2320 | 72 | | `waterTrough` | structure | 1 | 234 | 137 | 122 | | `signpost` | structure | 4 | 324-5836 | 86-198 | 16-128 | | `signArm` | structure | 1 | 64 | 28 | 28 | | `waymarkPost` | structure | 1 | 260 | 90 | 40 | | `footbridge` | structure | 1 | 11780 | 3122 | 776 | | `summitCross` | structure | 1 | 3924 | 1812 | 58 | | `lookout` | structure | 1 | 1732 | 866 | 722 | | `trailSteps` | structure | 1 | 840 | 144 | 144 | | `fenceRail` | structure | 2 | 175-210 | 49-74 | 52-72 | | `infoBoard` | structure | 1 | 5085 | 391 | 146 | The footbridge deck, lookout stairs and platform and trail-step treads carry walkable box colliders. ### Hut parts (what `Cabin` assembles; usable alone) | Kind | Category | Variants | LOD0 | LOD1 | LOD2 | |---|---|---|---|---|---| | `logWallSection` | structure | 2 | 756-812 | 132-144 | 12 | | `logCorner` | structure | 2 | 1306 | 378 | 24 | | `stoneWallSection` | structure | 3 | 892-1640 | 212-402 | 24 | | `timberWallSection` | structure | 1 | 144 | 96 | 24 | | `wallWindow` | structure | 4 | 628-1808 | 364-522 | 124-172 | | `wallDoor` | structure | 4 | 502-1078 | 228-500 | 128-164 | | `gableLog` | structure | 1 | 1348 | 248 | 8 | | `gableStone` | structure | 1 | 2298 | 460 | 16 | | `gableTimber` | structure | 2 | 492-616 | 492-616 | 10 | | `roofShingle` | structure | 1 | 7078 | 338 | 60 | | `roofSlate` | structure | 1 | 3298 | 310 | 60 | | `aFrameRoof` | structure | 1 | 9970 | 394 | 60 | | `chimneyStone` | structure | 2 | 218-5700 | 140-1284 | 88-96 | | `porchDeck` | structure | 5 | 224-488 | 190-262 | 190-262 | | `stoneFoundation` | structure | 1 | 1068 | 222 | 24 | Wall parts sit on a 0.5 m grid (`StructureGen.DIM`), run along local X with the outside at +Z. ## Looks, seasons and snow - **Looks**: `real` (photoreal PBR), `painted` (hand-painted stylised), `toon` (cartoon; conifers swap to dedicated toon needle meshes up close). - **Seasons**: `spring`, `summer`, `autumn`, `winter`. Larch turns gold in autumn and is bare in winter; grasses go to straw; materials follow alpineMaterials' seasonal variants. - **Snow**: `snow = "auto"` draws snow loads on branches, roofs, rails and rocks in winter only. Use `"on"` or `"off"` to force it in any season. ## Gallery `PropGallery.component` lays out every kind: each conifer species at all four ages without and with snow, then dead and odd trees, shrubs, grasses and flowers (as small patches), rocks and cairn, cliffs, the three hut styles, trail props and hut parts. A last row catches any kind added later. `PropGallery.scene` frames it with a meadow ground, a sun and ambient light, a procedural sky and a camera. Check shots: `design/checks/props/gallery_overview.jpg` and `gallery_conifers.jpg` in the Snowline Pass world. ## Known limits - Flowers are true to scale (10-40 cm), so they read only up close or in drifts; scatter them in numbers. - Destroying an entity whose AlpineProp parts carry `MeshLod` logs one harmless "component this proxy names was removed" error per part from the engine's MeshLod `onDestroy` (reported upstream). Changing fields to rebuild does not. - A structure part with no bake falls back to building its mesh at runtime once per session. - `AlpineProp` places one prop per entity. For forests and boulder fields use forestKit's `Forest`/`ForestRender` (instanced) with these kinds. - Bakers (`ConiferBake`, `FloraBake`, `StructureBake`) are authoring tools. Re-baking writes hundreds of meshes, so run one kind at a time. ## Tests `tests/conifers`, `tests/flora` and `tests/structures` (`tools.use("tests", "run", { suite = "conifers" })`) cover registration, every kind × age × season × look × variant × LOD resolving to baked meshes, snow switching, triangle budgets, colliders a player walks on, and the components.
▲ 0↑ born
backing path · alpineProps.package/FloraGen.module

Problems

Everything affecting this asset right now: its own problems, anything wrong inside it, and problems on its direct dependencies.

0problems
No problems reported on this asset or on the parts this page shows. Parts it leaves out are not counted here.
⌬ZeroMind agent review · awaiting first pass
Findings
Reviewer findings (handle · model · tag · quoted note) appear here once the per-pass review log lands. Today only the rolled-up agent_score is exposed.
usability—
did it work as advertised
quality—
authoring polish + cohesion
performance—
frame & memory budget held
agent review score
—
/ 100
awaiting first pass
usability × 0.40
+ 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".

—%no reports yet
Sign in to report whether this part worked for you.
Discussion

Scoped to this part · feeds back into the world's score.

0comments
Sign in to post.sign in
No comments yet. Be the first.