Coilhead mod

Freeze in your last pose when a player or NPC looks at you. Watchers have colored silhouettes, and a small countdown number appears in the lower-right corner of your headset view. For BONELAB PCVR.

Install and update

Requires MelonLoader 0.7.3, BoneLib 3.2.2 and Fusion 1.14.2. Fusion remains an installed dependency; NPC mode works without joining a lobby.

Close BONELAB completely, replace Mods/MannequinMod.dll and restart. Remove any old CoilHeadBeta.dll or renamed copies of previous versions. Use the MelonLoader Mods folder next to the game executable, not the mod.io/avatar folder.

All participating players and viewers need 1.2.0 or newer; this package is 1.2.1. Viewers can leave their own role off. This version sends live gaze independently of the visible frozen pose and includes the configured duration in freeze messages. Senders older than 1.2.0 can still transmit frozen gaze; viewers older than 1.2.0 cannot interpret the extended freeze message and may animate legs normally.

How to play

1. Open BoneMenu > Coilhead mod. Choose Players, NPCs or Both under Who can freeze you. Players mode needs a Fusion lobby. NPCs and Both also work solo.
2. Turn on Enable Coilhead. The role starts off each time the game launches.
3. When a selected observer looks at you with clear sight, your last completed body and leg pose is held. Your real headset view remains tracked. A number counts down in the lower-right corner, without a background panel, extra labels or a progress bar.
4. When everyone looks away or loses sight, you release and the number disappears. An early release earns no cooldown; a new direct look can freeze you again.
5. Completing the full freeze grants the configured cooldown, during which you can move while watched. The corner number disappears during cooldown. BoneMenu shows cooldown status. With a zero-second cooldown, another freeze can start on the next observed frame.
6. Hold both grips OR both triggers for 1.5 seconds to disable and release, or use Emergency release / disable. Changing observer mode releases and resets the round.

Settings

Open BoneMenu > Coilhead mod > Settings:

Setting	Choices	Default
Outline color	Yellow, White, Cyan, Green, Blue, Purple, Pink, Red	Yellow
Freeze duration	1–120 seconds	20 seconds
Cooldown	0–120 seconds	20 seconds
View cone	20–100 degrees, full angle around headset/eye forward	60 degrees

These settings save between launches through MelonPreferences. Color applies to both player and NPC watchers immediately. Editing a duration or view cone releases and resets the current round. A narrower cone requires a more direct look; a wider one includes peripheral vision. This uses headset direction, not eye tracking.

Display & highlights independently toggles the countdown or watcher outlines. The role itself does not turn on automatically after a restart.

Version 1.2.1 updates the name and outline icon. Gameplay and saved settings are unchanged from 1.2.0.

Fixes in 1.2.0

• Incoming player gaze uses the newest received headset pose rather than a delayed displayed rig. Without new pose packets for 0.35 seconds, a player no longer counts as watching.
• Frozen mannequins continue transmitting real headset direction and view rotation, so looking away works even when both players are mannequins. Updated receivers hold the displayed statue separately.
• Skinned silhouettes bake scale into the mesh once and use a position/rotation-only draw matrix. Rigid meshes retain their regular transform scale. This removes the extra scaling that could inflate highlights on scaled avatars.
• The countdown, local hold and remote hold all use the chosen duration. No persistent physics constraints, kinematic flags or Fusion movement-lock flags are written.

No native rig, physics, art or camera detours install. The two managed Fusion pose hooks install only after role activation in a lobby with a valid rig.

Observation and performance

Sight has a 100-metre limit. A clear ray to the head, chest or pelvis counts. Walls block it; transparent objects with solid colliders can also block it. Mirrors do not count. Headset direction and network delay mean this is an approximation of what another person sees.

Up to 8 player checks / 24 rays and 4 NPC checks / 12 rays run per frame. NPC discovery runs every two seconds only in NPC/Both mode. Newly spawned NPCs may take up to two seconds to join the roster. Dead, inactive or despawned NPCs do not count. NPCs require a standard AIBrain, living puppet and eye transform; Ford is an intended target, but custom NPC systems may not be supported.

Watcher silhouettes reuse our EchoLocation player-rendering code; EchoLocation is not a dependency. Players and NPCs share one mesh bake and up to 96 submesh draws per frame, a one-million-vertex cache and a 120,000-vertex limit per mesh. Extremely complex meshes can be skipped. Held props are not frozen.

Validation

The build and automated checks cover pose release, incoming gaze freshness, live outgoing headset data, saved settings, adjustable local/remote deadlines, NPC sight, countdown state/placement and mesh transform math. They use simulated Unity/Fusion objects. Actual baking, both-eye rendering, multiplayer gaze and native callbacks still need an in-game test of 1.2.1. FPS has not been measured.

For bug reports, include the mod version on both players, observer mode, view-cone setting, freeze/cooldown settings, whether the menu still says FROZEN after look-away, and the newest MelonLoader log.