diff --git a/modules/billing/docs/ricochet/index.php b/modules/billing/docs/ricochet/index.php index c1e5e4b5..09d99f9f 100644 --- a/modules/billing/docs/ricochet/index.php +++ b/modules/billing/docs/ricochet/index.php @@ -1,68 +1,275 @@ -

Ricochet Server Guide

- -

Overview

-

Ricochet is available for hosting on our platform. This guide covers the basics of setting up and managing your Ricochet server.

- -
-

Server Information

- -

- Note: When running on a VPS or dedicated server, you can use the default port or configure a custom port in your server configuration file. -

+
+

📚 Quick Navigation

+
+ Overview + Ports & Firewall + Installation + Startup Parameters + Configuration + Maintenance + Troubleshooting + Resources +
-

Getting Started

-

To create a Ricochet server:

+

Ricochet Dedicated Server Hosting Guide

+

Ricochet is a Half-Life 1 era arena shooter that still uses the classic HLDS (GoldSrc) dedicated server stack. The notes below describe how to deploy and operate a Ricochet server on any Linux or Windows VPS without relying on a control panel.

+ +

Quick Facts

+ + +

🔌 Ports & Firewall Rules

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
PortProtocolPurposeRequired?
27015UDPGame traffic & master server heartbeatsRequired
27015TCPRCON & remote consoleOptional
27016UDPSpectator / HLTV relay (if used)Optional
27005UDP (outbound)Client auth replies; allow outbound so players can connectRequired outbound
+

Valve master servers also require outbound UDP 27010-27012; keep them open so your instance appears on public listings.

+
+
# UFW (Ubuntu/Debian)
+sudo ufw allow 27015/udp comment 'Ricochet game'
+sudo ufw allow 27015/tcp comment 'Ricochet RCON'
+sudo ufw allow 27016/udp comment 'Ricochet HLTV (optional)'
+
+# FirewallD (RHEL/CentOS)
+sudo firewall-cmd --permanent --add-port=27015/udp
+sudo firewall-cmd --permanent --add-port=27015/tcp
+sudo firewall-cmd --permanent --add-port=27016/udp
+sudo firewall-cmd --reload
+
+# Windows Defender Firewall
+netsh advfirewall firewall add rule name="Ricochet Game" dir=in action=allow protocol=UDP localport=27015
+netsh advfirewall firewall add rule name="Ricochet RCON" dir=in action=allow protocol=TCP localport=27015
+
+
+
+ +

Installation & SteamCMD Setup

+

Prerequisites

+ + +

Linux Deployment

+
# Create user	sudo useradd -m -s /bin/bash ricochet
+sudo passwd ricochet
+sudo -u ricochet bash
+
+# Install dependencies and SteamCMD
+sudo apt update && sudo apt install steamcmd lib32gcc-s1 lib32stdc++6 -y
+mkdir -p ~/ricochet-server && cd ~/ricochet-server
+steamcmd +login anonymous +force_install_dir $PWD +app_update 90 validate +quit
+
+# Launch once (tmux/screen recommended)
+./hlds_run -game ricochet -console -port 27015 +ip 0.0.0.0 \
+    +map rc_deathmatch +maxplayers 16 +sv_lan 0 +exec server.cfg
+
+ +

Windows Deployment

    -
  1. Navigate to the Game Servers page
  2. -
  3. Find Ricochet in the list
  4. -
  5. Select your preferred configuration (slots, duration, etc.)
  6. -
  7. Add to cart and complete checkout
  8. -
  9. Your server will be automatically provisioned within minutes
  10. +
  11. Install SteamCMD from Valve's developer wiki and extract to C:\steamcmd.
  12. +
  13. Create C:\servers\ricochet and run:
    + steamcmd +login anonymous +force_install_dir C:\servers\ricochet +app_update 90 validate +quit
  14. +
  15. Launch via batch file:
    cd /d C:\servers\ricochet
    +hlds.exe -console -game ricochet -port 27015 -ip 0.0.0.0 ^
    +    +map rc_deathmatch +maxplayers 16 +sv_lan 0 +exec server.cfg
  16. +
  17. Use Task Scheduler or NSSM to keep the process running after reboots.
-

Server Configuration

-

After your server is created, you can configure it through the control panel:

+

Startup Parameters

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
ParameterDescriptionExample
-game ricochetLoads the Ricochet mod data folderAlways required
-consoleForces console-only mode (no GUI)Recommended on servers
-port / -sportSets game and spectator ports-port 27015 -sport 27016
-ipBinds to a specific interface-ip 192.0.2.10
-autoupdateLinux only; pulls updates via SteamCMD when server restarts-autoupdate -steam_dir ~/steamcmd -steamcmd_script ~/ricochet/update.txt
+mapStarting map when the process boots+map rc_deathmatch
+maxplayersHard slot limit (1–32)+maxplayers 16
+sv_lan0 exposes to internet, 1 keeps LAN-only+sv_lan 0
+exec server.cfgEnsures your config runs on boot+exec server.cfg
+

Append +log on and +sv_password "pass" directly on the command line to guarantee they are processed even if configs fail.

+ +

Core Configuration Files

+

server.cfg Template

+
// Identity & access
+hostname "My Ricochet Arena"
+sv_password ""            // Set for private servers
+rcon_password "ChangeMe!2025"
+sv_lan 0
+sv_region 0                // 0 = worldwide listing
+
+// Gameplay
+mp_timelimit 20
+mp_fraglimit 20
+mp_weaponstay 1
+mp_falldamage 1
+mp_friendlyfire 0
+mp_flashlight 0
+mp_chattime 10
+mp_footsteps 1
+sv_cheats 0
+
+// Physics
+sv_gravity 800
+sv_airaccelerate 10
+sv_accelerate 10
+sv_friction 4
+sv_maxspeed 320
+
+// Networking
+sv_minrate 1500
+sv_maxrate 20000
+sv_minupdaterate 20
+sv_maxupdaterate 60
+sys_ticrate 300
+
+// Logging & security
+log on
+sv_logbans 1
+sv_logecho 1
+sv_log_onefile 0
+writeid
+writeip
+
+ +

mapcycle.txt

+
rc_deathmatch
+rc_arena
+rc_trinity
+rc_bounce
+
+

Reorder or duplicate entries to weight the rotation. Use mp_timelimit and mp_fraglimit to control the length of each round.

+ +

Scheduled Maintenance Scripts

+

Create restart.sh (Linux) to keep the process alive:

+
#!/bin/bash
+cd /home/ricochet/ricochet-server
+while true; do
+  ./hlds_run -game ricochet -console -port 27015 \
+    +map rc_deathmatch +maxplayers 16 +sv_lan 0 +exec server.cfg
+  echo "Server crashed/restarted at $(date)" >> restart.log
+  sleep 5
+done
+
+

Run it inside tmux or screen, or convert to a systemd service for automatic boot.

+ +

Maintenance & Best Practices

-

Common Tasks

- -

Starting Your Server

-

Servers are automatically started after creation. You can stop/start your server from the control panel.

- -

Connecting to Your Server

-

Use your server's IP address and port to connect from the game client.

- -

Managing Files

-

Access your server files via FTP using the credentials provided in your control panel.

- -

Support

-

If you need assistance with your Ricochet server:

- - -
-

Important Notes

-
+ +

Reference Links

+ diff --git a/modules/billing/docs/ricochet/metadata.json b/modules/billing/docs/ricochet/metadata.json index 19deb1c5..f8ba1dc7 100644 --- a/modules/billing/docs/ricochet/metadata.json +++ b/modules/billing/docs/ricochet/metadata.json @@ -1,6 +1,6 @@ { - "description": "Setup and configuration guide for Ricochet game servers", + "description": "Self-hosted Ricochet dedicated server reference (Linux/Windows)", "name": "Ricochet", "order": 73, - "category": "todo" -} \ No newline at end of file + "category": "game" +}