FWGS/xash3d-fwgs
2
0
Fork 0
mirror of https://github.com/FWGS/xash3d-fwgs synced 2024-11-25 03:11:06 +01:00
Code Issues 2 Projects Releases Wiki Activity
1,833 Commits 25 Branches 50 Tags 30 MiB
C 95.5%
Python 1.8%
C++ 0.8%
Java 0.7%
Kotlin 0.6%
Other 0.5%
2218126c75
Go to file
Alibek Omarov 2218126c75 engine: disable stdout output and flush on Windows, Wcon already does the job
2022-06-14 04:41:37 +03:00
.github/workflows github: disable cleanup for self-hosted runners because there are none 2022-03-11 14:05:53 +03:00
common engine: remove LoadLibrary macros, to avoid possible misuse. Although macros moved to game_launch, it's part of it's own problem from now 2022-06-11 03:25:57 +03: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: opensource-mods.md: update 2022-06-03 19:54:45 +03:00
engine engine: disable stdout output and flush on Windows, Wcon already does the job 2022-06-14 04:41:37 +03:00
game_launch game_launch: fix win32 build 2022-06-13 04:21:57 +03:00
mainui@0a28db384b update: mainui 2022-06-09 03:09:48 +03:00
pm_shared Trim all trailing whitespace 2021-01-04 20:55:10 +03:00
public public: remove custom str(r)chr functions 2022-06-14 03:23:46 +03:00
ref_gl ref_gl: gl4es: update 2022-05-29 18:27:16 +03:00
ref_soft ref_soft: use correct types for pointer arithmetics 2022-05-29 04:23:07 +03:00
scripts scripts: gha: fix including vgui.dll 2022-06-12 04:16:41 +03:00
utils utils: mdldec: add fixed uv coords support. 2022-02-12 22:06:31 +03:00
vgui_support@2c17ffffdb vgui_support: re-add as submodule 2022-06-12 04:15:41 +03:00
.cirrus.yml ci: upgrade freebsd tasks 2022-06-03 19:53:58 +03:00
.editorconfig editorconfig: initial add 2019-06-11 03:07:02 +03:00
.gitattributes Add .gitattributes to enforce Git write normal human file endings and show pretty diffs for C and Python 2021-10-02 03:47:32 +03:00
.gitignore engine: common: add quote symbol escaping support (#411) 2021-04-04 22:03:02 +03:00
.gitmodules vgui_support: re-add as submodule 2022-06-12 04:15:41 +03:00
CONTRIBUTING.md readme: sligthly update contributing guidelines 2019-10-06 03:49:46 +03:00
README.md wscript: set rpath to current folder, LD_LIBRARY_PATH is unneeded anymore 2022-03-03 05:57:51 +03:00
waf waf: upgrade to temporary waifu branch with absolute path clang compilation database generator 2022-05-29 05:19:23 +03:00
waf.bat waf.bat: correctly parse reg query on Windows 10+, fallback only to py.exe wrapper 2022-05-29 19:22:48 +03:00
wscript wscript: better _FILE_OFFSET_BITS check, as suggested by @nekonomicon 2022-06-12 04:25:09 +03:00

README.md

Xash3D FWGS Engine

GitHub Actions Status FreeBSD Build Status Discord Server
Download Stable Download Testing

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

Installation & Running

  1. Get Xash3D FWGS binaries: you can use testing build or you can compile engine from source code.
  2. Copy engine binaries to some directory.
  3. Copy valve directory from Half-Life to directory with engine binaries. If your CPU is NOT x86 compatible or you're running 64-bit version of the engine, you may want to compile Half-Life SDK. This repository contains our fork of HLSDK and restored source code for some of the mods. Not all of them, of course. You still needed to copy valve directory as all game resources located there.
  4. Run the main executable (xash3d.exe or AppImage).

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

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
  • Issues are accepted in both English and Russian
  • 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/

NOTE: NEVER USE GitHub's ZIP ARCHIVES. GitHub doesn't include external dependencies we're using!

Prerequisites

If your CPU is x86 compatible, we are building 32-bit code by default. This was dont 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!

If your CPU is NOT x86 compatible or you decided build 64-bit version of engine, you may want to compile Half-Life SDK. This repository contains our fork of HLSDK and restored source code for some of the mods. Not all of them, of course.

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

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

Building

Windows (Visual Studio)

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

Linux

If compiling 32-bit on amd64, you may need to supply export PKG_CONFIG_PATH=/usr/lib/i386-linux-gnu/pkgconfig prior to running configure.

  1. Examine which build options are available: ./waf --help
  2. Configure build: ./waf configure -T release (You need to pass -8 to compile 64-bit engine on 64-bit x86 processor)
  3. Compile: ./waf build
  4. Install(optional): ./waf install --destdir=/path/to/any/output/directory