moved md files to root

QUICKSTART.md

@@ -0,0 +1,112 @@
+# Quick Start Guide
+
+## Getting Started in 5 Minutes
+
+### 1. Open the Project
+1. Open Godot 4.6
+2. Import this project
+3. Wait for assets to load
+
+### 2. Test Single Player
+1. Press F5 (or click Play)
+2. Click "Host Game"
+3. Use WASD to move
+4. Press E to grab a box
+5. Press Q to throw it
+
+### 3. Test Local Multiplayer
+1. Connect a gamepad
+2. Press F5
+3. Set "Local Players" to 2
+4. Click "Host Game"
+5. Player 1: Use WASD
+6. Player 2: Use gamepad left stick
+7. Try grabbing each other!
+
+### 4. Test Network Multiplayer
+
+**On Host Machine:**
+1. Press F5
+2. Click "Host Game"
+3. Note your IP address (run `ipconfig` in cmd)
+
+**On Client Machine:**
+1. Press F5
+2. Enter host's IP address
+3. Click "Join Game"
+4. Play together!
+
+## Controls Quick Reference
+
+| Action | Keyboard (P1) | Gamepad (P2+) |
+|--------|---------------|---------------|
+| Move | WASD/Arrows | Left Stick |
+| Lift/Throw (Tap) | E | A Button |
+| Push/Pull (Hold) | E (hold) | A Button (hold) |
+
+## Tips
+
+- **Grab Range**: You need to be close to objects/players (within 80 units)
+- **Tap vs Hold**: Quick tap lifts object, hold to push/pull
+- **Throw vs Place**: Move while lifting + tap = throw, stand still + tap = place down
+- **Pushing**: Hold grab button and move, or just walk into objects
+- **Camera**: Automatically follows all your local players
+- **Multiple Locals**: Each machine can have up to 4 local players
+
+## Troubleshooting
+
+**"Connection Failed"**
+- Check the IP address
+- Make sure port 7777 is open
+- Try 127.0.0.1 for local testing
+
+**"No Gamepad Detected"**
+- Connect gamepad before starting
+- Set Local Players > 1
+- Check in Godot's Input settings
+
+**"Players Not Moving"**
+- Make sure you're controlling the right player
+- Check console for errors
+- Verify input actions are set up
+
+## Next Steps
+
+1. Read the full README.md for detailed information
+2. Check TESTING.md for comprehensive testing guide
+3. Explore the scripts folder to understand the code
+4. Modify game_world.tscn to add more objects
+5. Customize player colors and abilities
+
+## Example Scenarios
+
+### Scenario 1: Couch Co-op
+- 2 players on same PC
+- Player 1: Keyboard
+- Player 2: Gamepad
+- Work together to move heavy objects!
+
+### Scenario 2: Online Co-op
+- Host on PC 1
+- Join from PC 2
+- Each with 1 player
+- Throw objects at each other!
+
+### Scenario 3: Mixed Multiplayer
+- Host with 2 local players (keyboard + gamepad)
+- Friend joins online with 2 local players
+- 4 total players in one game!
+- Chaos ensues!
+
+## Development Mode
+
+To modify the game:
+
+1. **Add Objects**: Duplicate boxes in game_world.tscn
+2. **Change Physics**: Edit mass in interactable_object.tscn
+3. **Adjust Speed**: Change move_speed in player.gd
+4. **Add Abilities**: Extend player.gd with new actions
+5. **New Levels**: Create new scenes based on game_world.tscn
+
+Enjoy your multiplayer adventure!
+