Swatchbook
Walk into a ring of material swatches. Every material in the library stands on a sphere, a cube, a shader ball, a cylinder, a 2 x 2 m floor tile and a wall section, each mapped at its real-world tile size. Each one has a plaque saying what it is, its style, its roughness and metallic, and what its textures cost.
Use the toolbar to switch between four views:
- All, grouped by category.
- Close-up of one material, with a 40 m runway to catch shimmer at distance.
- Compare, two materials side by side.
- Style, a shelf filtered to one style family.
Change the lighting live: daylight, overcast, golden hour, moonlight, warm interior or neutral studio. Open Materials to put any material on whatever you click or tap, from a thumbnail grid, a searchable list, or a quick card made for gamepads and phones. Everyone in the world sees the same lighting and the same applied materials, and a player who joins later gets them too.
What you can install
materialLibraryKit (1.4.1) is the shared material library every material collection plugs into.
Materials.apply(entity, "oakPlanks")andMaterials.list({ category = "metal", style = "realistic" })from any script, for every player.- Tags on every material: display name, category, sub-kind, style, tile size, roughness and metallic range, texture cost, how many textures it samples, animated.
- A 20-piece calibration shelf: 18% grey, white and black cards; chrome, glossy grey, glossy black and matte grey balls; roughness, metallic and albedo ramps; a UV orientation checker, a normal-map test, a colour checker, a grey wedge; emitters at 1.0 and 16x; and more. No textures, so it costs no texture memory.
- The swatch gallery (drop the
SwatchGallerycomponent into any scene), six shared lighting looks, the on-screen picker and toolbar. - Checking tools for a collection's own tests: render-pass views (albedo, roughness, metallic, normal), a 4 x 4 seam test, near and 30 m shimmer, texture memory, a per-material verdict (at most 9 sampled textures and 1 storage buffer), and web-budget warnings. Also available as
zero materialChecks run <id>. - Two guides: "How to add materials to your game" (install collections, find, apply and swap materials for every player, make your own material collection and plug it in) and "Dress your game level with materials" (build a small level in an empty world, dress it with the woods and metals collections, then change its whole look with one change).
starterMaterials (1.1.4) is a small starter collection. It tags 19 of the engine's own ready-made surfaces (chrome, brushed metal, gold, glass, water, grass, plastics, toon, neon, checkers, an animated one and parallax bricks) without copying them. Installing it on its own brings the library with it, once, and nothing else.
Once a collection is installed next to the library, its materials appear in the list, the picker and the gallery on every player's machine, with no code. Published collections cover metals, woods, stone, masonry, ground, fabrics, glass, organic surfaces, plastics, sci-fi, fantasy, toon, retro, weathering and animated surfaces. The woods and metals collections were installed together in a new world with 1.4.0: one library, 73 materials, no problems, and both collections' own tests pass.
Measured in a browser tab: 47-60 fps on every page of the core gallery. The library has tests covering every public call.
Latest release
materialLibraryKit 1.4.1 and starterMaterials 1.1.4 (2026-10-31), a patch on 1.4.0 / 1.1.3:
- After Stop in the editor, what the library reports is back to what it was when play started, matching what the scene shows: a material picked during play comes off the record, a box re-dressed during play reports its material from before, and the lighting look and gallery exhibit go back too.
- The READMEs name only open issues.
- Tests: 41, passing twice in a row in this world and in a new world with starterMaterials alone.
1.4.0 / 1.1.3 (earlier the same day) added the two guides, one calibration shelf whatever a collection was published against, and a starterMaterials install that brings only the library.
Comments · 0
Open discussion, no rating attached. Ask questions, swap notes, follow threads.
Documented parts · 14
- calibNormalTestshader
- calibration.materialCollectionmaterialcollection
- calibStepRampshader
- calibUvCheckershader
- Checksmodule
- Gallerymodule
- Lightingmodule
- materialCheckstoolbox
- materialCollection.assetTypeassettype
- materialLibraryKitpackage
- normalTestmaterial
- Pickermodule
- starterMaterialspackage
- uvCheckermaterial