mirror of https://github.com/FWGS/xash3d-fwgs synced 2024-12-23 09:16:04 +01:00

Go to file

mittorn bbd033c254 lib: restore dll loader support		2020-01-19 07:38:37 +07:00
common	Merge branch 'lib' of https://github.com/FWGS/xash3d-fwgs	2020-01-18 07:15:45 +07:00
contrib/mittorn	contrib: remove my personal qtcreator project, as I'm using compile_commands.json support now	2019-11-28 19:21:53 +03:00
Documentation	Documentation: engine-porting-guide: finalize document	2019-11-24 02:31:48 +03:00
engine	lib: restore dll loader support	2020-01-19 07:38:37 +07:00
game_launch	Revert "game_launch: check for Platform_Main before Host_Main"	2019-11-07 05:06:51 +03:00
mainui@f197117dac	engine: fix -Wmaybe-uninitialized	2019-12-24 02:47:51 +03:00
pm_shared	xash3d-fwgs: append missing new line at the end of file	2019-10-27 22:29:03 +03:00
public	engine: fix -Wmaybe-uninitialized	2019-12-24 02:47:51 +03:00
ref_gl	Merge branch 'lib' of https://github.com/FWGS/xash3d-fwgs	2020-01-18 07:15:45 +07:00
scripts	Merge branch 'lib' of https://github.com/FWGS/xash3d-fwgs	2020-01-18 07:15:45 +07:00
vgui_support	wscript: refactoring, add waf_unit_test, disable -Wdouble-promotion, rename fast as fastnative and leave fast without -march=native for x-compiling	2019-11-05 01:01:33 +03:00
vgui-dev@f5566261bd
.cirrus.yml	ci: disable dedicated build for freebsd at now	2019-10-18 07:36:03 +03:00
.editorconfig
.gitignore
.gitmodules
.travis.yml	travis: don't upload dead APKs [ci skip]	2019-12-03 04:00:11 +03:00
CONTRIBUTING.md	readme: sligthly update contributing guidelines	2019-10-06 03:49:46 +03:00
README.md	readme: wording	2019-07-07 02:46:16 +03:00
waf	waf: third msvc test	2019-11-07 07:19:08 +03:00
waf.bat
wscript	lib: restore dll loader support	2020-01-19 07:38:37 +07: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.