Skip to content

Material

Materials can be written inline on a track or saved as assets in assets/<namespace>/kinesis/materials/<path>.json and referenced by id.

A material, inline or as an asset.

Field Type Default Description
parent string A material asset to start from; fields here override it.
texture string Texture id. kinesis:soft style ids resolve to textures/fx/<name>.png; full paths ending in .png are used as is. Each track type picks a sensible default.
frames vector [1,1,0] Flipbook layout as [columns, rows]. Particles pick frames by life, randomly, or at fps.
fps number 0 Flipbook speed in frames per second; 0 plays over life.
blend "add" | "alpha" | "cutout" | "opaque" "add" How the material combines with the scene.
color color "#ffffff" Tint multiplied with the texture.
alpha number 1 Opacity multiplier.
glow number 0 How strongly the material feeds Kinesis’s bloom. 1 is a clear glow; values above 2 bloom heavily.
gradient color "#ffffff" Gradient map: replaces colour by looking this gradient up with gradient_by.
gradient_by "luma" | "alpha" | "life" | "u" | "v" | "fresnel" "luma" What drives the gradient map.
scroll vector [0,0,0] Texture scroll speed as [u, v] per second.
noise noise Animated noise.
dissolve dissolve Noise-driven erosion.
fresnel fresnel Rim lighting for meshes and models.
shading shading Lights meshes, ribbons and model layers like solid, wet or translucent surfaces.
soft number 0 Fades the material out over this many blocks where it meets the world, hiding hard intersections.
distortion number 0 Turns the material into heat haze: the scene behind is warped by this much. Colour is ignored.
lit boolean false Darken with the world light level.
cull boolean false Hide back faces.
depth_test boolean true Hide behind world geometry.
shader string A custom core shader, assets/<ns>/shaders/core/<path>.json, using the Kinesis vertex format.
uniforms uniforms Extra float uniforms for a custom shader: name to number or expression.

Animated noise on the material.

Field Type Default Description
scale number 2 Noise frequency across the texture.
scroll vector [0,-0.5,0] Noise scroll speed as [u, v] per second.
strength number 0.5 How much the noise breaks up the alpha.
distort number 0 How much the noise warps the texture lookup.

Erodes the material through noise.

Field Type Default Description
amount number 0 0 is whole, 1 is gone. Animate it with a curve or t.
edge number 0.08 Width of the burning edge.
edge_color color "#ff7a1a" Colour of the burning edge; values above 1 glow.
scale number 3 Noise frequency.

Brightens or fades surfaces seen edge-on.

Field Type Default Description
power number 3 Sharpness of the rim.
strength number 1 Brightness of the rim.
color color "#ffffff" Rim colour.
fade boolean false Fade the centre out instead of adding a rim (hologram look).

With a custom shader, Kinesis fills the same uniforms as its own effect program (Tint, MatParams, Frames, NoiseA, NoiseB, DissolveA, DissolveColor, FresnelA, FresnelColor, GradientMode, Depth) plus any named under uniforms.