Skip to content
XBLAH's Modding Tool Download

Create a Half-Life 2 mod

Source Essentials · Updated 14 Oct 2026 · 2 min read

Written for version 2.5.0. Some labels may have changed since.

This page has versions for
On this page

A Half-Life 2 mod needs more than a gameinfo.txt. The tool creates all the files and folders it needs for you, from one window.

Making a Portal mod instead? See Create a Portal mod.

1. Start a new project

Open Top Menu > File > New > Project...

Or click Toolbar > Add

Creating a new Half-Life 2 mod in the tool

2. Select the base game

For a Half-Life 2 mod, select the Mapbase base game.

If the base game is greyed out, you don't have Mapbase installed, or you don't have Source SDK Base 2013 Singleplayer installed.

3. Select the mod template

Once a base game is selected, pick a Mod Template. The recommended template is marked as default, but other templates may be available.

Not sure which one to use? Choose the default.

4. Fill in the mod information

  • Title: the title of your mod.
  • Path: the name of the mod's folder. This is not the mod's name or title: it is a unique folder name, in lower-case letters and hyphens.
If the tool finds another mod with the same folder name, the folder shows as invalid.

5. Create the mod

When everything is set, click Create. You now have a fully working mod, ready to work on.

The new Half-Life 2 mod, ready to work on
Was this page helpful?