Ammo, health, and other collectible item models for Half-Life.

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

Basic requirements

1. Make
2. GNU Core Utilities (a.k.a. coreutils)
3. sed
4. Wget
5. unzip
6. ImageMagick 7 or newer as a magick command found somewhere in your path

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

Building to game

In addition to the basic requirements:

1. Rsync

Rendering promo art

In addition to the basic requirements:

1. Blender installed as a flatpak (recommended) or as a blender command found somewhere in your path
2. Inkscape installed as a flatpak (recommended) or as an inkscape command found somewhere in your path

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.

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 the developer of ModelTextureMaker for creating such an invaluable tool, 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, and 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.