scenario-labs/skills

scenario-roblox-assets

Use when bringing 3D assets into Roblox Studio or preparing avatar items: import from Blender, GLB, FBX or OBJ files, AI-generated or image-to-3D meshes (Scenario or other tools), wrong scale or size in studs, mesh faces the wrong way, too many triangles, m…

Quelltext ansehen

Verwendung

  1. Installationsbefehl kopieren und das Quellpaket vor der Installation in der eigenen Agentenumgebung prüfen.
  2. Benötigte Werkzeuge, Zugangsdaten und Hosts im Original prüfen.
  3. Eingabe und gewünschtes Ergebnis beschreiben und die Ausgabe mit den Quellen abgleichen.
npx skills add https://github.com/scenario-labs/skills --skill scenario-roblox-assets

Vor dem Start

  • Die Installation umfasst weder Modellabo noch API-Kontingent oder Dateizugriffsrechte.
  • Sterne und Installationen zeigen Aktivität, keine unabhängige Qualitäts- oder Sicherheitsprüfung.
Originales Skill-Dokument

Aus dem Quell-Repository gerendert; Überschriften, Beispiele, Code, Tabellen, Links und Bilder bleiben erhalten.

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

ValueRelative toSource
20,000 trianglesOne mesh in a placeCreator Docs
4,000 trianglesRigid or layered accessoryCreator Docs; live AccessoryMaxTriangles
60,000 vertices, 20,000 trianglesOne EditableMesh; a quad counts as 2EditableMesh reference
256 px per 2 x 2 x 2 studsTexture side, next power of twoTexture specifications
4096 pxPlace textures (since 2026-01-30)DevForum
1024 pxAvatar ColorMap, live MaxTextureSize; other avatar maps 256Validation system; live
1024 pxEditableImage sideAssetService reference
Hat 3 x 4 x 3 studsNo AvatarPartScaleType or Classic; ProportionsNormal 1.87 x 2.5 x 1.87Live rules and validator; accessory specifications
10 piecesDisconnected components per accessory MeshPartValidation #187
0.05 to 4.0 studsPer-axis MeshPart size for avatar partsValidation #176, #177
0.02Lowest MeshPart.Transparency for soft alpha with AlphaMode TransparencySurfaceAppearance
0 to 40EmissiveStrength on Marketplace itemsSurfaceAppearance
1.35 studsHat crown opening, for a 1.16-stud default R15 head[added, wear test]
0.3 studHat attachment above the mesh bottom: brim a quarter of the head height below its top[added, wear test and fit render]
10 calls per 60 sValidateUGCAccessoryAsync rate limitLive error string

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

MistakeSymptomFix
Importing the unit-sized GLB as isProp the size of a brickScale in Blender to studs; Scale Unit Studs
No yaw on glTF inputLock or face on the back sideyaw: 180 before export
Make Double Sided to hide holesValidation boundary-edge error; double trianglesClose holes in Blender
Trusting holes_fill"Not watertight" after the fixCap loops, repair after decimation, recount
Decimating in Studio's headOver 4,000 triangles at uploadDecimate in Blender to 3,800
Packed metallic-roughness used as one mapMetal everywhere or nowhereSplit G and B to grayscale maps
Partial metalness keptTinted, plastic-looking metalSnap to 0 or 1 after reading the mask
ColorMap with alpha on an accessoryValidation #145, see-through spotsopaque_color
TextureID and SurfaceAppearance both setValidation #146One of them
Attributes or tags left on the accessoryValidation #191Strip before validating
Pivot at the feet for an accessory"Mesh data is not centered"Center pivot
Rotating the hat inside the fitting boxBox red although the mesh looks insideRe-center and orient in Blender
Sizing a hat by its brimHead pokes through the crownscale.opening, then opening.clears
Massless true on the HandleValidator: "Expected to be = false"Leave the default
AddAccessory from the client on your own characterNo joint; the hat fallsAttach on the server; seat a local preview by CFrame
Hat mesh and texture built from Editable content on the serverClients draw a small checkered cube at the HandleKeep the joint on the server; on each client, apply a locally built mesh (ApplyMesh) and SurfaceAppearance (procedures P8)
Expecting an EditableMesh preview to savePart empty after reopeningSession only; import for real
Expecting the Edit preview in a playtestCopied parts keep Size but have no meshStage and build in that data model

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

what the live runs added.

results.

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

plugin and Blender paths.

timestamps.

gates, texture sizing, payloads, kit runner.

prep pass.

UGCCheck.

Verwandte Aufgaben

aus demselben Repository

Weitere Skills

Alle Skills
scenario-labs
Community

scenario-blender-expert

Use when doing any 3D work in Blender through Python or an MCP bridge, headless or in a live session: modeling, sculpting a character or head, retopology, UV unwrapping, baking, texturing, rigging, animating, previs, geometry nodes, lighting and rendering, grease pencil, or finishing an AI-generated mesh into a production asset. Also before exporting or handing off an asset, to check it is ready for a game engine, a render or a 3D print (floating parts, z-fighting, inside-out normals, unapplied

Installationen / 1h
3
GitHub Stars
3963
Aktualisiert
22. Nov.
scenario-labs
Community

scenario-blender-sculpting

Use when sculpting in Blender through Python: sculpt a head, face or bust, a stylized or cartoon character, a creature or a realistic portrait; block out from primitives; cut planes, a jaw or gonial angle, cheekbones; fix a jaw or face that looks like a ball or balloon; stylized hair clumps; eyelids; an expression or smirk; plan remesh or multires resolution; reproduce Clay Strips, Crease, Draw Sharp, Scrape, Grab or mask moves without a tablet; final clay renders; or when a sculpt operator cras

Installationen / 1h
3
GitHub Stars
3963
Aktualisiert
22. Nov.
scenario-labs
Community

scenario-blender-texturing-shading

Use when texturing, shading or look-developing in Blender: building a PBR material from a texture set, displacement, procedural materials, edge wear, dirt, grime, color variation, decals, box or triplanar mapping on meshes without UVs, stylized character skin (subsurface, pores), eyes and cornea, hand-painted stylized textures, texture painting or painting masks headless. Also when a material looks plastic, CG, waxy or blown out, color spaces are wrong, or EEVEE and Cycles disagree.

Installationen / 1h
3
GitHub Stars
3963
Aktualisiert
22. Nov.
scenario-labs
Community

scenario

Use when connecting an AI agent to Scenario (scenario.com) through MCP, or when a task involves generating images, video, 3D, audio, sprites, textures, or game assets. Also when picking a Scenario model, running a LoRA, refining a generation prompt, uploading reference images, waiting on generation jobs, checking credits or quota, hitting Scenario auth, scope, or Forbidden errors, or setting up mcp.scenario.com in Claude Code, Cursor, VSCode, or another agent.

Installationen / 1h
2
GitHub Stars
3963
Aktualisiert
22. Nov.