.357 revolver weapon model for Half-Life.

Please note that while most of this repository is licensed under the GPL v3, the High Definition Pack meshes, animations, and textures are based on work that is the property of Valve and Gearbox.

Development

All development is done on Linux. While it is possible to get this working on Windows, I have no intention of spending time on that. Gaming on Linux is really good now, so why not join us?

Git submodules

When cloning this repository, make sure to use the --recurse-submodules (or --recurse) flag to also include Git submodules containing shared source files. You won't be able to compile if you skip this.

Requirements

1. Make
2. GNU Core Utilities (a.k.a. coreutils)
3. Rsync
4. Wget
5. unzip
6. ImageMagick 7 or newer

All but ImageMagick are pre-installed on nearly all flavours of Linux.

Git LFS

If you need to access the model and texture source files (such as Photoshop PSDs, etc.), you'll also need to have Git LFS installed for git to pull them. If you install it after checking out this repository, you'll need to open a terminal, navigate to the repo root, and run:

git lfs install
git lfs fetch
git lfs checkout

This will update the repository's hooks, then download and check out the LFS files, replacing the pointer files with their actual contents.

See git-lfs-install(1), git-lfs-fetch(1), and git-lfs-checkout(1).

Building

Open a terminal in root of this repostory and run:

make

This will automatically download and extract ModelTextureMaker and a compiled copy of the PrimeXT project's pxstudiomdl to the repository directory if they aren't found and then will build all models. The first build will be the longest, but subsequent builds should only build models whose source files have changed.

To automate this further, you can run:

make build-to-game

Warning: this will overwrite any model files with the same names in your Half-Life/valve_addon/models directory; other model files should be left as-is.

Building for other expansions/mods

By default, the build process builds for valve_addon with HEV suit arms, but can easily be run for other expansions/mods with other hands:

Opposing Force

make mod-dir=gearbox_addon arms-type=soldier

Blue Shift

make mod-dir=bshift_addon arms-type=security

Echoes

make mod-dir=echoes_addon arms-type=scientist

Please see the makefile for other targets you can invoke.

Useful links

• ImageMagick documentation
• ImageMagick usage and examples

Thank you

Thank you to the developer of ModelTextureMaker for creating such an invaluable tool, the PrimeXT project for their Linux build of pxstudiomdl, and thank you to the developers of ImageMagick for such a bonkers useful CLI tool they've built upon and maintained since (I kid you not) 1987.

---

No generative AI was used for any part of this project.