🕹️ AI Controller

• 👁️ Sight Detection: Uses viewAngle and viewDistance to detect players within a cone of vision.
• 👂 Sound Detection: Detects audio sources via hearingRange and volumeThreshold.
• 🚶 Wandering: Moves randomly within wanderRadius at wanderInterval intervals.
• 🌀 Teleportation: Randomly spawns near player (spawnNearPlayerDistanceRange) or behind them (CloseSpawnNearPlayerDistanceRange).
• 🎵 Dynamic Music: Plays actionMusic during chases and BehindSpawn on teleport.
• 👣 Footstep System: Plays surface-specific sounds via footstepSounds list and raycast detection.
• 💀 Jumpscare: Triggers ThingsThatShouldBeTurnOn/Off and loads PreviousScene on player contact.

🚪 Hiding Mechanics

• 🎥 Camera Switching: Swaps between mainCamera and childCamera with smooth animations.
• 🖱️ Cabinet Interaction: Uses HidingRaycast to detect cabinets within interactionDistance (layer: LayerMaskInteract).
• 📦 Cabinet Animations: CabinetAnimator plays "Cabinet" (open) and "CabinetClose" (exit) via Cabinet.cs.
• 🔴 Crosshair Feedback: Changes color (red/white) via CrosshairChange() during interactions.

🔄 Scene Management

• ⏳ Delayed Transition: Waits for JumpScareAnimation.length before loading sceneId.
• 🖥️ Loading Screen: Displays progress via LoadingBarFill during async scene load.

⚙️ Customization

• 🛠️ AI Parameters: Adjust detection ranges, teleport chances (CloseTeleportChance), and cooldowns.
• 🔊 Audio Layers: Link sounds to surfaces (e.g., "tag" in FootstepSound class).
• 🎭 Animation Control: Define cabinet/camera animations in HideCamera.cs and Cabinet.cs.
• ⏱️ Interaction Cooldown: interactionCooldown prevents spamming cabinet interactions.

🎮 Player Controller System

• ⚡ Energy System: Manage stamina or other resources during gameplay.
• 👣 Footstep System: Adds immersive footstep sounds based on player movement and surface type.
• 🔻 Crouch System: Customizable crouching options, with support for both “hold to crouch” and “press to crouch.”
• 🖱️ Mouse Look System: Advanced mouse look controls with head bobbing for first-person perspective.

🔧 Technical Notes

• NavMesh Required: AI uses NavMeshAgent for pathfinding.
• Player Tag: Ensure player is tagged as "Capsule" for detection.
• Layer Masks: Assign audioLayer and LayerMaskInteract for sound/interaction systems.

🚀 Optimized Workflow

• 🧩 Prefab-Ready: Scripts are modular for drag-and-drop setup.
• 📊 Inspector Tools: Variables include [Tooltip] and [Header] for clarity.