Welcome, Guest! Login | Register

Debugging your mod using steam [Print this Article]
Posted by: Bulk
Date posted: Sep 15 2003
User Rating: 5 out of 5.0
Number of views: 7543
Number of comments: 6
Description: An small guide, written by Valve's Alfred Reynolds, on how to debug your mod in steam.
To debug in steam you will need to do the following:

1) Install steam.

2) Run steam at least once and launch half-life and have it load.

3) Place your mod in the directory of the program you launched in step 2 (i.e c:\program files\steam\steamapps\<email addr>\Half-Life)

4) Copy the "SteamApp.cfg" file (created from the text below) into the programs directory (i.e c:\program files\steam\steamapps\<email addr>\Half-Life\SteamApp.cfg

5) Edit "SteamApp.cfg" to point to the correct username, password, install path and AppID. The AppID value should be 70 (meaning Half-Life). The version entry should be 0 for now, if we ever update the content for your chosen AppID you will need to increment this number (we will phase this field out soon).

6) Launch hl.exe in the debugger like usual, just add "-steam" to the command line. If you forget "-steam" you will launch hl.exe using steam.exe and you will be unable to use the debugger (unless you attach to the process).


We will be releasing details on customizing the UI soon.

- Alfred

 CODE  

------------ SteamApp.cfg -------- Cut Here
############################################################################
##
# SteamApp.cfg
#
# Steam Client App configuration-override file
#
# This file is read by the Steam code in the Client
# Application, and controls configurable parameters that
# affect only that App.
#
# To be effective it must be placed in the App directory
# (for example, c:\Steam\SteamApps\me@web.com\Half-Life\).
#
############################################################################
##
#
# Debug-launch settings
#
# Use these settings when you are running your application directly
# from your debugger (ie, not launching the App from the Steam UI)
# In such cases, you need to tell Steam which application
# you are running and the version you want to use.  Each application has
# an ID number and each version of your application has a version ID number.
# You also need to indicate the username you are running Steam under.
#
# SteamInstallPath should point to the directory where the corresponding Steam.exe
# resides
#
# To do a debug launch:
#
# - do at least one launch from the UI first to ensure the Minimum Footprint files
#   are present
# - leave the Steam UI running
# - copy this file into the App directory
# - fill out the following config parameters
# - run the app directly or through the debugger, with "-steam" on the command line
#
# You may leave it setup and still do normal launches through the
# Steam UI. However, if you comment out the SteamInstallPath parameter,
# you must also REMOVE Steam.dll from the App directory, or else the
# launch will fail with "The local Steam service is not running".
#
# SteamAppId=0
# SteamAppVersionId=0
# SteamInstallPath=u:\Steam
# SteamAppUser=user

------------ End of SteamApp.cfg --------

Rate This Article
This article is currently rated: 5 out of 5.0 (2 Votes)

You have to register to rate this article.
User Comments Showing comments 1-6

Posted By: imperio59 on Mar 20 2004 at 13:58:39
If you get an error saying "missing "=" in last line" or something of the sort, you can change the last 2 lines of the .cfg to have quotes, like so:
SteamInstallPath="C:\Program Files\Steam"
SteamAppUser="imperio59@isp.com"
Of course, replace with your own email addy and steam root path...

Posted By: jim_the_coder on Jun 11 2004 at 03:29:00
The other thing to do is to make sure you didn't copy the End of SteamAmpp.cfg and the bit at the top like I did...

Posted By: lillbrorsan on Jul 22 2004 at 15:46:15
Hmm lemme post in forums insteadEdited by lillbrorsan on Jul 22 2004, 15:56:31

Posted By: IdeaMan on Sep 15 2004 at 19:04:33
Well, this doesn't work on the new steam. I ended up just running HL, then attaching the debugger.
All the exceptions that are thrown and handled during load slow down the debugger tremendously, so if the crash doesn't happen during map load you can wait until after you've started the server and map running to attach.
Debug->Processes click on hl.exe, attach. There's a delay (you can see what it's doing in the debug output window) while it loads up all the dlls for debugging.

Posted By: harSens on Oct 30 2004 at 17:48:44
It should be SteamAppId=70 now.

Posted By: NuclearFriend on Dec 04 2004 at 10:07:34
Anyone know if this method works with HL2? Or any other methods for that matter. >_>


You must register to post a comment. If you have already registered, you must login.

Latest Articles
3rd person View in Multiplayer
Half-Life 2 | Coding | Client Side Tutorials
How to enable it in HL2DM

By: cct | Nov 13 2006

Making a Camera
Half-Life 2 | Level Design
This camera is good for when you join a map, it gives you a view of the map before you join a team

By: slackiller | Mar 04 2006

Making a camera , Part 2
Half-Life 2 | Level Design
these cameras are working monitors that turn on when a button is pushed.

By: slackiller | Mar 04 2006

Storing weapons on ladder
Half-Life 2 | Coding | Snippets
like Raven Sheild or BF2

By: British_Bomber | Dec 24 2005

Implementation of a string lookup table
Half-Life 2 | Coding | Snippets
A string lookup table is a set of functions that is used to convert strings to pre-defined values

By: deathz0rz | Nov 13 2005


Latest Comments
Spinning Corpses Simple Fix
Half-Life | Coding | Snippets
By: darkPhoenix | Sep 05 2008
 
Where do we go from here
General | News
By: MIFUNE | Jun 09 2008
 
The Input/Output system
Half-Life 2 | Level Design
By: nazitaco | Dec 23 2007
 
Where do we go from here
General | News
By: Rob_F | Nov 22 2007
 
Rescaling Half-Life
Half-Life | Coding | Shared Tutorials
By: christoph | Nov 12 2007
 
GameUI
Half-Life 2 | Coding | Client Side Tutorials
By: Evil_j | Oct 29 2007
 
3 State Zoom For Any Weapon
Half-Life 2 | Coding | Server Side Tutorials
By: Ennuified | Oct 18 2007
 
Storing weapons on ladder
Half-Life 2 | Coding | Snippets
By: cct | Sep 07 2007
 
CTF Gameplay Part 1
Half-Life | Coding | Shared Tutorials
By: DarkNight | Aug 28 2007
 
CTF Gameplay Part 1
Half-Life | Coding | Shared Tutorials
By: deedok | Aug 20 2007
 

Site Info
296 Approved Articless
5 Pending Articles
3940 Registered Members
2 People Online (48 guests)
About - Credits - Contact Us

Wavelength version: 3.0.0.9
Valid XHTML 1.0! Valid CSS!