Obsidian Conflict Wiki - User contributions [en]

Dedicated Server Setup 2

2011-08-01T20:27:43Z

Tgp1994: /* Half-Life 2: Lost Coast */ whoops

{{wip}}
This page was created since I can't update the one [[Dedicated Server Setup|here]]. I'm still working on it (but don't have enough time to do it all at once), so it may seem incomplete. - [[User:TESLA-X4|TESLA-X4]] 12:01, 3 April 2011 (CEST)

__TOC__

==Prerequisites==
* A basic understanding of filesystem paths (i.e. <tt>orangebox/hl2</tt> refers to the folder <tt>hl2</tt> ''inside'' <tt>orangebox</tt>, not both the folders), and the different path representations between Windows and *nix (i.e. <tt>\</tt> in Windows is the same as <tt>/</tt> in UNIX[-like] operating systems).
* A basic understanding of the operating system's command-line interface (i.e. [[Wikipedia:Command Prompt|Command Prompt]] for Windows and Terminals for [[Wikipedia:GNOME Terminal|Linux]] and [[Wikipedia::Apple Terminal|Mac OS]]).
* A fast broadband connection (preferably one without a data transfer limit) to prevent premature aging waiting for the uploads to complete.

<span style="color:red;">'''Note:''' At the time of writing, no binaries are publicly available for Linux and Mac OS.</span>

==Base Server Install==
===Step 1: Download The HLDS Update Tool===
{{Windows|Download this file to a temporary location: '''http://www.steampowered.com/download/hldsupdatetool.exe'''}}

{{Linux|''Adapted from <nowiki>http://www.srcds.com/db/engine.php?subaction=showfull&id=1098643920</nowiki>''|
|In a ''Terminal (On Ubuntu: Applications → Accessories → Terminal)'' window, execute the following commands:
|<tt>mkdir srcds_l</tt>
|<tt>cd srcds_l</tt>
|<tt>wget <nowiki>http://www.steampowered.com/download/hldsupdatetool.bin</nowiki></tt>}}

{{Mac|''Unavailable at time of writing.''}}

===Step 2: Install The HLDS Update Tool===
{{Windows|''Adapted from <nowiki>http://www.srcds.com/db/engine.php?subaction=showfull&id=1097362093</nowiki>''|
||''This could help : <nowiki>http://planethalflife.gamespy.com/View.php?view=HL2Guides.Detail&id=4&game=3</nowiki>''|.
|Double-click on <tt>hldsupdatetool.exe</tt> and follow the instructions given by the wizard.
|For the purpose of this tutorial, we will assume that you have installed the server to <tt>c:\srcds</tt>.
|Open a ''Command Prompt (Start → Accessories → Command Prompt)'' window and execute the following commands:
|<tt>c:</tt>
|<tt>cd srcds</tt>
|<tt>hldsupdatetool</tt>|
|An updated version of ''hldsupdatetool'' will now be downloaded to replace the one installed by the wizard.}}

{{Linux|''Adapted from <nowiki>http://www.srcds.com/db/engine.php?subaction=showfull&id=1098643920</nowiki>''|
|In the same ''Terminal'' window as [[#Step 1: Download The HLDS Update Tool|Step 1]], execute the following commands:
|<tt>chmod +x hldsupdatetool.bin</tt>
|<tt>./hldsupdatetool.bin</tt>
|<tt>./steam</tt>|
|An updated version of ''steam'' (the executable) will now be downloaded to replace the one extracted when you ran <tt>./hldsupdatetool.bin</tt>.}}

{{Mac|''Unavailable at time of writing.''}}

===Step 3: Download The Base Server Files===
{{Windows|''Adapted from <nowiki>http://www.srcds.com/db/engine.php?subaction=showfull&id=1097362093</nowiki>''|
|In the same ''Command Prompt'' window as [[#Step 2: Install The HLDS Update Tool|Step 2]], execute the following command:
|<tt>hldsupdatetool.exe -command update -game "orangebox" -dir .</tt>|
|A breakdown of the command:
|<tt>hldsupdatetool.exe</tt>: The executable to run.
|<tt>-command update</tt>: Omnipresent, never omit this.
|<tt>-game "<game>"</tt>: The set of files to download, specify ''list'' instead to see what can be downloaded.
|<tt>-dir <nowiki><directory|.></nowiki></tt>: The directory to install the files in, specify '.' to automatically use the directory ''hldsupdatetool'' is located in.|
|The base server files will now be downloaded. It will take a while, so don't go staring at the window waiting for it to complete. ;)}}

{{Linux|''Adapted from <nowiki>http://www.srcds.com/db/engine.php?subaction=showfull&id=1098643920</nowiki>''|
|In the existing ''Terminal'' window from Steps 1 and 2, execute the following command:
|<tt>./steam -command update -game "orangebox" -dir .</tt>|
|A breakdown of the command:
|<tt>./steam</tt>: The executable to run.
|<tt>-command update</tt>: Omnipresent, never omit this.
|<tt>-game "<game>"</tt>: The set of files to download, specify ''list'' instead to see what can be downloaded.
|<tt>-dir <nowiki><directory|.></nowiki></tt>: The directory to install the files in, specify '.' to automatically use the directory ''steam'' is located in.|
|The base server files will now be downloaded. It will take a while, so don't go staring at the window waiting for it to complete. ;)}}

{{Mac|''Unavailable at time of writing.''}}

===Step 4: Setting Up The Folder Structure===
After [[#Step 3: Download The Base Server Files|Step 3]] completes, you should end up with something like this:

{{Windows|<tt>hl2\
|orangebox\
|orangebox\bin\
|orangebox\hl2\
|orangebox\platform\
|orangebox\reslists\
|orangebox\hlds_steamgames.vdf
|orangebox\srcds.exe
|orangebox\steam_appid.txt
|ClientRegistry.blob
|HldsUpdateTool.exe
|HldsUpdateTool_<tool version>.mst
|InstallRecord.blob</tt>}}

{{Linux|<tt>.steam\
|.steam\clientregistry.blob
|hl2\
|orangebox\
|orangebox\bin\
|orangebox\hl2\
|orangebox\platform\
|orangebox\reslists\
|orangebox\hlds_steamgames.vdf
|orangebox\srcds_linux
|orangebox\srcds_run
|orangebox\steam_appid.txt
|hldsupdatetool.bin
|InstallRecord.blob
|steam
|test1.so
|test2.so
|test3.so</tt>}}

{{Mac|''Unavailable at time of writing.''}}

Now, because Valve didn't set up the files properly on their server, you'll need to fix it yourself.

'''GUI Approach:'''
<div style="padding: 0.5em 1em 0.5em 1em; border: 1px dashed #2f6fab; color: black; background-color: #f9f9f9; line-height: 1.1em;">
Delete the <tt>orangebox/hl2</tt> folder and copy the <tt>hl2</tt> folder (the one outside) in its place.
</div>

'''Command-Line Approach:'''

{{Windows|In the existing ''Command Prompt'' window from the earlier steps, execute the following commands:
|<tt>rmdir /s orangebox\hl2
|xcopy /s /e hl2 orangebox</tt>}}

{{Linux|In the existing ''Terminal'' window from the earlier steps, execute the following commands:
|<tt>rm -R orangebox/hl2</tt>
|<tt>cp -R hl2 orangebox</tt>}}

{{Mac|''Unavailable at time of writing.''}}

==Campaign Content==
Campaign content is stored only in GCFs downloadable only via the Steam client, so be prepared to upload the extracted files to your server. You will need [http://nemesis.thewavelength.net/index.php?p=25 this application] in order to proceed.

Things are a little easier for Windows server operators with Remote Desktop access to their servers since they can simply install Steam on their servers and do everything directly there.

'''Note:''' The Obsidian Team might offer to copy the extracted GCF content onto servers via their Windows server to save upload time in future, in which case you can safely ignore this section.

===Half-Life: Source===
<div style="padding: 0.5em 1em 0.5em 1em; border: 1px dashed #2f6fab; color: black; background-color: #f9f9f9; line-height: 1.1em;">
====half-life source.gcf====
Extract everything from the <tt>hl1</tt> folder (in the GCF) to your dedicated server's <tt>orangebox/hl1</tt> folder, creating the folder if it doesn't exist.
</div>

===Half-Life Deathmatch: Source===
<div style="padding: 0.5em 1em 0.5em 1em; border: 1px dashed #2f6fab; color: black; background-color: #f9f9f9; line-height: 1.1em;">
''Incompatible at the time of writing.''
</div>

===Half-Life 2===
<div style="padding: 0.5em 1em 0.5em 1em; border: 1px dashed #2f6fab; color: black; background-color: #f9f9f9; line-height: 1.1em;">
====half-life 2 content.gcf====
Extract the <tt>maps</tt> folder from the <tt>hl2</tt> folder (in the GCF) into your dedicated server's <tt>orangebox/hl2</tt> folder.
====source 2007 binaries.gcf====
====source 2007 shared materials.gcf====
====source 2007 shared models.gcf====
====source 2007 shared sounds.gcf====
====half-life 2 2007 base content.gcf====
For all of the above GCFs (<u>in given order</u>, with <tt>source 2007 binaries.gcf</tt> being extracted first and <tt>half-life 2 2007 base content.gcf</tt> being last), extract the <tt>hl2</tt> folder (in the GCFs) into your dedicated server's <tt>orangebox/hl2</tt> folder, overwriting if prompted to do so.
</div>

===Half-Life 2: Lost Coast===
====lostcoast content.gcf====
Extract the <tt>lostcoast</tt> folder into your dedicated server's <tt>orangebox</tt> folder.

===Half-Life 2: Episode One===
<div style="padding: 0.5em 1em 0.5em 1em; border: 1px dashed #2f6fab; color: black; background-color: #f9f9f9; line-height: 1.1em;">
====episode 1 shared.gcf====
Extract everything from the <tt>episodic</tt> folder (in the GCF) into your dedicated server's <tt>orangebox/episodic</tt> folder, creating the folder if it doesn't exist.
====half-life 2 episode one.gcf====
Extract the <tt>maps</tt> folder from the <tt>episodic</tt> folder (in the GCF) into your dedicated server's <tt>orangebox/episodic</tt> folder.
====episodic 2007 shared.gcf====
Extract everything from the <tt>episodic</tt> folder (in the GCF) into your dedicated server's <tt>orangebox/episodic</tt> folder, overwriting if prompted to do so.
====episode one 2007 content.gcf====
Extract everything from the <tt>episodic</tt> folder (in the GCF) into your dedicated server's <tt>orangebox/episodic</tt> folder, and everything from the <tt>hl2</tt> folder (in the GCF) into your dedicated server's <tt>orangebox/hl2</tt> folder, overwriting if prompted to do so.
</div>

===Half-Life 2: Episode Two===
<div style="padding: 0.5em 1em 0.5em 1em; border: 1px dashed #2f6fab; color: black; background-color: #f9f9f9; line-height: 1.1em;">
====episode two content.gcf====
====episode two maps.gcf====
====episode two materials.gcf====
For all of the above GCFs (<u>in given order</u>), extract everything from the <tt>ep2</tt> folder (in the GCF) into your dedicated server's <tt>orangebox/ep2</tt> folder, creating the folder if it doesn't exist and overwriting if prompted to do so.
</div>

===Half-Life 2: Episode Three===
<div style="padding: 0.5em 1em 0.5em 1em; border: 1px dashed #2f6fab; color: black; background-color: #f9f9f9; line-height: 1.1em;">
You must be living in the future.
</div>

==Additional Game Content==
'''Note:''' If you download any of the following (sans ''Portal'') using the ''HLDS Update Tool'' after downloading <tt>orangebox</tt>, <span style="color:red;">you will be forced to download a new set of engine binaries incompatible with the current release of Obsidian Conflict</span>. A telltale sign that this has occurred is when you see an engine error along the lines of ''SetupArrayProps_R: array prop '(null)' is at index zero'' or ''Host_Error: IDLLFunctions::DLLInit returned false'' when you try to start the server. To workaround that, simply rename the <tt>bin</tt> folder (inside <tt>orangebox</tt>) to something else (e.g. <tt>bin_se2007</tt>) '''before''' downloading the game's files. On completion, delete the newly created <tt>bin</tt> folder and rename the old one back to <tt>bin</tt>.

For the curious, the reason for this is that almost all official Valve games now run on [http://developer.valvesoftware.com/wiki/Source_Engine_2009 Source Engine 2009], but most mods (sans ''Garry's Mod'') continue to run on the older ''Source Engine 2007'' (Source SDK Base 2007). These two versions are incompatible with each other, and Valve has yet to release a version of ''Source SDK Base'' for ''Source Engine 2009''.
===Counter-Strike: Source===
<div style="padding: 0.5em 1em 0.5em 1em; border: 1px dashed #2f6fab; color: black; background-color: #f9f9f9; line-height: 1.1em;">
{{Todo|Downloadable with the HLDS Update Tool, elaboration needed.}}
</div>

===Day of Defeat: Source===
<div style="padding: 0.5em 1em 0.5em 1em; border: 1px dashed #2f6fab; color: black; background-color: #f9f9f9; line-height: 1.1em;">
{{Todo|Downloadable with the HLDS Update Tool, elaboration needed.}}
</div>

===Portal===
<div style="padding: 0.5em 1em 0.5em 1em; border: 1px dashed #2f6fab; color: black; background-color: #f9f9f9; line-height: 1.1em;">
''Incompatible at the time of writing.''
</div>

===Team Fortress 2===
<div style="padding: 0.5em 1em 0.5em 1em; border: 1px dashed #2f6fab; color: black; background-color: #f9f9f9; line-height: 1.1em;">
''Incompatible at the time of writing.''
</div>

==Downloading And Installing Obsidian==
Copy the <tt>obsidian</tt> folder from a fresh install of Obsidian Conflict into your dedicated server's <tt>orangebox</tt> folder.
{{Todo|Further elaboration needed.}}

==Mounting Content==
Content mounts are controlled by a set of files in the <tt>obsidian/mount</tt> folder. Each file determines whether or not the respective game's content is mounted. These files are merely blank files without any extensions - their contents do not matter since the mod merely checks if the file is there, mounting the content if the file is present.
Valid file names are:
<div style="padding: 0.5em 1em 0.5em 1em; border: 1px dashed #2f6fab; color: black; background-color: #f9f9f9; line-height: 1.1em;">
<tt>css</tt> ↔ Counter-Strike: Source

<tt>dod</tt> ↔ Day of Defeat: Source

<tt>ep2</tt> ↔ Half-Life 2: Episode Two

<tt>episodic</tt> ↔ Half-Life 2: Episode One

<tt>hls</tt> ↔ Half-Life: Source

<tt>lostcoast</tt> ↔ Half-Life 2: Lost Coast
</div>
{{Todo|Further elaboration needed.}}

==Optional: Installing Metamod:Source and SourceMod==
===Preface===
SourceMod, in combination with Metamod:Source, make a very powerful toolset for administration of a Source engine-based server. Sourcemod has [http://www.sourcemod.net/plugins.php a large library of plugins] available, along with an active community making Sourcemod one of the easiest choices in administration mods for a server.

===Preparation/Downloading===
''Platform Independent''<br />
Grab the latest version of Metamod:Source from [http://www.sourcemm.net/ their website]. Make sure you download the one that is built for your operating system, otherwise it will not function. Don't forget to download [http://www.sourcemod.net/downloads.php Sourcemod] as well.

After you have downloaded both, extract them to their respective directories. Metamod:Source will go in the addons folder (see the note below), and Sourcemod has folders that belong in the addons folder and cfg folder.

<div style="background-color:#AAAAAA; padding:4px">'''A note about addons'''
It seems that at some point in the development process of Obsidian Conflict, a decision was made to change the name of the addons folder from the standard Source engine-associated name "addons", to a hyphenated name of "add-ons". As the server operator, you must be weary of this, and make sure that any references to the addons folder have the hyphen inserted.

'''Update:''' It seems that renaming the "add-ons" folder to "addons" will still retain functionality. It also seems that it may be necessary to have it named "addons", otherwise it appears that Sourcemod will not work.
</div>

===Installation===
According to [http://www.obsidianconflict.net/forums/viewtopic.php?f=29&t=3309 this] topic (with which this section was made by), it seems that Obsidian Conflict does not load .VDF files (or path references are significantly different compared to other source games), so an older method involving modifying the gameinfo.txt file is necessary.

Open gameinfo.txt. Find
<pre>
SearchPaths
{
Game |gameinfo_path|.
Game |all_source_engine_paths|hl2
}
</pre>

And replace it with
<pre>
SearchPaths
{
GameBin |gameinfo_path|add-ons/metamod/bin
Game |gameinfo_path|.
Game |all_source_engine_paths|hl2
}
</pre>
===Final words===
At this point, Metamod:Source and Sourcemod are configured, and will start up when you start your server. To confirm that they're working, you can type meta info in the console once the server has finished starting up.

To start off, you'll want to add yourself as an administrator. You can follow the Sourcemod article [http://wiki.alliedmods.net/Adding_Admins_%28SourceMod%29 here] to do so. If you're looking for any other information regarding Sourcemod, a wealth of said information has been posted in the [http://wiki.alliedmods.net/index.php/Category:SourceMod_Documentation Sourcemod Documentation].

[[Category:ServerOP]]

Dedicated Server Setup 2

2011-08-01T20:27:24Z

Tgp1994:

{{wip}}
This page was created since I can't update the one [[Dedicated Server Setup|here]]. I'm still working on it (but don't have enough time to do it all at once), so it may seem incomplete. - [[User:TESLA-X4|TESLA-X4]] 12:01, 3 April 2011 (CEST)

__TOC__

==Prerequisites==
* A basic understanding of filesystem paths (i.e. <tt>orangebox/hl2</tt> refers to the folder <tt>hl2</tt> ''inside'' <tt>orangebox</tt>, not both the folders), and the different path representations between Windows and *nix (i.e. <tt>\</tt> in Windows is the same as <tt>/</tt> in UNIX[-like] operating systems).
* A basic understanding of the operating system's command-line interface (i.e. [[Wikipedia:Command Prompt|Command Prompt]] for Windows and Terminals for [[Wikipedia:GNOME Terminal|Linux]] and [[Wikipedia::Apple Terminal|Mac OS]]).
* A fast broadband connection (preferably one without a data transfer limit) to prevent premature aging waiting for the uploads to complete.

<span style="color:red;">'''Note:''' At the time of writing, no binaries are publicly available for Linux and Mac OS.</span>

==Base Server Install==
===Step 1: Download The HLDS Update Tool===
{{Windows|Download this file to a temporary location: '''http://www.steampowered.com/download/hldsupdatetool.exe'''}}

{{Linux|''Adapted from <nowiki>http://www.srcds.com/db/engine.php?subaction=showfull&id=1098643920</nowiki>''|
|In a ''Terminal (On Ubuntu: Applications → Accessories → Terminal)'' window, execute the following commands:
|<tt>mkdir srcds_l</tt>
|<tt>cd srcds_l</tt>
|<tt>wget <nowiki>http://www.steampowered.com/download/hldsupdatetool.bin</nowiki></tt>}}

{{Mac|''Unavailable at time of writing.''}}

===Step 2: Install The HLDS Update Tool===
{{Windows|''Adapted from <nowiki>http://www.srcds.com/db/engine.php?subaction=showfull&id=1097362093</nowiki>''|
||''This could help : <nowiki>http://planethalflife.gamespy.com/View.php?view=HL2Guides.Detail&id=4&game=3</nowiki>''|.
|Double-click on <tt>hldsupdatetool.exe</tt> and follow the instructions given by the wizard.
|For the purpose of this tutorial, we will assume that you have installed the server to <tt>c:\srcds</tt>.
|Open a ''Command Prompt (Start → Accessories → Command Prompt)'' window and execute the following commands:
|<tt>c:</tt>
|<tt>cd srcds</tt>
|<tt>hldsupdatetool</tt>|
|An updated version of ''hldsupdatetool'' will now be downloaded to replace the one installed by the wizard.}}

{{Linux|''Adapted from <nowiki>http://www.srcds.com/db/engine.php?subaction=showfull&id=1098643920</nowiki>''|
|In the same ''Terminal'' window as [[#Step 1: Download The HLDS Update Tool|Step 1]], execute the following commands:
|<tt>chmod +x hldsupdatetool.bin</tt>
|<tt>./hldsupdatetool.bin</tt>
|<tt>./steam</tt>|
|An updated version of ''steam'' (the executable) will now be downloaded to replace the one extracted when you ran <tt>./hldsupdatetool.bin</tt>.}}

{{Mac|''Unavailable at time of writing.''}}

===Step 3: Download The Base Server Files===
{{Windows|''Adapted from <nowiki>http://www.srcds.com/db/engine.php?subaction=showfull&id=1097362093</nowiki>''|
|In the same ''Command Prompt'' window as [[#Step 2: Install The HLDS Update Tool|Step 2]], execute the following command:
|<tt>hldsupdatetool.exe -command update -game "orangebox" -dir .</tt>|
|A breakdown of the command:
|<tt>hldsupdatetool.exe</tt>: The executable to run.
|<tt>-command update</tt>: Omnipresent, never omit this.
|<tt>-game "<game>"</tt>: The set of files to download, specify ''list'' instead to see what can be downloaded.
|<tt>-dir <nowiki><directory|.></nowiki></tt>: The directory to install the files in, specify '.' to automatically use the directory ''hldsupdatetool'' is located in.|
|The base server files will now be downloaded. It will take a while, so don't go staring at the window waiting for it to complete. ;)}}

{{Linux|''Adapted from <nowiki>http://www.srcds.com/db/engine.php?subaction=showfull&id=1098643920</nowiki>''|
|In the existing ''Terminal'' window from Steps 1 and 2, execute the following command:
|<tt>./steam -command update -game "orangebox" -dir .</tt>|
|A breakdown of the command:
|<tt>./steam</tt>: The executable to run.
|<tt>-command update</tt>: Omnipresent, never omit this.
|<tt>-game "<game>"</tt>: The set of files to download, specify ''list'' instead to see what can be downloaded.
|<tt>-dir <nowiki><directory|.></nowiki></tt>: The directory to install the files in, specify '.' to automatically use the directory ''steam'' is located in.|
|The base server files will now be downloaded. It will take a while, so don't go staring at the window waiting for it to complete. ;)}}

{{Mac|''Unavailable at time of writing.''}}

===Step 4: Setting Up The Folder Structure===
After [[#Step 3: Download The Base Server Files|Step 3]] completes, you should end up with something like this:

{{Windows|<tt>hl2\
|orangebox\
|orangebox\bin\
|orangebox\hl2\
|orangebox\platform\
|orangebox\reslists\
|orangebox\hlds_steamgames.vdf
|orangebox\srcds.exe
|orangebox\steam_appid.txt
|ClientRegistry.blob
|HldsUpdateTool.exe
|HldsUpdateTool_<tool version>.mst
|InstallRecord.blob</tt>}}

{{Linux|<tt>.steam\
|.steam\clientregistry.blob
|hl2\
|orangebox\
|orangebox\bin\
|orangebox\hl2\
|orangebox\platform\
|orangebox\reslists\
|orangebox\hlds_steamgames.vdf
|orangebox\srcds_linux
|orangebox\srcds_run
|orangebox\steam_appid.txt
|hldsupdatetool.bin
|InstallRecord.blob
|steam
|test1.so
|test2.so
|test3.so</tt>}}

{{Mac|''Unavailable at time of writing.''}}

Now, because Valve didn't set up the files properly on their server, you'll need to fix it yourself.

'''GUI Approach:'''
<div style="padding: 0.5em 1em 0.5em 1em; border: 1px dashed #2f6fab; color: black; background-color: #f9f9f9; line-height: 1.1em;">
Delete the <tt>orangebox/hl2</tt> folder and copy the <tt>hl2</tt> folder (the one outside) in its place.
</div>

'''Command-Line Approach:'''

{{Windows|In the existing ''Command Prompt'' window from the earlier steps, execute the following commands:
|<tt>rmdir /s orangebox\hl2
|xcopy /s /e hl2 orangebox</tt>}}

{{Linux|In the existing ''Terminal'' window from the earlier steps, execute the following commands:
|<tt>rm -R orangebox/hl2</tt>
|<tt>cp -R hl2 orangebox</tt>}}

{{Mac|''Unavailable at time of writing.''}}

==Campaign Content==
Campaign content is stored only in GCFs downloadable only via the Steam client, so be prepared to upload the extracted files to your server. You will need [http://nemesis.thewavelength.net/index.php?p=25 this application] in order to proceed.

Things are a little easier for Windows server operators with Remote Desktop access to their servers since they can simply install Steam on their servers and do everything directly there.

'''Note:''' The Obsidian Team might offer to copy the extracted GCF content onto servers via their Windows server to save upload time in future, in which case you can safely ignore this section.

===Half-Life: Source===
<div style="padding: 0.5em 1em 0.5em 1em; border: 1px dashed #2f6fab; color: black; background-color: #f9f9f9; line-height: 1.1em;">
====half-life source.gcf====
Extract everything from the <tt>hl1</tt> folder (in the GCF) to your dedicated server's <tt>orangebox/hl1</tt> folder, creating the folder if it doesn't exist.
</div>

===Half-Life Deathmatch: Source===
<div style="padding: 0.5em 1em 0.5em 1em; border: 1px dashed #2f6fab; color: black; background-color: #f9f9f9; line-height: 1.1em;">
''Incompatible at the time of writing.''
</div>

===Half-Life 2===
<div style="padding: 0.5em 1em 0.5em 1em; border: 1px dashed #2f6fab; color: black; background-color: #f9f9f9; line-height: 1.1em;">
====half-life 2 content.gcf====
Extract the <tt>maps</tt> folder from the <tt>hl2</tt> folder (in the GCF) into your dedicated server's <tt>orangebox/hl2</tt> folder.
====source 2007 binaries.gcf====
====source 2007 shared materials.gcf====
====source 2007 shared models.gcf====
====source 2007 shared sounds.gcf====
====half-life 2 2007 base content.gcf====
For all of the above GCFs (<u>in given order</u>, with <tt>source 2007 binaries.gcf</tt> being extracted first and <tt>half-life 2 2007 base content.gcf</tt> being last), extract the <tt>hl2</tt> folder (in the GCFs) into your dedicated server's <tt>orangebox/hl2</tt> folder, overwriting if prompted to do so.
</div>

===Half-Life 2: Lost Coast===
====lostcoast content.gcf
Extract the <tt>lostcoast</tt> folder into your dedicated server's <tt>orangebox</tt> folder.

===Half-Life 2: Episode One===
<div style="padding: 0.5em 1em 0.5em 1em; border: 1px dashed #2f6fab; color: black; background-color: #f9f9f9; line-height: 1.1em;">
====episode 1 shared.gcf====
Extract everything from the <tt>episodic</tt> folder (in the GCF) into your dedicated server's <tt>orangebox/episodic</tt> folder, creating the folder if it doesn't exist.
====half-life 2 episode one.gcf====
Extract the <tt>maps</tt> folder from the <tt>episodic</tt> folder (in the GCF) into your dedicated server's <tt>orangebox/episodic</tt> folder.
====episodic 2007 shared.gcf====
Extract everything from the <tt>episodic</tt> folder (in the GCF) into your dedicated server's <tt>orangebox/episodic</tt> folder, overwriting if prompted to do so.
====episode one 2007 content.gcf====
Extract everything from the <tt>episodic</tt> folder (in the GCF) into your dedicated server's <tt>orangebox/episodic</tt> folder, and everything from the <tt>hl2</tt> folder (in the GCF) into your dedicated server's <tt>orangebox/hl2</tt> folder, overwriting if prompted to do so.
</div>

===Half-Life 2: Episode Two===
<div style="padding: 0.5em 1em 0.5em 1em; border: 1px dashed #2f6fab; color: black; background-color: #f9f9f9; line-height: 1.1em;">
====episode two content.gcf====
====episode two maps.gcf====
====episode two materials.gcf====
For all of the above GCFs (<u>in given order</u>), extract everything from the <tt>ep2</tt> folder (in the GCF) into your dedicated server's <tt>orangebox/ep2</tt> folder, creating the folder if it doesn't exist and overwriting if prompted to do so.
</div>

===Half-Life 2: Episode Three===
<div style="padding: 0.5em 1em 0.5em 1em; border: 1px dashed #2f6fab; color: black; background-color: #f9f9f9; line-height: 1.1em;">
You must be living in the future.
</div>

==Additional Game Content==
'''Note:''' If you download any of the following (sans ''Portal'') using the ''HLDS Update Tool'' after downloading <tt>orangebox</tt>, <span style="color:red;">you will be forced to download a new set of engine binaries incompatible with the current release of Obsidian Conflict</span>. A telltale sign that this has occurred is when you see an engine error along the lines of ''SetupArrayProps_R: array prop '(null)' is at index zero'' or ''Host_Error: IDLLFunctions::DLLInit returned false'' when you try to start the server. To workaround that, simply rename the <tt>bin</tt> folder (inside <tt>orangebox</tt>) to something else (e.g. <tt>bin_se2007</tt>) '''before''' downloading the game's files. On completion, delete the newly created <tt>bin</tt> folder and rename the old one back to <tt>bin</tt>.

For the curious, the reason for this is that almost all official Valve games now run on [http://developer.valvesoftware.com/wiki/Source_Engine_2009 Source Engine 2009], but most mods (sans ''Garry's Mod'') continue to run on the older ''Source Engine 2007'' (Source SDK Base 2007). These two versions are incompatible with each other, and Valve has yet to release a version of ''Source SDK Base'' for ''Source Engine 2009''.
===Counter-Strike: Source===
<div style="padding: 0.5em 1em 0.5em 1em; border: 1px dashed #2f6fab; color: black; background-color: #f9f9f9; line-height: 1.1em;">
{{Todo|Downloadable with the HLDS Update Tool, elaboration needed.}}
</div>

===Day of Defeat: Source===
<div style="padding: 0.5em 1em 0.5em 1em; border: 1px dashed #2f6fab; color: black; background-color: #f9f9f9; line-height: 1.1em;">
{{Todo|Downloadable with the HLDS Update Tool, elaboration needed.}}
</div>

===Portal===
<div style="padding: 0.5em 1em 0.5em 1em; border: 1px dashed #2f6fab; color: black; background-color: #f9f9f9; line-height: 1.1em;">
''Incompatible at the time of writing.''
</div>

===Team Fortress 2===
<div style="padding: 0.5em 1em 0.5em 1em; border: 1px dashed #2f6fab; color: black; background-color: #f9f9f9; line-height: 1.1em;">
''Incompatible at the time of writing.''
</div>

==Downloading And Installing Obsidian==
Copy the <tt>obsidian</tt> folder from a fresh install of Obsidian Conflict into your dedicated server's <tt>orangebox</tt> folder.
{{Todo|Further elaboration needed.}}

==Mounting Content==
Content mounts are controlled by a set of files in the <tt>obsidian/mount</tt> folder. Each file determines whether or not the respective game's content is mounted. These files are merely blank files without any extensions - their contents do not matter since the mod merely checks if the file is there, mounting the content if the file is present.
Valid file names are:
<div style="padding: 0.5em 1em 0.5em 1em; border: 1px dashed #2f6fab; color: black; background-color: #f9f9f9; line-height: 1.1em;">
<tt>css</tt> ↔ Counter-Strike: Source

<tt>dod</tt> ↔ Day of Defeat: Source

<tt>ep2</tt> ↔ Half-Life 2: Episode Two

<tt>episodic</tt> ↔ Half-Life 2: Episode One

<tt>hls</tt> ↔ Half-Life: Source

<tt>lostcoast</tt> ↔ Half-Life 2: Lost Coast
</div>
{{Todo|Further elaboration needed.}}

==Optional: Installing Metamod:Source and SourceMod==
===Preface===
SourceMod, in combination with Metamod:Source, make a very powerful toolset for administration of a Source engine-based server. Sourcemod has [http://www.sourcemod.net/plugins.php a large library of plugins] available, along with an active community making Sourcemod one of the easiest choices in administration mods for a server.

===Preparation/Downloading===
''Platform Independent''<br />
Grab the latest version of Metamod:Source from [http://www.sourcemm.net/ their website]. Make sure you download the one that is built for your operating system, otherwise it will not function. Don't forget to download [http://www.sourcemod.net/downloads.php Sourcemod] as well.

After you have downloaded both, extract them to their respective directories. Metamod:Source will go in the addons folder (see the note below), and Sourcemod has folders that belong in the addons folder and cfg folder.

<div style="background-color:#AAAAAA; padding:4px">'''A note about addons'''
It seems that at some point in the development process of Obsidian Conflict, a decision was made to change the name of the addons folder from the standard Source engine-associated name "addons", to a hyphenated name of "add-ons". As the server operator, you must be weary of this, and make sure that any references to the addons folder have the hyphen inserted.

'''Update:''' It seems that renaming the "add-ons" folder to "addons" will still retain functionality. It also seems that it may be necessary to have it named "addons", otherwise it appears that Sourcemod will not work.
</div>

===Installation===
According to [http://www.obsidianconflict.net/forums/viewtopic.php?f=29&t=3309 this] topic (with which this section was made by), it seems that Obsidian Conflict does not load .VDF files (or path references are significantly different compared to other source games), so an older method involving modifying the gameinfo.txt file is necessary.

Open gameinfo.txt. Find
<pre>
SearchPaths
{
Game |gameinfo_path|.
Game |all_source_engine_paths|hl2
}
</pre>

And replace it with
<pre>
SearchPaths
{
GameBin |gameinfo_path|add-ons/metamod/bin
Game |gameinfo_path|.
Game |all_source_engine_paths|hl2
}
</pre>
===Final words===
At this point, Metamod:Source and Sourcemod are configured, and will start up when you start your server. To confirm that they're working, you can type meta info in the console once the server has finished starting up.

To start off, you'll want to add yourself as an administrator. You can follow the Sourcemod article [http://wiki.alliedmods.net/Adding_Admins_%28SourceMod%29 here] to do so. If you're looking for any other information regarding Sourcemod, a wealth of said information has been posted in the [http://wiki.alliedmods.net/index.php/Category:SourceMod_Documentation Sourcemod Documentation].

[[Category:ServerOP]]

Dedicated Server Setup 2

2011-08-01T17:43:47Z

Tgp1994: /* Preparation/Downloading */ Some testing of the addons folder

{{wip}}
This page was created since I can't update the one [[Dedicated Server Setup|here]]. I'm still working on it (but don't have enough time to do it all at once), so it may seem incomplete. - [[User:TESLA-X4|TESLA-X4]] 12:01, 3 April 2011 (CEST)

__TOC__

==Prerequisites==
* A basic understanding of filesystem paths (i.e. <tt>orangebox/hl2</tt> refers to the folder <tt>hl2</tt> ''inside'' <tt>orangebox</tt>, not both the folders), and the different path representations between Windows and *nix (i.e. <tt>\</tt> in Windows is the same as <tt>/</tt> in UNIX[-like] operating systems).
* A basic understanding of the operating system's command-line interface (i.e. [[Wikipedia:Command Prompt|Command Prompt]] for Windows and Terminals for [[Wikipedia:GNOME Terminal|Linux]] and [[Wikipedia::Apple Terminal|Mac OS]]).
* A fast broadband connection (preferably one without a data transfer limit) to prevent premature aging waiting for the uploads to complete.

<span style="color:red;">'''Note:''' At the time of writing, no binaries are publicly available for Linux and Mac OS.</span>

==Base Server Install==
===Step 1: Download The HLDS Update Tool===
{{Windows|Download this file to a temporary location: '''http://www.steampowered.com/download/hldsupdatetool.exe'''}}

{{Linux|''Adapted from <nowiki>http://www.srcds.com/db/engine.php?subaction=showfull&id=1098643920</nowiki>''|
|In a ''Terminal (On Ubuntu: Applications → Accessories → Terminal)'' window, execute the following commands:
|<tt>mkdir srcds_l</tt>
|<tt>cd srcds_l</tt>
|<tt>wget <nowiki>http://www.steampowered.com/download/hldsupdatetool.bin</nowiki></tt>}}

{{Mac|''Unavailable at time of writing.''}}

===Step 2: Install The HLDS Update Tool===
{{Windows|''Adapted from <nowiki>http://www.srcds.com/db/engine.php?subaction=showfull&id=1097362093</nowiki>''|
||''This could help : <nowiki>http://planethalflife.gamespy.com/View.php?view=HL2Guides.Detail&id=4&game=3</nowiki>''|.
|Double-click on <tt>hldsupdatetool.exe</tt> and follow the instructions given by the wizard.
|For the purpose of this tutorial, we will assume that you have installed the server to <tt>c:\srcds</tt>.
|Open a ''Command Prompt (Start → Accessories → Command Prompt)'' window and execute the following commands:
|<tt>c:</tt>
|<tt>cd srcds</tt>
|<tt>hldsupdatetool</tt>|
|An updated version of ''hldsupdatetool'' will now be downloaded to replace the one installed by the wizard.}}

{{Linux|''Adapted from <nowiki>http://www.srcds.com/db/engine.php?subaction=showfull&id=1098643920</nowiki>''|
|In the same ''Terminal'' window as [[#Step 1: Download The HLDS Update Tool|Step 1]], execute the following commands:
|<tt>chmod +x hldsupdatetool.bin</tt>
|<tt>./hldsupdatetool.bin</tt>
|<tt>./steam</tt>|
|An updated version of ''steam'' (the executable) will now be downloaded to replace the one extracted when you ran <tt>./hldsupdatetool.bin</tt>.}}

{{Mac|''Unavailable at time of writing.''}}

===Step 3: Download The Base Server Files===
{{Windows|''Adapted from <nowiki>http://www.srcds.com/db/engine.php?subaction=showfull&id=1097362093</nowiki>''|
|In the same ''Command Prompt'' window as [[#Step 2: Install The HLDS Update Tool|Step 2]], execute the following command:
|<tt>hldsupdatetool.exe -command update -game "orangebox" -dir .</tt>|
|A breakdown of the command:
|<tt>hldsupdatetool.exe</tt>: The executable to run.
|<tt>-command update</tt>: Omnipresent, never omit this.
|<tt>-game "<game>"</tt>: The set of files to download, specify ''list'' instead to see what can be downloaded.
|<tt>-dir <nowiki><directory|.></nowiki></tt>: The directory to install the files in, specify '.' to automatically use the directory ''hldsupdatetool'' is located in.|
|The base server files will now be downloaded. It will take a while, so don't go staring at the window waiting for it to complete. ;)}}

{{Linux|''Adapted from <nowiki>http://www.srcds.com/db/engine.php?subaction=showfull&id=1098643920</nowiki>''|
|In the existing ''Terminal'' window from Steps 1 and 2, execute the following command:
|<tt>./steam -command update -game "orangebox" -dir .</tt>|
|A breakdown of the command:
|<tt>./steam</tt>: The executable to run.
|<tt>-command update</tt>: Omnipresent, never omit this.
|<tt>-game "<game>"</tt>: The set of files to download, specify ''list'' instead to see what can be downloaded.
|<tt>-dir <nowiki><directory|.></nowiki></tt>: The directory to install the files in, specify '.' to automatically use the directory ''steam'' is located in.|
|The base server files will now be downloaded. It will take a while, so don't go staring at the window waiting for it to complete. ;)}}

{{Mac|''Unavailable at time of writing.''}}

===Step 4: Setting Up The Folder Structure===
After [[#Step 3: Download The Base Server Files|Step 3]] completes, you should end up with something like this:

{{Windows|<tt>hl2\
|orangebox\
|orangebox\bin\
|orangebox\hl2\
|orangebox\platform\
|orangebox\reslists\
|orangebox\hlds_steamgames.vdf
|orangebox\srcds.exe
|orangebox\steam_appid.txt
|ClientRegistry.blob
|HldsUpdateTool.exe
|HldsUpdateTool_<tool version>.mst
|InstallRecord.blob</tt>}}

{{Linux|<tt>.steam\
|.steam\clientregistry.blob
|hl2\
|orangebox\
|orangebox\bin\
|orangebox\hl2\
|orangebox\platform\
|orangebox\reslists\
|orangebox\hlds_steamgames.vdf
|orangebox\srcds_linux
|orangebox\srcds_run
|orangebox\steam_appid.txt
|hldsupdatetool.bin
|InstallRecord.blob
|steam
|test1.so
|test2.so
|test3.so</tt>}}

{{Mac|''Unavailable at time of writing.''}}

Now, because Valve didn't set up the files properly on their server, you'll need to fix it yourself.

'''GUI Approach:'''
<div style="padding: 0.5em 1em 0.5em 1em; border: 1px dashed #2f6fab; color: black; background-color: #f9f9f9; line-height: 1.1em;">
Delete the <tt>orangebox/hl2</tt> folder and copy the <tt>hl2</tt> folder (the one outside) in its place.
</div>

'''Command-Line Approach:'''

{{Windows|In the existing ''Command Prompt'' window from the earlier steps, execute the following commands:
|<tt>rmdir /s orangebox\hl2
|xcopy /s /e hl2 orangebox</tt>}}

{{Linux|In the existing ''Terminal'' window from the earlier steps, execute the following commands:
|<tt>rm -R orangebox/hl2</tt>
|<tt>cp -R hl2 orangebox</tt>}}

{{Mac|''Unavailable at time of writing.''}}

==Campaign Content==
Campaign content is stored only in GCFs downloadable only via the Steam client, so be prepared to upload the extracted files to your server. You will need [http://nemesis.thewavelength.net/index.php?p=25 this application] in order to proceed.

Things are a little easier for Windows server operators with Remote Desktop access to their servers since they can simply install Steam on their servers and do everything directly there.

'''Note:''' The Obsidian Team might offer to copy the extracted GCF content onto servers via their Windows server to save upload time in future, in which case you can safely ignore this section.

===Half-Life: Source===
<div style="padding: 0.5em 1em 0.5em 1em; border: 1px dashed #2f6fab; color: black; background-color: #f9f9f9; line-height: 1.1em;">
====half-life source.gcf====
Extract everything from the <tt>hl1</tt> folder (in the GCF) to your dedicated server's <tt>orangebox/hl1</tt> folder, creating the folder if it doesn't exist.
</div>

===Half-Life Deathmatch: Source===
<div style="padding: 0.5em 1em 0.5em 1em; border: 1px dashed #2f6fab; color: black; background-color: #f9f9f9; line-height: 1.1em;">
''Incompatible at the time of writing.''
</div>

===Half-Life 2===
<div style="padding: 0.5em 1em 0.5em 1em; border: 1px dashed #2f6fab; color: black; background-color: #f9f9f9; line-height: 1.1em;">
====half-life 2 content.gcf====
Extract the <tt>maps</tt> folder from the <tt>hl2</tt> folder (in the GCF) into your dedicated server's <tt>orangebox/hl2</tt> folder.
====source 2007 binaries.gcf====
====source 2007 shared materials.gcf====
====source 2007 shared models.gcf====
====source 2007 shared sounds.gcf====
====half-life 2 2007 base content.gcf====
For all of the above GCFs (<u>in given order</u>, with <tt>source 2007 binaries.gcf</tt> being extracted first and <tt>half-life 2 2007 base content.gcf</tt> being last), extract the <tt>hl2</tt> folder (in the GCFs) into your dedicated server's <tt>orangebox/hl2</tt> folder, overwriting if prompted to do so.
</div>

===Half-Life 2: Lost Coast===
<div style="padding: 0.5em 1em 0.5em 1em; border: 1px dashed #2f6fab; color: black; background-color: #f9f9f9; line-height: 1.1em;">
Huh? :V {{Todo|Further elaboration needed.}}
</div>

===Half-Life 2: Episode One===
<div style="padding: 0.5em 1em 0.5em 1em; border: 1px dashed #2f6fab; color: black; background-color: #f9f9f9; line-height: 1.1em;">
====episode 1 shared.gcf====
Extract everything from the <tt>episodic</tt> folder (in the GCF) into your dedicated server's <tt>orangebox/episodic</tt> folder, creating the folder if it doesn't exist.
====half-life 2 episode one.gcf====
Extract the <tt>maps</tt> folder from the <tt>episodic</tt> folder (in the GCF) into your dedicated server's <tt>orangebox/episodic</tt> folder.
====episodic 2007 shared.gcf====
Extract everything from the <tt>episodic</tt> folder (in the GCF) into your dedicated server's <tt>orangebox/episodic</tt> folder, overwriting if prompted to do so.
====episode one 2007 content.gcf====
Extract everything from the <tt>episodic</tt> folder (in the GCF) into your dedicated server's <tt>orangebox/episodic</tt> folder, and everything from the <tt>hl2</tt> folder (in the GCF) into your dedicated server's <tt>orangebox/hl2</tt> folder, overwriting if prompted to do so.
</div>

===Half-Life 2: Episode Two===
<div style="padding: 0.5em 1em 0.5em 1em; border: 1px dashed #2f6fab; color: black; background-color: #f9f9f9; line-height: 1.1em;">
====episode two content.gcf====
====episode two maps.gcf====
====episode two materials.gcf====
For all of the above GCFs (<u>in given order</u>), extract everything from the <tt>ep2</tt> folder (in the GCF) into your dedicated server's <tt>orangebox/ep2</tt> folder, creating the folder if it doesn't exist and overwriting if prompted to do so.
</div>

===Half-Life 2: Episode Three===
<div style="padding: 0.5em 1em 0.5em 1em; border: 1px dashed #2f6fab; color: black; background-color: #f9f9f9; line-height: 1.1em;">
You must be living in the future.
</div>

==Additional Game Content==
'''Note:''' If you download any of the following (sans ''Portal'') using the ''HLDS Update Tool'' after downloading <tt>orangebox</tt>, <span style="color:red;">you will be forced to download a new set of engine binaries incompatible with the current release of Obsidian Conflict</span>. A telltale sign that this has occurred is when you see an engine error along the lines of ''SetupArrayProps_R: array prop '(null)' is at index zero'' or ''Host_Error: IDLLFunctions::DLLInit returned false'' when you try to start the server. To workaround that, simply rename the <tt>bin</tt> folder (inside <tt>orangebox</tt>) to something else (e.g. <tt>bin_se2007</tt>) '''before''' downloading the game's files. On completion, delete the newly created <tt>bin</tt> folder and rename the old one back to <tt>bin</tt>.

For the curious, the reason for this is that almost all official Valve games now run on [http://developer.valvesoftware.com/wiki/Source_Engine_2009 Source Engine 2009], but most mods (sans ''Garry's Mod'') continue to run on the older ''Source Engine 2007'' (Source SDK Base 2007). These two versions are incompatible with each other, and Valve has yet to release a version of ''Source SDK Base'' for ''Source Engine 2009''.
===Counter-Strike: Source===
<div style="padding: 0.5em 1em 0.5em 1em; border: 1px dashed #2f6fab; color: black; background-color: #f9f9f9; line-height: 1.1em;">
{{Todo|Downloadable with the HLDS Update Tool, elaboration needed.}}
</div>

===Day of Defeat: Source===
<div style="padding: 0.5em 1em 0.5em 1em; border: 1px dashed #2f6fab; color: black; background-color: #f9f9f9; line-height: 1.1em;">
{{Todo|Downloadable with the HLDS Update Tool, elaboration needed.}}
</div>

===Portal===
<div style="padding: 0.5em 1em 0.5em 1em; border: 1px dashed #2f6fab; color: black; background-color: #f9f9f9; line-height: 1.1em;">
''Incompatible at the time of writing.''
</div>

===Team Fortress 2===
<div style="padding: 0.5em 1em 0.5em 1em; border: 1px dashed #2f6fab; color: black; background-color: #f9f9f9; line-height: 1.1em;">
''Incompatible at the time of writing.''
</div>

==Downloading And Installing Obsidian==
Copy the <tt>obsidian</tt> folder from a fresh install of Obsidian Conflict into your dedicated server's <tt>orangebox</tt> folder.
{{Todo|Further elaboration needed.}}

==Mounting Content==
Content mounts are controlled by a set of files in the <tt>obsidian/mount</tt> folder. Each file determines whether or not the respective game's content is mounted. These files are merely blank files without any extensions - their contents do not matter since the mod merely checks if the file is there, mounting the content if the file is present.
Valid file names are:
<div style="padding: 0.5em 1em 0.5em 1em; border: 1px dashed #2f6fab; color: black; background-color: #f9f9f9; line-height: 1.1em;">
<tt>css</tt> ↔ Counter-Strike: Source

<tt>dod</tt> ↔ Day of Defeat: Source

<tt>ep2</tt> ↔ Half-Life 2: Episode Two

<tt>episodic</tt> ↔ Half-Life 2: Episode One

<tt>hls</tt> ↔ Half-Life: Source

<tt>lostcoast</tt> ↔ Half-Life 2: Lost Coast
</div>
{{Todo|Further elaboration needed.}}

==Optional: Installing Metamod:Source and SourceMod==
===Preface===
SourceMod, in combination with Metamod:Source, make a very powerful toolset for administration of a Source engine-based server. Sourcemod has [http://www.sourcemod.net/plugins.php a large library of plugins] available, along with an active community making Sourcemod one of the easiest choices in administration mods for a server.

===Preparation/Downloading===
''Platform Independent''<br />
Grab the latest version of Metamod:Source from [http://www.sourcemm.net/ their website]. Make sure you download the one that is built for your operating system, otherwise it will not function. Don't forget to download [http://www.sourcemod.net/downloads.php Sourcemod] as well.

After you have downloaded both, extract them to their respective directories. Metamod:Source will go in the addons folder (see the note below), and Sourcemod has folders that belong in the addons folder and cfg folder.

<div style="background-color:#AAAAAA; padding:4px">'''A note about addons'''
It seems that at some point in the development process of Obsidian Conflict, a decision was made to change the name of the addons folder from the standard Source engine-associated name "addons", to a hyphenated name of "add-ons". As the server operator, you must be weary of this, and make sure that any references to the addons folder have the hyphen inserted.

'''Update:''' It seems that renaming the "add-ons" folder to "addons" will still retain functionality. It also seems that it may be necessary to have it named "addons", otherwise it appears that Sourcemod will not work.
</div>

===Installation===
According to [http://www.obsidianconflict.net/forums/viewtopic.php?f=29&t=3309 this] topic (with which this section was made by), it seems that Obsidian Conflict does not load .VDF files (or path references are significantly different compared to other source games), so an older method involving modifying the gameinfo.txt file is necessary.

Open gameinfo.txt. Find
<pre>
SearchPaths
{
Game |gameinfo_path|.
Game |all_source_engine_paths|hl2
}
</pre>

And replace it with
<pre>
SearchPaths
{
GameBin |gameinfo_path|add-ons/metamod/bin
Game |gameinfo_path|.
Game |all_source_engine_paths|hl2
}
</pre>
===Final words===
At this point, Metamod:Source and Sourcemod are configured, and will start up when you start your server. To confirm that they're working, you can type meta info in the console once the server has finished starting up.

To start off, you'll want to add yourself as an administrator. You can follow the Sourcemod article [http://wiki.alliedmods.net/Adding_Admins_%28SourceMod%29 here] to do so. If you're looking for any other information regarding Sourcemod, a wealth of said information has been posted in the [http://wiki.alliedmods.net/index.php/Category:SourceMod_Documentation Sourcemod Documentation].

[[Category:ServerOP]]

Dedicated Server Setup 2

2011-08-01T17:24:44Z

Tgp1994: Added tutorial for installing the latest version of Metamod:Source and Sourcemod.

{{wip}}
This page was created since I can't update the one [[Dedicated Server Setup|here]]. I'm still working on it (but don't have enough time to do it all at once), so it may seem incomplete. - [[User:TESLA-X4|TESLA-X4]] 12:01, 3 April 2011 (CEST)

__TOC__

==Prerequisites==
* A basic understanding of filesystem paths (i.e. <tt>orangebox/hl2</tt> refers to the folder <tt>hl2</tt> ''inside'' <tt>orangebox</tt>, not both the folders), and the different path representations between Windows and *nix (i.e. <tt>\</tt> in Windows is the same as <tt>/</tt> in UNIX[-like] operating systems).
* A basic understanding of the operating system's command-line interface (i.e. [[Wikipedia:Command Prompt|Command Prompt]] for Windows and Terminals for [[Wikipedia:GNOME Terminal|Linux]] and [[Wikipedia::Apple Terminal|Mac OS]]).
* A fast broadband connection (preferably one without a data transfer limit) to prevent premature aging waiting for the uploads to complete.

<span style="color:red;">'''Note:''' At the time of writing, no binaries are publicly available for Linux and Mac OS.</span>

==Base Server Install==
===Step 1: Download The HLDS Update Tool===
{{Windows|Download this file to a temporary location: '''http://www.steampowered.com/download/hldsupdatetool.exe'''}}

{{Linux|''Adapted from <nowiki>http://www.srcds.com/db/engine.php?subaction=showfull&id=1098643920</nowiki>''|
|In a ''Terminal (On Ubuntu: Applications → Accessories → Terminal)'' window, execute the following commands:
|<tt>mkdir srcds_l</tt>
|<tt>cd srcds_l</tt>
|<tt>wget <nowiki>http://www.steampowered.com/download/hldsupdatetool.bin</nowiki></tt>}}

{{Mac|''Unavailable at time of writing.''}}

===Step 2: Install The HLDS Update Tool===
{{Windows|''Adapted from <nowiki>http://www.srcds.com/db/engine.php?subaction=showfull&id=1097362093</nowiki>''|
||''This could help : <nowiki>http://planethalflife.gamespy.com/View.php?view=HL2Guides.Detail&id=4&game=3</nowiki>''|.
|Double-click on <tt>hldsupdatetool.exe</tt> and follow the instructions given by the wizard.
|For the purpose of this tutorial, we will assume that you have installed the server to <tt>c:\srcds</tt>.
|Open a ''Command Prompt (Start → Accessories → Command Prompt)'' window and execute the following commands:
|<tt>c:</tt>
|<tt>cd srcds</tt>
|<tt>hldsupdatetool</tt>|
|An updated version of ''hldsupdatetool'' will now be downloaded to replace the one installed by the wizard.}}

{{Linux|''Adapted from <nowiki>http://www.srcds.com/db/engine.php?subaction=showfull&id=1098643920</nowiki>''|
|In the same ''Terminal'' window as [[#Step 1: Download The HLDS Update Tool|Step 1]], execute the following commands:
|<tt>chmod +x hldsupdatetool.bin</tt>
|<tt>./hldsupdatetool.bin</tt>
|<tt>./steam</tt>|
|An updated version of ''steam'' (the executable) will now be downloaded to replace the one extracted when you ran <tt>./hldsupdatetool.bin</tt>.}}

{{Mac|''Unavailable at time of writing.''}}

===Step 3: Download The Base Server Files===
{{Windows|''Adapted from <nowiki>http://www.srcds.com/db/engine.php?subaction=showfull&id=1097362093</nowiki>''|
|In the same ''Command Prompt'' window as [[#Step 2: Install The HLDS Update Tool|Step 2]], execute the following command:
|<tt>hldsupdatetool.exe -command update -game "orangebox" -dir .</tt>|
|A breakdown of the command:
|<tt>hldsupdatetool.exe</tt>: The executable to run.
|<tt>-command update</tt>: Omnipresent, never omit this.
|<tt>-game "<game>"</tt>: The set of files to download, specify ''list'' instead to see what can be downloaded.
|<tt>-dir <nowiki><directory|.></nowiki></tt>: The directory to install the files in, specify '.' to automatically use the directory ''hldsupdatetool'' is located in.|
|The base server files will now be downloaded. It will take a while, so don't go staring at the window waiting for it to complete. ;)}}

{{Linux|''Adapted from <nowiki>http://www.srcds.com/db/engine.php?subaction=showfull&id=1098643920</nowiki>''|
|In the existing ''Terminal'' window from Steps 1 and 2, execute the following command:
|<tt>./steam -command update -game "orangebox" -dir .</tt>|
|A breakdown of the command:
|<tt>./steam</tt>: The executable to run.
|<tt>-command update</tt>: Omnipresent, never omit this.
|<tt>-game "<game>"</tt>: The set of files to download, specify ''list'' instead to see what can be downloaded.
|<tt>-dir <nowiki><directory|.></nowiki></tt>: The directory to install the files in, specify '.' to automatically use the directory ''steam'' is located in.|
|The base server files will now be downloaded. It will take a while, so don't go staring at the window waiting for it to complete. ;)}}

{{Mac|''Unavailable at time of writing.''}}

===Step 4: Setting Up The Folder Structure===
After [[#Step 3: Download The Base Server Files|Step 3]] completes, you should end up with something like this:

{{Windows|<tt>hl2\
|orangebox\
|orangebox\bin\
|orangebox\hl2\
|orangebox\platform\
|orangebox\reslists\
|orangebox\hlds_steamgames.vdf
|orangebox\srcds.exe
|orangebox\steam_appid.txt
|ClientRegistry.blob
|HldsUpdateTool.exe
|HldsUpdateTool_<tool version>.mst
|InstallRecord.blob</tt>}}

{{Linux|<tt>.steam\
|.steam\clientregistry.blob
|hl2\
|orangebox\
|orangebox\bin\
|orangebox\hl2\
|orangebox\platform\
|orangebox\reslists\
|orangebox\hlds_steamgames.vdf
|orangebox\srcds_linux
|orangebox\srcds_run
|orangebox\steam_appid.txt
|hldsupdatetool.bin
|InstallRecord.blob
|steam
|test1.so
|test2.so
|test3.so</tt>}}

{{Mac|''Unavailable at time of writing.''}}

Now, because Valve didn't set up the files properly on their server, you'll need to fix it yourself.

'''GUI Approach:'''
<div style="padding: 0.5em 1em 0.5em 1em; border: 1px dashed #2f6fab; color: black; background-color: #f9f9f9; line-height: 1.1em;">
Delete the <tt>orangebox/hl2</tt> folder and copy the <tt>hl2</tt> folder (the one outside) in its place.
</div>

'''Command-Line Approach:'''

{{Windows|In the existing ''Command Prompt'' window from the earlier steps, execute the following commands:
|<tt>rmdir /s orangebox\hl2
|xcopy /s /e hl2 orangebox</tt>}}

{{Linux|In the existing ''Terminal'' window from the earlier steps, execute the following commands:
|<tt>rm -R orangebox/hl2</tt>
|<tt>cp -R hl2 orangebox</tt>}}

{{Mac|''Unavailable at time of writing.''}}

==Campaign Content==
Campaign content is stored only in GCFs downloadable only via the Steam client, so be prepared to upload the extracted files to your server. You will need [http://nemesis.thewavelength.net/index.php?p=25 this application] in order to proceed.

Things are a little easier for Windows server operators with Remote Desktop access to their servers since they can simply install Steam on their servers and do everything directly there.

'''Note:''' The Obsidian Team might offer to copy the extracted GCF content onto servers via their Windows server to save upload time in future, in which case you can safely ignore this section.

===Half-Life: Source===
<div style="padding: 0.5em 1em 0.5em 1em; border: 1px dashed #2f6fab; color: black; background-color: #f9f9f9; line-height: 1.1em;">
====half-life source.gcf====
Extract everything from the <tt>hl1</tt> folder (in the GCF) to your dedicated server's <tt>orangebox/hl1</tt> folder, creating the folder if it doesn't exist.
</div>

===Half-Life Deathmatch: Source===
<div style="padding: 0.5em 1em 0.5em 1em; border: 1px dashed #2f6fab; color: black; background-color: #f9f9f9; line-height: 1.1em;">
''Incompatible at the time of writing.''
</div>

===Half-Life 2===
<div style="padding: 0.5em 1em 0.5em 1em; border: 1px dashed #2f6fab; color: black; background-color: #f9f9f9; line-height: 1.1em;">
====half-life 2 content.gcf====
Extract the <tt>maps</tt> folder from the <tt>hl2</tt> folder (in the GCF) into your dedicated server's <tt>orangebox/hl2</tt> folder.
====source 2007 binaries.gcf====
====source 2007 shared materials.gcf====
====source 2007 shared models.gcf====
====source 2007 shared sounds.gcf====
====half-life 2 2007 base content.gcf====
For all of the above GCFs (<u>in given order</u>, with <tt>source 2007 binaries.gcf</tt> being extracted first and <tt>half-life 2 2007 base content.gcf</tt> being last), extract the <tt>hl2</tt> folder (in the GCFs) into your dedicated server's <tt>orangebox/hl2</tt> folder, overwriting if prompted to do so.
</div>

===Half-Life 2: Lost Coast===
<div style="padding: 0.5em 1em 0.5em 1em; border: 1px dashed #2f6fab; color: black; background-color: #f9f9f9; line-height: 1.1em;">
Huh? :V {{Todo|Further elaboration needed.}}
</div>

===Half-Life 2: Episode One===
<div style="padding: 0.5em 1em 0.5em 1em; border: 1px dashed #2f6fab; color: black; background-color: #f9f9f9; line-height: 1.1em;">
====episode 1 shared.gcf====
Extract everything from the <tt>episodic</tt> folder (in the GCF) into your dedicated server's <tt>orangebox/episodic</tt> folder, creating the folder if it doesn't exist.
====half-life 2 episode one.gcf====
Extract the <tt>maps</tt> folder from the <tt>episodic</tt> folder (in the GCF) into your dedicated server's <tt>orangebox/episodic</tt> folder.
====episodic 2007 shared.gcf====
Extract everything from the <tt>episodic</tt> folder (in the GCF) into your dedicated server's <tt>orangebox/episodic</tt> folder, overwriting if prompted to do so.
====episode one 2007 content.gcf====
Extract everything from the <tt>episodic</tt> folder (in the GCF) into your dedicated server's <tt>orangebox/episodic</tt> folder, and everything from the <tt>hl2</tt> folder (in the GCF) into your dedicated server's <tt>orangebox/hl2</tt> folder, overwriting if prompted to do so.
</div>

===Half-Life 2: Episode Two===
<div style="padding: 0.5em 1em 0.5em 1em; border: 1px dashed #2f6fab; color: black; background-color: #f9f9f9; line-height: 1.1em;">
====episode two content.gcf====
====episode two maps.gcf====
====episode two materials.gcf====
For all of the above GCFs (<u>in given order</u>), extract everything from the <tt>ep2</tt> folder (in the GCF) into your dedicated server's <tt>orangebox/ep2</tt> folder, creating the folder if it doesn't exist and overwriting if prompted to do so.
</div>

===Half-Life 2: Episode Three===
<div style="padding: 0.5em 1em 0.5em 1em; border: 1px dashed #2f6fab; color: black; background-color: #f9f9f9; line-height: 1.1em;">
You must be living in the future.
</div>

==Additional Game Content==
'''Note:''' If you download any of the following (sans ''Portal'') using the ''HLDS Update Tool'' after downloading <tt>orangebox</tt>, <span style="color:red;">you will be forced to download a new set of engine binaries incompatible with the current release of Obsidian Conflict</span>. A telltale sign that this has occurred is when you see an engine error along the lines of ''SetupArrayProps_R: array prop '(null)' is at index zero'' or ''Host_Error: IDLLFunctions::DLLInit returned false'' when you try to start the server. To workaround that, simply rename the <tt>bin</tt> folder (inside <tt>orangebox</tt>) to something else (e.g. <tt>bin_se2007</tt>) '''before''' downloading the game's files. On completion, delete the newly created <tt>bin</tt> folder and rename the old one back to <tt>bin</tt>.

For the curious, the reason for this is that almost all official Valve games now run on [http://developer.valvesoftware.com/wiki/Source_Engine_2009 Source Engine 2009], but most mods (sans ''Garry's Mod'') continue to run on the older ''Source Engine 2007'' (Source SDK Base 2007). These two versions are incompatible with each other, and Valve has yet to release a version of ''Source SDK Base'' for ''Source Engine 2009''.
===Counter-Strike: Source===
<div style="padding: 0.5em 1em 0.5em 1em; border: 1px dashed #2f6fab; color: black; background-color: #f9f9f9; line-height: 1.1em;">
{{Todo|Downloadable with the HLDS Update Tool, elaboration needed.}}
</div>

===Day of Defeat: Source===
<div style="padding: 0.5em 1em 0.5em 1em; border: 1px dashed #2f6fab; color: black; background-color: #f9f9f9; line-height: 1.1em;">
{{Todo|Downloadable with the HLDS Update Tool, elaboration needed.}}
</div>

===Portal===
<div style="padding: 0.5em 1em 0.5em 1em; border: 1px dashed #2f6fab; color: black; background-color: #f9f9f9; line-height: 1.1em;">
''Incompatible at the time of writing.''
</div>

===Team Fortress 2===
<div style="padding: 0.5em 1em 0.5em 1em; border: 1px dashed #2f6fab; color: black; background-color: #f9f9f9; line-height: 1.1em;">
''Incompatible at the time of writing.''
</div>

==Downloading And Installing Obsidian==
Copy the <tt>obsidian</tt> folder from a fresh install of Obsidian Conflict into your dedicated server's <tt>orangebox</tt> folder.
{{Todo|Further elaboration needed.}}

==Mounting Content==
Content mounts are controlled by a set of files in the <tt>obsidian/mount</tt> folder. Each file determines whether or not the respective game's content is mounted. These files are merely blank files without any extensions - their contents do not matter since the mod merely checks if the file is there, mounting the content if the file is present.
Valid file names are:
<div style="padding: 0.5em 1em 0.5em 1em; border: 1px dashed #2f6fab; color: black; background-color: #f9f9f9; line-height: 1.1em;">
<tt>css</tt> ↔ Counter-Strike: Source

<tt>dod</tt> ↔ Day of Defeat: Source

<tt>ep2</tt> ↔ Half-Life 2: Episode Two

<tt>episodic</tt> ↔ Half-Life 2: Episode One

<tt>hls</tt> ↔ Half-Life: Source

<tt>lostcoast</tt> ↔ Half-Life 2: Lost Coast
</div>
{{Todo|Further elaboration needed.}}

==Optional: Installing Metamod:Source and SourceMod==
===Preface===
SourceMod, in combination with Metamod:Source, make a very powerful toolset for administration of a Source engine-based server. Sourcemod has [http://www.sourcemod.net/plugins.php a large library of plugins] available, along with an active community making Sourcemod one of the easiest choices in administration mods for a server.

===Preparation/Downloading===
''Platform Independent''<br />
Grab the latest version of Metamod:Source from [http://www.sourcemm.net/ their website]. Make sure you download the one that is built for your operating system, otherwise it will not function. Don't forget to download [http://www.sourcemod.net/downloads.php Sourcemod] as well.

After you have downloaded both, extract them to their respective directories. Metamod:Source will go in the addons folder (see the note below), and Sourcemod has folders that belong in the addons folder and cfg folder.

<div style="background-color:#AAAAAA; padding:4px">'''A note about addons'''
It seems that at some point in the development process of Obsidian Conflict, a decision was made to change the name of the addons folder from the standard Source engine-associated name "addons", to a hyphenated name of "add-ons". As the server operator, you must be weary of this, and make sure that any references to the addons folder have the hyphen inserted.
</div>

===Installation===
According to [http://www.obsidianconflict.net/forums/viewtopic.php?f=29&t=3309 this] topic (with which this section was made by), it seems that Obsidian Conflict does not load .VDF files (or path references are significantly different compared to other source games), so an older method involving modifying the gameinfo.txt file is necessary.

Open gameinfo.txt. Find
<pre>
SearchPaths
{
Game |gameinfo_path|.
Game |all_source_engine_paths|hl2
}
</pre>

And replace it with
<pre>
SearchPaths
{
GameBin |gameinfo_path|add-ons/metamod/bin
Game |gameinfo_path|.
Game |all_source_engine_paths|hl2
}
</pre>
===Final words===
At this point, Metamod:Source and Sourcemod are configured, and will start up when you start your server. To confirm that they're working, you can type meta info in the console once the server has finished starting up.

To start off, you'll want to add yourself as an administrator. You can follow the Sourcemod article [http://wiki.alliedmods.net/Adding_Admins_%28SourceMod%29 here] to do so. If you're looking for any other information regarding Sourcemod, a wealth of said information has been posted in the [http://wiki.alliedmods.net/index.php/Category:SourceMod_Documentation Sourcemod Documentation].

[[Category:ServerOP]]