A comprehensive toolkit for porting assets from Valve's Source 2 engine to Source 1, featuring a modern GUI interface and powerful automation tools.

The Source 2 Porting Kit simplifies the complex process of converting Source 2 assets back to Source 1. Whether you're working with textures, models, materials, or audio files, this toolkit provides automated workflows and professional-grade tools to streamline your porting projects.

• Texture Conversion: Convert PNG/TGA images to VTF format with customizable settings
• VMT Generation: Automatically generate Source 1 material files from templates
• PBR Baking: Convert Source 2 PBR materials to Source 1 compatible shaders
• Batch Processing: Handle multiple textures simultaneously
• Quality Control: Preview and adjust textures before conversion

• AO Baking: Generate ambient occlusion maps
• Brightness to Alpha: Convert brightness values to alpha channels
• Color Transparency: Make specific colors transparent with tolerance control
• Metal Transparency: Create metallic surface effects
• Subtexture Extraction: Extract regions from larger texture atlases

• Loop Sound Converter: Convert audio files to Source 1 loop formats
• Quad to Stereo: Convert surround sound to stereo
• Format Support: Handle multiple audio formats with automatic conversion

• QC Generation: Automatically generate QC files for model compilation
• Bone Backport: Convert Source 2 bone structures to Source 1
• SMD Processing: Handle Source Model Data files with proper scaling
• Batch Model Processing: Convert multiple models efficiently

• Search & Replace: Bulk text operations across multiple files
• File Management: Organize and rename files according to Source 1 conventions
• Soundscape Processing: Convert Source 2 soundscapes to Source 1 format
• Configuration Management: Save and load project settings

• Discord Rich Presence: Show your current work status
• Drag & Drop Support: Intuitive file handling
• Real-time Preview: See changes as you work
• Progress Tracking: Monitor long-running operations

1. Download the latest Source 2 Porting Kit.exe from the releases
2. Run the executable - no installation required!
3. All dependencies are bundled, works on any Windows machine

1. Install Python 3.13+
2. Clone the repository:

   git clone https://github.com/riggs9162/Source-2-Porting-Kit.git
   cd Source-2-Porting-Kit

3. Install dependencies:

   pip install -r requirements.txt

4. Run the application:

   python porter.py

To create your own executable:

build_exe.bat

python build.py

The executable will be created in the dist/ folder.

• Windows 10 or later
• No additional software required

• Python 3.13 or later
• Dependencies listed in requirements.txt
• Optional: Source 2 Viewer for asset extraction

• Source 2 Viewer: For extracting assets from Source 2 games
• Blender: For model editing and SMD export (with Source Tools addon)
• Crowbar: For compiling Source 1 models
• VTFEdit: For texture editing and preview

• Use Source 2 Viewer to extract models and textures from Source 2 games
• Export models as GLTF format
• Extract textures as PNG/TGA files

• Import GLTF files into Blender
• Scale models appropriately (typically 0.025 to 1.0 scale factor)
• Export as SMD files using Source Tools addon
• Use the QC Generation tool to create compilation files

• Load textures into the appropriate tools
• Convert to VTF format with desired settings
• Generate VMT files for materials
• Preview results before finalizing

• Compile models using Crowbar with generated QC files
• Test assets in your Source 1 environment
• Fine-tune materials and properties as needed

• AO Baker: Generate ambient occlusion maps
• Brightness to Alpha: Convert brightness to transparency
• Color Transparency: Make colors transparent
• Fake PBR Baker: Convert PBR to Source 1 materials
• Metal Transparency: Create metallic effects
• Subtexture Extraction: Extract texture regions

• Loop Sound Converter: Convert to Source 1 audio loops
• Quad to Stereo: Downmix surround sound

• Search & Replace: Bulk text operations
• VMT Generator: Create material files
• VMT Duplicator: Duplicate and modify materials
• Soundscape Searcher: Find and convert soundscapes

• VMAT to VMT: Convert Source 2 materials
• Textures → VTF/VMT: Comprehensive texture conversion

• Bone Backport: Convert bone structures
• QC Generation: Create model compilation files
• QC/SMD Prefix: Batch rename operations

Source-2-Porting-Kit/
├── porter.py              # Main application
├── porter.spec            # PyInstaller build configuration
├── requirements.txt       # Python dependencies
├── hlvr.ico              # Application icon
├── tools/                # Tool modules
│   ├── base_tool.py      # Base tool framework
│   ├── utils.py          # Utility functions
│   └── [tool_modules].py # Individual tools
├── VTFLibWrapper/        # VTF file support
└── old/                  # Legacy tools (archived)

Contributions are welcome! Here's how to get started:

1. Fork the repository
2. Create a feature branch: git checkout -b feature-name
3. Make your changes
4. Test thoroughly
5. Submit a pull request

• Follow existing code style and patterns
• Add tools to the tools/ directory
• Use the BaseTool class for new tools
• Update documentation for new features

This project is licensed under the MIT License.

• Issues: GitHub Issues
• Documentation: Check the tool-specific help within the application
• Community: Discord Rich Presence shows your progress to others

• Valve Software for the Source engine
• VTFLib developers for texture format support
• The Source modding community for continued innovation
• Contributors and testers who help improve the toolkit

Made with ❤️ for the Source modding community