Puppet Forge rev 520

Back to tools

Atlas-backed rig and keyframe editor. The preview now samples the same animation JSON module as the game, so edits are made in rig-space values rather than a second procedural imitation.

Workspace

Editor mode

View zoom: 100%

Character

Known project

Project JSON URL

Accepts a character definition, rig manifest, or atlas manifest. Rig/atlas URLs resolve to their matching character project when one exists.

URL project: assets/ct_char_wizard_1.json

Metadata

Label Icon

Description

Default hitbox width Default hitbox height

Default render scale Health

Artwork offset X Artwork offset Y

Locomotion AI strategy

All defaults JSON

Animation

Animation slot

Animation ID Duration (seconds)

Base cycles / second Speed cycles / second

Maximum speed ratio Idle threshold

Preview speed

Animation may be mirrored Frame-based animation: exactly one frame is visible at a time

With alpha preview on, parts use their in-game opacity. With it off, the selected part is fully opaque while other parts are ghosted between 10% and 50%, making rear and hidden parts easier to position and select.

New animation slot

Duplicate current creates a new in-memory animation file and adds its slot to the character definition. Download both changed JSON files to keep the new clip.

Keyframe

Rig part Property

Key time Key value

Interpolation after key

For X, Y and Angle mode, drag inside the selected yellow rectangle to move the part and drag a yellow corner handle to rotate it. When a parent pivot constraint is active, dragging inside the part moves its cyan parent point instead; X/Y tracks are read-only and regenerated automatically. Drag a diamond in the bottom timeline to move its editable key time. For single properties, edit the numeric value directly; typing at an unkeyed playhead creates a key automatically.

Rigging

Pivot X Pivot Y

Setup offset X Setup offset Y

Base scale Target height

Color Exchange

Apply GIMP-compatible Color Exchange to this part

From color To color

Red threshold Green threshold Blue threshold

Threshold 0.0 changes only an exact channel match. Threshold 1.0 accepts the complete channel range. Alpha is preserved, and the recolored sprite is generated once and cached.

Parent pivot constraint

Pin this part's pivot to a parent part

Parent rig part

Parent point X Parent point Y

The selected part's existing pivot is pinned to this normalized point on its parent. X/Y animation tracks are generated automatically; rotation and scale remain independent.

Projectile handoff

This rig part becomes a gameplay projectile Use this projectile part for the current character variant

Projectile ID Launch type

Animation slot Release time (seconds)

The projectile remains animation-controlled before Release time. At that time the game copies its sampled world position, hides the rig part, and gives the projectile to the simulation. The final keyed time is shown only as a reference. Pathing modes are reserved for a later obstacle-planning pass.

Draw order runs from back to front. The first part is drawn lowest; the last part is drawn on top.

Pivot and target height define shared sprite geometry. Setup offsets and base scale are still used by the current procedural airborne poses and as rig defaults, but a data-driven clip such as Run supplies its own absolute X, Y, and scale values while that clip is playing.

Load project files

Select a complete folder or a portable group of files. Puppet Forge resolves the references inside the character, rig, atlas, and animation JSON in memory; browsers never grant silent folder access.

Project files Project directory, where supported

Character JSON Rig JSON Atlas JSON Atlas PNG

Animation JSON files

Enemy Catalog JSON

This is the complete ct_enemies_001.json document. The visual enemy-default controls above edit the selected entry in this JSON.

Character JSON

Rig JSON

Atlas JSON

Use Atlas parts mode to author frame rectangles directly over the selected PNG. The JSON remains available for exact inspection and advanced edits.

Animation JSON

Reference

Load a local MP4 behind the rig as a temporary animation reference. The visible video moment follows the animation playhead while playing, pausing, scrubbing, stepping, changing preview speed, and looping. The file and all alignment settings remain only in this browser tab and are never written to character, rig, atlas, or animation JSON.

MP4 reference clip

No motion reference loaded.

Video time offset (seconds)

X offset Y offset from ground

Width at 100% zoom Height at 100% zoom

Opacity45% Show video behind the rig Loop video when its end is reached

The video is bottom-aligned to the cyan ground guide and follows canvas zoom, pan, and facing.

Full dopesheet