Kopper Camera

Kopper Camera

A unified, client-side camera system for Cobblemon packs. Forge 1.20.1, NeoForge 1.21.1 and Fabric 1.21.1.

Kopper Camera brings the camera work of several mods into a single camera arbiter: RPG-style third person, Cobblemon battle cameras, lock-on, level cameras and recorded camera paths. Other mods ask for what they want (position, look direction, framing, FOV, roll, shake) through the KopperLib API, and Kopper Camera decides who is in charge, blends the transitions, and steps aside when CMDCam or Freecam take control.

Early release. Expect rough edges, and please report anything odd on our Discord.

Features

Gameplay views

• RPG third person: the body turns toward where you walk or look, over-the-shoulder offsets, aiming and editable camera profiles.
• Dungeon view, plus improved first person.
• Distance profiles with smooth transitions and per-block collision filtering, so the camera does not clip through walls or get stuck in leaves.
• Smooth FOV when sprinting.

Cobblemon battles

• A battle camera that frames both sides, orbits and cuts between them.
• It follows each attack from the attacker to the impact, with zoom and shake on the hit (Forge 1.20.1 with Cobble Strike). On 1.21.1 it reacts to hits by HP loss.
• Cobble Strike lock-on runs through the same camera.

Level cameras (with Kopper Stages)

• Top-down, isometric, 2D side view, fixed camera and rails, with screen-relative WASD input.
• Hold X to nudge the camera (drag to pan, scroll to zoom). Shift+X puts it back.
• On-screen cursor in the top-down view, with magnetic snapping to targets and click-to-move.
• Sound stays on the player, and there is no view bobbing in 2D and top-down views.
• F9 drops the level camera and gives you the normal one back; press again to restore it.

Camera paths

• Build Bezier camera paths in the world with the in-game editor (/kamera path edit).
• Graph per channel, on-screen numbers and warnings, undo and redo.
• Ready-made templates: orbit, dolly, crane and flyby.
• Share paths with copy, paste, export and import as plain JSON.

Compatibility

• Cobblemon mounts: free-look camera while riding a Pokemon (works with PokeRider).
• Steps aside for CMDCam and Freecam. Leawind's Third Person is replaced by the RPG view, or you can keep Leawind in charge.
• Forge 1.20.1 only: MTR trains (smooth camera with its own collision) and Create: Hypertube (hands the camera to Hypertube inside a tube). Both can be turned off in the config.
• Safe around Valkyrien Skies 2 and other physics mods: its collision never uses the vanilla ray cast and rejects bad rays. Collision against ships is not supported yet.
• If you use Camera Fix Compat or Cobblemon Battle Camera, Kopper Camera switches the overlapping parts off and warns you.
• On Fabric, Kopper Camera carries the camera hooks other mods use for screen shake and roll through KopperLib.

Configuration

• Its own screen with General, RPG, Profiles, Block collision, Mods, Battle and Keys tabs (on Fabric, open it from Mod Menu).
• Every key is configurable. On Fabric the camera path editor shortcuts are fixed and do not appear in Controls.

Requirements

• Client only. Servers do not need it.
• KopperLib 1.6.0 or newer (all loaders).
• Fabric: Fabric API and Forge Config API Port. Mod Menu is optional.
• Optional: Cobblemon (battle camera), Cobble Strike (lock-on and attack cues), Kopper Stages (level cameras).

For developers

The API lives in KopperLib (CameraRequests, RigSpec): POSE, LOOK, FRAMING, ROLL, FOV, SHAKE and INPUT channels, each with priorities, blend curves and fallbacks. The camera path model (com.kopperlib.camera.path) is also part of KopperLib.

Community

Questions, bug reports and suggestions: Discord

Author: koppernico.