
Coilhead mod
Freeze when players or NPCs watch you. Configurable look time, release delay, freeze/cooldown and colored watcher outlines. Headset countdown and emergency disable. One DLL for PCVR and standalone Quest; Fusion 1.14.3.Coil Head
Version 1.2.6 brings the current Coil Head build to Thunderstore with one DLL for PCVR and standalone Quest, Fusion 1.14.3 compatibility checks, the Coil Head name, and a gold outline icon with a white QU/PC badge. It includes the two-second release delay and the inset bottom-left headset countdown. All existing settings and saved preferences are retained. See installation instructions.
Freeze in your last pose after players or NPCs watch for the required time. Separate looks add up; the default is 2.5 seconds. Watchers have colored silhouettes, and a small countdown number appears in the bottom-left area, inset from the lens edges of your headset view once you freeze.
Install and update
Use BoneLib 3.2.2 and Fusion 1.14.3. PCVR uses MelonLoader 0.7.3. Standalone Quest uses BONELAB Patch 6 with LemonLoader 0.6.5 and the Quest installations of BoneLib and Fusion. The Thunderstore loader dependency is for PC; install LemonLoader separately on Quest. Fusion remains an installed dependency; NPC mode works without joining a lobby. EchoLocation is not required.
Close BONELAB completely, remove the old MannequinMod.dll, install CoilHead.dll and restart. Remove any old CoilHeadBeta.dll or renamed copies of previous versions so only one copy loads. On PC, use the MelonLoader Mods folder next to the game executable. On Quest, use the Mods folder under LemonLoader's BONELAB data directory, normally /sdcard/MelonLoader/<BONELAB package name>/. This is separate from the mod.io/avatar folder. Quest Link/Air Link running the PC game uses the PC installation.
Install 1.2.6 on players using the role and their viewers for matching PC/Quest behavior. Viewers can leave their own role off. The freeze message format remains compatible with 1.2.0+ viewers. This version sends live gaze independently of the visible frozen pose and includes the remaining hold duration in freeze messages. Older senders can still transmit frozen gaze; viewers older than 1.2.0 cannot interpret the extended freeze message and may animate legs normally. Quest Fusion's Steam transport also needs FusionHelper/Steam on a computer on the same network; follow Fusion's setup instructions.
How to play
- Open BoneMenu > Coil Head. Choose Players, NPCs or Both under Who can freeze you. Players mode needs a Fusion lobby. NPCs and Both also work solo.
- Turn on Enable Coil Head. The role starts off each time the game launches.
- Before each freeze, selected observers must watch you with clear sight for the configured Look time before freezing (default 2.5 seconds). Separate looks add up: one second now plus 1.5 seconds later qualifies. Time pauses while nobody is looking; simultaneous watchers count at normal speed. Once the requirement is met while watched, your last completed body and leg pose is held and the full main countdown starts. Your real headset view remains tracked. The corner display stays a basic number; BoneMenu shows pending look-time progress before the countdown starts.
- When everyone looks away or loses sight, the same pose stays frozen for the Release delay (default two seconds). Looking back during this delay keeps that same hold without a new capture or countdown. If everyone remains unseen for the full delay, you move freely while the same countdown continues. Each later freeze needs fresh combined look time and can begin only while more than five seconds remain. Countdown expiry releases even during the delay. A hold that stays continuous can last until zero.
- At zero, you release and receive the configured cooldown, even if nobody is currently looking. The corner number disappears during cooldown. BoneMenu shows cooldown status. With a zero-second cooldown, another countdown can start on the next observed frame.
- To disable and release, double-tap both triggers + Y + B together: briefly squeeze both index triggers while pressing left Y and right B, release all four, then repeat. The second press disables immediately. All four controls are required on each tap. You can also use Emergency release / disable in BoneMenu. Changing observer mode releases and resets the round.
The shortcut allows up to 0.2 seconds between fingers, a first tap up to 0.4 seconds long, and up to 0.65 seconds from releasing the first tap to completing the second press. Fully release between taps. Trigger noise is filtered, and stale input or a disconnected controller cancels the sequence. Release all controls after enabling before starting a gesture. Holding grips or triggers no longer disables the role. Y and B refer to the upper face button on each Touch controller.
Settings
Open BoneMenu > Coil Head > Settings:
| Setting | Choices | Default |
|---|---|---|
| Look time before freezing | 0–10 seconds, in 0.25-second steps | 2.5 seconds |
| Release delay | 0–5 seconds, in 0.25-second steps | 2 seconds |
| 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. Set look time to zero for instant freezing; set release delay to zero for immediate look-away release. Freeze duration sets the continuous countdown from the first qualifying freeze, including time spent unseen. The default remains 20 seconds. If you choose five seconds or less, the first qualifying look can still freeze you, but after a full release you cannot be frozen again until a new countdown after cooldown. Watching during cooldown does not build look time. Disabling, scene/avatar changes, mode changes, or editing a duration/view cone clears pending timing and releases immediately, including during the delay. Color applies to both player and NPC watchers immediately. 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.5 updates only the package icon, with a gold outline, rounded border and CO tab. Version 1.2.4 adds the adjustable combined look-time requirement. Version 1.2.3 keeps one continuous countdown across look-aways and prevents new freezes in its final five seconds. Version 1.2.2 introduced the double-tap shortcut above; 1.2.1 updated the name and outline icon. Existing settings and the network message format remain compatible; the new look-time setting starts at 2.5 seconds.
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. Quest installs no managed Fusion patches either: a new received pose object renews gaze freshness, while local and receiving pose holders keep the statue still. PC may install one optional outgoing-pose hook after role activation in a lobby; failure falls back without disabling the role. Both platforms reject stale snapshots and rebaseline after a lobby or rig change.
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
Both PC/shared and Quest API builds pass, together with 410 automated timing, gesture, gaze, pose-release, networking, countdown and mesh checks. These use simulated Unity/Fusion objects. The actual Fusion 1.14.2 and 1.14.3 DLLs pass PC/Quest API resolution and packet/pose/metadata implementation checks. The embedded Android shader has GLES3/Vulkan stereo compiler checks. Live headset rendering, controller input and multiplayer sessions have not been verified for this package. FPS has not been measured. The included playtest checklist covers the remaining device checks.
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.