Building SourceMod

From AlliedModders Wiki
Revision as of 17:21, 14 November 2013 by BAILOPAN (talk | contribs)
Jump to: navigation, search

Compiling SourceMod is not difficult, but requires a number of prerequisites. This article details the requirements and steps to being able to build working SourceMod binaries.

Note that specific compiler versions are required to maintain ABI compatibility with Source engine binaries.

Requirements

No matter what platform you're on, you will need to install some baseline software to get going.

  1. Install Mercurial.
  2. Install AMBuild (You may need to run the install line as administrator):
    hg clone http://hg.alliedmods.net/ambuild
    cd ambuild
    python setup.py install
    
  3. Checkout the SourceMod source code. There are many ways to get it, but via the command-line is easiest:
    hg clone http://hg.alliedmods.net/sourcemod-central
    

Windows

You need one of the following Visual Studio versions:

  • Microsoft Visual C++ 2012 (Express or higher) will work for some games; notably, not Dota 2.
  • Microsoft Visual C++ 2010 (Express or higher) is supported and used for official builds.

Grab the necessary Windows dependencies by running tools\buildbot\checkout-windows-deps.bat. It should be run in the folder above sourcemod-central. Note that it will download quite a few HL2SDK copies. Example:

C:\Users\dvander> sourcemod-central\tools\buildbot-checkout-windows-deps.bat

In order to actually perform builds, you will need to be in a Visual Studio Command Prompt. You can do this in a few ways:

  • Under Start, Programs, Microsoft Visual Studio, select the "Visual Studio Tools" folder and run "Visual Studio Command Prompt".
  • Open a command prompt, and run "C:\Program Files (x86)\Microsoft Visual Studio 9.0\VC\bin\vcvars.bat". You can substitute alternate version numbers.
  • Use MozillaBuild. MozillaBuild provides batch files that will launch a unix-like shell for whatever Visual Studio environment you need. Make sure to launch 32-bit environments, not 64-bit ones.

Linux

For Linux, SourceMod requires a compiler compatible with the GNU C/C++ Compiler:

  • If using GCC, 4.4 or higher is required. For SourceMod 1.5 and prior, GCC 4.4 is used officially.
  • If using Clang, 3.2 or higher is required. For SourceMod 1.6 and higher, Clang 3.3 is used officially.

If using a 64-bit Linux, you will need to install a few packages to ensure you can build 32-bit binaries. On Ubuntu or Debian, these packages are:

sudo apt-get install ia32-libs gcc-multilib g++-multilib
sudo apt-get install lib32z1 lib32z1-dev
sudo apt-get install libc6-dev-i386 libc6-i386

Grab the remaining necessary Linux dependencies by running tools/buildbot/checkout-linux-deps.sh. It should be run in the folder above sourcemod-central. Note that it will download quite a few HL2SDK copies. Example:

$ bash ./sourcemod-central/tools/buildbot-checkout-linux-deps.sh

Mac OS X

Grab the remaining necessary OS X dependencies by running tools/buildbot/checkout-linux-deps.sh. It should be run in the folder above sourcemod-central. Note that it will download quite a few HL2SDK copies. Example:

$ bash ./sourcemod-central/tools/buildbot-checkout-mac-deps.sh

Configuring

The first time you are building a SourceMod tree, you must configure the build. This step initializes some basic information and allows some customization around how things get compiled.

To make a default, optimized build, simply run configure.py: cd sourcemod-central python configure.py

Deprecated Tools

Visual Studio Project Files

In the future, we will use AMBuild to automatically generate project files, and the existing project files will be removed from the SourceMod tree. In the meantime however, it is possible to use these files. Unfortunately, they require a bit of extra work to use.

First, make sure you've downloaded all necessary dependencies (SDKs, Metamod:Source source code, and MySQL) via the checkout-windows-deps.bat script. Next,

  1. Open the Control Panel (for example, via Start -> Settings).
  2. Open the System control. If you don't see it, you may need to switch to "Classic view" (either via the left-hand pane or by going to Tools -> Folder Options).
  3. Click the Advanced tab.
  4. Click the Environment Variables button.

Now, add your environment variables to either your User settings or your System settings. Create a new variable for each item in the list below. You may omit SDKs that you do not plan to build against. The item names are in fixed-width font and their value descriptions follow.

  • MMSOURCE19 - Path to Metamod:Source 1.10+
  • MMSOURCE18 - Path to Metamod:Source 1.10+
  • HL2SDK - Path to HL2SDK Ep1/Original
  • HL2SDKOB - Path to HL2SDK Ep2/OrangeBox for mods
  • HL2SDKOBVALVE - Path to HL2SDK Source 2009 (HL2:DM, DoD:S, TF2)
  • HL2SDK-SWARM - Path to HL2SDK Alien Swarm
  • HL2SDK-BGT - Path to HL2SDK for Bloody Good Time
  • HL2SDKCSGO - Path to HL2SDK CS:GO
  • HL2SDKCSS - Path to HL2SDK CS:S
  • HL2SDK-DARKM - Path to HL2SDK Dark Messiah
  • HL2SDK-EYE - Path to HL2SDK E.Y.E.: Divine Cybermancy
  • HL2SDKL4D - Path to HL2SDK L4D1
  • HL2SDKL4D2 - Path to HL2SDK L4D2
  • HL2SDK-DOTA - Path to HL2SDK DOTA 2
  • MYSQL5 - Path to the folder that contains MySQL's include and lib folders.

Makefiles

Makefiles are deprecated and will be removed from the tree soon.