mirror of https://github.com/2revoemag/PSF-BotServer.git synced 2026-01-19 18:14:44 +00:00

2revoemag 2e5b5e0dbd 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>

2025-11-23 00:22:30 -05:00

3 KiB

Raw Permalink Blame History

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

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

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

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

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

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

Use PlanetSide client version 3.15.84.0
Point client at server IP (127.0.0.1 for local)
Create account on first login (auto-created)

Running in Background

# 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

sudo lsof -i :51000
# Kill the process using the port

3 KiB Raw Permalink Blame History