310 Lines
  • Markdown 63.5%
  • Yaml 34.8%
  • JSON 1.6%
README.md

OpenProStreetV

CLI management tool and runner written in V for Need for Speed: ProStreet dedicated servers.

Download Artifacts Repository


đŸ“Ļ Downloads & Releases

Pre-compiled OpenProStreetV binaries can be downloaded directly from: 👉 https://weexnes.dev/project/OpenProStreetV#artifacts


🚀 Features

  • Automated Setup: Clones and updates server binaries and dependencies (setup).
  • Foreground & Service Control: Starts, manages, and gracefully stops NFS ProStreet server instances (start, stop).
  • Multi-Instance Support: Easily configure and spin up multiple game server instances with -instances / -i.
  • Systemd Integration: Generate and install systemd user services effortlessly (install-service).
  • HTTP & LAN Server Config: Configure custom HTTP/LAN ports and options directly via CLI flags.

đŸ•šī¸ Usage & Commands

# Basic Setup (Note: Requires access to server binaries repository)
./OpenProStreetV setup

# Start Server with 2 instances on HTTP port 8080
./OpenProStreetV start -i 2 -p 8080

# Stop running server instances
./OpenProStreetV stop

# Install systemd user service
./OpenProStreetV install-service

Command Flags

  • -i, --instances <int>: Max game instances to launch (default: 1)
  • -l, --lanport <int>: LAN Server port (default: 10104)
  • -p, --httpport <int>: HTTP Server port (default: 8080)
  • -h, --http: Enable HTTP Server (default: true)

âš ī¸ Important Note regarding setup & Manual Installation

Warning

The ./OpenProStreetV setup command attempts to clone https://code.weexnes.dev/ProStreet-LAN.git into ~/.OpenProStreet. Because this repository contains original game server files shipped with NFS ProStreet, it is private.

Manual Server Setup Instructions

End users without access to the repository must set up the directory manually:

  1. Create the server folder at ~/.OpenProStreet/.
  2. Copy all server files from your game installation's ONLINE/ directory (specifically bombd.exe, rebroadcasterlan.exe, and any accompanying DLLs/configs) into ~/.OpenProStreet/.
  3. Put winmm.dll (from ProStreetServerASILoader) into ~/.OpenProStreet/ if using custom .asi server plugins.
  4. Launch the server using ./OpenProStreetV start.

đŸ› ī¸ Installation

  1. Download the latest binary from weexnes.dev Artifacts.
  2. Grant execution permissions:
    chmod +x OpenProStreetV
    
  3. Prepare server files in ~/.OpenProStreet/ (as described above) and start the server:
    ./OpenProStreetV start
    

đŸ’ģ Building from Source

Requires the V programming language (vlang).

# Compile OpenProStreetV binary
v . -o OpenProStreetV

📜 License & Repository

Please wait...
Connection lost or session expired, reload to recover
Page is in error, reload to recover