RIGGERSET - HOW TO USE (PEOPLE AND AI) Updated 2026-10-29 | Tool contract 6 Studio: https://oddsprig.com/tools/riggerset/studio/ Guide: https://oddsprig.com/tools/riggerset/how-to-use.txt QUICK START - PEOPLE AND AI Loading artwork uses the normal browser controls. Connections is optional HTTP automation for an already-open project; it is NOT required to upload artwork, create a project, use the workflow buttons or generate a model in the browser. 1. Open Studio in the browser/profile that will hold your project. If the link opens Model with "No artwork loaded", choose "1. Image" first, or open: https://oddsprig.com/tools/riggerset/studio/?stage=reference&workflow=image 2. Choose the subject/body plan, then "Choose my artwork" and select the actual PNG/JPEG/WebP file (up to 10 MB / 24 million pixels), or drop it on the image area. The image shown in a chat or a saved prompt is not a Studio upload. 3. Verify the project name and "Immutable original" preview in Studio. Uploading creates a local project without a token, model-weight download or GPU use. To resume existing work, choose its saved project in the same browser/profile. 4. Before processing, check "Model files on this browser". Reuse saved files; download only missing required files that the user has authorized. Turn on "Use my GPU" only within the user's authorization. Connections does not replace these controls. Keep the Studio page open during processing. 5. Under Image, choose "Prepare pose". Use its run button; compare the result and choose "Approve this reference". If reference preparation is disabled, the run button uses the original and that reference still needs approval. 6. Choose "2. Model", then run "Generate 3D". Changing a step changes the view; it does not run processing. Inspect the actual result before Cleanup, Rigging, Animation and Export. "Run remaining stages" can continue available work, but stops for the reference approval and other required choices. AI ASSISTANT: PICK A WORKING CONTROL PATH 1. Identify the browser tool and profile you actually control. Read its upload instructions and use its documented file-chooser or file-input operation. Do not confuse a local path, a chat picture or a text fetch with a file upload. 2. The RiggerSet page does not require Chrome extension file-URL access. An individual browser automation tool CAN require it for its local-file route. If the documented upload call returns that exact permission error, report it as a browser-tool requirement, follow the user's existing authorization, and reconnect after an extension reload. Do not invent this requirement, ask for it repeatedly, or claim that every browser/profile requires the same setting. 3. If this browser exposes the optional document.modelContext tools, use riggerset_read_workflow first. riggerset_import_artwork takes the actual image bytes as standard dataBase64, name, mimeType and the returned expectedProjectId (null for no selected project). It creates a separate local project and returns its original ID, byte count and SHA-256 receipt. It does not approve the reference or generate a model. It is not an HTTP Connections upload. Feature-detect this capability; ordinary Chrome may not expose it. 4. Otherwise use Choose my artwork with the normal browser upload tool. If your tools lack an upload capability, say exactly which capability is missing. The site cannot grant your assistant filesystem/browser access. Do not add unrelated setup steps or substitute a saved prompt for the actual file. 5. Confirm the new project and Immutable original. Then prepare, inspect and approve the modelling reference before Generate 3D. Read the actual stage result before reporting success. A chosen step is not a completed operation. - Read this guide before declaring a setup blocker. Inspect the actual page and project state. With an authorized browser-control tool, use the ordinary buttons/file-upload control above; no RiggerSet connection token is needed. - A text/HTTP fetch of the page is not browser control. If your tools cannot upload a local file or operate the page, report that exact missing capability. Do not claim the website requires Connections merely because your tool does. - Do not substitute a saved prompt, chat image or proposed action for a completed upload. Confirm the visible project/source before reporting "imported"; report "generated" only after a completed geometry checkpoint and actual model exist. - Respect permissions already granted; ask only for a genuinely missing choice, approval or tool. Do not bypass GPU/download settings or reference review. - For HTTP commands, first create/open the image project in Studio, then use the optional Connections steps below. The current API has no artwork-upload tool: pipeline.run acts on the reference already saved in that browser project. - Session/grant setup expires. Reuse a working authorized connection; request fresh setup only when missing, expired or revoked. Never request provider keys or passwords. Report the actual page/API error and failed step if blocked. START AND SAVE Choose a subject profile matching the reference: human, bird, paw/hoof quadruped, insect or arachnid. Use a clear whole-subject image. A single image is not a complete scan; inspect hidden surfaces and limb counts after generation. Create/reopen a project. Work through geometry, cleanup, rig, animation, export. Automatic handoff continues only when enabled and required packages/permission are already available. Download only the model/software files you choose and enable GPU use when ready. AI connections cannot approve either for you. Open the saved model in the Blender section when its packages are ready. STOP ALL stops this page's work and keeps completed saved checkpoints. Sampling step counters are progress within the named pass, not saved partial models. STOP does not save or resume a half-finished TRELLIS sampling pass. Continue from completed saved stages; an interrupted Generate starts again. Read the phase title with its counter: texture step6/12 is not6/12 of the whole generation. No per-step resume or guaranteed completion time is implemented. Download important .blend/GLB outputs: browser-local storage may be cleared or evicted. Other browser profiles/computers do not automatically share it. STYLE AND GAME BUDGET In the regular Blender editor, open "Style & game budget" near the top. Presets: Detailed (200,000 triangles / 2K texture cap), Game ready (20,000 / 1K), Performance (8,000 / 512px), Retro - early 2000s (2,000 / 256px), Voxel blocks (32 across). Choose the reference artwork for the aesthetic. Texture size and triangle limit are independent; the 2K texture setting means 2048px on the longest side. Increasing a budget does not invent additional source detail. Existing image reconstruction already requests 2048px textures; its 512/1024 control is the reconstruction pipeline, not the exported texture size. Choose the model part, adjust the settings, then Create styled copy. The original is kept in the Blender document. Static copies remain the default. For compatible plain FK rigs, "Keep the rig and animation on the copy" makes a reduced rest-mesh copy with actual normalized skin weights, the same skeleton and existing animation. Inspect its deformation and GLB before accepting it. Voxel conversion cannot keep a rig. Morph keys, control rigs, unsafe modifiers, shared or unsupported animation states are refused instead of silently losing them. Detailed, Game and Performance preserve standard opaque PBR image maps. Retro makes real coarse faceted geometry and crisp resized base-color texture copies. Voxel makes actual cubic blocks with transferred colors. Block count controls voxel detail; its resulting triangle count is measured rather than padded or silently decimated away. Unsupported or excessive conversions are refused. Inspect the actual 3D result, then export GLB or save .blend. Hidden originals are excluded from styled GLB exports. Undo last edit restores the previous saved document. Choosing a preset does not start an engine or download files. AI tool: mesh.style {object:"Body",style:"retro",triangles:2000, textureSize:256,voxelCells:32}. Styles: detailed, game, performance, retro, voxel. OPTIONAL BEGINNER TOOLS The regular editor is the default. Choose "Beginner? Try this" in the Blender section to show simpler tools. "Beginner mode: on - Switch off" returns to the regular controls. Show guide can be turned off independently. Enabling this mode does not start Blender, download files or enable GPU use. Open your model in Blender first, then Open edit view. Orbit turns the model; scroll/pinch zooms. Choose a tool, then draw with a mouse or one finger. A visible ring shows the geometry brush size. Completed strokes save separate checkpoints. Undo restores the previous saved edit. Your camera angle is kept when the preview refreshes. Esc/Stop still stops this page's work. Cut: select Model part and draw a straight line across it. The kept part and closed opening are shown before you commit. Flip kept side swaps sides. Keep cut saves that exact result; Cancel cut leaves the original untouched. Changing to another tool also discards an unconfirmed cut. Ambiguous caps or unsupported topology are refused. Models with shape variations require the explicit bake option; the prior shape variations remain in the Undo version. Build: start on the surface and draw a raised, rounded 3D part, or click for a round piece. These are real separate editable meshes with UVs, not painted images or a destructive fusion. On a supported neutral rig, a new part can follow its nearest joint. Complex flexible appendages still need manual rigging. Shape: Raise, Lower or Smooth a local area. Changes are held in an editable relative shape key called Shape edit. Basis, UVs and existing weights remain unchanged. Size is a percentage of the selected part; Strength controls the amount per completed stroke. Very coarse meshes have fewer vertices to shape. Color: paint an existing UV texture using the chosen color and opacity. It makes/reuses the Brush color variant. The original texture is retained. Shared or mirrored UVs may paint more than one surface. Unsupported shaders or a surface without usable texture coordinates require advanced preparation. Before cutting, building or shaping a posed/animated rig, use Prepare neutral model. This saves a checkpoint, detaches the active motion and clears the pose. It does not discard the earlier saved animation. Some constraints, drivers, modifiers or linked resources require manual preparation in the regular editor. AI tools use the same operations and checkpoints: mesh.cut.plan {object,planePoint:[x,y,z],planeNormal:[x,y,z],keep:"front", cap:true,bakeMorphs:false} mesh.cut {object,previewId,digest} -- use the current plan's exact ID/digest mesh.build {object,points:[{position:[x,y,z],normal:[x,y,z]}],radiusWorld, color:[r,g,b,a],attachToRig:true} mesh.sculpt {object,points:[{position:[x,y,z],normal:[x,y,z]}],radiusWorld, strength:0.2,mode:"raise",shapeName:"Shape edit"} Coordinates and geometry radii use Blender world units. Front keeps the positive side of the plane normal; back keeps the negative side. Plan is read-only and expires after a scene change. Build/Shape allow 1-64 samples per action. Shape strength is a fraction of the radius, with a bounded per-stroke displacement. The browser's cut preview is private; AI receives plan metadata and can export/download a result through the owning browser after applying it. LOCAL ANATOMY REPAIR Choose Local repair in "Repair, paint & simulation setup" and a working mesh. Open model selection view. Click/tap a surface point; drag to turn the model. Set the radius, then Preview selected region. Inspect the orange faces before choosing Remove region & close opening. Smaller radii or a different point can produce a safer boundary. For exact regions, select faces in the native Blender editor and preview without a picked point, or supply face IDs through the API. GLB import rejoins equivalent smooth UV-seam vertices using Blender's importer; custom vertex attributes and hard-normal seams stay separate. If a hard-edge seam leaves the cut disconnected, use manual topology cleanup first. The point uses Blender world X/Y/Z; radius uses mesh-local units. A brush finds connected face centers inside a sphere. It does not infer limb anatomy. Repair is most predictable before posing: a click on a deformed pose does not identify rest-mesh topology automatically. Preview again after any model edit. Repair removes selected faces, only their now-unused vertices, and caps their new simple boundary rings. Surviving coordinates, UV corners, material choices, weights and the rig are preserved. Mildly warped rims use their existing 3D vertices; there is no global remesh or flattening. Unsafe cuts are refused. Limits: 8,192 selected faces, 200,000 source polygons, 1-8 rings, 512 vertices per ring. Shape-key meshes, strongly folded/intersecting caps, nonmanifold cut neighborhoods and detached whole-component removal need manual editing. Each accepted tool edit saves a checkpoint. Undo tool action restores the previous document. The original project/model output remains available. SHAPE-LOCKED PAINTING Choose Paint variants. Click textured surfaces to add UV stamps. Set a variant name, solid/stripes/scales/belly pattern, two colors, pixel radius and opacity. Apply texture variant paints real pixels on a copy and refreshes the view. Clear brush points before another region. Overlapping stamps accumulate color. Shared/mirrored UV islands can show the same stamp. The first stroke for an ID clones the linked Base Color image and relevant materials; later strokes reuse that variant. Another ID makes another copy. The source texture, proportions, vertices, UVs and rig stay unchanged. Packed images are saved with the Blender document and GLB export. Requires an ordinary RGBA image linked directly (reroutes allowed) to Principled Base Color with untransformed UVs. Limits: 4096x4096, 128 points/action, brush radius 1-128 pixels, 32 variants. Composite shaders, tiled/sequence textures, missing UVs and resources shared with another object can be refused. CREATURE RIG CONTROLS Choose Rig controls and the actual armature. Under Rest joints, Prepare rest joints detaches the active action and clears its pose while retaining the action for Undo. Inactive imported clip stashes retain their Action IDs when rest preparation removes their muted tracks. Choose a joint and edit its armature-local head/tail. Necessary connected junctions follow; mesh vertex data stays in place. Actively animated, driven, constrained or non-rest rigs require preparation rather than silent conversion. Review deformation after any rest-joint edit. Visual rest joints: Inspect rig & open joint view shows H (head) and T (tail) handles over the actual model. Drag a filled handle or focus it and use arrow keys; Shift makes larger steps. Orbit away from handles to turn the model. Dashed handles retain saved positions. Review native plan checks the proposed connected-junction changes. Apply joints commits that exact plan in one undoable edit; Cancel/Escape discards it. Mirroring requires an explicitly identified compatible named joint across the armature's local X=0 plane. Numeric inputs remain under Advanced. Active animation, constraints or an unsafe rest pose require rest preparation first; they are never silently discarded. For each limb choose direct upper -> middle -> end joints. Bend direction is an ARMATURE-LOCAL direction, not a target point. Avoid a direction parallel to the limb. Ground height is WORLD Z. Save limb controls and regenerate the animal motion. Planting holds a stationary stance anchor with a returning swing. It creates no IK constraints or forward root locomotion. Anchors are solved at baked frames; FK interpolation between keys remains approximate. Unreachable anchors are reported before action creation. Up to 12 chains. Rigid hooves/claws: choose the deform joint and an existing vertex group, a current Blender vertex selection, or an earlier previewed region. Apply rigid weights sets those vertices to 1.0 on that bone and removes competing deform weights there. Non-deform groups and outside weights stay intact. Up to 10,000 vertices. Do not use a whole-body selection for a single hoof. Birds support flap/fold/idle; supported quadrupeds support walk/trot/idle. Insect & arachnid motions use explicitly mapped body/head and six or eight upper/lower/end leg chains. Six legs use alternating tripod timing; eight use a staggered wave. Feet hold their stance anchor and return through a smooth in-place swing. Map optional existing wing pairs for slow flap/fold inspection and ordered existing tail joints for sway. Wings use each mapped hinge's local Z axis. These are editable starter clips, not flight physics or detected anatomy. Unreachable or straight-locked legs require joint/pole/ground adjustment. Manual mapping supports different joint names. Do not apply a human gait to an insect, arachnid or another incompatible body plan. Face controls require existing shape keys or an actual jaw bone. Audio jaw motion uses a locally decoded volume envelope, not phoneme recognition or separate singer detection. Playback uses the original audio. QUICK MOTION VALIDATION Choose Motion check, sample count and ground height, then Run quick motion check. Read issue kinds/frame numbers and its stated assumptions. It checks joint flips, contact sliding, evaluated skin strain and ground penetration. The inspected frame/context is restored. The check does not modify animation. Inactive imported clip stashes are supported; active NLA blends require manual preparation. Limits: 60 sampled frames, 8 meshes, 256 bones, 512 evaluated vertices per mesh (including sampled edge endpoints), cooperative budget up to 45 seconds. A stalled native call still has the browser's outer watchdog. Timeout or cancellation is partial coverage, not a pass. Intentional large rotations or squash can raise warnings. A sampled pass is not proof about every frame. Play and orbit the actual exported animation preview; the native Blender editor remains available for joint/keyframe editing. Each actionable warning can open its exact native frame as a paused, evaluated 3D snapshot with the affected joint or surface marked. This bakes the evaluated pose for inspection rather than merely disabling the animation on a rest mesh. The saved base mesh, action and rig are retained. Reports belong to their saved checkpoint: after a real edit, run the check again. A correction link opens the relevant controls; it does not claim the current clip was automatically fixed. REUSE AN EXISTING MOTION Open Motion reuse with separate source and target armatures already in the scene. Map every compatible source/target joint one-to-one and preserve the hierarchy. Select at most 240 consecutive frames. Root travel starts off; when enabled its scale and maximum distance are explicitly bounded. Reuse motion creates a separately named target action while retaining the old target action and proportions. Preview the actual result and run a motion check. Plain FK deform rigs are supported; control/constraint, driver, NLA, morph and incompatible hierarchy cases need manual preparation. This does not invent missing joints. CONTACT POINTS, SCALE AND EXPORT Choose Contacts & scale. Enter the actual model height in meters, then Set height & ground level. Associated asset roots scale uniformly and the base moves to Z=0, preserving proportions and local mesh data. Size is not inferred from a photograph. Regenerate planted clips after scale/ground changes. Animated roots or constrained assets may need manual preparation first. Pick a mouth/horn/claw/foot/body point. Use stable names: mouth, horn.left, foot.front_left, body.chest. Set category, world position, radius in meters and optional linked joint. A bone binding follows that joint; otherwise the point follows its source object. Save, list or remove named points. Up to 64 points. Export simulation bundle downloads a ZIP with: model.glb: actual geometry, rig, animations and named contact nodes contacts.json: identities, position/binding/radius, frame and scale manifest.json: checkpoint ID, units, byte counts and SHA-256 hashes Coordinates are right-handed glTF (+Y up, +Z backward) in meters. Contact positions describe the reported frame; bound nodes follow the animation. Physical scale is confirmed only after supplying actual height. Bundles fit 128 MB. Ordinary GLB and editable Blender export are also available. OPTIONAL HTTP AUTOMATION Use this path when an external AI will issue HTTP commands. Ordinary browser operation does not require it. Keep the owning Studio project/page open. 1. Load the artwork/create the project first; "Start API session" needs a project. 2. In Connections, choose "Start API session". 3. Choose the required permissions and "Create connection token". The default read permission does not permit model, rig or pipeline changes. Choose only the needed scopes; export has its own separate permission. 4. "Copy setup" supplies the current endpoint and limited RiggerSet token to the authorized AI. Its provider key stays with that AI. 5. Choose "Allow AI control" to enable queued commands. Manual interaction, Pause AI, takeover, revoke and STOP can pause or cancel that control. This is current-session setup, not a permanent installation. Sessions and grants expire as described below. A token alone cannot execute work after the browser page closes, nor upload a source image through this API. This API coordinates the OPEN browser project. It is not a remote Blender farm, file hosting service or arbitrary Python/shell endpoint. Artwork stays local; the coordinator stores bounded metadata/results. Never send provider keys or passwords as tool arguments. AI cannot authorize GPU use or downloads. Use the setup's endpoint and Authorization: Bearer token: GET {endpoint}/state GET {endpoint}/tools POST {endpoint}/commands GET {endpoint}/commands/{commandId} Read fresh state before EACH change and the tool catalog before using a tool. automation.preflight is a bounded read for actual local reference/model evidence, checkpoints, capability limits and the next action. The connection setup also separates site blockers from your browser-tool capabilities. Missing metadata means unknown, never an approval. Saved immutable file hashes may be reused; selection IDs, cut plans and motion reports must still be current. No mutation or required inspection is skipped on the strength of an old cached result. POST /commands (replace names/epoch/revision/hash with current values): { "requestId":"selection-001", "epoch":0, "expectedRevision":0, "expectedHash":"sha256:", "tool":"mesh.selection", "args":{"object":"Body","center":[0,0,1],"radius":0.1,"space":"world"} } Poll until complete/failed/cancelled before dependent work. A requestId is idempotent only for exactly the same body. One command executes at a time. Agent requests: 16 KiB; browser-only completion reports: 256 KiB. Recent detailed results share a 256 KiB retention budget; older details are marked archived. Limits: 20 queued commands, 60 requests/minute/agent. Sessions last up to 8h; grants up to 1h and can be revoked sooner. Up to five connections. Scopes: read, model, appearance, lighting, rig, animation, pipeline, export. Export permission is separately opt-in; old grants do not acquire it. Strict new named tools (unknown parameters are refused): read: mesh.selection {object,faces?:[IDs] OR center:[x,y,z],radius,space?} space: local(default) or world. No region args uses selected Blender faces. Returns selectionId,digest,counts,bounds,repairable,reason. Full arrays stay behind the opaque ID; up to 8 cached selections. Any scene edit expires it. animation.validate {armature,objects?:[meshes],start?,end?,samples?,groundZ?, contacts?:[actual contact BONE names],maxSeconds?} contacts.inspect {} checkpoint.read {} -> id,previousId,savedAt,projectId model: mesh.repair {object,selectionId,digest} - exact current preview result asset.scale {object,heightMeters,ground?:true} checkpoint.restore {id} - a retained checkpoint for this project only Five recent documents/usable ancestors are retained; evicted IDs fail. appearance: texture.variant {object,image?,variant,pattern,points:[[u,v]],color:[r,g,b,a], secondaryColor?:[r,g,b,a],radius,spacing?,opacity?} pattern: solid|stripes|scales|belly; colors/UVs/opacity 0..1; spacing in pixels, API 0.5..128. Omit image for the unique linked image. rig: rig.rest {armature} rig.joint.set {armature,bone,head:[x,y,z],tail:[x,y,z]} rig.limb.configure {armature,chain,upper,lower,end,pole:[x,y,z],plant,groundZ?} pole is armature-local DIRECTION; groundZ is world Z. rig.weights.rigid {object,armature,bone,vertices?:[IDs] OR group?:name OR selectionId?:ID} - omit region to use selected vertices contact.set {object,name,kind,position:[x,y,z],bone?,radius?} kind: mouth|horn|claw|foot|body|custom; position in world Z-up contact.remove {object,name} export: asset.export {format:"glb"|"blend"|"bundle",filename?:simple basename} The file downloads in the OWNING BROWSER. The API returns filename, bytes, SHA-256, checkpointId and delivery:"browser-download"; no binary/public URL. The visitor/browser controls any download prompts. Existing named tools remain: scene.inspect, object.transform, mesh.offset, material.set, texture.paint, light.set, bone.pose, animation.preset, animation.creature, face.pose, animation.lipsync, keyframe.insert, timeline.set, timeline.play, scene.undo, pipeline.run. GET /tools provides bounded examples for the token's scopes. Inspect actual object/bone/image names before editing. Successful edits include checkpointId and previousCheckpointId. Read-only inspection/selection/validation does not advance revisions. Failures include code,message,tool,recovery,retryable,checkpointId when available, and rolledBack when the native bridge knows rollback completed. Codes: stale-input, unsupported, invalid-input, cancelled, time-budget, operation-failed. A rejected/cancelled action is not success. After interruption reopen the saved checkpoint and synchronize state. Do not claim automatic anatomy recognition, absent face controls, exhaustive validation or guessed scale.