scenario-roblox-assets

Roblox Asset Pipeline and UGC

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

Expert level here means every mesh arrives in Studio already at its size in studs, facing -Z, under its triangle budget, closed when it must be, with maps sized and split for Roblox, and with numbers that prove it. Fix in Blender, preview and audit in Studio without uploading, validate locally to green, and stop exactly where Roblox needs an uploaded asset.

If a sibling skill named here is missing from your available skills, ask the user to install it (npx skills add scenario-labs/skills --skill <name>); unattended, proceed from tool schemas and flag the gap.

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

Stance (the expert delta)

1. Treat an AI GLB as raw input with known defects. Image-to-3D output arrives about 0.95 units

across, front facing +Z, every material doubleSided, metallicFactor 1.0 with painted partial metalness, 2048 px JPEG maps and pinholes [added, measured on two generator outputs]. Raw meshes need remesh, pivot and scale work (CallMeDogey).

1. Decide size in studs in Blender, not in Studio. One Blender unit is one stud; glTF then needs

no Importer scale (Creator Docs, Importer; KatsBits [00:02:56]). Props pivot at the bottom center (Common Sense Machines [00:02:39]); accessories at the mesh center (validation #173).

1. Turn the front to -Z before export. glTF fronts face +Z; Roblox's LookVector is -Z. A 180

degree yaw in Blender fixes it for good [added].

1. An accessory is its bounding box, and a hat is its crown. Bounds are per AccessoryType,

measured around the attachment, and rotation grows the box (KatsBits [00:10:34]). The box follows AvatarPartScaleType: none or Classic gives the GetValidationRules() box (Hat 3 x 4 x 3), ProportionsNormal the docs row (1.87 x 2.5 x 1.87) [added, live]. Scale a hat so its crown clears the head, then check the box: filled to the Normal box by its brim, the test hat's crown was narrower than the default head [added].

1. Measure watertightness; do not trust a fill operator. bmesh.ops.holes_fill capped 2 of 9

pinholes on the test hat, and decimation then created edges with three faces [added]. Cap each loop, repair after decimation, count boundary edges again. Never use Make Double Sided to hide holes (Creator Docs, Importer).

1. Preview without uploading. EditableMesh plus EditableImage rebuild the prepared mesh and its

PBR maps in the place for audits, wear tests and captures [added]. That content is session-only and empty in a playtest copy [added]; ship through the Importer with Upload to Roblox off while iterating (Creator Docs; Templates [00:02:31]).

1. Validate locally to green, then stop. ValidateUGCAccessoryAsync runs Roblox's validator

inside a playtest. Fix every string about geometry, schema, materials or bounds; ownership and moderation strings need an uploaded asset and end the agent's part (Creator Docs, validation system).

1. Textures follow density, not the source. 256 px per 2 x 2 x 2 studs, power of two; OpenGL

normals; metalness 0 or 1 unless satin by design; opaque ColorMap on accessories (Creator Docs, texture specifications and SurfaceAppearance).

Establish first

• Destination: in-experience prop, or Marketplace avatar item. Only the second must pass validation

and be watertight.

• Size in studs per asset (an R15 character is about 5 to 6 studs tall), and for accessories the

AccessoryType and the AvatarPartScaleType it will declare (Classic, ProportionsNormal, ProportionsSlender).

• Budget class: hero prop, clutter, or accessory (4,000 triangles).
• Source: GLB from scenario-3d (preferred), FBX (needs FBX Unit Scale), or OBJ (mesh only).
• Rigged or skinned input goes to scenario-roblox-animation after import.
• Defaults when unanswered: prop, bottom pivot, longest side from the concept's scale, texture side

from texture_side, hat crown opening 1.35 studs, no scale type (Classic box).

Procedure

Full code and recorded results: procedures.md. Setup: import rbx_assets as ra (it finds the lead toolkit). Every snippet ran in Studio 0.743 or Blender 5.2 on 2026-10-19, except those marked not yet run; Edit and playtest captures confirmed the fit (a covered window returns dark frames: judge on numbers then).

1. Triage. Goal: know the defects. How: ra.glb_info(path) offline. GATE: triangles, size, map

sizes, doubleSided, skins and extensions written down per asset.

1. Fix in Blender. Goal: size, facing, pivot, budget, closed mesh, Roblox maps. How:

ra.blender_prep({**ra.PROP_PREP or ra.ACCESSORY_PREP, "input", "out_dir", "yaw": 180, "scale": ...}), with {"opening": 1.35, "band": [0.08, 0.2], "cap": [3, 4, 3]} for hats; it waits for the machine guard, runs blender -b, writes a report and four Workbench views. GATE: ra.gates(report["after"], kind, type) all pass, and the front view shows the front.

1. Read live rules. Goal: today's limits. How:

ra.run(studio, "return AssetAudit.rules()", kit=["AssetAudit"]). GATE: AccessoryMaxTriangles, MaxTextureSize and the type's attachment Size and Offset recorded; the offline gates use them.

1. Preview and audit in Studio. Goal: the asset in the place, measured. How: ra.stage the

packed mesh and maps, then MeshBuild.build and AssetAudit.prop. GATE: Size equals the Blender size within 0.01 stud, the triangle count matches, no audit error, the front capture shows the front.

1. Build the accessory. Goal: Accessory, Handle, one attachment named for the type. How:

MeshBuild.accessory, then AssetAudit.accessory(acc, rules). GATE: zero errors; AvatarPartScaleType is the only warning (the Accessory Fitting Tool adds it).

1. Wear test. Goal: it sits right. How: UGCCheck.rig and UGCCheck.wear in Edit, then

captures front and side. GATE: a joint exists, attachment error under 0.01 stud, opening.clears (crown at least head-wide at the head top), and the brim rests on the head in the captures.

1. Validate locally. Goal: only upload-bound strings left. How: in a Playtest,

ra.stage(..., dm="Server") and UGCCheck.validate(acc, Enum.AccessoryType.Hat); run single-fault copies as negative controls, at most 10 calls per 60 seconds. GATE: the item returns valid with no string; every fault copy fails.

1. Hand off the import. Goal: the shipping path. How: the human or a computer-use agent imports

<name>_roblox.glb with the settings in gui-paths.md; the Accessory Fitting Tool generates the final accessory. GATE: the imported MeshPart's Size equals the preview's; P7 audits it again.

Numbers

Quality gates

Measurable:

• Blender report: every ra.gates entry passes; the raw input fails what it should (negative

control).

• Studio: AssetAudit returns no error; Size and triangle count equal the report.
• Wear: joint present, attachment error under 0.01 stud.
• Validator: no string left that is fixable without an upload.

Visual (one contact sheet, 1,600 px at most, opened and read):

• Front of each asset faces the camera from -Z; props stand on the ground; nothing black or inside

out.

• The hat sits on the head from the front and the side, neither floating nor sunk past the brim.
• Textures read like the concept: details in place, no smeared atlas.

Score the result with critique.md before calling it done.

Common mistakes

Handoffs

• Receives from scenario-3d: GLB or FBX meshes with PBR maps (image-to-3D, remesh, retexture,

rigging). Ask for a remesh run when decimation damages the silhouette.

• Receives from scenario-textures: PBR sets for one mesh, which become SurfaceAppearance here.

Tileable sets go to scenario-roblox-environment as MaterialVariants.

• Receives from scenario-game-assets: the concept image that scenario-3d turns into a mesh (one

centered subject, plain background, front view). Icons, sprites and UI art go to scenario-roblox-ui, decals to scenario-roblox-environment.

• Delivers to scenario-roblox-environment: MeshParts at true size with a bottom pivot, a proposed

CollisionFidelity and the gate report; it places, sets final fidelity and LevelOfDetail, and lights.

• Delivers to scenario-roblox-animation: rigged or skinned imports, checked for scale and facing.
• Delivers to scenario-roblox-performance: each import batch, for its memory and batching audit

(references/memory-and-crowds.md, PerfAudit.assets), which this skill does not repeat.

Current Roblox notes

• EditableMesh and EditableImage are not creatable with Instance.new; use

AssetService:CreateEditableMesh(), CreateEditableImage() and Content.fromObject. Published experiences need the Mesh and Image APIs setting.

• CreateSurfaceAppearanceAsync takes EditableImage content only; maps cannot be swapped afterward.
• The Avatar Joint Upgrade joins rigid accessories with RigidConstraint, not a weld. Find

attachments with FindFirstChild(name, true).

• GenerateMeshAsync is scheduled for deprecation; GenerationService:GenerateModelAsync with

schema Car5 or Body1 replaces it.

• Places take 4096 px textures since 2026-01-30; avatar limits come from GetValidationRules().
• Studio MCP runs with plugin rights: in Edit it wrote SurfaceAppearance.ColorMap,

ColorMapContent and MeshPart.CollisionFidelity without error. Game scripts have fewer rights; test a snippet in a Script before shipping it in one.

• generate_mesh (Studio MCP) returns only {generationName, tag} and inserts a Model of segmented

MeshParts with asset IDs and a TextureID; pass size, maxTriangles and segmentation.

References

• references/expert-notes.md: principles by source, disagreements, and

what the live runs added.

• references/procedures.md: full code for P1 to P11 with test ids and

results.

• references/avatar-item-checks.md: engine calls behind each

wrapper, motion on several bodies, six-view opacity, tilt, Fitting Tool leftovers (Unknown type, TexturePack, MeshSize).

• references/critique.md: blocking and quality checks for your own output.
• references/gui-paths.md: Importer, Accessory Fitting Tool, validation

plugin and Blender paths.

• references/sources.md: every doc and video with credentials and

timestamps.

• scripts/rbx_assets.py: GLB triage, Blender runner with the machine guard,

gates, texture sizing, payloads, kit runner.

• scripts/blender_roblox_prep.py: the headless Blender inspect and

prep pass.

• scripts/agentkit/assets/: Payload, MeshBuild, AssetAudit,

UGCCheck.