Head Config

< Back to mechanic page

Description

Change the turn limits and turn speed of head bones. These are the same settings as the head tag parameters. Targets the model of the targeted entity. Changes are saved with the model.

Yaw is relative to the body and positive to the right. Pitch is positive downward, like Minecraft's.

Attributes

Attribute Aliases Description Type Default
modelid m, mid, model Targeted model String
partid p, pid, part Targeted head bone.
If not set, configures every head bone
String
yaw Shorthand setting maxyaw=yaw and minyaw=-yaw Float
pitch Shorthand setting maxpitch=pitch and minpitch=-pitch Float
minyaw The furthest the head turns to the left, in degrees Float
maxyaw The furthest the head turns to the right, in degrees Float
minpitch The furthest the head looks up, in degrees Float
maxpitch The furthest the head looks down, in degrees Float
speed s The most the head turns per tick, in degrees.
0 turns instantly
Float
exactmatch em, exact, match Should the part match the partid completely Boolean true

Attributes that are not set keep their current value.

Examples

Let the head only turn 45 degrees each way, slowly:

  Skills:
    - headconfig{p=head;yaw=45;pitch=20;speed=5} @self ~onSpawn
Updated Oct 12, 2026