Weapon Sling

A physical weapon sling for BONELAB. The strap is a real rope you can grab with both hands, stretch, and wear on your body, and your gun hangs from it and swings.

Version 0.2.0. Please report problems with the exact lines from MelonLoader/Latest.log that start with [Sling].

Features

• Physical strap. It sags when slack, pulls tight when stretched and turns red when stretched hard.
• Two-handed grab. Squeeze Grip with an empty hand next to the strap to hold that point. Hold two different points with two hands to stretch it.
• The gun hangs from the strap. While you hold the strap, the gun is carried by it and swings on it.
• Wear it anywhere: left shoulder, right shoulder, neck, chest, belly, back, or a custom spot you save yourself. Each spot can be switched on or off and moved with sliders. All enabled spots work at once; the nearest one to your hand catches the strap. The popup tells you where: Sling attached - Belly.
• Hint dots show the enabled spots while you hold a strap, and the spot about to catch it lights up.
• Take it off. Grab the strap at its spot and yank it away. You get a popup: Sling removed.
• Manual calibration. Put the strap ends exactly where you want them: a small laser with a dot, place the REAR end, then the FRONT end. The strap appears between the two dots.
• Colors and looks. RGB sliders, presets (black, sand, olive, red, blue, white, camo), match the gun's color, webbing / plain / camo textures, or your own picture (UserData/WeaponSling/strap.png). Paint a single strap without changing the others.
• Gun memory. Calibration and paint are remembered per gun. Optionally the strap is attached automatically when you pick that gun up again.
• Cross-body mode. A shoulder strap that also pins to the opposite hip.
• Quick draw. With the strap worn, squeeze the trigger with an empty hand near the wear spot and the gun flies to your hand.
• Auto-fit length to the wear spot and your body size.
• Lies on the floor. A dropped or thrown gun leaves its strap lying on the ground instead of sinking into it (can be switched off).
• Feedback. Controller buzz and a click sound when the strap goes on or comes off.
• BoneMenu settings for everything. Changes apply instantly and are saved.

How to use

1. Pick up a gun (or any item), then open BoneMenu > Sling > Attach strap to last held item. A strap appears on it. (Or use Calibrate strap on last held item to place both ends yourself.)
2. Grab the strap with an empty hand (Grip). Hold it with one or both hands.
3. Bring the held strap to a wear spot (the dots show where). It attaches. Yank it away to take it off.
4. Trigger with an empty hand near the wear spot calls the gun to your hand.

Calibration

1. Hold the gun or put it down in front of you, then BoneMenu > Sling > Calibrate strap on last held item, and close the menu.
2. A laser with a dot comes out of your hand. Aim at the rear end spot of the gun and press the trigger. A blue dot stays there.
3. Aim at the front end spot and press again. The strap appears.
4. B / Y button: one step back (cancel at the first step). The laser comes from the hand that is not holding the gun, so the trigger never fires it.

If the laser does not point where your hand points, use Sling > Calibration settings > Laser test and change Laser direction and Laser tilt until it matches.

Custom wear spot

Sling > Wear spots > Custom spot > Save here. Hold your hand where you want the strap to hang; the position is saved after 4 seconds.

Your own strap picture

Put a PNG named strap.png into UserData/WeaponSling, then choose the texture CustomPng (or the preset My texture) in Sling > Color and look, then press Reload strap.png under More look options. The picture is stretched once along the strap, so a long, thin image works best (for example 512x16). Colors multiply the picture, so use the White tint if you want it unchanged.

Requirements

• BONELAB on PC (Quest is not supported).
• MelonLoader and BoneLib (installed automatically by mod managers).

Multiplayer (Fusion)

The gun's position is synced by Fusion, so other players see it hanging and swinging. The strap itself is drawn only for players who have this mod, and its forces are applied on your own client.

Known limitations

• The strap does not pull on you or your hands, only on the gun.
• The strap lies on the floor and against walls, but only collides with the static world. It passes through your body, loose props and other players.
• Where the body spots are is a rough estimate from your head position. Use Body size and the per-spot sliders to fit them to you.
• If you do not calibrate a gun, the strap ends are picked automatically from its model and may sit oddly on some items.
• Up to 4 straps at a time. Straps are removed when the level changes (remembered guns get their strap back on pickup if auto-attach is on).

Files and settings

• Settings: BoneMenu > Sling, saved in UserData/MelonPreferences.cfg under [Sling], [Sling_Style] and [Sling_Wear].
• Remembered guns: UserData/WeaponSling/guns.txt (plain text, safe to delete).
• If a controller button is not detected on your setup, check the log for the line Readable bool/float/int members and set GripMethod, TriggerMethod, PrimaryMethod or SecondaryMethod in the config.