DungeonsOfKharadum/QUICKSTART.md

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!