PerspectiveSwitcher

PerspectiveSwitcher / 視角切換器

A powerful camera perspective mod for PEAK that supports First, Second, and Third person views

爲 PEAK 遊戲打造的強大視角切換模組，支持第一人稱、第二人稱和第三人稱視角

English | 中文

English

📖 Overview

PerspectiveSwitcher is an enhanced camera mod for PEAK that allows you to seamlessly switch between three different camera perspectives: First Person, Second Person, and Third Person. This mod is based on the excellent work from peak-thirdperson by EvaisaDev, with significant enhancements including second-person view support and improved code architecture.

Note: This project was developed with AI assistance. The architecture design was provided by the author, and the code implementation was AI-assisted.

✨ Features

• 🔄 Three Perspective Modes
• First Person: Classic immersive view (default game camera)
• Second Person: Unique front-facing view looking at your character
• Third Person: Traditional behind-the-character view

• 🎮 Easy Controls
• Press V (configurable) to cycle through perspectives: First → Second → Third → First
• Mouse wheel to zoom in/out in Second and Third person modes
• Smooth camera transitions with configurable sensitivity

• 🛡️ Other Features
• Collision detection prevents camera clipping through walls
• Proper handling during wall climbing
• Respects game's mouse and controller sensitivity settings
• Smooth interpolation for camera movement

🎯 Perspective Comparison

| Perspective | Camera Position | View Direction | Use Case |

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

| First Person | Inside character | Forward | Immersive gameplay |

| Second Person | In front of character | Looking at character | Unique cinematic shots |

| Third Person | Behind character | Forward (through character) | Better spatial awareness |

📸 Screenshots

TODO: Add screenshots here showing each perspective mode

First Person - Classic immersive view

Second Person - Unique front-facing perspective

Third Person - Traditional behind-character view

🚀 Installation

• Prerequisites
• BepInEx Pack for PEAK (v5.4.2403 or later)
• AutoHookGenPatcher (v1.0.9)

• Install via GALE Mod Manager (Recommended)
• Download GALE
• Open GALE and select PEAK
• Search for "PerspectiveSwitcher"
• Click "Install"
• Dependencies will be installed automatically

• Install via r2modman
• Download r2modman
• Select PEAK as the game
• Search for "PerspectiveSwitcher"
• Click "Install"
• Dependencies will be installed automatically

• Manual Installation
• Download the latest release
• Extract the zip file
• Copy the plugins folder contents to PEAK/BepInEx/plugins/
• Ensure you have BepInEx Pack for PEAK and AutoHookGenPatcher installed
• Launch the game

⚙️ Configuration

The mod creates a configuration file at BepInEx/config/com.github.nazo-x1.PerspectiveSwitcher.cfg:

[Camera.Toggles]

Switch the camera perspective (First -> Second -> Third)

Setting type: KeyboardShortcut

Default value: V

SwitchPerspective = V

You can change the toggle key by editing this file or using BepInEx Configuration Manager.

🎮 Usage

• Switching Perspectives
• Press V (default) to cycle: First Person → Second Person → Third Person → First Person
• The current mode is logged in the BepInEx console

• Adjusting Camera Distance (Second/Third Person only)
• Scroll mouse wheel up to zoom out
• Scroll mouse wheel down to zoom in
• Distance range: 2.0 to 4.0 units

• Tips
• The camera automatically adjusts when near walls to prevent clipping
• Wall climbing works correctly in all perspectives
• Camera sensitivity matches your game settings

🔧 Technical Details

• Architecture: Uses adapter pattern for clean code organization
• Architecture design provided by the author
• Code implementation assisted by AI
• Performance: Minimal overhead, efficient camera calculations
• Compatibility: Not guaranteed to work with other camera and gameplay mods
• Code Quality: Refactored from original third-person mod with improved struct