GamingSpartans-XenoCrawler icon

XenoCrawler

Crawl walls and ceilings like a Xenomorph: descend-and-grab, inner-jaw bite, pounces and surface leaps. Works with LabFusion multiplayer or solo.

Last updated 12 hours ago
Total downloads 131
Total rating 0 
Categories Mods
Dependency string GamingSpartans-XenoCrawler-1.8.2
Dependants 0 other packages depend on this package

This mod requires the following mods to function

bonelib-BoneLib-3.2.1 icon
bonelib-BoneLib

A BONELAB mod for making life easier for other mod creators.

Preferred version: 3.2.1
LavaGang-MelonLoader-0.7.3 icon
LavaGang-MelonLoader

The World's First Universal Mod Loader for Unity Games compatible with both Il2Cpp and Mono

Preferred version: 0.7.3
Lakatrazz-Fusion-1.14.2 icon
Lakatrazz-Fusion

A multiplayer mod for BONELAB, taking advantage of its physical interaction.

Preferred version: 1.14.2

README

XenoCrawler (BONELAB · MelonLoader · Il2Cpp · .NET 6)

Wall and ceiling crawling like a Xenomorph: descend-and-grab, an inner-jaw bite on both triggers, pounces and surface leaps. Works with LabFusion when it's installed, and also runs without it.

Requirements

  • MelonLoader 0.7.3
  • BoneLib 3.2.1
  • LabFusion 1.14.2 (installed automatically by r2modman; it's only used in multiplayer, and the mod still works solo). It lets you crawl with other players: your rotation, crawl gravity, grabs and bites sync to everyone. Every player on the server who wants to crawl needs XenoCrawler installed as well, and the host decides whether it's allowed (see Server fairness below).

Installation

  1. Install with r2modman / Thunderstore Mod Manager, or manually copy XenoCrawler.dll into BONELAB/Mods.
  2. If you install manually, also install LabFusion for multiplayer. Mod managers do this for you.
  3. Launch the game. The settings are in BoneMenu → Xeno Crawler.

Build

  1. Put these DLLs in ./Libs (one flat folder):

    • From BONELAB/MelonLoader/net6: MelonLoader, 0Harmony, Il2CppInterop.Runtime, Il2CppInterop.Common
    • From BONELAB/MelonLoader/Il2CppAssemblies: Il2Cppmscorlib, Il2CppSystem, Assembly-CSharp, Il2CppSLZ.Marrow, Il2CppSLZ.Algorithms, UnityEngine, UnityEngine.CoreModule, UnityEngine.PhysicsModule, UnityEngine.AudioModule
    • From BONELAB/Mods: BoneLib, LabFusion

    If you don't want to copy DLLs, delete Libs/MelonLoader.dll and set the BONELAB_DIR environment variable instead.

  2. Run dotnet build -c Release. The DLL is copied to BONELAB/Mods automatically when BONELAB_DIR is set.

Controls (defaults)

Action Input
Latch onto a wall or ceiling Grip with an empty hand while reaching toward it (default Grip mode). After a drop, let go of the grip before latching again. Automatic mode in BoneMenu restores push/fly-in latching
Move along the surface Left stick, relative to where you're looking
Scuttle (sprint) Keep the left stick fully pushed; it ramps up after about 0.35 s
Turn on the surface Right stick X
Drop Tap A. Off a ceiling this becomes an ambush drop with a downward burst
Pounce Hold A to coil (you freeze and press into the surface), then release to leap where you're looking. You latch onto any wall or ceiling you hit within 2 s
Surface leap Look at another wall or ceiling (up to 4 m away) and click the turn stick (right by default). You glide straight to it, turning onto it on the way, and land latched, so you don't need to crawl through a corner. Works ceiling ↔ wall, wall ↔ wall, and across gaps. Tap A mid-leap to drop
Lower & grab On a ceiling or wall, click the move stick (left by default). You lower yourself to whoever is below you (or out in front of the wall), without needing to look at them, and your nearest empty hand grabs the part it touches. Click again to drop them. BoneMenu → Xenomorph → Grab Button can move it to the turn stick or B/Y (the surface leap then moves to the move stick)
Descend grab On a ceiling or wall, reach toward an NPC or player (up to 2.5 m from your hand) and squeeze a grip with an empty hand. You lower yourself off the surface until your hand touches them, and your hand grabs the part it touched. With Rise With Victim on (default), you then slowly climb back onto the surface carrying them on your hand; with it off you stay hanging. Let go of the grip to drop them. Re-gripping someone you already have (or just let go of) is a plain grab on whatever your hand touches, with no pull
Idle sway Stay still on a surface and your body breathes, sways and twitches. Other players see it; your own view doesn't move
Inner-jaw bite Kills NPCs. What it does to players is set by Bite Players (default Off). Pull either trigger (the Bite Button) with an NPC or player in front of your face (0.6 m). Squeezing both triggers still works too. If you're holding someone, they're bitten first. Hands holding a gun or prop don't count, so their triggers don't bite. BoneMenu → Xeno Crawler → Headbite → Bite Button can change it to the left or right trigger only, B/Y, or Off. 2 s cooldown, 30 stamina
Hand-over-hand Grip near or on a surface and pull your arm in

How the sync works

LabFusion already sends OpenControllerRig.vrRoot.rotation as RigPose.TrackedPlayspace, which is a full quaternion. Remote reps Slerp to it, and this mod rotates exactly that transform, so the rotated and upside-down orientations replicate without any extra data. The mod's Fusion module (CrawlStateMessage) adds the one thing Fusion doesn't know about: the crawler's custom gravity direction (0 while hanging or leaping) and limb clearance. These get applied to the remote rep's PhysicsRig.selfRbs, so remote limbs don't hang toward world-down and fight Fusion's pelvis PD controller. Peers without the mod silently ignore the message.

Server fairness (LabFusion)

  • Hosting: BoneMenu → Xeno Crawler → Server (Host) has toggles for Allow XenoCrawler, Allow Pounce and Allow NPC Stealth. They apply to everyone on your server, including you.
  • Joining: XenoCrawler stays off until the host's permission arrives. If the host has it disabled, or doesn't run XenoCrawler at all, it stays off for the whole session and a popup tells you why. It returns to your own settings when you leave.
  • Only messages from the host's player ID are accepted, so another client can't switch it on for everyone. This keeps the honest setup fair, but it isn't anti-cheat: someone who modifies the mod can still bypass it.

Changelog

  • 1.8.2: Fixes for player grabs, the bite and landing.
    • Bite no longer kills players by default: new setting Bite Players (BoneMenu → Xeno Crawler → Headbite): Off (default; NPCs are still killed), Damage (uses Player Damage, default 0.5) or Kill (the old behaviour). Kill knocks players out instead when the server has mortality off.
    • No accidental bite on grab: for 1 s after a grab starts, bites are ignored. Squeezing the grip often brushed the trigger and bit (killed) the player you'd just grabbed, so they respawned at spawn.
    • Players aren't hauled up into the ceiling: Rise With Victim now only carries NPCs. New setting Rise With Players (off by default) restores it for players.
    • Grab safety for the grabbed player: a pull point that's invalid or more than 2.5 m away, or your body suddenly moving faster than 12 m/s, now lets you go instead of flinging you.
    • No more being stuck in ceiling mode on the floor: if you land on a floor while still in wall or ceiling mode (fell mid-turn, or while hanging to grab someone), you're switched back to normal walking after 0.3 s. A tilted view left over after a reset is turned upright again.
  • 1.8.1: Bite Button, and re-grips are plain grabs.
    • Re-gripping doesn't reel them in: letting go of a grip and grabbing again on someone you've pulled up used to start a fresh descend grab. It steered your hand to their nearest body part and forced a grab on it, pulling that part into your hand. Now, when they're already in your other hand, you let go of them less than 3 s ago, or your hand is within 0.3 m of them, the mod stays out of it. Your hand does a normal BONELAB grab on whatever it touches, and the mod only takes their weight off, with no pull. If that grab slips, they're let go instead of being soft-held back to your hand.
    • Both hands on one NPC: only one hand carries them, so they no longer get double lift and float upward.
    • One press bites: new Bite Button setting (BoneMenu → Xeno Crawler → Headbite). By default, pulling either trigger on an empty hand (or the hand holding your victim) fires the inner jaw, so you no longer need both triggers. Options: Either Trigger, Left Trigger, Right Trigger, B or Y, Off. Bite Input (both triggers / head thrust) still works alongside it, and the cooldown stops a double bite.
    • B or Y: while you're on a surface, B/Y is taken over for the bite. If the Grab Button is also on B/Y, the grab keeps the button and the bite button does nothing.
    • Fix: B/Y is now also suppressed on the controller that has the surface leap, when the Grab Button is on B/Y.
    • Network messages are unchanged.
  • 1.8.0: Descend-and-grab replaces the reel-in.
    • Ceiling cling removed: the flat press (both triggers), its NPC stealth and its body-audio muting are gone, and the Ceiling Cling page and the host's Allow NPC Stealth toggle went with them. The network message keeps its layout, with Clinging always false.
    • Bite on both triggers: setting Bite Input (Both Triggers by default, Head Thrust, or either). It works while you're holding someone, and the person in your hand is the first target. Bite reach is now 0.6 m.
    • Hands no longer sink into bodies: the descent steered your hand's centre onto their body's surface, so half the hand ended up inside them, and soft holds then kept it there. Now the hand is steered to a hand-radius off their surface (and backed out if it's already inside), contact is measured surface to surface (Grab Contact Gap, 0.05 m), and soft holds keep them against your hand, not inside it.
    • Left stick click lowers you: the grab button is now the move-stick click and targets whoever is below you, so you don't need to look at them. The surface leap moved to the turn-stick click.
    • Lowers all the way, then grabs: you keep lowering automatically until the grab has really caught. The mod retries the hand grab for 1.2 s and then falls back to a soft hold. Players without the mod need a real grab, so for them you get a popup instead. You never start rising (Rise With Victim) until the grab is confirmed, and if you're too far up you're told to raise Max Drop Depth (default now 2.5 m) instead of quietly going back up.
    • No sideways drag while lowering: the sideways lean toward them is capped at 0.6 m and 0.5 m/s, you hold your spot sideways while holding, and any world gravity the game switches back on is cancelled while you hang. Before, on walls especially, you were pulled along the surface as if you were standing on the ground.
    • Surface leap: look at a wall or ceiling and click the move stick to glide straight onto it, with no corner needed (settings: Surface Leap, Leap Range, Leap Speed). Surface gravity is off during the leap and synced as 0, so remote reps don't fight it either.
    • Grab button: the nearest empty hand is used, you lower yourself until it touches them, and the mod keeps that hand's grip squeezed until you click again. Nothing solid can be in between. If the game doesn't take the held grip, they're kept with a soft hold instead.
    • Both-hands reach glitch fixed: while attached, surface probes ignore surfaces facing back at you (the floor under a ceiling, the far wall), hand rays count for less than your body, normals that cancel each other out are ignored, and grip corner turns have a 0.6 s cooldown. Reaching out with both hands used to blend opposite surfaces together and spin your view.
    • You go to them: squeeze a grip while reaching toward someone and your body lowers off the ceiling (or out from the wall) until your hand physically touches them, up to Max Drop Depth (1.8 m). Your hand then does a real BONELAB grab on the part it touched. Nobody is pulled up to you; you hang at that depth while holding, and rise back onto the surface when you let go.
    • No gravity fight: while you hang, your surface gravity is off and one spring holds your height. The effective gravity (0) is sent to other players, so your rep's limbs aren't pulled back to the ceiling against Fusion's pelvis controller.
    • One mover per victim: a victim held by your hand is only made weightless and calmed, with no pull. Players with the mod are held at your hand by their own game (no joint for Fusion to fight). The soft pull is only used when no hand grip was possible, and it targets your hand, never your body.
    • No body-on-body shoving: your body and the victim's ignore each other's colliders while you're engaged (hands excluded). They're switched back on pair by pair only once the bodies no longer overlap, so letting go doesn't fling either of you. Grabbed players with the mod do the same on their side.
    • Single-player hand grab: without a Fusion server the grab uses BONELAB's Grip.OnGrabConfirm, found by reflection (falls back to a soft hold if it isn't there).
    • Aim: only targets roughly where you're reaching (40° cone from your head through your hand) count, so a grip on the ceiling next to an NPC is still a corner grip.
    • Rise With Victim (on by default): about 0.4 s after you grab them, you climb back to the surface at Rise With Victim Speed (0.6 m/s), carrying them on your hand. It's your body that moves; they're never pulled toward you, so the hand grab stays the only thing moving them. Turn it off to stay hanging until you let go.
    • New settings (Xenomorph page): Grab Descend Reach, Max Drop Depth, Descend Speed, Grab Contact Gap, Held NPC Weight, No-Grip Hold Strength, Rise With Victim, Rise With Victim Speed. Removed: Reel In Players, Grab Reach.
    • Network messages are unchanged, so 1.7.x players can still join, but everyone should update to get the fixes.
  • 1.7.1: Grabbing from walls and ceilings no longer glitches you or the victim.
    • One controller per grab: an NPC held by your hand is moved only by the hand and just made weightless, with no extra pull toward the hand. That removes the feedback loop.
    • Players with the mod are carried only by the message-based pull, with no physical grab to fight Fusion over. Players without it still get the synced native grab. Games running the mod now announce themselves every 3 s so grabbers can tell.
    • Softer anchor: while holding, it only keeps your distance from the surface and softly damps sideways drag, instead of pinning your whole body.
    • Shorter reel: the reel hand offset is capped at 0.8 m.
  • 1.7.0: Inner-jaw headbite (new XenoJaw.cs, BoneMenu → Xeno Crawler → Headbite).
    • Trigger: thrust your head forward fast (default 1.6 m/s relative to your body) with an NPC or player within about 0.45 m in front of your face.
    • NPCs: PuppetMaster.Kill(). In a server the bite takes ownership first and Fusion syncs the death.
    • Players: a lethal Attack sent through LabFusion's PlayerSender.SendPlayerDamage, applied by their own game's health system. This works without the mod, but respects the server's mortality settings.
    • The jaw: an inner-jaw strike effect shoots out and snaps back, and other players see it.
    • Limits: a 2 s cooldown and a 30 stamina cost.
    • Host toggle: Allow Headbite.
    • The host permission message changed, so everyone needs 1.7.0.
  • 1.6.4: Dragging limp (dead or knocked-out) NPCs and players no longer glitches. The held body is now fully weightless, its limbs are damped relative to the body, and the pull is one acceleration applied to every part instead of yanking a single limb. The body list refreshes every second, since ragdolls rebuild on death. If BONELAB's own grip is also holding the NPC, the reel moves your hand instead of pulling against the grip. Players with the mod get the same whole-body carry on their side.
  • 1.6.3: Grabbing an NPC or player no longer detaches you.
    • The grip-corner turn doesn't fire when an NPC or player is within grab reach, and never turns you onto a floor. Previously, the search past your hand could hit the floor behind a victim.
    • While you're holding someone, the lost-surface and floor detaches are suspended, and your body is spring-anchored in place so their weight can't drag you off. The anchor follows you if you crawl while holding them.
  • 1.6.2: Grabbed players are lifted and reeled up to you even without the mod. During a synced player grab, your grabbing hand's tracked transform is pulled toward your body just before BONELAB reads it, at the same OnRealHeptaEarlyUpdate hook LabFusion uses. Fusion sends that hand, so your copy's hand hauls them up on their machine. The offset is capped at 1.2 m, recomputed each frame, and gone when you let go. Setting: Reel In Players.
  • 1.6.1: Player grabs work on players without the mod. The grab is now a genuine BONELAB grab on their body, using LabFusion's own GripExtensions.TryAttach. Fusion's grab sync carries it to every game, so the victim's game holds them with your copy's hand and they're dragged as you move. Players who do have the mod also get the lift and reel-in on top.
  • 1.6.0: Grab players, and grab from walls.
    • Ambush grab from walls: the ambush grab works from walls as well as ceilings (setting: Grab From Walls).
    • Grab Players: in Fusion, grip near another player while you're on a wall or ceiling. Your game streams the pull point at 20 Hz to that player only, and their game pulls their own body toward your hand and reels them in. They're released when you let go, if updates stop for 0.4 s, or if they break more than about 2.5 m beyond your reach.
    • Victim side: players can opt out with Players Can Grab Me, they get a popup when grabbed and when they break free, and points more than 5 m away are ignored.
    • Host toggle: Allow Grabbing Players.
    • The host permission message changed, so everyone needs 1.6.0.
  • 1.5.4: Fixed drifting off in a random direction after detaching. The foot loco ball could spin freely while the feet were frictionless and roll you away once friction came back. Spin is now bled off while latched and zeroed on detach, leg velocity is matched to the pelvis, and the ball is held still for 0.6 s after detaching until you push the stick. This also applies to remote crawlers.
  • 1.5.3:
    • Legs no longer stick and glitch while latched. The feet and knee become frictionless while attached, because the stick-idle braking of the loco ball made them scrape and stick-slip. This also applies to remote crawlers, and normal friction comes back the moment you detach. Setting: Slippery Feet (Latched).
    • The grip latch and grip corners see past clutter. On a grip press, a fan of rays looks past light panels, trims and ledges (RaycastAll) and picks the dominant main surface. Small fixtures are down-weighted in the normal surface tracking and can't trigger a corner turn. Setting: Grip Reach Past Hand.
  • 1.5.2:
    • Fusion desync: remote crawlers' pelvis rotation is now driven to the synced pose while ball locomotion is on, because Fusion skips it then and the rep balanced itself upright. Remote cling and anti-clip forces no longer push the pelvis position that Fusion's PD controller owns.
    • Stamina bar: the bar's mesh and materials survive level reloads, such as starting a Fusion server. Previously a destroyed mesh was reused and the bar went invisible.
  • 1.5.1: In-headset stamina bar (new StaminaBar.cs). It's local only. It runs green → yellow → red, flashes red when exhausted, and auto-hides when full and off a surface. Position: HUD (bottom of view) or Wrist (above your left hand). It draws on top of walls when the UI shader is available.
  • 1.5.0: Stamina and light sensitivity (new XenoSurvival.cs), under BoneMenu → Xeno Crawler → Stamina & Light.
    • Stamina: a pounce costs 20–45 depending on charge, and scuttling drains 18/s. It regenerates 14/s after a 1 s pause, faster in darkness. When it runs out you're exhausted: no scuttle or pounce, a slower crawl, and visible panting until you're back to 30%.
    • Light sensitivity: samples the baked light probes plus nearby real-time lights such as flashlights, with a line-of-sight check. In the dark you crawl ×1.15 and regenerate ×1.5. In bright light you crawl ×0.75, regenerate ×0.5, and lose NPC stealth.
    • Hosts: Stamina Rule and Light Rule (PlayerChoice / ForceOn / ForceOff).
    • The host permission message changed, so everyone on a server needs 1.5.0.
  • 1.4.6: Grip-initiated corners. While on a wall, squeeze a grip with your hand on the ceiling (or vice versa) to roll straight onto it. New Corner Transitions setting: StickAndGrip (default), GripOnly or StickOnly.
  • 1.4.5: Direct wall-to-ceiling and ceiling-to-wall transitions. Once a corner is spotted, the turn onto it is committed and finishes, instead of stalling halfway when the forward probe stopped counting it. Corners are also spotted from your head and feet, not just your pelvis. Pulling the stick back away from the corner cancels the turn.
  • 1.4.4: Gentle detaching. Deliberate drops (tap A, Release Grip To Drop, crawling onto a floor, or the BoneMenu button) bleed off about 85% of your body's speed, and the push-off is now 0.4 m/s instead of 1.5 m/s (new Drop Push setting). Ceiling Ambush Boost is now opt-in, default 0. Pounces and falling off when you lose the surface keep their momentum.
  • 1.4.3: Performance pass (new Perf.cs):
    • The body-part list is cached instead of rebuilt several times per physics tick, which removes steady garbage-collection hitches.
    • Each limb's distance to the surface is cached and estimated between probes.
    • Surface probes run every other tick.
    • Gravity flags are only touched once per body part.
    • The NPC rescan is less frequent.
    • Toggle under Debug → Performance Mode (on by default).
  • 1.4.2: Fixed legs glitching on ceilings. BONELAB's leg spring assumes gravity points at the floor, so on a ceiling it pulls directly against the mod's ceiling gravity. The mod now captures your natural leg length when you latch and holds the knee and feet at it while on a ceiling, locally and on Fusion reps. New setting: Ceiling Leg Lock.
  • 1.4.1: Fixed legs twitching on Fusion reps and while idle. Anti-clip now uses forces instead of overwriting velocities. A new leg straightener (setting: Leg Straighten) keeps the knee and feet lined up under the pelvis, locally and on remote reps. Idle twitches are now short, soft pulses. The network message is unchanged.
  • 1.4.0: Adds the ceiling ambush grab and idle sway (new XenoBehaviours.cs), and an Allow Ambush Grab toggle for hosts. In Fusion, a grabbed NPC's network ownership is transferred to you. The host permission message gained a field, so everyone on a server should run 1.4.0.
  • 1.3.0: Host-controlled server permissions (new ServerPolicy.cs). Players on 1.2.0 or older ignore the host's permission message and keep crawling, so make sure everyone on the server updates.
  • 1.2.0: Latching now uses the grip by default (Latch Mode: Grip or Automatic), with an optional Release Grip To Drop setting. Fixed the jitter and re-latch loop before unlatching. Surface turns now use a filtered target and a critically damped glide that takes about 0.6 s by default; you can set this with Transition Time. Replaces the Align Speed and Transition Speed settings. The network message is unchanged.
  • 1.1.0: Instant latching and fast surface transitions. The next surface is detected ahead of you, and turning never drops below the Transition Speed setting (540°/s by default). You can also latch mid-jump, the drop cooldown is shorter, and there's an Instant Snap option. Also adds the Xenomorph pack: pounce, air latch, scuttle sprint and ceiling ambush drop, all under BoneMenu → Xeno Crawler → Xenomorph. The network message is unchanged.
  • 1.0.1: Fixed legs clipping into walls and ceilings, locally and on Fusion reps. A new LimbClearance.cs measures the real gap under each limb from its collider surface, adds an anti-clip guard, and exposes Limb Anti-Clip and Limb Skin Gap in BoneMenu → Crawl Locomotion. This changes the network message format, so everyone in the lobby needs 1.0.1.

Verified vs. needs tuning

These were verified against BoneLib (commit c6470de, Aug 2026) and LabFusion (commit 99ef0b5, Oct 2026) source:

  • BoneLib.Player
  • the Page.Root.CreatePage/CreateFloat/CreateBool/CreateEnum/CreateFunction signatures
  • Hooking events and GameLayers
  • Fusion's Module, ModuleMessageHandler, ModuleMessageManager.RegisterHandler<T>, MessageRelay.RelayModule<TMsg,TData>, CommonMessageRoutes, INetSerializable and NetworkPlayerManager.TryGetPlayer(byte, …)
  • the PhysicsRig, OpenController and OpenControllerRig members the mod uses, all of which LabFusion itself uses

These were not verified and are marked in the code:

  • The grab button and surface leap read and suppress _thumbstick/_thumbstickDown/_thumbstickUp and _bButton/_bButtonDown/_bButtonUp, and holds the grip with _solvedGrip, on OpenController (named like the _aButton/_aButtonUp fields the mod already uses).
  • The single-player hand grab looks up Grip.OnGrabConfirm(Hand, bool) and Hand.DetachObject() by reflection and logs if either is missing.
  • Collider.ClosestPoint contact checks skip non-convex mesh colliders.
  • NPC stealth scans BehaviourBaseNav at runtime for sight or hearing members and logs what it finds. It turns itself off if it finds none.
  • Body-audio muting only covers AudioSources that are children of the rig.
  • Debug rays use CreatePrimitive and turn themselves off if that call was stripped from the build.
  • The force constants are first guesses. Expect to tune Stickiness, Surface Gravity and Align Speed in BoneMenu.