This specification is valid for SN versions <= 423.
Data Type Versions Builds Description
32-bit signed int big-endian Any Any Stick Nodes version number. Must be between 0 and the latest version (inclusive).
32-bit signed int big-endian >=403 Any Build number
32-bit float big-endian Any Any Stickfigure scale
32-bit signed int big-endian Any Any Stickfigure color. See the color reference for more information.
Data Type Versions Builds Description
sequence of Node Any Any See Node for more information.
Data Type Versions Builds Description
32-bit signed int big-endian >=230 Any B = Number of polyfills
sequence with size of B of Polyfill >=230 Any See Polyfill for more information.
Data Type Versions Builds Description
32-bit signed int big-endian >=403 >=38 C = Number of connector connections
sequence with size of C of Connection >=403 >=38 See Connection for more information.
:: warning
The .stknds format is compressed when saved and decompressed when loaded to reduce its file size. It is compressed and decompressed using the GZIP compression and decompression algorithms with a buffer size of 4096. The following information assumes that the .stknds file is in its uncompressed state.
::
Data Type Versions Builds Description
32-bit signed int big-endian Any Any Stick Nodes version number
32-bit signed int big-endian >=401 Any Build number
32-bit signed int big-endian Any Any A = Length of project name (prob causes weird behavior or error if length of project name length is <= 0)
sequence with size of A of text bytes Any Any Project name
Data Type Versions Builds Description
8-bit unsigned byte >=401 >=16 Is YouTube short boolean
8-bit unsigned byte >=244 Any Watermark enabled boolean
32-bit signed int big-endian >=220 Any B = Length of watermark text (watermark text bytes are not read if this is <= 0)
sequence with size of B of text bytes >=220 Any Watermark text
32-bit signed int big-endian >=220 Any Watermark color. See Color for more information.
32-bit signed int big-endian Any Any FPS
32-bit signed int big-endian >=176 Any Number of tweened frames
8-bit unsigned byte >=127 Any Has shown loop message boolean
8-bit unsigned byte >=113 Any Has shown panning mode message boolean
8-bit unsigned byte Any Any Has shown tweening mode message boolean
8-bit unsigned byte >=220 Any Has shown magnifier message boolean
8-bit unsigned byte Any Any Tweening enabled boolean
8-bit unsigned byte >=127 Any Is loop boolean
8-bit unsigned byte >=140 && < 200 Any [empty byte]
Probably used to keep track of the last assigned unique ID(?)
Data Type Versions Builds Description
32-bit signed int big-endian Any Any Unique figure ID
32-bit signed int big-endian >=176 Any Unique textfield box ID
32-bit signed int big-endian >=300 Any Unique movieclip ID
32-bit signed int big-endian >=300 Any Frames container UID
Data Type Versions Builds Description
32-bit signed int big-endian >=400 Any C = Number of fonts to check if loaded? Does NOT include the default font. Should be equal to whatever the greatest index of all loaded fonts is.
sequence with size of C of 8-bit unsigned bytes (booleans) >=400 Any Loaded fonts booleans. See font booleans reference for the order of the booleans. Do NOT write a boolean for font index 0 (the default font)
Data Type Versions Builds Description
32-bit signed int big-endian >=300 Any D = Number of hidden stickfigure library IDs
sequence with size of D of 32-bit signed int big-endian >=300 Any Hidden stickfigure library IDs
Data Type Versions Builds Description
32-bit signed int big-endian >=300 Any E = Number of hidden movieclip library IDs
sequence with size of E of 32-bit signed int big-endian >=300 Any Hidden movieclip library IDs
Data Type Versions Builds Description
32-bit signed int big-endian >=400 Any F = Number of hidden sprite library IDs
sequence with size of F of 32-bit signed int big-endian >=400 Any Hidden sprite library IDs
Data Type Versions Builds Description
8-bit unsigned byte >=140 && <400 Any Background image enabled boolean
8-bit unsigned byte >=140 && <170 Any Some boolean related to bg image scaling? Something vaguely related to being strict 1920x1080 when false and scaling to canvas width and height when true?
32-bit float big-endian >=170 && <400 Any Scale background image x
32-bit float big-endian >=170 && <400 Any Scale background image y
32-bit signed int big-endian >=140 && <400 Any W = Background image width
32-bit signed int big-endian >=140 && <400 Any H = Background image height
sequence with size of (W * H ) of RGB888 >=140 && <400 Any Image data
Data Type Versions Builds Description
32-bit signed int big-endian Any Any G = Number of stickfigures in library
sequence of size G of Stickfigure Header Any Any See Stickfigure Header for more information.
Data Type Versions Builds Description
32-bit signed int big-endian Any Any H = Length of stickfigure name
sequence with size of H of text bytes Any Any Stickfigure name
Stickfigure Data Any Any See Stickfigure Data for more information.
Data Type Versions Builds Description
32-bit signed int big-endian >=160 Any I = Number of sounds
sequence with size of I of Sound Header >=160 Any See Sound Header for more information.
Data Type Versions Builds Description
32-bit signed int big-endian >=160 Any J = Length of sound name
sequence with size of J of text bytes >=160 Any Sound name
Data Type Versions Builds Description
32-bit signed int big-endian >=400 Any K = Number of sprites
sequence with size of K of Sprite Header >=400 Any See Sprite Header for more information
Data Type Versions Builds Description
32-bit signed int big-endian >=300 Any N = Number of movieclips
sequence with size of N of Movieclip Header >=300 Any See Movieclip Header for more information.
Data Type Versions Builds Description
32-bit signed int big-endian >=300 Any O = Length of movieclip name
sequence with size of O of text bytes >=300 Any Movieclip name
Movieclip Library Data >=300 Any See Movieclip Library Data for more information.
32-bit signed int big-endian >=300 Any Movieclip UID
Data Type Versions Builds Description
32-bit signed int big-endian Any Any P = Number of frames in project
sequence of Frame of length P Any Any See Frame for more information.
Data Type Versions Builds Description
32-bit signed int big-endian >=237 Any Q = Number of auto-cams
sequence with size of Q of Auto Camera >=237 Any See Auto Camera for more information.
Data Type Versions Builds Description
32-bit signed int big-endian >=319 Any R = Number of cached movieclips
sequence with size of R of Cached Movieclip >=319 Any See Cached Movieclip for more information.
:: warning
The .nodemc format is compressed when saved and decompressed when loaded to reduce its file size. It is compressed and decompressed using the GZIP compression and decompression algorithms with a buffer size of 4096. The following information assumes that the .nodemc file is in its uncompressed state.
::
Data Type Versions Builds Description
32-bit signed int big-endian Any Any Stick Nodes version number
32-bit signed int big-endian >=402 Any Build number
32-bit signed int big-endian Any Any A = Length of movieclip name (prob causes weird behavior or error if length of movieclip name length is <= 0)
sequence with size of A of text bytes Any Any Movieclip name
Data Type Versions Builds Description
32-bit signed int big-endian Any Any B = Number of frames
32-bit signed int big-endian Any Any C = Number of stickfigures
32-bit signed int big-endian >=400 Any D = Number of sprites
32-bit signed int big-endian Any Any E = Number of sounds
32-bit signed int big-endian Any Any F = Preview frame count
32-bit signed int big-endian Any Any W = Preview resolution width
32-bit signed int big-endian Any Any H = Preview resolution height
sequence with size of (W * H * F ) of RGBA8888 Any Any Preview image data
32-bit signed int big-endian Any Any FPS
32-bit signed int big-endian Any Any Number of tweened frames
8-bit unsigned byte Any Any Tweening enabled boolean
8-bit unsigned byte Any Any Tween loop protection enabled boolean
32-bit signed int big-endian Any Any Unique figure ID
Data Type Versions Builds Description
32-bit signed int big-endian Any Any G = Length of stickfigure name
sequence with size of G of text bytes Any Any Stickfigure name
Stickfigure Data Any Any See Stickfigure Data for more information.
Data Type Versions Builds Description
8-bit unsigned byte >=400 Any if 1 : H = sprite group source else if 0 : H = sprite source
32-bit signed int big-endian >=400 Any I = Length of sprite name
sequence with size of I of text bytes >=400 Any Sprite name
32-bit signed int big-endian >=400 Any Sprite ID?
if H == sprite group source : Sprite Group Library Data else if H == sprite source : Sprite Library Data >=400 Any See Sprite Group Library Data or Sprite Library Data for more information.
Data Type Versions Builds Description
32-bit signed int big-endian Any Any J = Length of sound name
sequence with size of J of text bytes Any Any Sound name
Data Type Versions Builds Description
32-bit signed int big-endian >=237 Any Start frame
32-bit signed int big-endian >=237 Any End frame
8-bit unsigned byte >=237 Any Is ease in boolean
8-bit unsigned byte >=237 Any Is ease out boolean
16-bit signed int (short) big-endian >=256 Any Interpolation ID
Color is represented by 4 bytes. They are as follows:
Data Type Description
8-bit unsigned int Alpha
8-bit unsigned int Blue
8-bit unsigned int Green
8-bit unsigned int Red
Defines the properties of a connector connection.
Data Type Versions Builds Description
32-bit signed int big-endian >=403 >=38 Draw order index of start node
32-bit signed int big-endian >=403 >=38 Draw order index of end node
Data Type Versions Builds Description
Data Type Versions Builds Description
Data Type Versions Builds Description
Data Type Versions Builds Description
Data Type Versions Builds Description
Data Type Versions Builds Description
32-bit float big-endian >=170 Any Camera scale
32-bit float big-endian >=170 Any Camera offset X (gets multiplied by App.assetScaling)
32-bit float big-endian >=170 Any Camera offset Y (gets multiplied by App.assetScaling)
32-bit float big-endian >=230 Any Rotation (degrees)
8-bit unsigned byte >=310 Any Is wobbling XY boolean
8-bit unsigned byte >=310 Any Is wobbling rotation boolean
8-bit unsigned byte >=310 Any Is wobble scale enabled boolean
32-bit signed int big-endian >=310 Any Wobble XY intensity
32-bit float big-endian >=170 Any Wobble rotation intensity
32-bit float big-endian >=170 Any Wobble speed
8-bit unsigned byte >=230 && <=kjdknclNJSCLqijfewiOIDJ :(
Data Type Versions Builds Description
Data Type Versions Builds Description
Data Type Versions Builds Description
Data Type Versions Builds Description
Data Type Versions Builds Description
32-bit signed int big-endian >=300 Any G = Number of destination containers
sequence with size of G of outer loop data >=300 Any See outer loop data for more information.
Data Type Versions Builds Description
32-bit signed int big-endian >=300 Any H = Number of source containers
32-bit signed int big-endian >=300 Any Destination container (timeline) UID
sequence with size of H of middle loop data >=300 Any See middle loop data for more information.
Data Type Versions Builds Description
32-bit signed int big-endian >=300 Any I = Number of ID mappings
32-bit signed int big-endian >=300 Any Source container (timeline) UID
sequence with size of I of inner loop data >=300 Any See inner loop data for more information.
Data Type Versions Builds Description
32-bit signed int big-endian >=300 Any Source container figure ID
32-bit signed int big-endian >=300 Any Destination container figure ID
When you paste a figure from one container to another, Stick Nodes converts the ID of the figure from the source container to an ID within the destination container. If the figure was never pasted to the destination container before, it will assign a new unique ID to the figure within the destination container. If the figure was previously pasted to the destination container, it looks at the ID conversion map to know what ID to assign the figure within the destination container.
For a visual aid to help understand ID conversion maps, see ID converstion maps visual aid .
You can imagine the map datatypes of an example ID conversion map like this:
{
int: {
int: {
int: int,
int: int,
},
int: {
int: int
}
},
int: {
int: {
int: int,
int: int,
int: int
}
}
}
For a visual of what each value could represent:
{
ID_of_main_animation_container: {
ID_of_movieclip_1_container: {
ID_of_figure_1_when_in_movieclip_1: ID_of_figure_1_when_in_main_animation,
ID_of_figure_2_when_in_movieclip_1: ID_of_figure_2_when_in_main_animation,
},
ID_of_movieclip_2_container: {
ID_of_figure_1_when_in_movieclip_2: ID_of_figure_1_when_in_main_animation
}
},
ID_of_movieclip_1_container: {
ID_of_main_animation_container: {
ID_of_figure_1_when_in_main_animation: ID_of_figure_1_when_in_movieclip_1,
ID_of_figure_2_when_in_main_animation: ID_of_figure_2_when_in_movieclip_1,
ID_of_figure_3_when_in_main_animation: ID_of_figure_3_when_in_movieclip_1
}
}
}
For an idea of what actual data might look like:
{
0: {
1: {
420: 69,
1: 3,
},
2: {
20: 20
}
},
1: {
0: {
1: 3000,
343: 222,
10: 8
}
}
}
Data Type Versions Builds Description
32-bit float big-endian >=300 Any Frame sound volume
32-bit float big-endian >=310 Any Frame sound pan
32-bit float big-endian >=310 Any Frame sound pitch
32-bit float big-endian >=300 Any Frame sound library ID
32-bit signed int big-endian >=300 Any V =
sequence with size of V of movieclip frame asset data >=300 Any See movieclip frame asset data for more information.
Data Type Versions Builds Description
32-bit signed int big-endian >=300 Any Library stickfigure ID
Data Type Versions Builds Description
32-bit signed int big-endian Any Any Stickfigure ID
32-bit float big-endian Any Any Stickfigure scale
32-bit float big-endian >=220 Any Stickfigure transparency
32-bit float big-endian >=220 Any Blur
8-bit unsigned byte >=401 >=16 Is motion blur boolean
8-bit unsigned byte >=401 >=16 Motion blur is one direction boolean
32-bit signed int big-endian >=401 >=16 d,nvsakf
Data Type Versions Builds Description
Data Type Versions Builds Description
Data Type Versions Builds Description
32-bit signed int big-endian >=300 Any Library sprite group ID
Data Type Versions Builds Description
32-bit signed int big-endian >=300 Any Library sprite ID
Data Type Versions Builds Description
32-bit signed int big-endian >=300 Any U = Number of frames
32-bit signed int big-endian >=300 Any Movieclip FPS
32-bit signed int big-endian >=300 Any Movieclip number of tweened frames
8-bit unsigned byte >=300 Any Movieclip tweening enabled boolean
8-bit unsigned byte >=300 Any Movieclip tween loop protection enabled boolean
32-bit signed int big-endian >=300 Any Movieclip unique figure ID
sequence with size of U of movieclip frame data >=300 Any See movieclip frame data for more information.
Data Type Versions Builds Description
8-bit signed byte Any Any Node type. See the node types table for more information. Main node must be -1.
32-bit signed int big-endian Any Any Draw order index. lesser = behind, greater = in front. Acts as ID for node. Every node must have a unique draw order index. Main node must be 0.
8-bit unsigned byte Any Any Is static boolean
8-bit unsigned byte Any Any Is stretchy boolean
8-bit unsigned byte >=403 >=48 Is floaty boolean
8-bit unsigned byte >=248 Any Is smart stretch boolean
8-bit unsigned byte >=252 Any Do not apply smart stretch boolean
8-bit unsigned byte >=403 >=50 Smart stretch, reset impulse boolean
8-bit unsigned byte Any Any Use segment color boolean
8-bit unsigned byte >=256 Any Use circle outline boolean
8-bit unsigned byte >=403 >=21 Circle is hollow boolean
8-bit unsigned byte >=176 Any Use gradient boolean
8-bit unsigned byte >=176 Any Reverse gradient boolean
16-bit signed int (short big-endian) >=403 >=20 Gradient mode
8-bit unsigned byte Any Any Use segment scale boolean
32-bit float big-endian Any Any Local X. The X offset from the parent node. Positive in rightward direction, negative in the leftward
32-bit float big-endian Any Any Local Y. The Y offset from the parent node. Positive in upward direction, negative in the downward direction
32-bit float big-endian Any Any Scale
32-bit float big-endian Any Any Default length
32-bit float big-endian Any Any Length
32-bit signed int big-endian Any Any Default thickness
32-bit signed int big-endian Any Any Thickness
32-bit signed int big-endian >=320 Any Segment curve radius & default curve radius
8-bit unsigned byte >=403 >=20 Curve “circulization” (circularization) boolean
16-bit signed int (short) big-endian >=403 >=21 Segment curve polyfill precision
8-bit unsigned byte >=256 Any Half-arc boolean
16-bit signed int (short) big-endian >=256 Any Right triangle direction
8-bit unsigned byte >=300 Any Triangle upside-down boolean
if build < 64 : 32-bit signed int big-endian else: 32-bit float big-endian>=403 >=36 Trapezoid thickness 1
if build < 64 : 32-bit signed int big-endian else: 32-bit float big-endian>=403 >=36 Trapezoid thickness 2
32-bit signed int big-endian >=403 ==36 [unused]
32-bit signed int big-endian >=403 ==36 [unused]
8-bit unsigned byte >=403 ==36 Use trapezoid thickness 1 boolean (I think?)
8-bit unsigned byte >=403 ==36 Use trapezoid thickness 2 boolean (I think?)
32-bit float big-endian >=256 !=36 Trapezoid top thickness ratio
8-bit unsigned byte >=403 >=36 Trapezoid is rounded 1 boolean
8-bit unsigned byte >=403 >=36 Trapezoid is rounded 2 boolean
16-bit signed int (short) big-endian >=256 Any Number of polygon vertices
32-bit float big-endian >=248 Any Default local angle
32-bit float big-endian Any Any Local angle
32-bit float big-endian >=248 Any Default angle
32-bit signed int big-endian Any Any Color. See Color for more information.
32-bit signed int big-endian >=176 Any Gradient color. See Color for more information.
32-bit signed int big-endian >=256 Any Circle outline color. See Color for more information.
8-bit unsigned byte >=403 >=39 Is angle locked boolean. If build <= 50, forced to false.
32-bit float big-endian >=403 >=39 && <=50 [unused]
8-bit unsigned byte >=403 >=51 Angle lock is main node boolean. If build < 56, 0 means true.
32-bit float big-endian >=403 >=51 && <=56 The number being subtracted from to calculate the angle lock offset. (in 10 - 5, it would be 10).
32-bit float big-endian >=403 >=51 && <=56 The number being subtracted to calculate the angle lock offset. (in 10 - 5, it would be 5).
32-bit float big-endian >=403 >=57 Angle lock offset
32-bit float big-endian >=403 >=63 Angle lock relative start
32-bit float big-endian >=403 >=67 Angle lock stickfigure start
8-bit signed byte >=403 >=63 Angle lock relative multiplier
if build <= 40 : 16-bit signed int (short) big-endian else: 8-bit unsigned byte>=403 >=39 Is drag locked boolean
16-bit signed int (short) big-endian >=403 >=41 && <=45 [unused]
32-bit float big-endian >=403 >=46 Drag lock angle
32-bit float big-endian >=403 >=41 Smart stretch multiplier
8-bit unsigned byte >=403 >=41 && <=45 [unused]
32-bit signed int big-endian Any Any A = Number of child nodes
sequence with size of A of 32-bit signed int big-endian >=403 >38 Sequence of ints representing booleans for whether each corresponding node is a connector
sequence with size of A of Node Data Any Any See Node Data for more information.
Data Type Description
32-bit signed int big-endian Draw order index of parent node (becomes the anchor node)
32-bit signed int big-endian Color. See the color reference for more information.
8-bit unsigned byte Use polyfill color boolean
32-bit signed int big-endian C = Number of polyfill nodes (not counting the anchor node)
sequence with size of C of 32-bit signed int big-endian The draw order index of each node that the polyfill is attached to, in order.
Data representing the state of where the user left off in their last session in the project when saving.
Data Type Versions Builds Description
32-bit signed int big-endian >251 Any Frame index
32-bit float big-endian >251 Any Guideline X (gets multiplied by App.assetScaling)
32-bit float big-endian >251 Any Guideline Y (gets multiplied by App.assetScaling)
32-bit float big-endian >251 Any Zoom
32-bit float big-endian >251 Any Zoom position x (gets multiplied by App.assetScaling)
32-bit float big-endian >251 Any Zoom position Y (gets multiplied by App.assetScaling)
32-bit signed int big-endian >251 Any UV quality
8-bit unsigned byte >=300 Any Only draw main nodes boolean
8-bit unsigned byte >=300 Any Show figure IDs boolean
8-bit unsigned byte >251 Any Onion skin is normal boolean
8-bit unsigned byte >251 Any Is showing outline boolean
8-bit unsigned byte >=300 Any Is showing outline creative boolean
8-bit unsigned byte >=310 Any Is showing neighbor nodes boolean
8-bit unsigned byte >=310 Any Is showing neighbor nodes creative boolean
8-bit unsigned byte >251 Any Is showing guides boolean
Data Type Description
32-bit signed int big-endian A = Number of sprite group state library IDs
sequence with size of A of 32-bit signed int big-endian Sprite group state library ID
Data Type Builds Description
8-bit unsigned byte Any A = Sprite is transparent boolean
8-bit unsigned byte Any Sprite is anti-alias boolean
32-bit float big-endian Any Sprite default origin X
32-bit float big-endian Any Sprite default origin Y
32-bit float big-endian Any Sprite internal scale X
32-bit float big-endian Any Sprite internal scale Y
8-bit unsigned byte >=9 Sprite has raw rgb data boolean
32-bit signed int big-endian Any Sprite image width
32-bit signed int big-endian Any Sprite image height
32-bit signed int big-endian Any B = Number of sprite pixels
sequence with size of B of if A == true : RGBA8888 bytes else if A == false : RGB888 bytes Any See RGBA8888 bytes or RGB888 bytes for more information.
Font Index Font Name
0 default
1 Coolvetica
2 Be Kind to the Earth
3 Enchanted Land
4 Capture It
5 VCR OSD Mono
6 Asian
7 Moon Runes
8 Yolks Emoticons
9 Andy Bold
10 Digital Play
11 Parametric Glitch
12 Pusaba
13 Sugar and Vinegar
14 Typo Round
15 international
16 Determination
17 Comic Sans
18 Impact
Each node type is represented by an integer. They are as follows:
Integer Node Type
-1 main node
0 rounded segment
1 segment
2 circle
3 triangle
4 filled circle (automatically converted to circle with an outline)
5 ellipse
6 trapezoid
7 polygon