2
0
mirror of https://github.com/rehlds/rehlds.git synced 2024-12-29 08:05:50 +03:00
rehlds/README.md
2016-02-10 20:08:26 +03:00

3.7 KiB

Rehlds

Reverse-engineered (and bugfixed) HLDS

What is this?

Rehlds is a result of reverse engineering of original HLDS (build 6152/6153) using DWARF debug info embedded into linux version of HLDS, engine_i486.so

Along with reverse engineering, a lot of defects and (potential) bugs were found and fixed

You can try play on one of the servers that using rehlds: http://www.gametracker.com/search/?search_by=server_variable&search_by2=sv_version

Goals of the project

  • Provide more stable (than official) version of Half-Life dedicated server with extended API for mods and plugins
  • Performance optimizations (use of SSE for vector math for example) is another goal for the future

How can use it?

Rehlds is fully compatible with latest official HLDS downloaded by steamcmd. All you have to do is to download rehlds binaries and replace original swds.dll/engine_i486.so. For windows you can also copy a swds.pdb file with a debug information.
Warning! Rehlds is not compatible with an old 5xxx or below platforms downloaded by hldsupdatetool.

Compiled binaries are available here: http://nexus.rehlds.org/nexus/content/repositories/rehlds-snapshots/rehlds/rehlds/0.2-SNAPSHOT/

Archive's bin directory contains 2 subdirectories, 'bugfixed' and 'pure'

  • 'pure' version is designed to work exactly as official hlds engine
  • 'bugfixed' version contains some fixes and improvements

Warning! Rehlds is not binary compatible with original hlds since it's compiled with compilers other than ones used for original hlds. This means that plugins that do binary code analysis (Orpheu for example) probably will not work with rehlds.

Configuring

Bugfixed version of rehlds contains an additional cvars:

  • listipcfgfile // File for permanent ip bans. Default: listip.cfg
  • sv_auto_precache_sounds_in_models <1|0> // Automatically precache sounds attached to models. Deault: 0
  • sv_delayed_spray_upload <1|0> // Upload custom sprays after entering the game instead of when connecting. It increases upload speed. Default: 0
  • sv_echo_unknown_cmd <1|0> // Echo in the console when trying execute an uncknown command. Default: 0
  • sv_force_ent_intersection <1|0> // In a 3-rd party plugins used to force colliding of SOLID_SLIDEBOX entities. Default: 0
  • sv_rehlds_force_dlmax <1|0> // Force a client's cl_dlmax cvar to 1024. It avoids an excessive packets fragmentation. Default: 0
  • sv_rehlds_movecmdrate_max_avg // Max average level of 'move' cmds for ban. Default: 400
  • sv_rehlds_movecmdrate_max_burst // Max burst level of 'move' cmds for ban. Default: 2500
  • sv_rehlds_stringcmdrate_max_avg // Max average level of 'string' cmds for ban. Default: 80
  • sv_rehlds_stringcmdrate_max_burst // Max burst level of 'string' cmds for ban. Default: 400

Build instructions

There are several software requirements for building rehlds:

  1. Java Development Kit (JDK) 7+ (http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html)
  2. For Windows: Visual Studio 2013 and later
  3. For Linux: Intel C++ Compiler 13 and later

Checking requirements

####JDK version Windows

> %JAVA_HOME%\bin\javac -version
javac 1.8.0_25

Linux

$ javac -version
javac 1.7.0_65

####Visual Studio Help -> About

####ICC

$ icc --version
icc (ICC) 15.0.1 20141023

Building

On Windows:

gradlew --max-workers=1 clean buildRelease

On Linux:

./gradlew --max-workers=1 clean buildRelease

Compiled binaries will be placed in the rehlds/build/binaries/ directory

How can I help the project?

Just install it on your game server and report problems you faced Merge requests are also welcome :)