WK Cinema

Film White Knuckle with a free camera, editable camera paths and orbit shots. Frame gameplay clips, repeat a camera move or circle a subject while keeping a chosen point in view.

Created by Илюшкинс — YouTube.

Version and requirements

This package targets White Knuckle 0.61f and BepInEx 5. WK Cinema is a standalone plugin. The in-game interface supports Russian and English, selected with the shared RU/ENG button. Unsupported languages use English.

Version 0.2.4 fixes freecam activation and rotation, moves the 9:16 guide to the menu, adds a dedicated Disable noclip button and displays the shared language button in the native main menu. Compilation and automated checks passed; native in-game validation is pending. See VERIFICATION.md for the observed scope.

Language

Use RU / ENG at the upper right of the game’s main menu, or open F11 and use the same control there. It shows the active language and switches every connected mod immediately. WKCinema uses the existing shared-language protocol for compatible mods. Each mod also works alone. Only one eligible menu draws the language button; no extra plugin is required. Older binaries need a compatible update, and DirtyMass has not yet been connected.

The choice persists in the current profile's BepInEx/config/ilya.whiteknuckle.shared-language.cfg: [General] Language = ru | en | auto. auto follows the game's language, never the OS; unsupported or unavailable languages use English. The initial WK 0.61f selection comes from the game's Steam setting. A manual choice takes precedence until reset to auto. The first common initialization imports a saved manual MineKnuckle choice if no shared choice already exists.

Open menus and existing statuses update without restarting the run. Typed fields, camera paths, seed locks, height and the filming bookmark are preserved. Config descriptions include both languages. The existing IMGUI font and approved icon are retained.

Controls

Shortcuts support modifiers (either Shift/Ctrl key works). F5–F10 have no default Cinema actions. F5 remains the game’s debug panel. The 9:16 guide is menu-only: F11 → Camera. On upgrade, an existing orbit binding on F5 migrates to Ctrl+F3; custom non-F5 bindings and world settings remain. Legacy default F6/F7/F8/F9 bindings also migrate. Do not delete your config. Compatible mod menus open one at a time.

Keys can be changed in BepInEx/config/ilya.whiteknuckle.cinema.cfg after the first launch. Remap any key already used by another mod.

Freecam keeps native movement controls: WASD for movement, Space/F for height, Q for precision adjustments, the wheel for speed, Shift + wheel for FOV and Alt + wheel for turn speed.

Persistent world and filming location

Open F11 → Мир и место (World and Location).

• Enter a seed and close its red padlock to reuse that starting seed on every new run. The green open padlock selects a fresh random world. Press Apply after editing a field that is already locked. Seed 0 is supported; -1 is reserved by the game.
• Enter a player height and close its second padlock to return to that height after loading. Opening it restores the normal start behavior.
• Запомнить это место и закрепить оба замка captures the current location and locks both controls. It saves the starting seed, corrected height, position relative to the level and player look direction. If freecam is active, its view and FOV are also saved.
• Вернуться сейчас returns in the current world. Перезапустить с этими настройками restarts the run with the selected settings. Settings persist in the plugin config across full game restarts.

Location restoration enables the native filming cheats, godmode and noclip so an airborne bookmark will not immediately fall. It waits for geometry and continues native world generation when necessary. Restoration runs once; it does not pin the player afterward.

Use the same game mode, options and version for an exact location. Manually editing the height clears the exact anchor and instead selects a basic position in the matching height region. A random seed plus a locked height gives the same altitude in a different world. This version supports bookmarks in the main world; side branches are not captured. Ordinary Continue/save loading is preserved: start a new run for the filming preset. Unavailable regions produce a status message. Loading is bounded to 180 seconds and 64 continuation steps and can be cancelled.

The approved first icon is included as icon.png; its original master is in branding/WKCinema-icon-master.png. This ZIP is prepared for Thunderstore: manifest.json, icon.png and README.md are at its root.

Free camera and framing

Press F3 or Enable freecam during a run. The mod first enables the cheats required by the game; it does not turn on player noclip or godmode for this action. Modes that forbid cheats remain unavailable, and the game disables run statistics when cheats activate. Switching back to the player remembers the camera's position, rotation and FOV for the current level session. Toggle freecam again to return to that view. The Камера (Camera) tab includes a separate action to return the camera to the player.

Adjust FOV, flight speed, turn speed and movement smoothing in the Camera tab. Mouse rotation responds directly by default, with unrestricted pitch and preserved roll. Look smoothing is separate: 0 seconds is direct input; a positive value smooths rotation. This avoids the old Euler-roll flip and shortest-arc response to large mouse movements. You can hide the crosshair and display a centered 9:16 guide. The guide is an on-screen overlay; turn it off before recording a clean image.

Opening F11 pauses the game and automatic camera movement and releases the cursor. Press Применить (Apply) after typing a numeric value. Starting a take closes the menu.

Camera paths

1. Position the free camera and press F4.
2. Fly to another view and press F4 again. A path needs at least two points.
3. Open Маршрут (Path) to edit points, reorder or delete them, preview a point or replace it with the current view.
4. Set the total duration and press Shift + F3 to start. Press Shift + F3 while moving to stop; the next start repeats from the beginning.

Each point stores position, rotation, roll and FOV. The editor supports up to 100 points and undo for the last 20 edits. Default start delay is two seconds. The menu offers pause, continue and restart actions.

Orbit shots

1. Aim at a subject and press Shift + F4. This picks a point on its surface.
2. Open Облёт (Orbit). Set radius, height, angular speed and starting angle.
3. Preview the starting view or press Ctrl + F3 to start. The camera always looks at the chosen center.

The center can also be set from the camera's position or entered as XYZ coordinates. You can fit the orbit to the current camera view. Use the two Clockwise / Counterclockwise buttons (viewed from above; the selected direction is highlighted). Choose one full circle or continuous looping. At 20 degrees per second, one circle takes 18 seconds.

The center stays fixed in world space; it does not track a moving object. The orbit is horizontal with a separate height offset. Camera motion does not avoid walls. Changing orbit settings stops the current take.

Filming aids

The Enable cheats + godmode + noclip button enables all three filming aids. Disable noclip separately restores normal player collision without disabling freecam or godmode; it also works if the cheat switch was subsequently turned off. The game disables run statistics when cheats are enabled; WK Cinema does not bypass that restriction.

Session behavior and recording

• Camera paths and the orbit center are held for the current level session. They are cleared when the level changes or the game restarts. Path and orbit edits are not written to disk; the World and Location bookmark is saved separately.
• Automatic movement uses a fixed 60 Hz take clock. Capture timing, the target frame rate and VSync are restored when a take stops.
• Opening the menu, pausing the game, opening the console or losing application focus holds the take. Switching cameras or levels stops it.
• Paths and orbits are mutually exclusive. Scene animation and object behavior are not rewound when repeating a camera move.
• Record with OBS or another capture application. WK Cinema does not encode videos or export vertical footage. External recording may drop frames under load.

Installation

After this package is published, install WKCinema from the White Knuckle catalog in r2modman or another compatible manager and launch the modded game. The declared dependency installs BepInExPack through the manager.

For manual installation with BepInEx already installed, copy BepInEx/plugins/WKCinema/WKCinema.dll into the same location in the selected game/profile folder.

Disable the older DirtyMassCinema filming plugin in that profile: both control the same native free camera and share some keys. This does not require uninstalling the separate DirtyMass content mod.

Troubleshooting

Start an actual run before using the filming controls. For failures, include BepInEx/LogOutput.log, the game version and the other enabled camera mods in your report. If another plugin uses a filming key, change it in the WK Cinema config.

To remove WK Cinema, disable it in the manager or remove its plugin folder. Its config can be removed separately.