# LiDAR FPS Game - Setup Guide

## Project Structure Created:
- **Assets/Scripts/** - Your C# scripts (including FirstPersonController.cs)
- **Assets/Models/LidarScans/** - Where you'll import your GLB files
- **Assets/Prefabs/** - For reusable game objects
- **Assets/Scenes/** - Your game levels

## Step 1: Import Your GLB Files

1. Open Unity and your OGG project
2. Copy some GLB files from `K:\OGG\lidar\` to `K:\OGG\OGG\Assets\Models\LidarScans\`
   - Start with one or two to test (e.g., "my bedroom.glb" or "studio old.glb")
3. Unity will automatically import them

## Step 2: Install glTFast Package (for better GLB support)

1. In Unity, go to **Window → Package Manager**
2. Click the **"+"** button in top-left
3. Select **"Add package by name"**
4. Enter: `com.atteneder.gltfast`
5. Click **Add**

## Step 3: Create Your Player

1. In the Hierarchy, **Right-click → Create Empty**
2. Rename it to "Player"
3. With Player selected, click **Add Component**
4. Search for and add: **Character Controller**
5. Add Component again, search for: **First Person Controller** (our script)

## Step 4: Set Up the Camera

1. In Hierarchy, **Right-click on Player → Camera**
2. Position the camera:
   - Set Position Y to about 1.6 (eye height)
   - Reset X and Z to 0
3. The FirstPersonController script should automatically find this camera

## Step 5: Import a LiDAR Scan into Your Scene

1. From Project window, navigate to **Assets/Models/LidarScans/**
2. Drag one of your GLB files into the Scene (Hierarchy)
3. Select the imported model in Hierarchy
4. In Inspector, click **Add Component → Mesh Collider**
   - This allows the player to walk on it
5. You might need to adjust the scale:
   - Try Scale: X=1, Y=1, Z=1 first
   - If too big/small, adjust all values equally

## Step 6: Position Your Player

1. Select the Player in Hierarchy
2. In the Inspector, set Transform Position:
   - Move the player above your scan (Y=2 or Y=3)
   - Adjust X and Z to be inside the scan area
3. Make sure Character Controller settings are reasonable:
   - Radius: 0.5
   - Height: 2
   - Center: Y=1

## Step 7: Test Your Game!

1. Click the **Play** button at the top
2. **Controls:**
   - **WASD** or **Arrow Keys** - Move
   - **Mouse** - Look around
   - **Left Shift** - Run
   - **Space** - Jump
   - **Escape** - Unlock cursor

## Troubleshooting:

### Player falls through the floor:
- Make sure your LiDAR model has a **Mesh Collider** component
- Check that the Mesh Collider is enabled (checkbox ticked)

### Can't see anything:
- The camera might be inside geometry - move the Player position up (increase Y value)
- Check that the Camera is a child of Player and positioned at Y=1.6

### Movement feels weird:
- Adjust the Character Controller's Radius and Height
- Try different Walk/Run speeds in the FirstPersonController settings

### GLB files won't import:
- Install the glTFast package (see Step 2)
- Alternatively, you can convert GLB to OBJ using Blender if needed

## Next Steps:

Once you have basic movement working, we can add:
- Crosshair UI
- Health system
- Shooting mechanics
- Enemies/targets
- Multiple level loading
- Lighting improvements for your LiDAR scans

## Tips for LiDAR Scans:

- Your scans might be very detailed - this can slow down the game
- You may need to optimize them later (reduce polygon count)
- Start with smaller scans (single rooms) before loading larger areas
- You can have multiple scans in one scene to create larger levels