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.7.2. Please report problems with the exact lines from MelonLoader/Latest.log that start with [Sling].

Features

• Mounts on your body, and a hook that clips on (0.7.0). The wear spots have real fixtures: a D-ring on a tab, a round ring or webbing loops. They appear while you hold a strap (or always, or never: Wear spots > Mounts and hook). Bring the strap close and its clip flies to the ring, swings about the bar and clicks shut; taking the strap off opens it again. A worn strap lies on your torso instead of passing through it.
• Reacts to the world (0.7.0). The strap follows the light of the level, creaks, rattles or rustles with its material, makes the controller hum when stretched, and lets go of your body when pulled hard enough (Breakaway).
• Lettering, patches and wear (0.7.0). A name tape or a patch on flat bands, lettering on the dog tag (pick a preset or write your own in tag.txt), four wear levels, eight themes that set a whole look at once, sixteen charms with a second one beside the first, neon modes, many pictures from a folder, and looks you can share as a short line.
• Realistic look. Everything is lit from where your head is, so metal, leather and fabric change as you move: sky and window reflections in the steel, brass and chrome, a soft sheen on fabric, real thread stitching along the edges of leather, padded and wide straps, band ends folded around the hardware (except the riveted claw hook), fine textures (twill webbing, leather grain, quilting, braid, rope fibre), glowing neon and polished steel chain.
• Physical strap with eleven looks and real hardware. Tactical webbing (the first model: flat band, flat rings, slide buckle), simple line, leather (thick stitched leather, brass claw hooks, tongue buckle with a keeper and a holed tail), padded (quilted cushion, quick-detach swivels, triglide with a tail), paracord (snap hooks and a cord lock), twisted rope (wound strands, snap hooks, thread whipping), chain (60 links, shackles), neon, cobra weave (thick striped band, screw-gate carabiners), bungee (thin elastic cord, snap hooks, cord lock) and wide combat (wide band with a centre stripe, shackles, ladder lock). Bands have thickness and rounded edges, narrow toward the fittings, and the loose tail of the adjuster lies on the band and bends with it. Switch in Color and look > Strap model. It sags when slack, pulls tight and gets a little thinner when stretched.
• Pick the hardware yourself. Color and look > Hardware and stripes: end fitting (ring, quick-detach swivel, snap hook, claw hook, carabiner, shackle), adjuster (none, slide, triglide, ladder lock, tongue buckle, cord lock), metal finish (steel, black, brass, gold, chrome, gunmetal), stripes and an accent colour.
• Eleven textures: webbing, plain, woodland / desert / urban / snow camo, cobra weave, braid, neoprene, carbon, or your own picture. Fifteen charms (two can hang at once): dog tag, carabiner, tassel, cartridge, skull, gold coin, key, whistle, magazine, grenade, flashlight, bell, feather, compass, glow stick.
• Strap length per gun (Strap length: longer, shorter, automatic; remembered) and smart length (longer guns get longer straps). Three look slots and Paint ALL straps. A metal clank when the strap snaps taut. Hold Grip and the trigger at the adjuster and slide your hand along the strap to change its length (away from the gun = longer). Surprise me picks a random look.
• 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 or right shoulder, neck, chest, belly, back, left or right hip, left or right thigh, 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.
• Wrap tape. Aim at any part of the gun and press the trigger: colored tape winds around it. As many wraps as you want, 10 color presets plus your own RGB, plain / warning stripes / camo, adjustable width and turns. A/X switches the color while you aim, B/Y undoes. Tape stays on the gun and is remembered per gun.
• Gun memory. Calibration, paint (the whole look: model, color, texture, charm, hardware) and tape 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.

Mounts and the hook

Sling > Wear spots > Mounts and hook. Mounts on the body: Auto (shown while you hold a strap and where one hangs), Always or Off. Mount style: D-ring on a tab, round ring or webbing loops. Hook animation switches the clip flying to the ring and snapping on/off (off = instant attach). Breakaway sets how hard a worn strap has to be pulled before it lets go (Off / Easy / Normal / Hard). Mounts follow the spot sliders, so after you move a spot, the ring moves with it.

Lettering, patches, wear and themes

Sling > Color and look > Strap model has Second charm and Themes; Hardware and stripes > Wear, patches and lettering has Wear, Patch on the band, Neon glow and the lettering buttons. The game menu has no text box, so lettering comes from a list of presets (Lettering: next / previous) or from the first line of UserData/WeaponSling/tag.txt (Lettering: read tag.txt; a slash starts a new line on the dog tag). Letters are A-Z, 0-9 and a few signs.

Sharing a look, many pictures, diagnostics

• Sling > Settings > Guns, sharing and diagnostics > Share my look copies a short line of numbers and writes UserData/WeaponSling/look_export.txt. Take a look reads one from the clipboard, or from look_import.txt.
• Put several PNG files into UserData/WeaponSling/pictures; Color and look > Color > Next picture / Previous picture steps through them (choose the texture MyPicture).
• Write a diagnostics report writes what the mod found (shader, light source, settings, pictures) to the log and UserData/WeaponSling/report.txt. Please send it with a bug report.

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 > Laser and calibration > Laser test and change Laser direction and Laser tilt until it matches.

Wrap tape

1. Pick up the gun, then BoneMenu > Sling > Wrap tape > Start wrapping, and close the menu.
2. A thin beam comes out of the hand that is not holding the gun, with a ring that shows where the tape would go.
3. Aim at a part of the gun and press the trigger. The tape winds around that part. Do it again on other parts or on the same part.
4. A / X on the beam hand: next color. B / Y: undo the last wrap (press again with nothing left to end the tool). The tool also ends after a few minutes without use, or with Stop wrapping.
5. Colors, pattern, width, turns and winding axis are in Wrap tape > Tape colors and Wrap tape > Shape and pattern. If a wrap goes around the wrong way, set Wind around to one of the item's axes.

The beam uses the same hand, button, direction and range as calibration (Settings > Laser and calibration). Tape sits on the gun's collision shapes, so on some guns it floats or sinks a few millimetres; Distance from the part fixes that.

Strap models and charms

Sling > Color and look > Strap model: Model picks the look, Next model steps through them, Charm on the strap and Second charm hang charms from it, Show hardware (in Hardware and stripes) switches the metal parts off, Surprise me picks a random look. A strap you painted keeps its own model (Paint strap on last held item saves it for that gun); Strap follows global look (in More look options) releases it.

Custom wear spot

Sling > Wear spots > Lower body > 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 MyPicture (or the preset My texture) in Sling > Color and look, then press Reload the chosen picture under Color > Color. 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, and (when Strap lies on the body is on) on your torso, which is approximated as an ellipse around the body spots. It passes through your arms, 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 (on the underside, rear and front) and may sit oddly on some items.
• Tape is built from the gun's collision shapes, so very simple colliders give a boxy wrap. Up to 12 wraps per gun.
• 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).
• Other files in UserData/WeaponSling: strap.png and the pictures folder, tag.txt (your lettering), look_export.txt / look_import.txt (sharing looks), report.txt (diagnostics).
• 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.