🏚️ FiveFloors

"Can you escape? Or will something follow you out?"

A 3D first-person horror puzzle game built in Unity as a college project.
Navigate through 5 floors of an abandoned building — solve puzzles, find keys, and survive.

---

🎮 Gameplay

Level	Name	Objective	Enemies
1	The Lobby	Tutorial — learn flashlight & keys. Find 1 key to unlock the stairs.	None
2	The Office	Find a well-hidden key among scattered furniture.	None
3	The Library	Find the key while a ghost patrols the aisles.	👻 Ghost
4	The Basement	Solve an electrical switch puzzle, then find the key.	👻 Ghost
5	The Attic	Sprint through a corridor while dodging moving obstacles.	None

Controls

Key	Action
WASD	Move
Mouse	Look around
Space	Jump
Shift	Sprint
F	Toggle flashlight
E	Interact
Escape	Pause

---

🛠️ Built With

• Engine: Unity 2022.3 LTS
• Render Pipeline: Universal Render Pipeline (URP)
• Language: C#
• Assets: ZNS3D Vintage Living Room Game Pack (Unity Asset Store)

---

📁 Project Structure

Assets/
├── Editor/             # Editor-only utility scripts
├── Models/             # 3D models
├── Prefabs/            # Reusable prefabs (Player, etc.)
├── Scenes/             # Game scenes (MainMenu, Level_01–05, WinScreen)
├── Scripts/
│   ├── AI/             # Ghost patrol AI
│   ├── Atmosphere/     # Flicker lights, ambient audio, jumpscares
│   ├── Core/           # GameManager, Inventory, IInteractable
│   ├── Interactables/  # Keys, doors, notes
│   ├── Player/         # PlayerController, Flashlight, Footsteps
│   ├── Puzzles/        # Switch puzzle, obstacle corridor
│   └── UI/             # HUD, menus, tutorial hints
└── Settings/           # URP pipeline assets

---

🚀 Getting Started

Prerequisites

• Unity 2022.3 LTS (download via Unity Hub)
• Universal Render Pipeline (included in project)

Setup

1. Clone the repository:

   git clone https://github.com/YOUR_USERNAME/FiveFloors.git

2. Open Unity Hub → Add project from disk → select the FiveFloors folder
3. Let Unity import and compile (first launch may take a few minutes)
4. Re-import assets marked in .gitignore:
   • ZNS3D Vintage Living Room Game Pack — search on Unity Asset Store
   • Import into Assets/Imported Assets/ZNS3D/
5. Open Assets/Scenes/MainMenu.unity and press Play

Note: NavMesh needs to be re-baked for Level_03 and Level_04 after cloning.
Window → AI → Navigation → Bake

---

🗺️ Scene Setup Guide

See Assets/SCENE_SETUP_GUIDE.md for full hierarchy and component setup instructions for each level.

---

✨ Features

• 🔦 Flashlight system — toggle on/off, aims at crosshair even when held off-center
• 🗝️ Key & door system — collect keys, unlock doors
• 👻 Ghost AI — NavMesh-based patrol with proximity scare audio
• 💡 Atmosphere system — flickering lights with synced bounce lighting, random horror events, jumpscare triggers
• 📝 Readable notes — story clues scattered around levels
• 🎬 Level title cards — cinematic level intros with fade in/out
• ⏸️ Pause menu — pause, resume, return to main menu

---

👥 Team

Name	Role
Lyravein	Everything 💀

---

📝 License

This project is for educational purposes. Third-party assets belong to their respective owners.