Documentation · NEXUS Bodycam

8presets

17DoF passes

3.06sbreathing cycle

75–83FPS with everything on

Systems

Every icon opens the internals

These are the subsystems that make up the mod. Click any card to open the matching diagram — including the family tree of the code.

dev.bodycam mod root
- BodycamClient — client entrypoint
- BodycamModMenu — Mod Menu entrypoint
- camera — the heart of the camera
  - BodycamEffects — orchestrates bob, shake, roll, breathing
    - TemporalSmoother — smoothing on real delta
    - Spring — damped spring (k/c)
    - CameraState — per-frame persistent state
    - ChestCam — chest mode + wide FOV
  - BreathSound — breathing + synced OGG
  - PostEffects — exposure, flash, motion blur
  - WaterEffects — waves, caustics, refraction
  - tacz — optional weapon realism
    - TaczBridge — reflection bridge
    - TaczGunRealism — weapon spring (2nd order)
    - TaczSway — run sway / ADS
- compat
  - IrisCompat — shaderpack detection
- config
  - BodycamConfig — JSON + validation
- core
  - GameState — game context
  - RenderCoordinator — render phase
- gui
  - BodycamConfigScreen — settings screen
- mixin — injection points
  - CameraMixin — getRotation / update
  - GameRendererMixin — renderWorld
  - EntityMixin — footsteps synced to audio
  - ClientPlayerEntityMixin — player state
  - TaczGunTransformMixin — weapon transform (TACZ only)
  - BodycamMixinPlugin — enables/disables mixins

dev.bodycam — 6 packages, 19 classes. The mixins are the only contact with Minecraft's code; everything else is pure client-side.

Effect	Behaviour
`Surface waves`	Procedural displacement at the waterline
`Caustics`	Noise-driven pattern projected onto the floor
`Foam`	Contact edge against the terrain
`Refraction`	Distortion of the image behind the water
`Fog + RGB tint`	Full submersion, with a lens response

Footsteps are also surface-aware: sound and shake change with the block underfoot (grass, sand, stone, water).

It never touches raycasts, bullets or aiming. Without TACZ installed the mixins disable themselves via BodycamMixinPlugin.

Genuinely optional

TACZ is not a dependency — it is a bonus. The mod compiles, installs and runs on a machine that has never seen a TACZ jar. Two things guarantee that, and both are about compilation, not runtime:

Piece	Without the TACZ jar
`TaczBridge`	Compiles. It has no `import com.tacz.` at all — it resolves the API via reflection*.
`TaczGunTransformMixin`	Left out. It must `@Mixin` a TACZ class, so there is no way to compile it.

No third-party code enters the repository. The TACZ jar is gitignored, none of its code is copied, and none of its classes are bundled into the final jar — build.gradle only consumes it as modCompileOnly.

How the reflection works

Two details make this cheap and hard to break:

TACZ's event bus is the Fabric event bus (net.fabricmc.fabric.api.event.Event), which you already depend on. Only the listener type becomes a proxy — registration is an ordinary call.
Minecraft types are never named. The live ClientPlayerEntity is handed straight to the reflective call, so the code is tied to no mapping.
Lookups match by name + arity, not by descriptor. If TACZ ever renames a method the bridge disables itself with a log — never a LinkageError.

What TACZ adds

Weapon spring of 2nd order with overshoot — recoil has weight.
Weapon lower while sprinting and while crawling.
Run sway plus stabilization while aiming (ADS).
Reload response and wall proximity.
Phase D kit: inertia, movement-to-aim, recoil kick.

Architecture

The contract: pure client-side

The mod changes only how the camera is drawn. No competitive advantage — by construction, not by promise.

What it does

Rewrites the world render matrix
Adds post-processing shaders
Plays local breathing audio
Saves config to config/bodycam.json

What it does NOT do

No change to speed or collision
No touching of hitboxes or raycasts
Nothing is sent to the server
No effect on TACZ bullets or aiming

Injection points

CameraMixin — camera rotation
GameRendererMixin — render phase
EntityMixin — footsteps ↔ audio
TaczGunTransformMixin — weapon (TACZ only)

In action

Previews

Every clip lives in gameplay/ in the repository.

Installation

Three steps

Requirements: Fabric Loader ≥ 0.15.11 · Fabric API · Java 17+.

Install Fabric Loader

For Minecraft 1.20.1. Get it from the official site.

Download the JAR

Grab the JAR from the latest release — the download buttons never need updating: they always resolve automatically to the newest published version (v1.4.3+1.20.1).

Drop it in `mods/`

Optional: Mod Menu for the config screen, TaCZ for guns, Iris for shaders.

Building from source

git clone https://github.com/jhfuheuiwfh/nexus-bodycam-mod.git
cd nexus-bodycam-mod
./gradlew build          # Windows: gradlew.bat build

The artifact lands in build/libs/. It compiles without TACZ — in that case the weapon mixin is left out and the bridge stays off. For the full package, put the TACZ jar in libs/ before building. libs/ is gitignored because that jar is third-party.

Compatibility

Works with your setup

Mod	Status	Notes
Fabric API	Required	—
Mod Menu	Optional	Opens the in-game settings screen
TaCZ	Optional	Weapon realism (visual only). Wired via reflection — without it the mod still works
Iris / Sodium	Compatible	Shadow passes are skipped
Bodycam shaderpacks	Compatible	Use "Sync with Shader"
Distant Horizons	Compatible	—

Watch out for mod compatibility. Versioning semantics: 1.0.x = small fix · 1.x.0 = big feature · x.0.0 = heavy rework. If something breaks, test before blaming another mod.

Roadmap

Still to be validated

Implemented, but not yet confirmed comfortably in game.

Needs playtesting

Blurred vignette (v1.4.3) — slider 0…1, default 0.6
Aim alignment while mining (chest cam on/off)
Breathing exhaustion at 5 s / 20 s of sprint
TACZ feel: spring, lowering, sway, recoil

Ideas without a date

Bodycam REC overlay (timestamp, battery, blinking dot)
Share presets by importing a bodycam.json
Script that fetches the TACZ jar into libs/
Localization beyond en_us / pt_br

Transparency

Disclosures

AI usage

This project is substantially AI-generated and owns that openly. Most of the code, shaders, assets and documentation was produced by AI agents, with the human author directing the work, playtesting in game and making the final calls.

Full details in AI-TRANSPARENCY.md.

Warnings and license

Photosensitivity: this project may contain flashing lights.

Released under GNU GPL v3.0.

Independent project. Not affiliated with, sponsored by or endorsed by Mojang Studios or Microsoft. Minecraft is a trademark of those companies.

A bodycam inside Minecraft.

Every icon opens the internals

Code family tree

Temporal architecture

Synced breathing

Lens pipeline

Water effects

TACZ integration

Genuinely optional

How the reflection works

What TACZ adds