IW4x Launcher

Getting Started

IW4x launcher is built using the build2 build system. To get started, you'll need the staged toolchain, which you can grab as either source or binary packages. The pre-built binaries are available here:

• Staged Toolchain
• SHA256 Checksums

You'll also need a working GCC compiler. Use GCC if you're compiling on Linux, or MinGW if you're on Windows. If you need help setting these up, you can find installation instructions below:

• GCC
• MinGW-w64

Consumption

Note

Consumption is just build2's term for building the package without actively modifying the code. These steps are great if you want to test the latest development builds, but we don't recommend them for regular users just looking to install and play the game.

Windows

# Create the build configuration:
bpkg create -d launcher cc          ^
  config.cxx=x86_64-w64-mingw32-g++ ^

cd launcher

# To build:
bpkg build launcher@https://github.com/iw4x/launcher.git#main

# To test:
bpkg test launcher

# To install:
bpkg install launcher

# To uninstall:
bpkg uninstall launcher

# To upgrade:
bpkg fetch
bpkg status launcher
bpkg uninstall launcher
bpkg build --upgrade --recursive launcher
bpkg install launcher

Linux

# Create the build configuration:
bpkg create -d launcher @gcc cc

cd iw4x

# To build:
bpkg build launcher@https://github.com/iw4x/launcher.git#main

# To test:
bpkg test launcher

# To install:
bpkg install launcher

# To uninstall:
bpkg uninstall launcher

# To upgrade:
bpkg fetch
bpkg status launcher
bpkg uninstall launcher
bpkg build --upgrade --recursive launcher
bpkg install launcher

If you want to dive deeper into how these commands work, check out the build2 package consumption guide.

Development

Note

These instructions are meant for developers looking to modify and contribute to the IW4x launcher codebase. If you just want to compile and test the latest build, follow the Consumption steps above instead.

Linux

# Clone the repository:
git clone --recursive https://github.com/iw4x/launcher.git

cd launcher

# Create the build configuration:
bdep init -C @gcc        \
  config.cc.compiledb=./ \
  cc

# To build:
b

# To test:
b test

Windows

# Clone the repository:
git clone --recursive https://github.com/iw4x/launcher.git

cd iw4x

# Create the build configuration:
bdep init -C -@mingw32 cc           ^
  config.cxx=x86_64-w64-mingw32-g++ ^
  config.cc.compiledb=./

# To build:
b

# To test:
b test

For more details on bdep and typical development workflows, take a look at the build2 build system manual.

License

IW4x launcher is licensed under the GNU General Public License v3.0 or later. See LICENSE.md for details.