ryan
36032ebb1e
- Introduced a new artist agent to create and review vector, raster, clothing, prop, and animation assets based on user prompts or reference images. - Created an asset-creation skill to manage the delegation, review, approval, and handoff processes for graphical assets and animations. - Added project format routing documentation to guide asset creation and ensure consistency in Stickman Studio. - Established a review workflow for asset promotion, ensuring thorough validation and user approval before finalizing assets. - Documented the specifications for scenery, backgrounds, and vector surface finishes to enhance the child experience in the Sandbox Stage.
36 lines
2.2 KiB
Markdown
36 lines
2.2 KiB
Markdown
# Project asset format routing
|
|
|
|
Inspect these sources at execution time; do not copy their schemas into prompts because the formats evolve.
|
|
|
|
## Stickmen and embedded clothing
|
|
|
|
- Serializer and current version: `scripts/editors/stickman/stickman_editor.gd`
|
|
- Runtime conversion: `scripts/characters/stickman/stk_rig_adapter.gd`
|
|
- Rig target: `scenes/characters/stickman/stickman_rig.tscn`
|
|
- Representative current assets: `content/stickmen/*.stk` (confirm the version before choosing a sample)
|
|
- Visual harness: `scenes/tools/test_harness.tscn`
|
|
|
|
An `.stk` owns ten body-part records and may contain multiple layered shapes per part. Clothing uses those layers until the project defines a separate wardrobe format. Preserve joint alignment, guide offsets, pivots, length metadata, body-part transforms, shape ordering, and the serializer's current version contract.
|
|
|
|
## Props
|
|
|
|
- Serializer/parser: `scripts/editors/prop/prop_file.gd`
|
|
- Anchor normalization: `scripts/props/prop_anchor_data.gd`
|
|
- Runtime visual/collision interpretation: `scripts/props/prop_visuals.gd`
|
|
- Representative assets: `content/props/*.prop`
|
|
- Visual editor: `scenes/editors/prop/prop_editor.tscn`
|
|
|
|
Use current `PropFile` output, including shape styling and normalized anchors. Ensure at least one valid closed shape can provide runtime collision geometry when the prop is intended for stage use. Lines are visual/editor shapes and do not supply collision geometry.
|
|
|
|
## Animation
|
|
|
|
- Rig scene: `scenes/characters/stickman/stickman_rig.tscn`
|
|
- Existing authoring tool: `scripts/tools/create_animations.gd`
|
|
- Playback behavior: inspect the relevant component under `scripts/characters/stickman/`
|
|
|
|
Stickman animations target the current rig's IK or animation targets, not `.stk` shape coordinates. Match the runtime clip name and locomotion/facing contract from the approved specification. For animated props, use only a representation already defined by the feature; otherwise return art direction, states, and timing requirements for architecture.
|
|
|
|
## PNG art
|
|
|
|
Use the `imagegen` skill for generated or edited raster art. Preserve alpha when transparency is requested. Approved PNGs go into the narrowest fitting `resources/` category; create a new `resources/art/<feature-or-kind>/` folder only if no current category fits.
|