Sourcemod Builder

Sourcemod Builder

Developer(s)

LaVashikk

Initial release

Jan 29, 2025

Stable release

Dec 1, 2025
(version 1.2.2)

Operating system

Type

Mod tool

Target engine(s)

Distribution

Freeware

Download

Latest Release

Version

1.2.2

Sourcemod Builder is a utility designed to drastically simplify the process of building and distributing Source Engine mods. It automates the collection of all essential assets (models, materials, sounds, etc.) required for your maps, processing multiple maps at once to ensure a complete and accurate asset set. Ideal for mod developers, workshop contributors, and anyone streamlining their Source Engine content creation pipeline.

Installation

You can install Sourcemod Builder in several ways:

1. Download from GitHub Releases (Recommended):
   
   • Pre-built binaries for the CLI (sourcemods-builder) and GUI (sourcemods-builder-gui) versions are available in the Releases section of this GitHub repository. Download the appropriate version for your operating system.
2. Build from source:
   • Clone the following repository using the command prompt (Git is required):

git clone https://github.com/IaVashik/Sourcemods-Builder cd sourcemods-builder

• For CLI version (sourcemods-builder):

cargo build --release

The executable will be located in target/release/sourcemods-builder.

• For GUI version (sourcemods-builder-gui):

cargo build --package gui --release

The executable will be located in target/release/sourcemod-builder-gui.

Usage

Command-Line Interface (CLI)

1. Open your terminal or command prompt.
2. Run the sourcemods-builder executable with the map directory, game directory, and output directory as arguments:

sourcemods-builder <MAPS_DIR> <GAME_DIR> <OUTPUT_DIR>

• <MAPS_DIR>: Path to the directory containing your map files (.vmf or .bsp).
• <GAME_DIR>: Path to the root directory of your Source Engine game installation (e.g., csgo).
• <OUTPUT_DIR>: Path to the directory where you want to save the collected assets.

Example:

sourcemods-builder my_maps/ csgo/ output_assets/

For more options and verbose output, use:

sourcemods-builder --help sourcemods-builder --verbose <MAPS_DIR> <GAME_DIR> <OUTPUT_DIR>

Graphical User Interface (GUI)

1. Run the sourcemods-builder-gui executable.
2. In the application window:

• Set the "Game Dir" and "Output Dir" by browsing to the respective directories.
• Drag and drop map files or folders containing maps onto the window, or use the "Add" button.
• Click "Start Process" to begin asset collection.
• Monitor the progress and find the collected assets in your specified "Output Dir".

Why use Sourcemods Builder?

• Rapid Mod Build Assembly: Significantly accelerates the process of preparing your mod builds by automating asset gathering from multiple maps.
• Complete Asset Sets: Ensures all necessary models, materials, and sounds are included, minimizing missing asset issues in your mod.
• Versatile Tooling: Offers both a powerful CLI for automated workflows and a user-friendly GUI.

Features

• Multi-Map Processing: Handles asset extraction from multiple maps simultaneously.
• Comprehensive Asset Coverage: Collects models, materials, sounds, and is designed for future expansion.
• Cross-Platform: Works on Windows, Linux, and macOS.

External links

• Official GitHub repository