Maintenance script: BlockyRenderer wiki

2026-10-20T21:29:19Z

BlockyRenderer wiki

New page

The preview plays <code>.blockyanim</code> animations on the matching model. It opens the same way as for a model: automatically, with the title bar button, <code>Ctrl+K V</code> or <code>Ctrl+Shift+V</code>.

[[File:BlockyRenderer_Screenshot_02.png|800px|center|An animation playing on its model, with the timeline at the bottom]]

== Which model is used ==
An animation file does not name a model. The extension searches for one in two ways:
* '''Server JSON files''' that name a model and an animation in the same file. It reads all <code>.json</code> files under <code>Server/Models/</code> and <code>Server/Item/Items/</code>, for example <code>AnimationSets</code> or <code>CustomModelAnimation</code> entries. Player animations in item files (<code>FirstPerson</code>, <code>ThirdPerson</code>, <code>ThirdPersonFace</code>, <code>ThirdPersonMoving</code>) are skipped, because they move the player and not the item.
* '''Folders''': models in the folder of the animation and in every folder above it, each also in a <code>Models</code> subfolder.

All candidates are then ranked:
# the share of animated nodes the model has (node names are compared),
# models named in a server JSON before the others,
# models closer to the animation before models further up,
# the shorter file name, which is usually the base model (<code>Player</code> before <code>Player_With_Face</code>),
# the path.

The files under <code>Server/Models/</code> are read first. The many item files are read in the background. If a clearly better model turns up later, the preview switches to it on its own, unless you chose a model by hand.

== Model list ==
In the preview of an animation, ''Model'' at the top lists the candidates, the best first (up to 40). If a model does not have all animated nodes, the share is shown, for example <code>Frog/Models/Frog · 80%</code>. While the search is still running, the list shows ''Searching…''.

''Other model…'' opens a quick pick with the matching models first and all other models of the workspace below. A model you choose by hand is stored for this animation in the workspace and used from then on.

If no model is found, the preview shows ''No matching model was found for this animation.'' and a '''Choose Model…''' button.

== Animation list ==
In the preview of a model, ''Animation'' lists the animations that belong to it:
* animations named together with the model in a server JSON,
* animations you paired with the model by hand,
* animations in the folder of the model and its subfolders. If the model lies in a <code>Models</code> folder, the folder above it counts.

''(no animation)'' stops the animation. ''Other animation…'' (or ''More animations… (n)'' if the list is longer than 60) searches all animations of the workspace. If you pick an animation from outside the list, it is paired with this model, and this model also becomes the stored model for that animation.

The Blocky Editor has no animation list.

== Timeline ==
The timeline at the bottom appears when an animation is loaded.
{| class="wikitable"
! Control !! What it does
|-
| ▶ / ⏸ || Plays and pauses.
|-
| Slider || Jumps to a point in time. Moving it pauses playback.
|-
| Time || Current frame, total frames and seconds, for example <code>61 / 120 · 1.03 s</code>. Animations run at 60 frames per second.
|-
| Speed || <code>0.25×</code>, <code>0.5×</code>, <code>1×</code> or <code>2×</code>.
|-
| ''Loop'' || Starts over at the end. When an animation is loaded, it is on if <code>holdLastKeyframe</code> is <code>false</code>.
|}

=== Keys ===
These keys work while the timeline is shown and the focus is in the 3D view:
{| class="wikitable"
! Key !! Action
|-
| <code>Space</code> || Play or pause
|-
| <code>←</code> / <code>→</code> || One frame back or forward (pauses)
|-
| <code>Shift+←</code> / <code>Shift+→</code> || Ten frames back or forward
|-
| <code>Home</code> || Jump to the start
|-
| <code>End</code> || Jump to the end (pauses)
|}

== Missing nodes ==
If the animation moves nodes the model does not have, the timeline shows <code>⚠ n of m nodes missing</code>. Hover over it to see the names (up to 20). This is common in vanilla files: many animations have tracks for nodes that no longer exist in the model.

== Text and 3D ==
* '''Cursor in the animation text''': the node of the track at the cursor is outlined in the 3D view. If several nodes share the name, the first one is shown.
* '''Click in the 3D view''': the tracks of the clicked node are selected in the animation text, if it has any.
* Changes to the animation text apply at once, also unsaved ones. The playback position stays where it is.

== What is played ==
All five tracks of the format are played: position, rotation, stretch, visibility and UV offset. A UV offset moves the texture of a shape, which is how flames run through a texture strip. Details are on [[BlockyRenderer:File Format|File Format]].

{{BlockyRenderer Nav}}

BlockyRenderer:Animations - Revision history

Maintenance script: BlockyRenderer wiki