Skip to content

Latest commit

 

History

4 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

SBPhotoModeCutsceneFreecam

日本語: README.ja.md

A UE4SS mod for Stellar Blade (PC) that lets you move the photo mode camera during cutscenes.

Normally the photo mode camera can only be moved during regular gameplay. Open photo mode in the middle of a cutscene and the camera is locked in place. This mod removes that restriction.

  • Enables movement and look controls in cutscene photo mode
  • Disables camera collision, so you can clip through walls and terrain to frame a shot
  • Runs only while the cutscene camera exists, so there is no cost during normal gameplay

Requirements

You need a build of UE4SS made for Stellar Blade. Install one of these first:

Upstream UE4SS-RE/RE-UE4SS does not work with Stellar Blade as-is, because its signatures do not match.

Once UE4SS is installed, your game folder looks like this:

StellarBlade/SB/Binaries/Win64/
├── dwmapi.dll
└── ue4ss/
    ├── Mods/
    └── UE4SS-settings.ini

Installation

  1. Copy the Mods/SBPhotoModeCutsceneFreecam folder from this repository into the game's ue4ss/Mods/.

    StellarBlade/SB/Binaries/Win64/ue4ss/Mods/SBPhotoModeCutsceneFreecam/Scripts/main.lua
    
  2. Add this line to ue4ss/Mods/mods.txt. It must go above Keybinds : 1.

    SBPhotoModeCutsceneFreecam : 1
    
  3. Some UE4SS builds also read ue4ss/Mods/mods.json. If that file exists, add an entry there too.

    {
        "mod_name": "SBPhotoModeCutsceneFreecam",
        "mod_enabled": true
    }
  4. Launch the game. The mod loaded successfully if this line appears in ue4ss/UE4SS.log:

    [SBPhotoModeCutsceneFreecam] loaded. F3=toggle mod / F2=numeric log / console command: cscam
    

Usage

Open photo mode during a cutscene and the controls just work.

Action Keyboard / Mouse Gamepad
Move forward / back W / S Left stick, vertical
Strafe left / right A / D Left stick, horizontal
Move up / down LeftShift / LeftControl RT / LT
Look Mouse Right stick
Boost (3x speed) LeftAlt L1
Toggle the mod on / off F3 n/a
Toggle the numeric log F2 n/a

Camera roll, FOV and depth of field still use the game's own photo mode controls.

Configuration

Edit the CFG table at the top of Scripts/main.lua. These are the settings you are most likely to change:

Setting Default Description
Speed 700.0 Movement speed, in units per second
MouseSensitivity 4.0 Mouse look sensitivity
PadLookSpeed 90.0 Right stick turn rate, in degrees per second
BoostMultiplier 3.0 Speed multiplier while boosting
Smoothing 10.0 Acceleration smoothing. Higher is snappier
InvertPitch false Invert vertical look
DisableCollision true Disable camera collision

You can also tune these at runtime. Set GuiConsoleEnabled and GuiConsoleVisible to 1 in ue4ss/UE4SS-settings.ini to get a console in game. The console window costs frame time while it is open, so set both back to 0 when you are done tuning.

cscam                        show current values
cscam MouseSensitivity 2.5   change mouse sensitivity
cscam Speed 1000             change movement speed

Uninstall

Delete the ue4ss/Mods/SBPhotoModeCutsceneFreecam folder and remove the corresponding line from mods.txt (and mods.json).

Troubleshooting

Check ue4ss/UE4SS.log.

Log What it means What to do
No [SBPhotoModeCutsceneFreecam] loaded. line The mod was not loaded Check the mods.txt entry and the install path
No camera acquired line The cutscene camera was not detected Make sure you opened photo mode during a cutscene
No UE4SS output at all UE4SS was not injected A game patch likely broke its signatures. Wait for a UE4SS update

Press F2 to log input values, position, rotation and speed once per second. This is usually enough to narrow down a problem.

If the mod stops working after a game update, the cause is almost always UE4SS rather than this mod. The mod only touches the game through the UE4SS Lua API and Unreal's reflection system, so it has a good chance of continuing to work once UE4SS itself runs again.

How it works

The cutscene camera, SBPhotoModeCutSceneCameraPawn, is a perfectly functional pawn with a working movement component. It sits still because the game never feeds it any input, and the direct cause is that PhotoModeMovementTable contains no rows for CutSceneCamera at all.

This mod reads input itself every frame, integrates position and rotation, and applies the result to the pawn directly. That bypasses the game's input path entirely.

For the full investigation, including approaches that were tried and did not work, see docs/research.md. That document is in Japanese.

Tested on

  • Stellar Blade PC (Steam), build as of August 2026
  • Unreal Engine 4.26
  • SB-UE4SS v1.3, based on UE4SS 3.0.1

License

MIT License. See LICENSE.

About

Unlock photo mode camera movement during cutscenes in Stellar Blade. A UE4SS Lua mod.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages