Shotgun weapon model for Half-Life.

This is heavily inspired by Sappy & Wonrz' recreation of the original Half-Life shotgun, while also adopting ideas from Chris Bryant's and Juniez' shotguns.

Animations and sounds are by Bobito Pawner.

See our view arms repository for arm credits.

Downloading

Downloads are found on the releases page.

Development

All development is done on Linux. While it is possible to get this working on Windows, I don't really want to spend 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
7. Inkscape installed as a flatpak (recommended) or as an inkscape command found somewhere in your path

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/games

By default, the build process builds for Half-Life/valve_addon with HEV suit arms, but can easily be run for other expansions, mods, or even games 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

Decay: Solo Mission

This is an example of building for a different base game:

make base-game="Half-Life Decay Solo Mission Demo" mod-dir=decaysolodemo_addon arms-type=hev_hd_tan

All at once

All of the above can be built all at once by running:

make build-all-games

and to do all of that plus copying to each mod or game:

make build-to-all-games

---

Please see the makefile for other targets you can invoke.

Useful links

• ImageMagick documentation
• ImageMagick usage and examples

License

The content in this repository are licensed under the CC BY-NC 4.0 license. This means:

• You can include the built content in your own non-commercial project.

• You can adapt, alter, remix, and then release that derivative work. (Please use the source files and not decompiled models, however.)

• You must link back to ambientimpact.com/unforeseen in your credits and/or readme.

• You cannot use this as-is for a commercial project; if you wish to do so, please get in touch and we can work out an agreement and compensation.

Thank you

Thank you to Bobito Pawner for the awesome animations and sounds.

Thank you to the developer of ModelTextureMaker for creating such an invaluable tool.

Thank you to the PrimeXT project for their Linux build of pxstudiomdl.

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

Thank you to all the developers of Inkscape for such a full featured, powerful, and Linux-friendly Adobe Illustrator replacement.

Thank you to idleberg/Creative-Commons-Markdown for providing Creative Commons licenses in Markdown format.

---

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