Skip to content

Server Setup

Jump to bottom
wootguy edited this page Aug 24, 2025 · 3 revisions

Building the server

  1. Install dependendies.
    Windows: Install Git, CMake, and Visual Studio
    Debian: apt install git cmake build-essential gcc-multilib g++-multilib libc6-dev-i386 mesa-common-dev
  2. Open a shell somewhere and clone the repo: git clone --recurse-submodules https://github.com/wootguy/SevenKewp
  3. Run scripts/build_server_and_plugins.bat (Windows) or scripts/build_server_and_plugins.sh (Linux).
  4. Intall the official Half-Life dedicated server from SteamCMD. The steam_legacy beta is needed for ReHLDS compatibility: 
    login anonymous
app_set_config 90 mod cstrike
app_update 90 -beta steam_legacy validate
  5. Copy the contents of SevenKewp/build/output/ to Half-Life/valve/ in your Half-Life dedicated server.
  6. Build and install my fork of ReHLDS. This is required for some maps.
    1. Windows users:
      1. Open rehlds/msvc/ReHLDS.sln. Select OK if asked to retarget.
      2. Optional: If you're setting up a public server, right-click the ReHLDS project and select Properties -> Configuration Manager. Change the Active solution configuration to Release. This gives much better performance.
      3. Right click Solution 'ReHLDS' and select Build Solution
      4. Copy the .exe and .dll files from SevenKewp/rehlds/msvc/Debug (or Release) over the existing files in your Half-Life/ folder on the dedicated server. Director.dll is special and goes into Half-Life/valve/dlls/ instead.
  7. Copy the contents of SevenKewp/sevenkewp/ to Half-Life/valve/ on your dedicated server. The .cfg files must be in valve/, but you can copy everything else to valve_downloads/ if you want.
  8. Add -dll dlls/server.dll (Windows) or -dll dlls/server.so (Linux) to the launch options of your dedicated server. If you use metamod, then add gamedll dlls/server.dll (or .so) to metamod's config.ini instead.
  9. Try it out! Example launch command:
    hlds.exe +map c1a1 -dll dlls/server.dll +maxplayers 32 +developer 1 -heapsize 65536 -num_edicts 4096 +servercfg "" +log on

Building native plugins

Native plugins are tightly integrated with the mod code and have full access to its classes and utilities. This makes native plugins powerful but easily broken by mod updates. Here's how to build them.

  1. Set up the mod project as described in the previous section
  2. Open a shell in SevenKewp/plugins/
  3. Clone all the plugin repos you want. Example: git clone https://github.com/wootguy/HLCMapPlugins/
  4. Run the build script again: scripts/build_server_and_plugins.bat (Windows) or scripts/build_server_and_plugins.sh (Linux)
  5. Copy the contents of SevenKewp/build/output/ to valve/ on your dedicated server.
  6. Repeat steps 4 and 5 whenever the mod updates.

Installing native plugins

Once you have built or downloaded a native plugin, you need to copy it to the right place and update the relevant config file. valve and valve_downloads are interchangeable. The plugin loader will search both paths.

Server plugins

  1. Copy the dll to the server plugins folder (Example: valve/plugins/server/AntiBlock.dll)
  2. Add the plugin file path to valve/plugins.txt without the file extension (Example: write Antiblock to load the path in step 1)

Plugin paths in plugins.txt start in valve/plugins/server/. That's why you only need to write AntiBlock instead of valve/plugins/server/AntiBlock in the above example.

Map plugins

These steps only apply to unreleased maps/ports. Ideally the map package will set this up for you so that you only need to extract the files.

  1. Copy the dll to the map plugins folder (Example: valve/plugins/maps/pizza_ya_san.dll)
  2. Add the plugin file path to the map cfg file(s) the plugin was made for (Example: add map_plugin pizza_ya_san to valve/maps/pizza_ya_san1.cfg and valve/maps/pizza_ya_san2.cfg).

Plugin paths in map cfg files start in valve/plugins/maps/.

Installing Sven Co-op maps

Sven Co-op maps often need converting before they can be used in Half-Life. Not doing this will result in crashes. This section is here mostly as a warning not to install maps directly. Good luck actually following this. I plan to publish all my ports and ripents later so that this isn't needed.

  1. Create a folder and copy scripts/convert_map.py to the new folder.
  2. Add modelguy, ripent, bspguy, and wadmaker to the same folder. modelguy and bspguy need to be built from source because the latest releases are missing features.
  3. Copy resguy_default_content_hl.txt from resguy to the folder, and rename it to resguy_default_content.txt
  4. Copy skill.cfg to the folder.
  5. Copy titles.txt from the latest version of Sven Co-op to the folder.
  6. Update valve_path in the script to point to your Half-Life/valve folder.
  7. Install imagemagick and ffmpeg. Make sure magick and ffmpeg are usable from the command-line.
  8. Extract a map package to the folder (maps/ should end up next to the script)
  9. Run the script

Maps made for Sven Co-op 5.x often need special attention (map moving/splitting to fit in the +/-4096 grid, texture resizing, etc.). bspguy has porting tools to help with this.

So far, I've had the only server hosting sven maps so I don't bother renaming files that the script modifies. That's a horrible practice and will cause crashes once other server ops start hosting without reading this section.

Clone this wiki locally