Retinal scanner models.

These only work in maps, mods, and/or SDKs that support PS2-style model-based retinal scanners such as our Featureful Campaigns project.

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.

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

Requirements

Basic requirements

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

All but Inkscape and ImageMagick are usually pre-installed on most flavours of Linux.

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.

Useful links

• Inkscape CLI man page
• ImageMagick documentation
• ImageMagick usage and examples
• ModelTextureMaker documentation

Credits

• Warning symbol from File:ISO_7010_W001.svg on Wikipedia
• Retinal image based on File:Healthy_Adult_OS,_Color_-_California_Projection.jpeg on Wikipedia
• The Anton font is used for the heavy text as an alternative to the Impact font.
• The OCR A Std font is used for other text.
• Chromatic aberration Inkscape filter used on the monitor is by Fabien Fellay.

License

The content in this package and the source files 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.

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

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

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 idleberg/Creative-Commons-Markdown for providing Creative Commons licenses in Markdown format.

---

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