source1import

KO | EN

gitlite — search

#typescript #ai-agents #ai #dsh-plugin #deepseek-harness #open-source #cli #claude-code #codex #developer-tools #react #windows

★ 70 Open GitHub ↗

Import Source game content into Source 2

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# source1import
Set of scripts for importing Source 1 assets such as materials, models, and particle effects into Source 2. Inspired by Valve's own import utility also named source1import.

The main difference is this one is open source so you can customize it (i.e. use different shader sets).

Based off of [source2utils](https://github.com/AlpyneDreams/source2utils).

> [!WARNING]
> This tool has a number of disadvantages over the built-in [CS2 Import Scripts](https://github.com/andreaskeller96/cs2-import-scripts). Including:
> * No PBR material conversion. So your textures will look dark and flat.
> * No map converter.
> * Cannot filter assets by map.

> [!Note]
> However there may be some features you might find useful such as:
> * Support for texture ANIMATION
> * Support for SKYBOX materials
> * Support for material proxies (quite basic, but [this one](https://www.youtube.com/watch?v=g7xpRSqHV5g) for example works)

## Usage
#### Download from here: [Releases](https://github.com/kristiker/source1import/releases)
#### Note:
* Make sure to move the entire s1 `models` folder to `content/` **before importing**.
* Make sure to move the entire s1 `sound` folder to `content/` and rename it to `sounds`. No import necessary.
* Make sure to have `gameinfo.txt` present in Import Game.
* Make sure to read [this guide](https://developer.valvesoftware.com/wiki/Half-Life:_Alyx_Workshop_Tools/Importing_Source_1_Maps) for importing map files.
* Materials won't be PBR ready. so you need to use some other post-conversion tool.

## Advanced Usage:
### CLI:
```bash
cd utils
python scripts_import.py   -i "C:/.../Team Fortress 2/tf" -e "D:/Games/steamapps/common/sbox/addons/tf_source2" -b sbox
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 folder. \<*modname*\> (short notation also allowed e.g. `-e portal2_imported`, provided the game folders sit next to eachother)
* **-b** *\<branch\>* Switch to a different branch. Default is `hlvr`. Other branches include `steamvr` `adj` `sbox` `cs2` `dota2`, ordered by magnitude of support.
* **[filter]** Optionally a path at the end can be added as a filter.
### Requirements (dev):
* [Python](https://www.python.org/downloads/) >= 3.10  
* `pip install -r requirements.txt`
## Results
### [CS:GO Taser - Streamable](https://streamable.com/eders9)
<img src="https://i.imgur.com/qxNDhEE.jpeg" width=100%>
<img src="https://i.imgur.com/zhHOMWJ.png" width=100%>
* maps converted via built-in hammer 5 funcionality

source1import

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README