Enhance setup instructions and add build scripts for easier game launch

Author: th33k

README.md

@@ -58,26 +58,47 @@ A **production-grade** top-view multiplayer shooter game with professional UI/UX
 
 ### Installation
 
+#### Option 1: One-Click Launch (Recommended)
+```bash
+# Windows
+scripts\run.bat
+
+# Linux/Mac
+./scripts/run.sh
+```
+✅ **Automatically starts both servers and opens browser!**
+
+#### Option 2: Manual Setup
+
 1. **Clone or navigate to the game directory**
    ```bash
    cd Game
    ```
 
-2. **Start the Server**
+2. **Build the Server (Optional)**
+   ```bash
+   # Windows
+   scripts\build.bat
+
+   # Linux/Mac
+   ./scripts/build.sh
+   ```
+
+3. **Start the Server**
    ```bash
    cd server
    mvn clean compile exec:java
    ```
    Server runs on `ws://localhost:8080/game`
 
-3. **Start the Client Server**
+4. **Start the Client Server**
    ```bash
    cd client
    python -m http.server 3000
    ```
    Open `http://localhost:3000` in your browser
 
-4. **Play!**
+5. **Play!**
    - Enter your callsign
    - Click "Deploy to Battle"
    - Use WASD to move, mouse to aim, click to fire

docs/QUICKSTART.md

@@ -2,46 +2,59 @@
 
 ## ⚡ 10-Second Setup (EASIEST)
 
-### Option 1: One-Click Launch
+### Option 1: One-Click Launch (Windows)
 ```cmd
-run.bat
+scripts\run.bat
 ```
 ✅ **Automatically starts both servers and opens browser!**
 
-### Option 2: Manual Setup
+### Option 2: One-Click Launch (Linux/Mac)
+```bash
+./scripts/run.sh
+```
+✅ **Automatically starts both servers and opens browser!**
+
+### Option 3: Manual Setup
+
+#### 1. Build Server (Optional)
+```bash
+# Windows
+scripts\build.bat
 
-#### 1. Start Server
+# Linux/Mac
+./scripts/build.sh
+```
+
+#### 2. Start Server
 ```bash
 cd server
 mvn exec:java
 ```
 ✅ Server running on `ws://localhost:8080`
 
-#### 2. Start Client
+#### 3. Start Client
 ```bash
 cd client
 python -m http.server 3000
 ```
 ✅ Game at `http://localhost:3000`
 
-#### 3. Play
+#### 4. Play
 - Open browser → `http://localhost:3000`
 - Enter name → Click "Deploy to Battle"
 - Use **WASD** to move, **mouse** to aim, **click** to fire
 
 ---
 
 ### 🛑 Stop the Game
-```cmd
-stop.bat
-```
-✅ **Stops all servers cleanly**
+- **Windows**: Close the command prompt window that was opened by `run.bat`
+- **Linux/Mac**: Press `Ctrl+C` in the terminal where `run.sh` is running
+- The servers will stop automatically when the script is terminated
 
 ### 📊 Check Server Status
-```cmd
-status.bat
-```
-✅ **Shows if servers are running**
+- **Server**: Check if port 8080 is listening: `netstat -an | find "8080"` (Windows) or `netstat -tlnp | grep 8080` (Linux)
+- **Client**: Check if port 3000 is listening: `netstat -an | find "3000"` (Windows) or `netstat -tlnp | grep 3000` (Linux)
+- Or simply try opening `http://localhost:3000` in your browser
 
 ---
 

scripts/build.bat

@@ -0,0 +1,9 @@
+@echo off
+echo Building Mini Tank Fire Game...
+
+REM Build server
+cd server
+mvn clean compile
+cd ..
+
+echo Build complete!

scripts/build.sh

@@ -0,0 +1,9 @@
+#!/bin/bash
+echo "Building Mini Tank Fire Game..."
+
+# Build server
+cd server
+mvn clean compile
+cd ..
+
+echo "Build complete!"

run.bat scripts/run.batrun.bat renamed to scripts/run.bat

@@ -0,0 +1,35 @@
+#!/bin/bash
+echo "Starting Mini Tank Fire Game..."
+
+# Start server in background
+cd server
+mvn exec:java &
+SERVER_PID=$!
+cd ..
+
+# Wait a bit for server to start
+sleep 3
+
+# Start client server in background
+cd client
+python3 -m http.server 3000 --bind 0.0.0.0 &
+CLIENT_PID=$!
+cd ..
+
+# Wait a bit for client to start
+sleep 2
+
+# Open browser (if xdg-open is available)
+if command -v xdg-open > /dev/null; then
+    xdg-open http://localhost:3000
+elif command -v open > /dev/null; then
+    open http://localhost:3000
+fi
+
+echo "Game is running! Server on ws://localhost:8080, Client on http://localhost:3000"
+echo "For LAN multiplayer: Tell friends to visit http://[YOUR_LAN_IP]:3000 and enter your LAN IP in the server address field"
+echo "Press Ctrl+C to exit (servers will keep running)"
+
+# Wait for user interrupt
+trap "echo 'Stopping servers...'; kill $SERVER_PID $CLIENT_PID 2>/dev/null; exit" INT
+wait