Welcome, Guest! Login | Register

Debugging your mod using steam [Print this Article]
Posted by: Bulk
Date posted: Sep 16 2003
User Rating: 5 out of 5.0
Number of views: 11197
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 19: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 09: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 21:46:15
Hmm lemme post in forums insteadEdited by lillbrorsan on Jul 22 2004, 21:56:31

Posted By: IdeaMan on Sep 16 2004 at 01: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 23:48:44
It should be SteamAppId=70 now.

Posted By: NuclearFriend on Dec 04 2004 at 16: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 05 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
knock knock
General | News
By: MIFUNE | Dec 31 2017
 
knock knock
General | News
By: omega | Dec 22 2016
 
knock knock
General | News
By: MIFUNE | Oct 10 2015
 
New HL HUD Message System
Half-Life | Coding | Shared Tutorials
By: chbrules | Dec 31 2011
 
knock knock
General | News
By: Whistler | Nov 05 2011
 
Particle Engine tutorial part 4
Half-Life | Coding | Client Side Tutorials
By: darkPhoenix | Feb 18 2010
 
Particle Engine tutorial part 2
Half-Life | Coding | Client Side Tutorials
By: darkPhoenix | Feb 11 2010
 
Particle Engine tutorial part 3
Half-Life | Coding | Client Side Tutorials
By: darkPhoenix | Feb 11 2010
 
Game Movement Series #2: Analog Jumping and Floating
Half-Life 2 | Coding | Shared Tutorials
By: mars3554 | Oct 26 2009
 
Particle Engine tutorial part 5
Half-Life | Coding | Client Side Tutorials
By: Deadpool | Aug 02 2009
 

Site Info
297 Approved Articless
8 Pending Articles
3940 Registered Members
0 People Online (8 guests)
About - Credits - Contact Us

Wavelength version: 3.0.0.9
Valid XHTML 1.0! Valid CSS!