feat: Add bot player system for PlanetSide population

Initial implementation of server-side bots that:
- Spawn as real Player entities with full equipment
- Move and broadcast position updates (10 tick/sec)
- Take damage and die with backpack drops
- Respawn after death
- Combat system with accuracy model (adjustment vs recoil)

Includes project documentation in bot-docs/ and Claude agent helpers.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

bot-docs/DEV_SETUP.md

@@ -0,0 +1,123 @@
+# Development Environment Setup
+
+> Verified working on: Ubuntu 22.04 (Linux Mint 21.3 Virginia)
+
+## Requirements
+
+| Component | Version | Notes |
+|-----------|---------|-------|
+| Java | JDK 8 (1.8.0_xxx) | **Must be Java 8** - other versions fail |
+| sbt | 1.8.2+ | Scala build tool |
+| PostgreSQL | 14+ | Database |
+
+## Installation (Ubuntu/Mint)
+
+### 1. Java 8
+```bash
+sudo apt update
+sudo apt install -y openjdk-8-jdk
+
+# Set as default
+sudo update-alternatives --set java /usr/lib/jvm/java-8-openjdk-amd64/jre/bin/java
+sudo update-alternatives --set javac /usr/lib/jvm/java-8-openjdk-amd64/bin/javac
+
+# Verify
+java -version
+# Should show: openjdk version "1.8.0_xxx"
+```
+
+### 2. sbt
+```bash
+echo "deb https://repo.scala-sbt.org/scalasbt/debian all main" | sudo tee /etc/apt/sources.list.d/sbt.list
+curl -sL "https://keyserver.ubuntu.com/pks/lookup?op=get&search=0x99E82A75642AC823" | sudo apt-key add -
+sudo apt update
+sudo apt install -y sbt
+```
+
+### 3. PostgreSQL
+```bash
+sudo apt install -y postgresql postgresql-contrib
+sudo systemctl start postgresql
+sudo systemctl enable postgresql
+
+# Create database and user
+sudo -u postgres psql -c "CREATE USER psforever WITH PASSWORD 'psforever';"
+sudo -u postgres psql -c "CREATE DATABASE psforever OWNER psforever;"
+```
+
+## Building & Running
+
+### First Compile
+```bash
+cd PSF-LoginServer
+sbt compile
+```
+- Takes ~2-3 minutes on first run (downloads dependencies)
+- Expect some warnings (unused imports, non-exhaustive matches) - these are fine
+
+### Run Server
+```bash
+sbt "server/run"
+```
+
+**Expected behavior:**
+- Terminal stays open with live debug output
+- Shows player connections, actions, etc. in real-time
+- Does NOT return to prompt - this is correct
+
+**Expected startup output:**
+```
+PSForever Server - PSForever Project
+Login server is running on 127.0.0.1:51000
+```
+
+### Known Startup Errors (IGNORE)
+```
+ERROR akka.actor.SupervisorStrategy - null
+java.lang.NullPointerException: null
+    at net.psforever.objects.guid.GUIDTask$RegisterObjectTask.action(GUIDTask.scala:44)
+    ...
+    at net.psforever.objects.serverobject.shuttle.OrbitalShuttlePadControl...
+```
+These are **HART shuttle (orbital pad) initialization errors** - known issue, doesn't affect gameplay or our bot work.
+
+## Server Ports
+
+| Port | Protocol | Purpose |
+|------|----------|---------|
+| 51000 | TCP | Login server |
+| 51001 | UDP | World server |
+
+## Connecting a Client
+
+1. Use PlanetSide client version 3.15.84.0
+2. Point client at server IP (127.0.0.1 for local)
+3. Create account on first login (auto-created)
+
+## Running in Background
+
+```bash
+# Start in background
+nohup sbt "server/run" > server.log 2>&1 &
+
+# View logs
+tail -f server.log
+
+# Find and kill
+ps aux | grep sbt
+kill <PID>
+```
+
+## Troubleshooting
+
+### "authentication method 10 not supported"
+PostgreSQL version too old or password encryption mismatch. Upgrade PostgreSQL or check `postgresql.conf`.
+
+### Java version errors
+Make sure `java -version` shows 1.8.x. Use `update-alternatives` to switch if needed.
+
+### Port already in use
+```bash
+sudo lsof -i :51000
+# Kill the process using the port
+```