3D Ghost Town Explorer

A mysterious 3D town exploration game built with React Three Fiber, featuring physics-based movement and ethereal encounters.

🎮 Features

• Immersive 3D Environment: Explore a town with realistic physics and lighting
• Smooth Controls: Intuitive WASD movement with camera-relative direction
• Ghost Encounters: Watch the ethereal spirit patrol the town
• Dynamic Camera: Follow camera with mouse-controlled rotation
• Real-time Minimap: Track your position with the top-right minimap

🚀 Getting Started

Prerequisites

• Node.js (v18 or higher)
• npm (v9 or higher)

Installation

1. Clone the repository:

git clone <repository-url>

2. Install dependencies:

npm install

3. Start the development server:

npm run dev

🎯 How to Play

1. Use WASD keys to move your character
2. Move your mouse to control the camera view
3. Explore the town and watch for the floating ghost
4. Use the minimap in the top-right corner for navigation

🛠️ Built With

• React - UI Framework
• React Three Fiber - React renderer for Three.js
• Three.js - 3D Graphics Library
• @react-three/rapier - Physics Engine
• @react-three/drei - Useful helpers for React Three Fiber
• TypeScript - Type Safety
• Vite - Build Tool

📝 License

This project is licensed under the MIT License - see the LICENSE file for details