AskaFirstPerson

Aska First Person Camera

A BepInEx 6 IL2CPP plugin that adds a fully-featured first-person camera to Aska.

Features

• Toggle camera with F5 (keyboard) or LB + R3 (gamepad) -- both fully configurable
• Smooth camera positioning anchored to the player's head bone with configurable offsets
• Motion dampening reduces vertical camera shake from combat, rolls, and head bob without adding lateral lag
• Shadow-only body -- player model is hidden but still casts shadows for immersion
• Held items stay visible -- weapons, tools, and shields in either hand remain rendered
• Upper body spine rotation -- arms and held items follow the camera direction naturally, split across two spine bones for a smooth look
• Equipment hiding -- all gear (backpack, cape, quiver, stowed weapons, hair, beard) is hidden cleanly; periodic re-scan catches newly equipped items
• Multiplayer aware -- correctly identifies the local player via Photon Fusion InputAuthority; other players are unaffected
• Pause detection -- camera input stops when the game is paused, a menu is open, or the cursor is unlocked
• Scene-aware -- auto-disables when returning to the main menu and re-discovers references on new sessions
• Experimental lower body mode -- optional config to show forearms, hands, and legs (may have mesh artifacts)
• Configurable FOV, mouse sensitivity, near clip plane, smoothing, and more
• Troubleshooting escape hatch: General.SafeMode=true loads the plugin inert while you collect logs
• All settings editable via BepInEx/config/com.community.askafirstperson.cfg or in-game with BepInEx ConfigManager (F1)

Installation

With r2modman (recommended)

• Install r2modman
• Select Aska as your game
• Search for AskaFirstPerson and install

Manual

• Install BepInEx 6 IL2CPP (BE #755+) for Aska
• Copy AskaFirstPerson.dll into BepInEx/plugins/ inside your Aska game folder
• Launch the game

Configuration

After first launch, edit BepInEx/config/com.community.askafirstperson.cfg:

Camera

| Setting | Default | Range | Description |

|---------|---------|-------|-------------|

| FOV | 80 | 60 -- 120 | First-person field of view |

| MouseSensitivity | 2.0 | 0.1 -- 10 | Mouse look sensitivity |

| NearClipPlane | 0.05 | -- | Near clip plane distance (lower prevents seeing inside geometry) |

| VerticalOffset | 0.1 | -- | Vertical offset above the head bone (metres) |

| ForwardOffset | 0.12 | -- | Forward offset from the head bone (metres) |

| SmoothSpeed | 15 | 1 -- 100 | Position smoothing factor (higher = less smoothing) |

| MotionDampening | 0.4 | 0 -- 1 | Reduces vertical camera shake from combat and head bob. 0 = raw tracking, 1 = maximum dampening. Recommended 0.3 -- 0.5 |

Visibility

| Setting | Default | Description |

|---------|---------|-------------|

| ShowLowerBody | false | Show forearms, hands, and legs in first-person. Off = cleaner shadow-only body. On = experimental, may have mesh artifacts |

Controls

| Setting | Default | Description |

|---------|---------|-------------|

| ToggleKey | F5 | Keyboard key to toggle first-person and third-person |

| GamepadToggleButton | RightStickButton | Gamepad button to toggle first-person mode |

| GamepadModifierButton | LeftShoulder | Modifier button held with the toggle button (LB + R3 by default). Set to "None" for a bare button press |

General / Advanced troubleshooting

| Setting | Default | Description |

|---------|---------|-------------|

| SafeMode | false | Skip all Harmony patches and per-frame behaviour. Use this if the mod crashes at startup so it can remain installed while you collect logs |

| EnableCinemachinePatch | true | Apply the Cinemachine camera-control patch. Disabling this prevents first-person camera control |

| EnableInputSuppressionPatch | true | Apply gamepad chord suppression. Disabling this means the gamepad toggle can still trigger its normal in-game action |

| EnableBehaviour | true | Register the per-frame first-person behaviour. Disabling this stops camera/input/visibility work |

Game