scenario-roblox-environment

name: scenario-roblox-environmentdescription: "Use when building or lighting a Roblox map: graybox or blockout, level layout, landmarks, doors and walls, parts versus unions (CSG), collision fidelity, terrain (generate, sculpt, paint, water, Part to Terrain), MaterialVariants, custom terrain materials, PBR textures from Scenario, skyboxes, Lighting, Atmosphere, Clouds, bloom, color correction, day or night moods, interior light, scattering rocks, bushes and trees, level of detail (SLIM, RenderFidelity), per-model streaming or a streaming test, collision overlays, invisible walls, or texture sizes. Also when a map looks flat, foggy, too dark or plastic, grass pokes through floors, a doorway blocks players, content pops in or never unloads, a custom material disappears, or the sun lights the wrong side."license: MIT

Roblox environment (builder, environment artist and lighter)

Target: Roblox Studio (October 2026 build) on macOS, driven through the scenario-roblox-expert toolkit.

Expert environment work on Roblox means a graybox built from plain parts and composed from the spawn camera, terrain and materials made from code with their silent failures checked, and light designed from a mood with the sun aimed first and post effects last. This skill carries those rules from the sources, corrected by live tests in Studio 0.743 on a village, terrain and interior built for the purpose, plus kit modules that build, light, measure and audit a scene. If a sibling skill named here is missing from your available skills, load it with skill_get (Scenario MCP) or ask the user to install it (https://github.com/scenario-labs/skills#install); unattended, proceed from tool schemas and flag the gap.

REQUIRED BACKGROUND: scenario-roblox-expert (channels, review loop, toolkit, current-Roblox traps).

Status (2026-10-19): live run 2026-10-19 01:14 passed 14 of 14 in Studio 0.743; offline O1 to O9 pass. Scatter, the streaming test and the overlays are offline-tested only. A later run stalled on a viewport that stopped drawing (see references/procedures.md).

Stance (the expert delta)

1. Graybox in plain parts, composed from the spawn camera. Primitives, one grid MaterialVariant, folders with underscores, a ground color distinct from walls (Jalapeno, T--CNfkfBBQ [00:02:01 to 00:02:35, 00:08:13]). Landmarks as loud placeholders at true size (RoBuilder, eRnnjqVOq7c [00:05:20]). Doorways and halls at least 10 studs wide, walls at least 10 tall (Roblox graybox tutorial). Compose from where players spawn and time the walk between landmarks (Gino, vWx8UTxsi0A [00:11:49, 00:12:21]).
   • Live: the template SpawnLocation faced away from the village, so the first view was a hillside. Turn the spawn toward the first landmark.
2. Parts before CSG; test what collision does to openings. Cut axis-aligned holes with parts, not unions (Kaiwala, x9jg8kjH3Vs [00:04:41]). Each distinct union is its own mesh and collision asset (Kaiwala, Ahn2P_4TDrU [00:20:40]). Pick fidelity by whether players pass through or touch the shape (Roblox collisions docs).
   • Kaiwala saw Default collision close a hole and switches to PreciseConvexDecomposition; Hull or Box are his cheap fix for simple shapes (Ahn2P_4TDrU [00:01:54, 00:02:28]).
   • Live: Hull and Box filled a 10 by 10 doorway; Default and PreciseConvexDecomposition kept it open. Probe every opening rather than trusting a fidelity name.
   • GetPartBoundsInBox reported every union door as blocked because it compares bounding boxes. Test passage with GetPartsInPart or a ray.
3. Terrain from code, checked by reading the voxels. Block out with parts, convert, then smooth (BONES, -DoOf32pkPo [00:04:34, 00:09:57]). Region calls need resolution 4, grid-aligned regions and at most 4,194,304 voxels each (Terrain reference).
   • Live: a FillBlock whose top sat at y 0 left the walkable surface near y 2. TerrainKit.occupancy places the surface exactly.
   • Live: a raycast right after a fill returned nothing. TerrainKit.surfaceY reads the height from the voxels instead.
   • Grass blades poke through parts; paint LeafyGrass there (SmartyRBX, CippiATeZ54 [00:01:40]). Live, they grew through every floor set on Grass; TerrainKit.paintUnder repaints under floors.
4. Materials link by name, per base material, and terrain needs more. A rename breaks every part using the variant (Roblox materials docs). Terrain uses a variant only through an override, one per material: Grass and LeafyGrass separately (SmartyRBX, CippiATeZ54 [00:05:13, 00:05:47]).
   • Live: creating a Basalt variant changed nothing until SetBaseMaterialOverride.
   • Live: the override still rendered near black because the terrain material color (Basalt 30, 30, 37) multiplies the map. Brighten it with Terrain:SetMaterialColor, as SmartyRBX does by hand [00:02:44].
5. Decide the mood, then aim the sun, then color. Mood sentence first, ClockTime next (RingWorld, UlvSrWHESwA [00:01:06, 00:01:58]). Aim the sun so light lands where it matters (DatBoiEle, aq0Fi0R2FAY [00:02:11]; BONES uses GeographicLatitude as the direction control, zAoY8pxJM9c [00:08:36]).
   • Live: at the default latitude the spawn camera faced the sun and saw only shadow sides, tinted by Ambient. Looks.aimSun finds a ClockTime and GeographicLatitude for any direction, error under 1 degree.
6. Warm light, cool shadow; contrast last, in small steps. Ambient tints shadows and ColorShift_Top tints light; lowering EnvironmentDiffuseScale raises contrast (DatBoiEle [00:03:38, 00:05:48]). Realistic first; Atmosphere Density 0.3 to 0.4 with Offset 0; color correction last, for contrast (Develuper, vkEXLmRAQgs [00:00:27, 00:01:04, 00:02:16]). Move ColorCorrection in 0.05 steps (DatBoiEle [00:08:09]). His Bloom: Threshold about 0.03, a large Size, then Intensity lowered to taste [00:07:37].
7. Night needs a focal light and silhouettes. BONES' dark recipe works in a corridor: black Atmosphere Color and Decay, Density 0.495, Offset 0.25, Haze 5, Glare 0, environment scales 0, ExposureCompensation -0.4 (zAoY8pxJM9c [00:03:15 to 00:06:04]). Outdoors, RingWorld lowers Brightness, drops glare, tints blue and adds near and far lights (UlvSrWHESwA [00:06:44 to 00:07:54]).
   • Deciding condition: does the player need the skyline? Live, the corridor recipe turned 96 to 100 % of the far views black. night_outdoor kept every view readable.
8. Interiors: windows must pass light, then fake the bounce. Glass casting shadows blocks the sun shaft; turn CastShadow off (DatBoiEle [00:09:16]). For window-lit rooms BONES uses Brightness 44, black ambients, environment scales 0. He adds a PointLight [234, 255, 254], Range 50, Shadows on, near the window (zAoY8pxJM9c [00:06:14, 00:07:14]). All three confirmed live.

Establish first

• Camera and genre: third person (the default) needs larger doors and ceilings than first person.
• Target devices; mobile reach favors Soft lighting and the performance owner's budgets.
• Map size, StreamingEnabled, and which models must always exist on clients.
• One mood sentence per zone and two or three reference images.
• Asset sources: Scenario meshes, textures and skyboxes, or Roblox materials only.
• File pipeline: Rojo or Studio only. Several settings are file-only (Current Roblox notes).

Defaults: Realistic with PrioritizeLightingQuality, graybox grid variant at StudsPerTile 8, doors 10 by 10, the day_fantasy look aimed for the spawn view.

Procedure

Setup: import rbx_environment as E, then E.run(studio, code, kit=["Graybox", "TerrainKit", "MaterialKit", "Looks", "EnvAudit"]) (it finds the lead toolkit). Full code and recorded results: references/procedures.md.

1. Readiness (P1). Read LightingStyle, overrides and the file-only settings. GATE: values as intended; anything scripts refuse is set in the place file or the Properties panel.
2. Graybox (P3). Graybox.house, wall, lantern, block under map_geo/<area>/<kind>; landmark placeholders; spawn turned toward the first landmark. GATE: Graybox.clearance returns no findings; walk times reported; the spawn capture shows the landmark.
3. Terrain (P2, P13, P4). TerrainKit.heightfield with a height function, water, fromParts and smooth, then paintUnder for floors. GATE: the spawn ground (groundY after a frame, or surfaceY) sits at the design height; no grass through floors in the spawn and interior captures.
4. Openings and collision (P5). Openings from parts; any union keeps Default fidelity and the Opening attribute. GATE: a character-sized GetPartsInPart probe and a ray pass every doorway.
5. Materials (P6). MaterialKit.kit, dress by role, one override per terrain material, terrain material colors. GATE: MaterialKit.links returns 0 broken; each override reads back; the dressed captures judged with references/critique.md.
   • Foliage, rocks and trees: Scatter.plan and Scatter.place, with collision and LevelOfDetail per variant (references/foliage.md).
6. Light (P7 to P10). Snapshot, Looks.apply, Looks.aimSun, capture the same cameras before and after, E.look_metrics, one contact sheet. GATE: metric bands in Quality gates; the sheet judged against the mood sentence.
7. Playtest (P11). Client Stats, per-model streaming check, walk through a door. GATE: the character arrives inside; numbers go to the performance owner.
   • Checks that can fail beyond captures: streaming at radius 64, collision and invisible-blocker overlays, texture sizes and mesh groups (references/verification.md).
8. Audit and hand off (P12). EnvAudit.all(game) in Studio, E.lune_audit(place) on the saved file. GATE: no error or warn.

Numbers

Quality gates

Measured (lower half of each capture with skip_top=0.45, so the sky does not dominate):

• Day looks: crushed under 0.05 in every view; spread wider than the neutral capture.
• Outdoor night: crushed under 0.5 in every view; a lit focal point near spawn.
• Interior with sun: the floor patch clips (clipped above 0.05) and the fake bounce lifts mean_luma while the patch stays.
• Graybox.clearance, MaterialKit.links, EnvAudit: zero findings at error or warn.
• Playtest: 60 fps on the dev machine; draw calls and triangles reported per view.

Judged by eye on the contact sheet (references/critique.md): mood matches the sentence; value structure reads in gray; light faces seen from spawn; landmark contrasts with its background; no plastic or near-black materials; distance haze leaves silhouettes.

Common mistakes

Handoffs

Current Roblox notes

• Lighting.Technology is superseded by LightingStyle (Soft or Realistic) and PrioritizeLightingQuality; scripts cannot read Technology.
• Script-refused, file-only (live): StreamingTargetRadius and the other streaming settings except StreamingEnabled, Terrain.Decoration, GrassLength, MaterialService.<Material>Name. Rojo 7.7.1 writes them all (Lune read-back).
• A place built by Rojo starts with engine defaults: GlobalShadows off, environment scales 0, gray ambients, no Sky or Atmosphere (live).
• GeometryService:SubtractAsync and siblings replace BasePart:SubtractAsync; results come back unparented; a CollisionFidelity write reads back after the next yield (live).
• ReadVoxelChannels returns Size on the result table, ReadVoxels on the materials array (live).
• Terrain Clouds live under Workspace.Terrain and can be created by script (live).
• ClockTime does not advance by itself in a running game (live).

References

• references/procedures.md: P1 to P13, the code the live tests run, with results.
• references/critique.md: how to judge a capture; the findings from this skill's own captures.
• references/expert-notes.md: the expert claims by source, agreements, disagreements and live corrections.
• references/gui-paths.md: GUI-only tools, their code substitutes and menu paths.
• references/foliage.md: scatter, leaf cards, collision, RenderFidelity and LevelOfDetail.
• references/verification.md: streaming test, overlays, texture and batching audit.
• references/sources.md: every source with its public URL.
• Kit: Graybox, TerrainKit, MaterialKit, Looks, EnvAudit, Scatter, WorldCheck, lune_env_audit, rbx_environment.py.