Skip to content

model

Re-renders an entity’s own model with an effect material.

Field Type Default Description
type "model" required Track type.
name string Optional name, used in error messages.
start number 0 When the track starts, in seconds.
end number -1 When the track ends, in seconds. Defaults to the end of the effect; looping effects run forever.
at attach Where the track sits.
material material How the track is shaded.
model "self" | "target" "self" Whose model to draw.
hide_original boolean false Hide the entity’s normal rendering while the track runs.
shadow boolean true Keep the hidden entity’s shadow, on the ground and in a shaderpack’s shadows. Turn it off when the copy moves away from the entity, such as halves falling apart; shatter always leaves it off.
snapshot boolean false Freeze the pose at the track start. The copy outlives the entity.
offset vector [0,0,0] Offset of the copy, in the entity’s frame.
scale number 1 Scale of the copy around the entity’s feet.
inflate number 0 Push the surface out along its normals, in blocks.
color color "#ffffff" Tint over everything.
mask mask The travelling front.
layers list of layer Surfaces behind the front, nearest first. Defaults to the entity’s own texture.
edge edge A glowing rim along the front.
afterimages afterimages Copies left behind as the entity moves.
deform deform Swelling, bulging, ripples and melting.
slice slice Cut the model in two along a plane.
shatter shatter Break the model into flying chunks.

A front that travels across the model.

Field Type Default Description
mode "none" | "point" | "plane" | "bones" | "noise" "none" point measures distance from origin, plane along axis, bones along the skeleton from root, noise is a pure dissolve, none shows everything.
origin attach Mask origin for point and plane.
axis vector [0,1,0] Sweep direction for plane, in the entity’s frame.
root string "body" Bone the bones mode starts from; falls back to the model root.
progress number 0 How far the front has travelled, in blocks. Animate it, for example with a curve over the track.
noise number 0.12 How ragged the front is, in blocks.
noise_scale number 5 Frequency of the ragged edge.
invert boolean false Show what the front has not reached instead: growth becomes disintegration.

A surface shown behind the mask front.

Field Type Default Description
width number 0 How far behind the front this layer lasts, in blocks. The last layer lasts forever.
texture string "entity" entity for the model’s own texture, or a texture id that tiles across the model.
tiling number 4 How many times a tiling texture repeats per model texture.
color color "#ffffff" Tint.
glow number 0 Bloom strength.
shine number 1 Scales the material’s specular highlight on this layer: 0 for dry skin, 1 or more for wet tissue.

A glowing rim along the mask front.

Field Type Default Description
width number 0.06 Width of the glowing rim at the front, in blocks.
color color "#ff6a2a" Rim colour.
glow number 1.5 Rim bloom strength.

Frozen copies left behind as the entity moves.

Field Type Default Description
count integer 4 Copies left behind.
interval number 0.06 Seconds between copies.
life number 0.3 Seconds each copy lasts while it fades.

Bends the model’s surface on the graphics card: swelling, a bulge around a bone, ripples, melting.

Field Type Default Description
swell number 0 Pushes the whole surface out along its normals, in blocks.
bulge_at attach Where the bulge swells from; give it a bone such as right_arm:center for a flexing muscle or growth.
bulge number 0 How far the surface around bulge_at swells, in blocks.
bulge_radius number 0.35 Reach of the bulge, in blocks.
ripple number 0 Height of waves running over the surface, in blocks.
ripple_size number 0.4 Distance between ripple crests, in blocks.
ripple_speed number 3 How fast the ripples travel.
melt number 0 0..1: the model sags toward the ground and spreads into a puddle; unevenly, so it drips.
spread number 0.6 How wide a melting model spreads at the bottom.

Cuts the model in two along a plane; the halves can part, tip and fall.

Field Type Default Description
origin vector [0,1,0] A point on the cut, in blocks from the entity’s feet, in its frame.
normal vector [1,0.2,0] Direction the cut faces, in the entity’s frame: [1, 0, 0] splits left from right, [0, 1, 0] top from bottom.
gap number 0 How far apart the halves move, in blocks.
tilt number 0 Degrees each half tips away from the cut.
drop number 0 How far the half on the normal side slides down, in blocks.
cap_color color "#b0141a" Colour of the inside where the model is cut open; values above 1 glow.

Freezes the model and breaks it into chunks that burst apart, tumble and fall.

Field Type Default Description
pieces integer 24 How many chunks, up to 64.
size number 0.125 Faces are cut into squares this many blocks wide before chunking, so chunks have ragged edges.
origin vector [0,1,0] Centre of the burst, in blocks from the entity’s feet, in its frame.
time number "age" Seconds since the model broke; chunks fly while it rises. Hold it to freeze the burst.
force number 3 Outward speed, in blocks per second.
lift number 2 Extra upward speed, in blocks per second.
spin number 360 Tumbling speed, in degrees per second.
gravity number 12 Pull down, in blocks per second squared.
inner_color color "#3a0a0a" Colour of the chunks’ insides.