mirror of
https://github.com/2revoemag/PSF-BotServer.git
synced 2026-01-19 18:14:44 +00:00
2e5b5e0dbd
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>
124 lines
3 KiB
Markdown
124 lines
3 KiB
Markdown
# 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
|
|
```
|