Xash3D FWGS engine.

mittorn bef873e1f8 platform/android: enable dynamic dladdr, fix build		5 years ago
Documentation	Fixed mod title in Open Source mods documentation.	5 years ago
common	platform/android: enable dynamic dladdr, fix build	5 years ago
contrib/mittorn	contrib: remove my personal qtcreator project, as I'm using compile_commands.json support now	5 years ago
engine	platform/android: enable dynamic dladdr, fix build	5 years ago
game_launch	game_launch: fix Win32 main	5 years ago
mainui@b921b2a7d4	mainui: update	5 years ago
pm_shared	xash3d-fwgs: append missing new line at the end of file	5 years ago
public	tgmath: remove including tgmath.h in everything that uses xash3d_mathlib, as it's included already	5 years ago
ref_gl	engine: try to fix -Wmaybe-uninitialized that may be enabled with -Wuninitialized. Diagnostic is prone to false-positives, as compiler don't have enough data for this	5 years ago
ref_soft	gles1 and non-pbo fallbacks	5 years ago
scripts	waf/xcompile: gnu hash on android confuses old linkers	5 years ago
utils/mdldec	utils: add studio model decompiler.	5 years ago
vgui-dev@f5566261bd	readme: add note for debian/ubuntu prerequisites, add vgui-dev as submodule, update mainui	6 years ago
vgui_support	wscript: refactoring, add waf_unit_test, disable -Wdouble-promotion, rename fast as fastnative and leave fast without -march=native for x-compiling	5 years ago
.cirrus.yml	ci: run pkg update for freebsd	5 years ago
.editorconfig	editorconfig: initial add	6 years ago
.gitignore	…
.gitmodules	readme: add note for debian/ubuntu prerequisites, add vgui-dev as submodule, update mainui	6 years ago
.travis.yml	travis: don't upload dead APKs [ci skip]	5 years ago
CONTRIBUTING.md	readme: sligthly update contributing guidelines	5 years ago
README.md	readme: fix #187	5 years ago
waf	waf: upgrade to latest waifu version	5 years ago
waf.bat	waf.bat: fix strange ERRORLEVEL bug	6 years ago
wscript	wscript: disable treating uninitialized as error because it gives too much false-positives	5 years ago

README.md

Xash3D FWGS Engine

Xash3D FWGS is a fork of Xash3D Engine by Unkle Mike with extended features and crossplatform.

Xash3D is a game engine, aimed to provide compatibility with Half-Life Engine, 
as well as to give game developers well known workflow and extend it.
Read more about Xash3D on ModDB: https://www.moddb.com/engines/xash3d-engine

Fork features

HLSDK 2.4 support.
Crossplatform: supported x86 and ARM on Windows/Linux/BSD/Android. (see docs for more info)
Modern compilers support: say no more to MSVC6.
Better multiplayer support: multiple master servers, headless dedicated server.
Mobility API: allows better game integration on mobile devices(vibration, touch controls)
Different input methods: touch, gamepad and classic mouse & keyboard.
TrueType font rendering, as a part of mainui_cpp.
Multiple renderers support: OpenGL, GLESv1, GLESv2, Software
A set of small improvements, without broken compatibility.

Planned fork features

Virtual Reality support and game API
Voice support
Vulkan renderer

Contributing

Before sending an issue, check if someone already reported your issue. Make sure you're following "How To Ask Questions The Smart Way" guide by Eric Steven Raymond. Read more: http://www.catb.org/~esr/faqs/smart-questions.html
Before sending a PR, check if you followed our contribution guide in CONTRIBUTING.md file.

Build instructions

We are using Waf build system. If you have some Waf-related questions, I recommend you to read https://waf.io/book/

If you're stuck somewhere and you need a clear example, read .travis.yml and scripts/build*.sh.

NOTE: NEVER USE GitHub's ZIP ARCHIVES. They are broken and don't contain external dependencies sources we're using.

Prerequisites

Windows(Visual Studio)

Install Visual Studio.
Install latest Python OR run cinst python.install if you have Chocolatey.
Install latest Git OR run cinst git.install if you have Chocolatey.
Download SDL2 development package for Visual Studio.
Clone this repository: git clone --recursive https://github.com/FWGS/xash3d-fwgs.
Make sure you have at least 12GB of free space to store all build-time dependencies: ~10GB for Visual Studio, 300 MB for Git, 100 MB for Python and other.

GNU/Linux

NOTE FOR USERS WITH X86 COMPATIBLE CPUs: We have forced build system to throw an error, if you're trying to build 64-bit engine. This done for keeping compatibility with Steam releases of Half-Life and based on it's engine games. Even if Xash3D FWGS does support targetting 64-bit, you can't load games without recompiling them from source code!

Debian/Ubuntu

Enable i386 on your system, if you're compiling 32-bit engine on amd64. If not, skip this

$ sudo dpkg --add-architecture i386

Install development tools
- For 32-bit engine on amd64:
  $ sudo apt install build-essential gcc-multilib g++-multilib python libsdl2-dev:i386 libfontconfig-dev:i386 libfreetype6-dev:i386
- For everything else:
  $ sudo apt install build-essential python libsdl2-dev libfontconfig-dev libfreetype6-dev
Clone this repostory: $ git clone --recursive https://github.com/FWGS/xash3d-fwgs

ArchLinux

ArchLinux users are lucky enough and there is a xash3d-git AUR package for them.

Building

Windows(Visual Studio)

Open command line
Navigate to xash3d-fwgs directory.
Carefully examine which build options are available: waf --help
Configure build: waf configure -T release --sdl2=c:/path/to/SDL2 --prefix=c:/path/to/any/output/directory
Compile: waf build
Install: waf install

Linux

Examine which build options are available: ./waf --help
Configure build: ./waf configure -T release --prefix=/path/to/any/output/directory (To compile 64-bit engine on 64-bit x86 processor, you need to pass -8 also)
Compile: ./waf build
Install(optional): ./waf install

Running

Copy libraries and main executable somewhere, if you're skipped installation stage.
Copy game files to same directory
Run xash3d.exe/xash3d.sh/xash3d depending on which platform you're using.

For additional info, run Xash3D with -help command line key.