Skip to content
XBLAH's Modding Tool Download

Create a Portal mod

Source Essentials · Updated 14 Oct 2026 · 1 min read

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

On this page

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

Making a Half-Life 2 mod instead? See Create a Half-Life 2 mod.

1. Start a new project

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

Or click Toolbar > Add

Creating a new Portal mod in the tool

2. Select the base game

For a Portal mod, select the Portal base game.

If the base game is greyed out, you don't have Portal 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 Portal mod, ready to work on
Was this page helpful?