io.github.kendall8388/keyframe

Apply bone transforms at a time in the active clip. Validates all names and values before editing. Use build_animation for a whole clip.

Build a complete clip atomically. Partial transforms carry forward from setup. loop:true copies the first pose to the end. replace:true replaces a clip and all its tracks. FPS is project-wide.

Call a scripting method using positional arguments. Read keyframe_methods first. Mutations are saved; image results appear inline.

Check endpoint discontinuities, sampled invisible parts and rig problems. Warnings can be intentional; also review rendered frames.

Set clip duration and project FPS. Rejects shortening past keys/events.

Show sampled frames with timestamps, empty frames and edge-touch warnings. Uses a fixed camera fitted to the clip; warnings indicate possible clipping.

Atomically add text or embedded image layers, edit properties/text, reorder or delete layers. Updates composite and editable layers. Close the human image editor first.

Write an editable project JSON, animated GIF or Spine ZIP to disk. Returns an MCP resource and local path. Spine ZIP includes atlas, textures and a preview.

Show one image layer as a PNG.

List editable image layers and stable IDs in bottom-to-top order.

List projects saved in this connector profile.

List scripting methods; read recipes through keyframe_call for rigging workflows.

Open or resume a saved editor session in a dedicated Chrome profile. Call first; waits for project restoration.

Save the active project and open a saved project by ID.

Save the project and show it in visible Chrome with the connector profile. Export project JSON to transfer to your usual browser.

Wait for the active project to commit to browser storage.

Show the editor UI. Prefer contact sheets to assess animation.

Read active project, readiness and revision. Supply expected to edit tools to reject stale edits.

Give a held prop (axe, sword, shield, staff) its own rigid bone under parent (usually a hand). Works on a rig draft or on a model already rigged (MeshForge or Meshy). The selection grows along the prop automatically; check with meshforge_render_rig (draft) or meshforge_contact_sheet.

How to write an animation spec (aim/rot/root/ease, grounding, anatomy, timing) plus the skeleton. Read before meshforge_build_animation.

Build the bones and automatic skin weights from the draft: method "heat" (bone heat, as Blender's automatic weights; default) or "nearest" (quicker). Existing animations are retargeted where the skeletons can be matched. Returns a weight check; then meshforge_flex_test.

Keyframe spec → animation on the open rig, played at once. Bones take {aim:[x,y,z], twist} (point the bone that way, character space), {rot:{yaw,pitch,roll}} (degrees from rest) or {rest:true}. root.move [x,y,z] metres (feet are kept on the floor; y = jump height). Returns warnings and measurements. replace:true overwrites a clip of the same name.

Call any window.meshforge method with positional arguments. Read meshforge_methods first. Images appear inline; exports become files.

Frames of an animation from the front and side (or other views) in one labelled image: the way to judge motion.

Write the open model with every animation as a .glb to disk.

Find skin that follows the wrong limb (a hand moving part of a foot) and hand it to the bone it sits by. Returns what was fixed and a fresh check.

Add a temporary clip (not saved) bending each limb, the spine, head and tail in turn; then meshforge_contact_sheet {animation:"Flex test", samples:12} to spot bad weights.

Image → textured 3D model on the user's own fal.ai key (PAID unless MeshForge is in demo mode: ask the user first and pass confirmCost:true). image: a local PNG/JPEG/WebP path. Then meshforge_wait.

Add a .glb from the local disk to the library and open it.

Numbers for an animation: feet vs floor, foot sliding, loop gap, which bones move, hips travel.

List every MeshForge scripting method (window.meshforge) with arguments, plus recipes. Reach methods without a named tool through meshforge_call.

The MeshForge library in this connector profile: id, name, label (how it was made), status.

Open MeshForge (3D models: rig in the browser, animate from keyframe specs, prop bones, sprite sheets) in the connector profile, optionally opening a library model by id or name. A new profile starts with the example orc (rigged, 18 clips). Call first.

Open a library model in the viewer by id or name.

Save (if changed) and show MeshForge in visible Chrome with the connector profile, so the user can keep working.

Free ready-made motion fitted to the open rig: cycles walk | run | idle (bipeds, four-legged rigs, tails) and actions punch | swipe | kick | hit | jump | death | taunt (two-legged rigs). Multipliers speed, stride, arms (for actions: strength), bounce, tail (1 = default). Returns measurements.

Free polygon reduction in the browser to about `triangles` (UVs, textures, rig weights and animations carry over); maxTexture (e.g. 2048) also scales textures down. Then meshforge_save with asNew:true to keep it as a copy.

Free remesh: rebuild the open model as one clean, even mesh of about `triangles` (default 30000) with fresh UVs and its texture baked across (texSize 1024 | 2048 | 4096). Drops any rig: rig it again after. Then meshforge_save with asNew:true.

One picture of the open model, optionally at a time in an animation, from a view (default threeQuarter).

The model from the front and side with the draft joints drawn on it over a measuring grid (read coordinates off it). Props show purple; pass select to preview a selection in orange.

Save the open model (rig and animations) to the MeshForge library. A model saved from MeshForge before is updated; a generated or imported one gets a new entry.

Show the MeshForge page. Prefer meshforge_contact_sheet or meshforge_render_rig to judge work.

Move draft joints: {jointName: [x, y, z]} in character space. mirror (default true) moves the left/right twin too. Joints belong INSIDE the body.

The open model's bones: name, parent, role, joint position and rest aim, in character space (+x right, +y up from the floor, +z forward; metres).

Rig the open model in the browser (free): a template skeleton (humanoid, humanoid_tail for lizard/shark folk, quadruped or chain) fitted to the mesh. Over ~150k triangles, meshforge_reduce first. facing: which way the model looks in its own space. Then meshforge_render_rig.

The open model (rigged? bone count, height), its animations, what is playing, any rig draft, unsaved changes.

Wait for a generation job to finish (up to timeout seconds), then meshforge_open_model.

Call any window.spritePuppeteer method with positional arguments. Read puppeteer_methods first. Image results appear inline; exports become files.

A labelled grid of a move's frames (cells about 220 px): the way to judge a move. Defaults to the current move.

Rigged characters: add a keyframed move. keys list only channels that differ from rest; a loop flows back to its first key. replace: an existing custom move id to overwrite (keeps its id and hotkey).