You are viewing a potentially older version of this package. View all versions.
DuoLab-CameriumCamera-1.9.4 icon

CameriumCamera

In-game camera for BONELAB: 9 modes (handheld, bodycam, headcam, tripod, security, 3rd person, orbit, selfie, drone) and 11 looks (camcorder, 2007 & 2009 Android, bodycam, VHS, CCTV and more). All settings in BoneMenu.

By DuoLab
Date uploaded 5 days ago
Version 1.9.4
Download link DuoLab-CameriumCamera-1.9.4.zip
Downloads 276
Dependency string DuoLab-CameriumCamera-1.9.4

This mod requires the following mods to function

bonelib-BoneLib-3.2.2 icon
bonelib-BoneLib

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

Preferred version: 3.2.2

README

Camerium (Cm, element 35)

Camerium made by DuoLab

The periodic table of cameras for BONELAB. Film your fights on a 90s camcorder, a crunchy 2009 Android phone, realistic bodycam footage, VHS, CCTV, night vision, or as a cinematic shot. Every setting is in BoneMenu, and the main ones are also buttons on the camera itself.

The camera

When you turn Camerium on, a handheld camera appears in front of you. It has a big live screen, a chunky frame with grip handles on both sides, a lens on the back and a selfie lens on the front.

  • Grab either handle with your grip button to hold it. It's a physical object, so it collides with walls and props. Let go and it floats where you left it like a tripod, or drops if you turn on Drop When Released.
  • Poke the buttons with your index finger:
    • < > change the mode and the effect (or tap the name itself)
    • - / + change FOV, ZOOM and SMOOTH
    • FLIP switches between the back lens and the selfie lens
    • PHOTO, LIGHT, HUD, FX (overlay effects), quality (480p–1440p), and a big RECORD button
  • Lost it? Use Summon Camera in BoneMenu, or press F4.

The image you see on the screen is the exact image that goes to your desktop window (record it with OBS) and into your photos: the noise, scanlines, compression blocks, date stamps and REC overlay are all included.


Modes (where the camera is)

# Mode What it does
1 Handheld The camera device: hold it, aim it, or leave it floating.
2 Bodycam Strapped to your chest. It follows your avatar's real torso (leans, twists and crouches with your body), not where your head looks. Wide fisheye lens, and it bobs as you walk.
3 Headcam Locked exactly to your eyes by default, with no offset or lag, but with a wide action-cam lens. You can also pick a forehead, side, top or chin mount; the side and top mounts show the helmet edge in the shot.
4 Tripod A fixed shot. Place Tripod Here drops it at your hand.
5 Security Cam Fixed in place, but turns to follow you.
6 Third Person An over-the-shoulder follow cam that stays out of walls.
7 Orbit Circles around you.
8 Selfie The device's front lens, pointed back at you. FLIP toggles this.
9 Drone Hovers behind and above you with a floaty lag.

Effects (how it looks)

Effect Look
Clean No filter.
90s Camcorder Hi8 / VHS-C: soft 4:3 at about 300 lines, heavy tape noise (black-and-white and colored), interlace lines, milky lifted blacks, color bleed, blooming highlights, and a chunky white STBY / REC / SP OSD with a 1996 date stamp.
Android 2007 A first-gen phone: 192×144 at 12 fps, upscaled soft, washed-out grey-lavender colors, heavy blotchy compression blocks and dark speckles. Very crunchy.
Android 2009 The same washed-out phone look, toned down so you can see what's happening: about 267×200 at 15 fps, with lighter blocking and speckles. Still clearly a bad phone camera.
Bodycam Wide 108° fisheye, heavy bloom, desaturated, grain, motion blur, a UTC timestamp and a unit ID.
CCTV Black and white at 10 fps, CAM 0x label and timestamp.
Night Vision Green phosphor, huge bloom, IR noise, a reticle.
VHS Chromatic bleed, rolling tracking bands, head-switch noise, PLAY, SP, and a VCR date.
Cinematic 2.39 letterbox, 45° lens, ACES, warm grade.
Action Cam 118° wide lens, punchy colors, a GoPro-style HUD.
Film Noir High-contrast black and white with heavy grain.

BoneMenu: Camerium

  • Main: Camera On, Mode, Effect, Take Photo, Start/Stop REC, Summon Camera, Place Tripod Here, Reset All
  • Lens: FOV, Effect Picks FOV, Zoom, Resolution, Aspect Ratio (16:9, 4:3, 21:9, 1:1, 9:16), FPS Cap, Authentic Res/FPS, Near Clip, Dutch Tilt, Auto-Focus DoF, Aperture, Camera Light
  • Motion: Wrist Monitor Hand, Position/Rotation Smoothing, Shake, Horizon Lock, Bodycam Walk Bob, Camera Collision
  • Placement: offsets, Pitch/Yaw, Headcam Mount, Helmet Edge In Shot, Clear Own Face, Third Person / Orbit / Drone distances
  • Effects: Strength, Bloom/Grain/Vignette boosts, Saturation, Exposure, Overlay FX, Letterbox, Keep Map Post FX
  • HUD: Show HUD, REC, Timestamp, 24h, Fake Year (one tap sets 1996), Battery, Rule of Thirds, Bodycam Unit ID, Custom Text
  • Output: Desktop View (Fullscreen / PiP / Off), PiP Size and Corner, Show Camera Device, Device Live Screen, Device Size, Wrist Monitor, Open Photos Folder
  • Presets: 3 save/load slots, plus quick presets: Bodycam Footage, 90s Camcorder, Old Android Phone, Helmet Cam, Security Footage, Movie Shot

Shortcuts

Input Action
Grip near a handle Hold the camera (let go to leave it floating)
Index finger on a button Press it
Click both thumbsticks together Take a photo (turns the camera on if it's off)
Hold both thumbsticks for about 1 second Start or stop REC
F6 / F7 / F8 Camera on/off · next mode · next effect
F9 / F10 / F5 Photo · REC · desktop view
F4 / End Summon the camera · place the tripod
PgUp / PgDn / Home Zoom in · zoom out · reset zoom

Installing

Mod manager: click Install. BoneLib is installed automatically.

Manual: you need MelonLoader 0.6+ and BoneLib 3.2+. Put Camerium.dll in BONELAB/Mods/.

Recording

Press REC (on the camera, in BoneMenu, F10, or hold both thumbsticks) to record a real .mp4 video with sound. Press it again to stop.

  • What's recorded: exactly what the camera shows, with the effect, noise and HUD.
  • Sound: the game audio (whatever your PC is playing) plus your voice from your default microphone, usually your VR headset mic. Each has its own on/off switch and volume in BoneMenu > Camerium > Recording. Lo-fi looks also make the recording sound lo-fi (phone mic, tape hiss, bodycam compression) - turn off with Effect Changes Sound. When the camera is away from you, your voice gets quieter and more muffled with distance and behind walls (you can turn this off). The RECORD button shows MIC while your voice is being recorded.
  • Where: videos are saved to BONELAB/UserData/Camerium/Videos. There's an Open Videos Folder button on the Recording page.
  • Quality: Low, Medium or High, and 10–60 FPS. Low-resolution looks are upscaled to at least 480p so they play well on any site.
  • Requirement: Windows Media Foundation, which every normal Windows install has. "N" editions need Microsoft's free Media Feature Pack.

Notes

  • Photos are saved to BONELAB/UserData/Camerium/Photos.
  • Performance: the camera renders the scene a second time. Use 480p or 720p, or an FPS Cap, if your frame rate drops. Low-res looks like Android, CCTV and the camcorder cost less to render.
  • Auto-Focus DoF can soften the HUD text, because the HUD is inside the image.
  • Settings save on their own to UserData/Camerium/settings.json.

CHANGELOG

Changelog

1.9.5

  • Properly fixed broken heads on camera. BONELAB hides your own head in first person in two ways. Besides hiding the head and hair meshes, it shrinks the head bone to almost nothing. That collapses the hair into the skull (the 'buzzcut') and pinches the neck of the body into a point. The camera now gets copies of your avatar's head, hair and body, attached to a private full-size copy of your head skeleton that follows your real head every frame. Your VR view is unchanged.
  • The log now records how much the game shrank the head bone for each avatar, to make any future head problems easier to diagnose.

1.9.4

  • Fixed the camera's keys not responding at all (a 1.9.3 bug):
    • Squeezing grip no longer blocks presses. In BONELAB you squeeze grip to make a pointing hand, so that rule blocked pointing itself.
    • A key now presses when your visible fingertip touches it. Before, you had to push your finger about 1.5 cm through the key.
  • Still in place from 1.9.3: the hand holding the camera can't press keys, your finger has to come in from the front, and it has to rest on the key briefly (now 35 ms).

1.9.3

  • No more accidental key presses while moving. A key now only registers a deliberate poke:
    • The hand holding the camera can't press keys, and neither can a hand squeezing grip or holding an item.
    • Your finger has to come in from the front and push into the key. Sliding across the face or brushing in from the side doesn't count.
    • Your finger has to rest on the key for a split second (50 ms), so quick brushes while running are ignored.
    • After a press, you have to pull your finger back before the same hand can press again.
  • New: Lock Camera Buttons (Output page) turns the camera's keys off completely. BoneMenu and the keyboard shortcuts still work.

1.9.2

  • Removed all in-game pop-up alerts. Camerium no longer shows any notifications: not for mode or effect changes, recording start or stop, saved photos or videos, or warnings. Everything is written quietly to the MelonLoader console and log (MelonLoader/Latest.log) instead.

1.9.1

  • Fixed broken heads on camera (missing hair, open neck). BONELAB hides your own avatar's head and hair from your eyes in first person by setting them to 'shadows only', which also hid them from Camerium. That's why Ford had a buzzcut and a broken neck. The camera now gets its own copies of your head and hair, attached to the same skeleton, so they follow every movement and facial expression. The copies sit on Camerium's private layer, so your VR view stays unchanged.
  • Works with every avatar and updates when you switch avatars. It's switched off in Headcam mode, where the lens is inside your head. Toggle it with Show Your Head On Camera (Output page).

1.9.0

  • Lo-fi looks now sound lo-fi too. Each effect gives the recording (game sound and your mic) its own sound character:
    • Android 2007: tinny phone-call quality: mono, narrow band, 8 kHz, crunchy and distorted, with hiss.
    • Android 2009: the same phone sound, but clearer.
    • 90s Camcorder: muffled tape audio with hiss and a slight tape wobble.
    • VHS: duller, hissier tape with more wobble.
    • CCTV: a tiny, narrow security-camera mic.
    • Bodycam: mono, punchy, heavily compressed, and clipping on loud sounds.
    • Night Vision / Action Cam: lightly compressed and band-limited.
    • Film Noir: old mono film sound with hiss.
    • Clean / Cinematic: untouched.
  • The sound switches live if you change effects while recording. Turn it off with Effect Changes Sound on the Recording page.

1.8.0

  • Android 2007 (new name for the old Android 2009 look): the full-crunch first-gen phone camera, at 192×144 and 12 fps with heavy compression blocks and specks.
  • New Android 2009: the same washed-out lavender-grey phone colors, but with the damage toned down so you can actually see what's happening. It runs at about 267×200 and 15 fps, with about two-thirds of the blocking and speckles. It's still clearly a bad phone camera.
  • New quick preset: Ancient Phone (2007). Old Android Phone now uses the new 2009 look.

1.7.2

  • Fixed being frozen in place while holding the camera. In 1.7.1 the held camera became a kinematic body. BONELAB treats those like world geometry, so your hand latched onto the handle as a climbing hold, and neither you nor the camera could move. The camera now stays a normal physics object while you hold it, and is still placed exactly on your hand every frame.
  • Fixed the camera getting stuck on things it was already touching. The wall check now ignores surfaces it's resting against and only blocks real walls in its path.
  • Avatar swaps: after you change avatars, the camera re-checks your body's colliders so it doesn't bump into your new avatar.

1.7.1

  • The handheld camera now stays exactly in your hand, including while walking. Before, physics pulled it toward your hand, so it always trailed behind. Now, while you hold it:
    • it's placed exactly on your hand every frame, and again right before the frame renders, with no smoothing delay
    • it still can't pass through walls, because its path is checked each frame (if your hand stays inside a wall, it rejoins your hand after a moment)
    • it still pushes props around
    • when you let go, it keeps your hand's momentum, so you can toss it with Drop When Released on
  • The handheld view is locked to the camera. There's no smoothing lag and no fake shake; your real hand motion is the shake. Turn on Handheld Stabilizer (Motion page) for smooth, gimbal-style shots.

1.7.0

  • Your voice now follows the camera. When the camera isn't on you (a floating handheld, tripod, security cam, third person, orbit or drone), your voice gets quieter and more muffled the farther you walk away, and extra muffled when a wall is between you and the camera. At about 5 m behind a wall it's roughly 21 dB quieter with most of the high detail gone. Holding the camera, the headcam and the bodycam stay at full clarity.
    • New options on the Recording page: Voice Fades With Distance and Distance Falloff (0 = never fades, 2 = fades fast).
  • Fixed the headcam offset. The new default Eyes mount puts the headcam exactly at your eyes, with no offset, no lag and no wobble. It also cuts through your own face so your avatar's head doesn't block the view. Your existing setting switches to Eyes automatically; Forehead, Side, Top and Chin are still available.
  • Headcam locked to your head: it's re-positioned onto the headset's latest pose right before each frame renders, so it no longer trails a frame behind when you turn quickly.

1.6.0

  • Voice recording. Your microphone (your default Windows recording device, usually your VR headset's mic) is recorded and mixed into the video's soundtrack along with the game sound.
    • Voice stays in sync even when the game is silent.
    • A soft limiter stops loud voice plus loud game audio from crackling.
    • The camera's RECORD button shows MIC while your voice is being recorded.
    • If no microphone can be opened, the video still records, and a popup tells you why there's no voice.
  • Recording page: Record Game Sound, Game Volume, Record Voice (Mic) and Voice Volume (0–400%, default 150%).

1.5.1

  • Fixed the camera jittering while recording.
    • Frames are now copied off the graphics card in the background (async GPU readback), so recording no longer makes the game wait each frame. On systems that don't support this, it falls back to the old method.
    • The pull that keeps the handheld camera in your hand now uses the real frame time, so a dropped frame can't make it overshoot and shake.
    • Internal image copies no longer leave the game's render target changed.

1.5.0

  • Real video recording. REC (the device button, BoneMenu, F10, or holding both thumbsticks) now records a real .mp4 file with H.264 video and AAC sound, using Windows' built-in encoder (hardware-accelerated when your GPU supports it).
    • The video is exactly what the camera shows: effects, noise and the HUD are all included.
    • Sound is whatever your PC is playing (the game audio).
    • Files are saved to BONELAB/UserData/Camerium/Videos/, and a popup shows the file name when it's done.
    • Encoding runs on a background thread. If the encoder falls behind, frames are skipped instead of slowing the game.
    • Recordings stop and save automatically when you change levels, turn the camera off, or quit the game.
  • New BoneMenu page: Recording. It has Start/Stop, Save Video File, Record Sound, Video Quality (Low/Medium/High), Video FPS, and Open Videos Folder.

1.4.1

  • Fixed Bodycam and Cinematic showing a black screen. Both used motion blur, which BONELAB's renderer can't provide to a second camera, so motion blur has been removed.
  • Faster black-frame guard: it checks every second. On a black image it first turns off the riskier effects (tonemapping, depth of field, heavy bloom) and shows a popup. Only after that does it stop using the map's post-processing.
  • The guard now resets when you switch effects, so one bad effect no longer weakens the others.

1.4.0

  • The camera is now a physical object. It has colliders on the body, both handles, the lens and the battery pack. It bumps into walls and props, and props bump into it.
  • Holding it: it's pulled toward your hand by physics, so it stops at walls instead of passing through them. If it gets stuck more than about 35 cm from your hand for a second, it snaps back.
  • Letting go: it floats in place like a tripod but can be knocked around. Turn on Drop When Released (BoneMenu > Output) to make it fall with gravity instead.
  • Your own body: it ignores your player's colliders, so your hands and body don't shove it while you hold it or press keys.
  • Lost camera: it summons back to you if it falls out of the world or ends up more than 20 m away.

1.3.1

  • Fixed the device screen and labels showing up black. The FOV, ZOOM and SMOOTH readouts, the mode and effect names, the quality setting, RECORD and the live screen used a glow (emission) effect that BONELAB's build strips out. They now use the same shader BONELAB's own menus use, so they always render.
  • Easier to press keys: a larger press zone, a few millimeters of leeway around each key, and it works with short and long avatar fingers.
  • A popup now confirms the new mode or effect when you change it on the device.
  • Safety fallback: if copying the camera image ever fails, the device and the desktop show the camera's render directly.

1.3.0

  • Fixed the invisible camera device. It now uses the same lit shader BoneLib uses, which is known to render in BONELAB, so the model is properly lit by the level. The screen and LCD labels glow on their own like real screens.
  • If any part of the model fails to build, the rest still appears, and the camera keeps working.
  • Fixed the headcam offset:
    • The headcam is now fixed rigidly to your head, so it no longer trails behind you while you move.
    • The default mount is now centered on your forehead. Side, top and chin are still options.
    • Existing settings are moved over to the new default.
  • The bodycam's position is also rigid now, and so is the handheld camera while you're holding it.
  • New: BoneMenu > Camerium > Output > Camera Info (debug) shows which shader loaded and where the camera is.

1.2.0

  • A real camera model replaces the flat boxes:
    • a rounded chassis with a printed faceplate and raised keys that move when you press them
    • D-shaped rubber grip handles with metal grip rings
    • a stepped lens barrel with a glass element and an orange ring
    • a battery pack, mic, shutter button, tripod mount, selfie lens and a blinking REC LED
  • The faceplate reads "Camerium made by DuoLab" at the bottom.
  • The device screen shows exactly what your PC shows, including the HUD and noise.
  • Fixed black screens on some effects (Camcorder, Android, CCTV, VHS):
    • The camera now renders every frame instead of switching on and off for low-FPS looks. Their frame rate is now applied when the image is copied for display.
    • URP's Stop NaN is on.
    • A guard checks the image every 2 seconds. If it stays pure black, the camera stops using the map's post-processing, and then switches to safe effect values if needed.
  • New text rendering: all labels and HUD text now use a font built into the mod, instead of the game's text system.

1.1.0

  • New camera device: a handheld camera with a big live screen, grip handles on both sides, a back lens and a selfie lens. Grab a handle to hold it, or let go to leave it floating. Poke its buttons to change mode, effect, FOV, zoom and smoothing, flip lenses, take a photo, and toggle the light, HUD, FX, quality and REC.
  • The HUD and noise are now part of the image. The device screen, the desktop feed and photos all show the full look.
  • Bodycam rebuilt: it's mounted on your avatar's real torso (shoulders and spine), so it leans and turns with your body instead of your head. It also uses a wide fisheye lens.
  • Headcam rebuilt: an off-eye helmet mount (side, top or chin), a wide lens, mount wobble, and the helmet edge visible in the shot.
  • 90s Camcorder: a softer analog picture, much more tape noise (including color noise), milky lifted blacks, interlace lines and a chunky OSD with a 1996 date.
  • Android 2009: no longer blue. It's now washed-out 144p phone video with blotchy compression blocks and dark speckles.
  • Removed the 3-second calibration. Summon Camera (BoneMenu or F4) brings the device back to you.

1.0.0

First release.

  • 9 camera modes: Handheld, Bodycam, Headcam, Tripod, Security Cam, Third Person, Orbit, Selfie, Drone
  • 10 effects: Clean, Camcorder, Android 2009, Bodycam, CCTV, Night Vision, VHS, Cinematic, Action Cam, Film Noir
  • A BoneMenu page for every setting: Lens, Motion, Placement, Effects, HUD, Output, Presets, Shortcuts
  • Desktop output in Fullscreen or Picture-in-Picture, for recording with OBS
  • A camcorder model you can see in VR, with a flip-out viewfinder screen and a blinking REC light
  • Optional wrist monitor on your other hand
  • Photos saved as PNG to UserData/Camerium/Photos
  • REC timer, timestamps, fake year (for example 2008), a battery icon, a bodycam unit ID and custom text
  • Auto-focus depth of field, a camera light, zoom, Dutch tilt, horizon lock and camera collision
  • 3 save/load preset slots and 6 one-click quick presets
  • Shortcuts for VR controllers and the keyboard
  • Settings save on their own to UserData/Camerium/settings.json