Set of scripts for importing Source 1 assets such as materials, models, and particle effects into Source 2. Inspired by Valve's own internal utility (written in C++ and Perl), this one is in Python.
Fork of the popular long-standing source2utils tool.
- Make sure to convert textures before materials.
- Make sure to move the entire s1
models
folder tocontent/
then run the script. - Make sure to move the entire s1
sound
folder tocontent/
and rename it tosounds
. - Make sure to have
gameinfo.txt
present in Import Game. - Make sure to read this guide for importing map files.
- It suggests that your s1 files be in
game/<modname>
and imported files be incontent/hlvr_addons/<modname>_imported
โ you will get correct texture scale and fixed up entities only that way.
- It suggests that your s1 files be in
Download app from Releases.
The app can be slow to open up, but has no prerequisites. If you want to make edits to the scripts & have Python installed, run the advanced way by downloading the code.
cd utils
python scripts_import.py -i "C:/.../Team Fortress 2/tf" -e "D:/Games/steamapps/common/sbox/addons/tf_source2"
python particles_import.py -i "C:/.../Portal 2/portal2" -e "C:/.../Half-Life Alyx/game/hlvr_addons/portal2"
python scenes_import.py -i "C:/.../Half-Life Alyx/game/lostcoast" -e hlvr_addons/lostcoast
python models_import.py -i "C:/.../Half-Life Alyx/game/l4d2" -e l4d2_source2
python materials_import.py -i "C:/.../Half-Life Alyx/game/ep2" -e hlvr "materials/skybox"
- -i <dir> This should be an absolute path pointing into a source1 game directory containing gameinfo.txt
- -e <dir/modname> Path to source2 mod/addon. <modname> (e.g.
-e portal2_imported
) instead of an absolute path will only work if the input folder -i is placed inside a source2 /game/ environment which also contains <modname>. - [filter] Optionally a path at the end can be added as a filter.
- Python >= 3.9
pip install -r requirements.txt