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. |
afterimages
Section titled “afterimages”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. |
deform
Section titled “deform”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. |
shatter
Section titled “shatter”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. |
