Files
tactical-shooter/docs/playtest-guide.md
T
shawn d02b112d99 Phase 7: test server deployment + Windows export
- Fix: export_presets.cfg — platform='Windows Desktop' (correct name)
- Fix: server_main.gd — formatting bug on lag-comp string
- Fix: game_server.gd — auto-detect GDExtension, fall back to GDScript stub
- Add: server/scripts/simulation_server_stub.gd — lightweight SimulationServer in GDScript
- Add: docs/playtest-guide.md — connection instructions, control bindings, server commands
- Add: systemd user service — tactical-shooter-server (enabled, running)
- Add: server config at ~/tactical-shooter-server/server_config.cfg
- Build: Windows 109MB PE32+ client (build/tactical-shooter-windows-x86_64/)
- Build: Linux server binary (78MB) — running on oplabs:34197
- Temporarily disabled GDExtension (needs C++ build fix in entity.cpp enum casting)
2026-07-01 20:02:05 -04:00

102 lines
2.3 KiB
Markdown

# Tactical Shooter — Playtest Guide
## Quick Start
### 1. Get the Windows Client
Download `tactical-shooter-windows.zip` from the build directory, or clone the repo and find it at:
```
build/tactical-shooter-windows-x86_64/tactical-shooter.exe
```
Extract the zip anywhere on your Windows machine and run `tactical-shooter.exe`.
### 2. Connect to the Test Server
| Setting | Value |
|---------|-------|
| **Server IP** | `68.202.6.107` (external) or `192.168.0.127` (LAN) |
| **Port** | `34197` |
| **Protocol** | ENet (UDP) |
Launch the game, open the console (~) and type:
```
connect 68.202.6.107:34197
```
### 3. Controls
| Action | Key |
|--------|-----|
| Move | W/A/S/D |
| Jump | Space |
| Sprint | Shift (tap to toggle) |
| Crouch | Ctrl (hold) |
| Shoot | Mouse LMB |
| Aim | Mouse RMB |
| Reload | R |
| Interact | E |
| Release mouse | Escape |
---
## Dedicated Server Info
The test server runs on OPLabs infrastructure:
- **Host:** oplabs VM (192.168.0.127)
- **Binary:** `~/tactical-shooter-server/tactical-shooter-server.x86_64`
- **Service:** `systemctl --user status tactical-shooter-server`
- **Config:** `~/tactical-shooter-server/server_config.cfg`
### Server Commands (SSH into oplabs)
```bash
# Check status
systemctl --user status tactical-shooter-server
# View logs
journalctl --user -u tactical-shooter-server -f
# Restart
systemctl --user restart tactical-shooter-server
# Stop
systemctl --user stop tactical-shooter-server
```
### RCON Admin
Connect via TCP to port 34198 with the RCON password (set in server_config.cfg):
```
rcon_password <password>
rcon commands
rcon changelevel test_range
rcon kick <player_id>
```
---
## Troubleshooting
| Issue | Fix |
|-------|-----|
| Can't connect | Check server is running: `systemctl --user status tactical-shooter-server` |
| Firewall block | Ensure port 34197/UDP is open on the server |
| Game won't start | Install [VC++ Redistributable](https://aka.ms/vs/17/release/vc_redist.x64.exe) |
| High ping | The server is in eastern Canada; use the LAN IP if on the same network |
---
## Architecture
```
[Windows Client] -- ENet/UDP :34197 --> [Dedicated Server (oplabs)]
|
[GDExtension C++ Core]
[Game State 128Hz Tick]
```
See `docs/architecture.md` in the repo for full details.