mirror of https://github.com/FWGS/xash3d-fwgs synced 2024-11-25 19:30:08 +01:00

Go to file

Alibek Omarov cf17b4f63c waf: update binary waf		2019-09-10 10:27:42 +03:00
common	engine: don't include windows headers, as they globally included by port.h already	2019-08-09 02:46:29 +03:00
contrib
Documentation	engine: implement platform-unique library naming	2019-07-01 05:48:53 +03:00
engine	engine: android: fix building dlsym_weak on latest NDK	2019-09-10 11:15:48 +06:00
game_launch	game_launch: fix build on windows	2019-08-09 02:59:40 +03:00
mainui@c3095f477f	engine: implement menu extensions to allow choosing renderers from GUI	2019-08-09 04:44:50 +03:00
pm_shared
public	public: build: fix wrong hardfp abi detection	2019-07-29 06:53:42 +03:00
ref_gl	engine: implement menu extensions to allow choosing renderers from GUI	2019-08-09 04:44:50 +03:00
scripts	waifulib: allow compiling using host clang and NDK sysroots, thus enabling building engine from any environment that has clang(termux as example)	2019-09-10 11:24:11 +06:00
vgui_support	vgui_support: properly EXPORT main entry point	2019-07-09 04:53:05 +03:00
vgui-dev@f5566261bd	readme: add note for debian/ubuntu prerequisites, add vgui-dev as submodule, update mainui	2019-06-17 09:04:39 +03:00
.editorconfig	editorconfig: initial add	2019-06-11 03:07:02 +03:00
.gitignore
.gitmodules	readme: add note for debian/ubuntu prerequisites, add vgui-dev as submodule, update mainui	2019-06-17 09:04:39 +03:00
.travis.yml	travis: comment osx autobuilds #61	2019-08-10 14:47:35 +03:00
CONTRIBUTING.md
README.md	readme: wording	2019-07-07 02:46:16 +03:00
waf	waf: update binary waf	2019-09-10 10:27:42 +03:00
waf.bat
wscript	engine: win32: include shellapi.h	2019-08-09 03:07:56 +03:00

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

Latest release build: https://github.com/FWGS/xash3d-fwgs/releases/latest

Latest development build: https://github.com/FWGS/xash3d-deploy/tree/newengine-master

Fork features

HLSDK 2.4 support.
Crossplatform: officially supported x86 and ARM on Windows/Linux/BSD/Android. (see Documentation/ports.md 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, GLES, 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 coding guide in CODING_STYLE.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.

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.