Pehkui — Guide
Scale Types
Instead of only one "size" value, Pehkui exposes many independent scale types so you can control exactly how an entity grows or shrinks. Set base when you just want a normal, all-around size change; use the others for finer effects.
| Type | Effect |
|---|---|
base |
Overall size — the simplest option, affects everything at once |
width |
How wide the entity is |
height |
How tall the entity is |
model_width / model_height |
Visual model size without changing the hitbox |
motion |
Movement speed |
reach |
How far the entity can interact and attack |
jump_height |
How high it can jump |
step_height |
How tall a block it can step over without jumping |
Because these are separate, you can combine them — for example a mob that is visually huge but still moves quickly, or one that is small but has a long reach.
How Size Changes Gameplay
Scaling an entity does more than change how it looks:
- Hitbox grows or shrinks with the entity, so larger targets are easier to hit and smaller ones are harder.
- Reach increases for big entities, letting a giant attack or interact from farther away.
- Step height rises with size, so a large entity can walk over fences and full blocks that would normally stop it.
- Fall damage is reduced for small entities, and small sizes let them fit through gaps as little as part of a block tall.
- Movement feels different — a giant covers ground with each step, while a tiny creature looks fast and frantic.
These physical effects are what make the mod useful for boss-style giants, pet-sized companions, and puzzle or adventure scenarios.
Examples
A few practical setups:
Become a giant:
/scale set base 4 @s
Shrink yourself to explore tight spaces:
/scale set base 0.3 @s
Turn every nearby pig into a towering beast:
/scale set base 5 @e[type=pig,distance=..20]
Make a fast miniature pet (small body, normal speed):
/scale set base 0.4 @e[type=wolf,limit=1,sort=nearest]
/scale set motion 2 @e[type=wolf,limit=1,sort=nearest]
Return everything to normal:
/scale reset base @e