First Person Controller Pro

Professional First-Person Character Controller Solution for Unity Engine

This implementation provides a robust movement mechanic, an interactive audio system, and smooth camera control, engineered for production environments.

Core Components

Dependencies:

• Unity's CharacterController component
• Transform-based camera system
• Layer-based collision detection
• Terrain System Support: Integration with Unity TerrainData

Movement Architecture:

• Physics-Stable Grounding: Improved SphereCast detection with a constant downward force (-5f) to prevent "micro-bouncing" on slopes and stairs.
• Enhanced State Machine: Integrated Walking, Running, Crouching, and Jumping states with priority-based speed multipliers.
• Smart Standing Logic: Advanced overhead obstacle detection using a dedicated standingHeightMarker to prevent geometry clipping.
• Step Offset & Slope Processing: Optimized for standard Unity physics with frame-rate independent gravity calculations.

Camera System:

• Target-Based Rotation (New): Decoupled input from rotation using TargetYaw/Pitch variables to eliminate "jitter" or "snapping" during frame drops.
• Weighted Camera Movement: Adjustable CameraWeight parameter for high-end cinematic smoothness and input lag simulation.
• Dynamic FOV System: State-aware FOV transitions (60° → 70°) that persist through jump arcs for visual consistency.
• Hybrid Camera Tilting: Procedural leaning based on both horizontal movement vectors and mouse look velocity.
• Procedural Head Bobbing: State-dependent frequency and amplitude curves for realistic movement simulation across all speeds.

Audio Management System:

• Multi-Source Surface Detection:
  Terrain Texture Detection: Real-time sampling of the most prominent AlphaMap texture at the player's position.
  Tag-Based Identification: Standard fallback to GameObject tags for non-terrain objects.
• Advanced Playback Logic:
  Anti-Cut Smoothing: Air-time threshold logic (0.2s) prevents audio interruptions during stair descents or small jumps.
  Dynamic Pitch Modulation: Automatic pitch shifting based on movement state (Crouching: 0.8x, Running: 1.3x).

Advanced Features

Smart Standing & Ceiling Detection:

• Precise Clearance Checks: Uses OverlapSphere at the height marker to ensure the player only stands when a safe clearance is detected.
• Visual Status Gizmos: Color-coded Scene view debugging (Green: Clear / Red: Blocked).
• Auto-Crouch Retention: Automatically stays in crouch state as long as an obstacle remains overhead.

Physics-Safe Interactions:

• Velocity Reset: Smart landing logic that resets vertical velocity to a stable base value to prevent "gravity stacking" during ground contact.
• Consistent FOV Tracking: FOV transitions track player intent (input keys) rather than raw physics states, preventing FOV "flickering" on stairs.

Optimization Features

Performance:

• Cached Component Architecture: Minimal use of GetComponent or Camera.main inside Update loops.
• Efficient Math: Switched to sqrMagnitude for movement checks to reduce CPU overhead.
• Optimized Physics Sequence: Ground, Crouch, and Movement checks are processed in a specific order to ensure zero-frame latency in state updates.

Code Quality (Asset Store Standards):

• Full XML Documentation: Complete code comments for every method and property.
• Inspector Tooltips: Comprehensive tooltips for all public fields in the Unity Inspector.
• Namespaced Structure: Organized into PlayerSystem and PlayerAudio to prevent conflicts in large projects.

Integration Guide

Basic Setup:

1. Attach PlayerController to a GameObject with a CharacterController.
2. Assign the Camera Transform in the inspector.
3. Place a Standing Height Marker (empty GameObject) at the player's full height level.
4. Define Ground Layers and Obstacle Layers in the settings.

Audio Configuration:

1. Add PlayerMusic to the player hierarchy.
2. Populate the SurfaceSettings array with your Terrain Textures and/or Object Tags.
3. Assign corresponding AudioClips for each surface.

Version 2.3 Technical Updates (Major Update):

• Major: Replaced direct rotation with a target-based smoothing system for AAA camera feel.
• Major: Added full support for Terrain Texture-based footstep detection.
• New: Implemented "Stair Smoothing" logic to the audio system to prevent sound cutting.
• Improved: Upgraded overhead detection to prevent CharacterController ceiling clipping.
• Optimization: Reduced GC allocation footprint by optimizing surface detection raycasts.