ForestMaterialsBuild
Authoring-time builder for the forestMaterials package. `writeMaterials()` writes every own material (real tiles on `pbr`, real cards on `forestFoliage` per season, painted and toon versions of every surface on `forestStylised`) from the tables `TILES`, `CARDS` and `STYLE_SOURCE`…
ForestMaterialsBuild
Authoring-time builder for the forestMaterials package. writeMaterials() writes every own material (real tiles on pbr, real cards on forestFoliage per season, painted and toon versions of every surface on forestStylised) from the tables TILES, CARDS and STYLE_SOURCE; writeTable() regenerates ForestMaterialsTable with one string-literal resolve per material that exists (run it after adding or removing materials); writeCollection() writes forest.materialCollection; textureMemory() totals the package's GPU texture memory. All re-runnable: unchanged files are not rewritten.
Interface
What this asset declares: the schema it conforms to, what it exposes, and the rendered structured payload.
conforms to
zero/source-extract/v2strict
findPackageDir( ) → string
Where this package's files stand: the world's root when it is authored or installed there, else the dependency or library folder an install put it in.
num(v: number) → string
| arg | type | description |
|---|---|---|
| v | number |
col(c: { number }) → string
| arg | type | description |
|---|---|---|
| c | { number } |
sourcePng(name: string) → string
| arg | type | description |
|---|---|---|
| name | string |
saveTexture(name: string, png: string, kind: string, size: number, wrap: string) → void
| arg | type | description |
|---|---|---|
| name | string | |
| png | string | |
| kind | string | |
| size | number | |
| wrap | string |
hasTex(name: string) → boolean
| arg | type | description |
|---|---|---|
| name | string |
writeAtlases(only: string?) →
Compose ferns, shrubs, wildflowers and fungi atlas textures (albedo per season, normal, and ORM for fungi) from the member cards and tiles in textures/, at 512 px a cell. Re-runnable.
| arg | type | description |
|---|---|---|
| only | string? | Optional atlas name to compose just that one. |
writeMat(name: string, shader: string, props: { [string]: string }, textures: { [string]: string }, cull: string, description: string, tags: { string }) → void
| arg | type | description |
|---|---|---|
| name | string | |
| shader | string | |
| props | { [string]: string } | |
| textures | { [string]: string } | |
| cull | string | |
| description | string | |
| tags | { string } |
writeMaterials( ) → number
Write the 13 base materials (summer, real look). Tiles on forestSolid (opaque PBR, clear coat), cards on forestFoliage (alpha-cut, two-sided, translucent, wind sway by vertex alpha). Re-runnable: unchanged files are not rewritten.
exists(ref: string, kind: string) → boolean
| arg | type | description |
|---|---|---|
| ref | string | |
| kind | string |
writeTable( ) →
Regenerate ForestMaterialsTable: one literal resolve per base material, collection material, texture and shader ForestMaterials can answer with or build from. Names that do not exist in this world are reported, not written.
tidy(dryRun: boolean?) →
Delete material and texture assets in this package that nothing uses any more (materials not in FM.BASE; textures not named by a base material, a runtime season, or an atlas source still needed). Pass `dryRun = true` to list them.
| arg | type | description |
|---|---|---|
| dryRun | boolean? |
texKB(name: string) → number
| arg | type | description |
|---|---|---|
| name | string |
textureMemory( ) →
GPU texture memory of this package's own textures (UASTC/BC7, 1 byte a texel, mipmaps included), in KB, with the per-texture list.
yamlList(t: { string }) → string
| arg | type | description |
|---|---|---|
| t | { string } |
writeCollection( ) → number
Write forest.materialCollection/collection.yaml: the 13 base materials, tagged for materialLibraryKit's list and picker.
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.
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.