Scale Type (Data Type)

A namespaced ID naming one axis of an entity's size. Every entity has a value for each one, and every value starts at 1.

A scale type is written like apoli:base. A pehkui: namespace resolves to the matching Apoli type, so IDs copied from a Pehkui pack keep working.

Scale types

Each type multiplies the ones listed under "Built from", so apoli:base is the one value that moves everything.

Because apoli:falling is built from 1 ÷ apoli:motion, a bigger entity takes more fall damage and a smaller one takes less, without any extra setup.

apoli:held_item isn't built from apoli:base on purpose. In third person the item is drawn inside the entity's model, so it already follows apoli:model_width and apoli:model_height, and apoli:held_item is the extra multiplier on top. It is also the only thing that sizes the item in first person. apoli:held_item_mainhand and apoli:held_item_offhand narrow it to one hand: a left-handed player's main hand item is the one in their left hand, and a mob that carries its item in its mouth uses apoli:held_item_mainhand.

How the model is drawn

apoli:model_width and apoli:model_height scale the model along its own body, so the proportions hold whatever pose it is in. A tall, thin entity lying in a bed is long, not thick, and a scaled entity that swims or glides with an elytra keeps its shape.

• Sleeping: a scaled sleeper lies on the mattress with its head on the pillow, and a big one hangs over the foot of the bed instead of sinking into it.
• Name tags sit just above the drawn head at their usual size, whatever the scale, including for a scale that only changes the model or only the hitbox.
• Leads run from the entity's leash point to whatever holds them, at any size.
• Crouching keeps a scaled entity's feet on the ground.

The inventory doll

The preview of an entity in the inventory, the creative inventory and other menus is always drawn at normal size. None of the scale types above reach it, so a giant or a tiny entity can still see themselves. apoli:doll is the one scale that does. Give it a value and the preview grows or shrinks by that much:

{
    "type": "apoli:scale",
    "scale_types": "apoli:doll",
    "scale": 2
}

The preview scales about its middle and stays clipped to its box. On Minecraft 1.20.1, which positions previews by their feet, it grows upwards from the feet instead.

Easings

Anywhere a scale change takes ticks, an easing picks how the change is spread over them:

linear, ease_in_sine, ease_out_sine, ease_in_out_sine, ease_in_quad, ease_out_quad, ease_in_out_quad, ease_in_cubic, ease_out_cubic, ease_in_out_cubic, ease_in_expo, ease_out_expo, ease_out_back, ease_out_bounce.

Where scales come from

Three sources multiply together:

1. the value stored on the entity (set by /apoli:scale or the apoli:scale entity action), which persists;
2. every apoli:scale power the entity holds whose condition passes;
3. the parent scales in the table above.

Scales are clamped between 0.0001 and 10000.