General
This very wiki has tutorials for making Half-Life and Source mods. Valve also hosts the
Valve Developer Community, a wiki that has a great deal of information and tutorials pertaining to modding. Check it out if you can't find something here.
Mapping
Editors
- J.A.C.K. - General-purpose BSP tool aimed at all Quake-based engines. The free version runs on Windows and Linux. Currently the most stable of the modern Hammer clones. There's a paid Steam version that's slightly more up-to-date, and has Mac support. JACK is almost identical to Hammer, making it easy to use as a drop-in replacement, and tutorials for Hammer will make sense when using JACK.
A late December 2023 update to Steam J.A.C.K., and early January 2024 to the free version, created breaking changes to J.A.C.K.'s native JMF format. If you're using the free version, please update to the latest version.
Third party tools that supported the JMF format may break until patched. Use other supported formats in the meantime.
- TrenchBroom - A Quake editor that has support for Half-Life as well. Runs on Windows, Linux, and Mac. A very stable application that is being updated often, but is very different to Hammer, which will make most tutorials difficult to follow. TrenchBroom has an excellent manual to assist with that, and a lot of the Quake based tutorials will still help.
- Valve Hammer Editor 3.5 - The final version of the original, official Goldsrc editor, including model support and Prefab Support.
- Quark - The Quake Army Knife, another tool aimed at being a universal editor. Don't forget to install the required addons to enable mapping for your chosen HL mod.
- GtkRadiant 1.4 or 1.5 - Half-Life has never been a big focus of the GtkRadiant project, and support for it has been removed in version 1.6.
- Sledge Editor - A free, open-source replacement for the Hammer Editor that's no longer being actively developed. Unfinished and rather unstable, although you can use a fork of it called HammerTime which is actively supported and new features are being added very frequently.
- U need a Unit - A unit converter that helps designers create a space with accurate proportions. It is recommended to download only uneed.patched.exe, as the other program may not be able to close completely.
Game Data Files
In order to use an editor for more than empty rooms, you'll need a FGD! An FGD file contains the definitions of the entities in a game/mod so you can create a map for it, and actually use the entities of the corresponding game.
- Goldsource Games FGD Collection - All official Valve games in one convenient file, including Half-Life, Counter-Strike, Opposing Force, etc.
- Counter-Strike: Condition Zero Deleted Scenes FGD
- Sven Co-op: Check your Steam installation, the FGD is included at
/Steam/steamapps/common/Sven Co-op/svencoop/sven-coop.fgd
- For non-Valve games and mods, consult the mod website. Often the FGD is included in the mod install folder, or if you cant find it, just google it, or ask in the TWHL Forums.
- Vluzacn's ZHLT v34 (Official home on the Sven Co-op forums) - The most up-to-date and feature rich version of the Half-Life compile tools, with a host of lighting options and optimization entities. Includes 32- and 64-bit builds, so you can get more power if you're running a modern system. (64-Bit recommended).
- SDHLT - VHLT fork that builds and works cleanly on Linux.
- Zoner's Half-Life Tools 3.4 (64-bit) (or 32-bit) - The foundation for Vluzacn's tools, Zoner's tools were open-source and his improvements over the Quake tools the HL SDK shipped with made it the de-facto standard for over a decade. Official website.
- Nem's Batch Compiler - An interface for the compile tools, if you don't like using the command line or compiling through your editor.
- HLFix 0.81b - A tool that converts a Hammer RMF to MAP files. In the process, it performs a number of geometric operations to fix common problems with brush geometry. Some custom builds of Hammer include these fixes by default, and the modern Hammer alternatives do not require HLFix.
- fixprt - Fixes VHLT v34 portal files, allowing you to import them into J.A.C.K.
- PS2 Half Life Tools These Tools allow for compiling Half Life PS2 Levels, they also include a Tool for visualizing texlight RGB Values
Macros and Generators
Tools that generates map geometry outside of editors, or modifies maps between the editing and compiling steps.
- Map2Curve - A tool that generates curved or splined geometry from a prefabricated segment (e.g. a premade hallway section)
- MESS (Macro Entity Scripting System) 1.2.3 - An automation tool that provides template entities that simplify complex entity setups, various automation scripts that can generate intermediate entities and apply workarounds for known issues, an entity-based template instancing system, an optional scripting language that enables additional customization, the ability to create your own template entities, and file conversion between .map, .rmf and .jmf files. Official website & Tutorials.
- REMEC - Similar to MESS, it has new macro entities to simplify normally complex entity setups and some enhanced versions of the regular entities.
Please do not use decompile tools to steal other people's maps! However, they are useful tools for seeing how certain entities are used, and to see how certain Maps work.
Post-compile Tools
- bspguy (newbspguy fork) - A tool primarily built to merge maps for svencoop conversion campaigns, it's also a 3D map viewer and a powerful entity editor. The fork has more features and is in active development.
- Several compile tools also (or only) work on already-compiled maps such as hlrad and ripent.
- ResGuy - Generates .res files for custom multiplayer maps, which specifies the map's dependencies e.g. WADs, models, sprites, and skyboxes. Servers in turn use the resource list to check and download those dependencies to users.
Textures and Sprites
- Wally 1.55b - Create new texture wads, extract textures from existing ones, or make edits directly in the program.
- ⚠️Make sure you're creating the correct type of WAD. It should be the one called "Half-Life Package [wad3]".
- Sprite Explorer 2.0 - Viewer and editor specifically for .spr files.
- Half-Life Texture Tools - A more recent wad editor that can also create sprites.
- Joe's WAD Editor - A simple online WAD editor.
- To actually create texture images, use your favourite image editor such as Photoshop, GIMP, Paint.NET, etc.
- WadMaker & SpriteMaker 1.2 - Command-line tools for converting directories full of true-color images to wad files or sprites. They accept a variety of file formats, including Photoshop and Krita files, and provide special support for water fog color, transparency and external image conversion tools (Gimp, Aseprite, Irfanview, etc.). They can also be used to extract textures or to convert sprites back to images. Official website & Tutorial.
- goldutil - WAD and SPR creation and extraction CLI for Linux, designed for automated workflows.
- pngquant - Quantization, can be used to automate reducing images to 256 colors.
Modelling
- kHED (or older free version) - A basic - but easy to use - modelling tool to edit low poly models. Has good support for Half-Life.
- MilkShape 3D - A popular (but non-free) model editor with good support for Half-Life. A 30 day trial is available.(OUTDATED)
- Blender - A free, fully-featured modelling program that supports animations. Install the Blender Source Tools (which also support Goldsource) to get Half-Life support. A guide is available here.
- Crowbar - A convenient app which allows you to easily compile and decompile GoldSource and Source models.
- fragMOTION - Another model editor that exports to various game engines' formats, including both GoldSrc and Source. Free and paid versions.
- Ambient.Impact.Design - Ambient.Impact's old website has arguably the best HD character models made for Half-Life, it's expansions, and a couple mods, often with source files included for those inclined to make edits.
- trueSpace - Free, relatively comprehensive modeling software.The official update has been stopped and is now maintained by the community.
Programming & Mod Bases
While this section is mostly focused on programming a custom game for GoldSrc, it also lists mod bases with pre-built binaries. They incorporate quality of life improvements as well as bells and whistles, enough for you to base your mods on without having to touch code. These are indicated with the ▶️ icon.
- Visual Studio Community Edition - A free version of Visual Studio which will allow you to work with the Half-Life SDK.
- Half-Life SDK on GitHub - Official GitHub repository for the same code released in the SDK, but with additional updates and bugfixes.
- Half-Life Updated - A version of the official Half-Life SDK, updated to support Visual Studio 2019 and fix many bugs. If you are starting a new Half-Life mod and don't plan on using Spirit (see below), it is strongly recommended you use this version of the SDK.
- Half-Life SDK 2.3 - Though heavily outdated, this package encompasses everything Valve made available to the general public back in the day, including model and map example source files, early models and map compile tools, and full dll source for Half-Life and multiple official mods.
- Spirit of Half-Life 1.5 (Or 1.8) - ▶️ Laurie Cheer's mod that adds a whole mess of quality-of-life features for mod authors. Have buttons and breakable glass move with your elevator, give every NPC a unique model, or fill your map with particle effects. 1.5 and 1.8 are more or less the same feature-wise but each have their own set of minor bugs you'll have to fix on your own using the included source code.
- Spirit of Half-Life Updated 1.8 - ▶️ Spirit of Half-Life applied on top of the Half-Life Updated SDK, with support for VS2019 and Linux compiles. If you are starting a new Half-Life mod and want to base it on Spirit, it is strongly recommended that you use this version of the SDK. There are also branches for other versions of Spirit: 1.2, 1.4, 1.5, 1.8
- Half-Life Featureful SDK - ▶️ A Half-Life SDK fork that implements Opposing Force and Blue Shift entities, some entities from the Dreamcast/PS2 ports, as well as some features from Spirit of Half-Life and Sven Co-op. Almost all added features are optional and customizable with configuration files to cut down on unused assets.
- Half-Life Programming - A tutorial series on TWHL (this site!) about programming for the GoldSrc engine.
Viewers
- Solokiller's Half-Life Asset Manager - Updated for modern systems, and with a host of new features. Probably the best model viewer you'll find.
- Jed's HLMV - An updated version of the official Half-Life Model Viewer supporting all HL texture features.(OUTDATED)
- Crafty Object Viewer - View models, materials, or even the geometry of compiled maps for both Source and Goldsource. Also supports exporting data to obj, if you need to use map data for creating animations or models.
- GCFScape - Browser utility for opening now-deprecated Source GCF files to view or extract content. Also compatible with HL pak files, wads, bsp files with packed information, and Source VPK files, making it an essential tool.
- bspguy (newbspguy fork) - A tool primarily built to merge maps for svencoop conversion campaigns, it's also a 3D map viewer and a powerful entity editor. The fork has more features and is in active development.
Additional Resources
- Slackiller's Half-Life Programs - Slackiller hosts a bunch of tools that would otherwise have been lost over the years - including a lot of things linked on this page! Hammer builds, compilers, viewers, and miscellaneous utilities abound.
- Tommy of Escondido's Mapping help Tutorials for Half-Life & Mods - Mapping & Compiling Errors and solutions
- Valve Developer Union - Tool archival site dedicated to keeping Goldsource modding alive. If you can't find it on Slackiller's site, and it's still floating around, you'll almost certainly find it here.
- GS HL Tools - TWHL user Stojke maintains this repository of useful Goldsource-related modding tools.
- Penguinboy's Half-Life File Repository - A (somewhat unorganised) collection of Half-Life related downloads, applications, and miscellaneous other things.
- TWHL, of course! - The site you're on right now! We have forums and various other things. Be sure to make use of all our resources! Also contribute if you have some Information that could be useful!
- Sven Manor - A resource site focused on Sven Co-op editing, but much of the information can be used for any Goldsource editing.
- Old Sven Manor Archive - An archived version of the aforementioned site before it went down and was revived. Hosts a few unique old tutorials that continue to be useful to this day, both for Sven Co-op and for general Goldsource editing.
- The303's Tutorials - An excellent collection of Goldsource tutorials with a focus on textures, sprites, and modelling.
- hlbsp project (Internet Archive link) - Contains unofficial file specs for the BSPv30 and WAD3 file formats used in GoldSrc. [Original SourceForge hosted page no longer works.]
- The Rimpository - An ever-growing repository of prefabs and useable objects for mapping purposes. Several members of the community have contributed to its development and is regularly maintained by Rimrook. It has over 600 prefabs and features foliage model sets that match each other that includes palm trees, pine trees, cactuses, and even Xen trees and more.