SourcePauseTool

A plugin for all your pausing needs.

Usage

1. Download the DLL corresponding to your game / engine / SDK:

   SDK	SPT DLL
   Source SDK (Base) 2007 / New Engine / Source Unpack* / Orange Box	spt.dll
   Source SDK (Base) 2013 / SteamPipe / Latest	spt-2013.dll
   Black Mesa	spt-bms.dll
   Source SDK (Base) 2006 / Old Engine	spt-oe.dll

   * Including Portal 3420

2. Place the DLL into the correct folder:

   SDK	Folder
   Old Engine & Portal (3420)	Topmost bin with AdminServer.dll etc.
   Old Engine mods	Source SDK Base\bin
   Half-Life: Source	hl1
   Half-Life 2	hl2
   Half-Life 2: Episode 1	episodic
   Half-Life 2: Episode 2	ep2
   Half-Life 2: Lost Coast	lostcoast
   Portal	portal
   Black Mesa	bms

3. Launch the game.

4. Go to Options > Keyboard > Advanced, check Enable developer console, and press OK.

5. Press the tilde key (~) and enter plugin_load spt into the developer console.

   • You must disconnect first in Black Mesa.
   • Add plugin_load spt to cfg/autoexec.cfg to load SourcePauseTool automatically.

Building

0. You will need Visual Studio 2022 (or later) and git.
1. Open Visual Studio 2022. Click on Tools → Get Tools and Features... from the top bar of the window.
   This should open the Visual Studio Installer in another window. From the Workload tab, install Desktop development with C++. From the Individual Components tab, install:
   • MSVC v143 - VS 2022 C++ x64/x86 build tools
2. In Visual Studio, go to Tools -> Options -> CMake, and make sure one of the options to use CMake presets is set.
3. Run the following in cmd:

   git clone --recurse-submodules https://github.com/OutOfBoundsOffice/SourcePauseTool.git
   

4. To open the project in Visual Studio, do one of:
   • from Visual Studio, click File -> Open -> Folder and open SourcePauseTool
   • from Visual Studio, click File -> Open -> CMake and open SourcePauseTool/CMakeLists.txt
   • from within the SourcePauseTool folder, right click -> 'Open with Visual Studio'
5. Choose the build configuration:

   SDK	Configuration
   Source SDK 2007 / New Engine / Source Unpack / Orange Box	Release
   Source SDK 2013 / SteamPipe / Latest	Release 2013
   Black Mesa	Release BMS
   Source SDK 2006 / Old Engine	Release OE

6. Click Build > Build Solution.
   spt*.dll will be in SourcePauseTool/build/Debug|Release

If you get a warning about pwsh.exe not being a recognized command, you can safely ignore it, or install from here.

To build without Visual Studio, cd in to the directory and run:

cmake --preset base-x86
cmake --build --preset "ALL (Debug)"

.srctas documentation

.srctas is the SPT TAS script format. You can find its documentation here.

Contributing

See the contributing guide here.