Profile Builder · Tilt & pivot — using the IMU

The Z3 contains a processor unit (IMU) that measures how you hold the mouse. The Builder turns three physical axes into triggers and analog controls:

Axis	Name in the Builder	Feels like
roll	Tilt (roll)	Rolling the mouse left/right (banking)
pitch	Tilt forward/back (pitch)	Nose up / nose down
yaw	Pivot (yaw)	Swivelling the mouse on the spot (pointing left/right)

There are two trigger styles per axis: a discrete tilt gesture (a threshold crossing) and an analog tilt range (a sliding band of motion). Pivot (yaw) is what people use for free‑look / turning, e.g. to look around with your thumb instead of flicking the whole mouse.

---

1. The two trigger types

Tilt gesture

A movement that crosses an angle threshold along one axis. It behaves like a button: fires once on entry, again on exit.

Field	Values	Meaning
Axis	Tilt (roll) / Tilt forward/back (pitch) / Pivot (yaw)	Which rotation plane.
Direction	both / increasing / decreasing	increasing = tilt into the positive side of that axis, decreasing = the negative side.
Entry start ° / Entry end °	0–360	Degree range that counts as "entered". 180° = level.
Exit start ° / Exit end °	0–360	Degree range that counts as "left".

Think of 0–360 as the compass of your tilt; 180 is flat/level. So a forward gesture could be entry 200–240°, exit 120–200°.

Tilt range (analog)

A continuous band of tilt that outputs progressively (the deeper you tilt, the more it acts — great for joystick‑style control).

Field	Values	Meaning
Axis	as above
Range from °	−180…+180	Start of the band relative to level. Negative = left/backward, positive = right/forward.
Range to °	−180…+180	End of the band; may cross 0°, e.g. from −12.5 to +33.8.

The Builder draws the band on a range plot; the mirrored checkbox builds an identical band on the other side so tilting left and right behave symmetrically.

A mental model: gesture = switch, range = slider.

---

2. Zeroing — why it matters

The IMU measures relative motion, so the Z3 needs a reference "level". Two features keep that honest:

• Tilt auto-zero (device setting, default enabled) — the mouse re‑calibrates level whenever the sensor idles, so "flat" always means flat in your current grip.
• Zero tilt/pivot action — recalibrates a single axis right now. Bind it to Pivot (yaw) and press it once before a round: from then on, "level" means pointing straight ahead in your hand. Essential for reliable yaw free‑look.

If you skip zeroing yaw and your starting hand angle is off, pivoting looks lopsided from the start — one Zero tilt/pivot (Pivot) tap at round start fixes it.

---

3. Wiring them up

Pivot free‑look with a joystick device:

1. Settings → Game device mode → Joystick. Apply.
2. Add a mapping → trigger Tilt range, Axis Pivot (yaw).
3. Add action Joystick stick, Axis leftRight, and set left/right start‑end % bands (or tick Mirrored).
4. Bind Zero tilt/pivot → Pivot (yaw) to a button (e.g. Top Thumb tap).

Now holding the joystick automatically looks around for as long as you keep the tilt; the range plot makes small tilts subtle and big tilts fast.

Tilt‑range lean with Scroll wheel as proxy: trigger Tilt range (roll), action Scroll wheel with notches — tilting the mouse left/right scrolls down/up at a rate proportional to tilt depth. Nice as a no‑device fallback for inventory menus.

Gesture as a bind: trigger Tilt gesture (roll, increasing, level→left), activation Haptic pulse 100% 30 ms + Key G [tap] for a physical "lean left = grenade" feel.

---

4. Rules & constraints

• Gesture angles are always 0–360 (180 = level), range angles always −180…+180 relative to level. Don't mix them up when tweaking numbers.
• A tilt gesture fires once per crossing; a tilt range fires continuously (ideal for analog actions). Don't use a range trigger with a one‑shot action like Type text or it will re‑type every polling tick.
• Ranges can cross 0°; a mirrored range mirrors exactly around level.
• Direction increasing/decreasing refers to the numeric direction along the axis; both fires for either.

---

5. Troubleshooting

Symptom	Likely cause
Pivot looks wrong / off‑centre	Level was set at a bad angle — bind Zero tilt/pivot (Pivot) and tap it at a neutral resting grip, or enable Tilt auto-zero and let the mouse idle before starting.
Range acts even when the mouse is flat	Band is drawing across 0° while you hold "level" past it — shrink the range so level sits outside.
Actions fire repeatedly on a range	You used a range trigger with a one‑shot action. Use a gesture (or a Delay / loop guard) instead.
Nothing fires on yaw	Game device mode must be joystick/gamepad for Joystick actions — without a device nothing consumes the yaw value.
Tilt feels twitchy	Widen the entry/exit band hysteresis (like deep‑click) or raise the range from/to gap so small hand wobble stays inside "level".

---

6. Ideas

• Yaw free‑look — pivot range + joystick stick (see above).
• Lean key — tilt gesture (roll) → A/D keys for peeking without keyboard.
• Sensitivity clutch — tilt range (pitch, forward) → DPI selection increase as you extend your index finger.
• Emergency — tilt gesture (yaw, either direction) → Select profile next to swap to a "safe/sniping" sub‑profile instantly.

---

Related guides

• Every trigger & action
• Deep-click & pressure zones
• Settings & DPI