Source SDK Known Issues: Difference between revisions

From Valve Developer Community
Jump to navigation Jump to search
No edit summary
m (formatting fixes)
 
(4 intermediate revisions by 2 users not shown)
Line 1: Line 1:
[[Category:Steam]][[Category:Changelists]]
This is a list of known and verified issues with the Source SDK release, and potential workarounds.
This is a list of known and verified issues with the Source SDK release, and potential workarounds.
= General Issues =


=== Visual Studio 2002 Is No Longer Supported (Since 8/4/2006)===
== General issues ==
 
=== Visual Studio 2002 is no longer supported (Since 8/4/2006)===


As of this SDK Release Visual Studio 2002 is no longer supported. We are sorry for the inconvenience that this causes our customers.
As of this SDK Release Visual Studio 2002 is no longer supported. We are sorry for the inconvenience that this causes our customers.
Line 11: Line 11:
{{note|This patch is provided here as a convenience. Valve does not maintain or support it.}}
{{note|This patch is provided here as a convenience. Valve does not maintain or support it.}}


=== Visual Studio 2005 Is Not Presently Supported (Since 1/17/2006)===
== Hammer Editor issues ==
 
Presently the Source SDK does not support Visual Studio 2005 or Visual C++ Express. This support will be added in a future release.
 
= Tools Issues =
 
== SDK Launcher Issues ==
 
=== SDK Launcher Will Terminate if No 'gameinfo.txt' Exists In A MOD Directory (Since 8/4/2006)===
 
In order to remind MOD makers choose the correct <code>SteamAppId</code> the SDK Launcher will inspect all installed MODs and attempt to load their 'gameinfo.txt' files. If a MOD directory does not contain a 'gameinfo.txt' file then the user will see the following message and the SDK Launcher will terminate.
 
[[Image:Gameinfonotfound.JPG]]
 
Unfortunately, the SDK Launcher will attempt this check each time it is launched until the check is successful. This issue can be worked around in the following ways:
 
* Move the offending MOD directory, run the SDK Launcher, and then copy it back after the SDK Launcher starts successfully.
* Bypass this check altogether by creating a file named 'show_deprecatedappid_marker.txt' at '%Steam Root%\SteamApps\%Steam User%\sourcesdk\launcher'.
* Adding a 'gameinfo.txt' to the offending MOD's directory.
 
''This issue is addressed and the fix will be available in the next release.''
 
== Faceposer Issues ==
 
=== Faceposer Crashes When When Trying to Extract or Add a .txt File (Since 8/4/2006)===
 
The community has developed a workaround to this problem until it can be addressed in a patch. Here is the workaround:
 
* When you load up your sound file in the phoneme editor, right click to get the menu that pops up and select import data from .txt file.
 
* If you have previously exported data to .txt, you can just import that data as I said above. Once this data is imported, you can "Commit Extraction". When you do that, you should be able to now manually add words and phonemes. Remember to periodically export data to .txt incase of crashes so you won't end up wasting a lot of time.
 
* If you don't have any previously exported data to import into FacePoser you can copy this sample into a text file. [[Phoneme Data Example]]
 
== Hammer Issues ==


=== Direct Shortcuts to Hammer Will Not Work (Since 8/4/2006)===
=== Direct shortcuts to hammer will not work (Since 8/4/2006)===


With this version of the SDK you will get an error if you attempt to run hammer.exe from the 'sourcesdk\bin' directory. Here is the best way to work around this issue:
With this version of the SDK you will get an error if you attempt to run hammer.exe from the 'sourcesdk\bin' directory. Here is the best way to work around this issue:
Line 59: Line 25:
This has the added benefit of actually launching the SDK Launcher before Hammer, making sure it is the latest version.
This has the added benefit of actually launching the SDK Launcher before Hammer, making sure it is the latest version.


Also, you can create shortcuts to Model Viewer and Face Poser by creating other shortcuts and adding these command line arguments:
{{note|Shortcuts for Model Viewer and FacePoser can be created by following the same procedure and replacing <code>-runhammer</code> with one of these command line arguments: <code>-runmodelviewer</code> or <code>-runfaceposer</code>.}}
 
<code>-runmodelviewer</code>
 
<code>-runfaceposer</code>
 
=== 3D Lighting Preview View In Hammer Causes Strange Behavior and Crashes(Since 8/4/2006)===


=== 3D Lighting Preview View in Hammer causes strange behavior and crashes (Since 8/4/2006)===
There is a main menu item for 3D Lighting Preview that should not be exposed at this point. Please do not use it as it does not work.
There is a main menu item for 3D Lighting Preview that should not be exposed at this point. Please do not use it as it does not work.


''This issue is addressed and the fix will be available in the next release.''
''This issue is addressed and the fix will be available in the next release.''


=== 3D View In Hammer Appears Empty (Since 8/4/2006)===
=== 3D View in Hammer appears empty (Since 8/4/2006)===
 
The newest release of Hammer requires that at least on Camera be placed in the map in order for the 3D Views to work. If you are experiencing empty 3D views simply [[Hammer_Camera_Tool|place a camera]] in your map.
The newest release of Hammer requires that at least on Camera be placed in the map in order for the 3D Views to work. If you are experiencing empty 3D views simply place a camera in your map.
 
=== Error When Compiling Maps from Within A Mod (Since 8/4/2006)===
 
When compiling a map within Hammer you may see the following error message:
 
[[Image:Systemcannotfindpath.JPG]]
 
This is caused by the fact that the Create MOD Wizard does not create a 'maps' subdirectory under the $SteamDir\SteamApps\SourceMods\%ModName% directory. Until this problem is fixed in the SDK you can bypass the problem by adding this directory yourself and attempting to re-build the map.
 
''This issue is addressed and the fix will be available in the next release.''
 
=== Error When Running Maps from Within A Mod (Since 8/4/2006)===


=== Error when running maps from within a mod (Since 8/4/2006)===
When attempting to run a map from within Hammer you may come across the following error message:
When attempting to run a map from within Hammer you may come across the following error message:


Line 93: Line 42:
Here is the process for working around this issue until it is addressed in the SDK:
Here is the process for working around this issue until it is addressed in the SDK:


# On Hammer's Tools|Options|Build Tools page change the Game Executable page to be:
# On Hammer's Tools > Options > Build Tools page change the '''Game Executable''' to be:
#: <code>$SteamDir\steam.exe</code> instead of <code>$SteamUserDir\half-life 2\hl2.exe</code><br /><br />
#: [[Image:SteamFSError-Sol1.JPG]]
# From the '''Run Map''' dialog, prepend the <code>-applaunch 215</code> parameter for the '$game_exe' command:
#: [[Image:SteamFSError-Sol2.JPG]]


<code>$SteamDir\steam.exe</code> instead of <code>$SteamUserDir\half-life 2\hl2.exe</code>
What this will do is run Steam and instruct it to launch 'Source SDK base' and point it to the map defined by the remainder of the <code>$game_exe</code> parameters. One thing to look out for is that you will need to build the DLL's for your mod before running it.


[[Image:SteamFSError-Sol1.JPG]]
== SDK code issues ==
 
# From the Run Map screen prepend the following to the parameters for the '$game_exe' command:
 
<code>-applaunch 215</code>
 
[[Image:SteamFSError-Sol2.JPG]]
 
What this will do is run Steam and instruct it to launch 'Source SDK base' and point it to the map defined by the remainder of the '$game_exe' parameters. One thing to look out for is that you will need to build the DLL's for your MOD before running it.
 
= SDK Code Issues =
 
== General ==
 
=== Error Running a New Mod (Since 8/4/2006)===
 
In the new SDK it is necessary to build the client and server DLLs before running the MOD. Please build them if you see this message when trying to run the MOD.


=== Error running a new mod (Since 8/4/2006)===
[[Image:Couldnotloadclient.JPG]]
[[Image:Couldnotloadclient.JPG]]


=== From Scratch Mod Exits When Launching from Steam Menu (Since 8/4/2006)===
In the new SDK it is necessary to build the client and server DLLs before running the mod. Please build them if you see this message when trying to run the mod.
Launching a (Make a mod from scratch) mod from the steam menu enters the game, shows the game menu, dings, and then exits, no error.
Although, launching from a command line works fine.


: Well actually it should work fine. Though note that if you have compiled you're dlls in debug mode you have to add "-allowdebug" to the MOD's launch options! The run_mod.bat already adds it.
=== From scratch mod exits when launching from Steam Menu (Since 8/4/2006)===
Launching a (Make a mod from scratch) mod from the Steam menu enters the game, shows the game menu, dings, and then exits, no error. Although, launching from a command line works fine.


=== Included cs_militia Map Does Not Load Properly (Since 8/4/2006)===
: Well actually it should work fine. Though note that if you have compiled your DLLs in debug mode you have to add <code>-allowdebug</code> to the mod's launch options! The <code>run_mod.bat</code> already adds it.


The version of cs_militia that came with the SDK does not load properly and will be fixed in a patch release of the SDK.
== See also ==
* [[Source SDK Release Notes]]


''This issue is addressed and the fix will be available in the next release.''
[[Category:Steam]][[Category:Changelists]]
 
== SDK Shaders ==
 
=== SDK Shaders are Not Building Properly (Since 8/4/2006)===
 
In the new SDK it is presently not possible to build the <code>game_shader_generic_sample.vcproj</code> or <code>game_shader_generic_advanced.vcproj</code> projects.
 
== Linux Support ==
 
=== SDK Does Not Compile Under Linux (Since 8/4/2006)===
 
The SDK was not properly tested under Linux before it was released. Until a patch addresses this here is the workaround:
 
<pre>
--- Makefile.vcpm      9 Jun 2006 04:27:20 -0000      1.3
+++ Makefile.vcpm      6 Aug 2006 19:00:54 -0000
@@ -33,7 +33,9 @@
TIER1_OBJS = \
        $(TIER1_OBJ_DIR)/characterset.o \
        $(TIER1_OBJ_DIR)/interface.o \
+      $(TIER1_OBJ_DIR)/generichash.o \
        $(TIER1_OBJ_DIR)/KeyValues.o \
+      $(TIER1_OBJ_DIR)/stringpool.o \
        $(TIER1_OBJ_DIR)/utlbuffer.o \
        $(TIER1_OBJ_DIR)/utlsymbol.o \
 
 
--- Makefile    23 Jun 2006 02:42:01 -0000      1.5
+++ Makefile    6 Aug 2006 19:04:26 -0000
@@ -61,7 +61,7 @@
 
# the CPU target for the build, must be i486 for now
ARCH=i486
-ARCH_CFLAGS=-march=pentium -mmmx
+ARCH_CFLAGS=-march=pentium3 -mmmx -O3
 
# -fpermissive is so gcc 3.4.x doesn't complain about some template stuff
</pre>
 
Also it won't compile without -O3 due to some weird inline forcing.  Still investigating that bizarreness.
 
=== <code>vbsp.exe</code> Does Not Create Linux Terrain Physics Data(Since 8/4/2006)===
 
In this version of the SDK the vbsp.exe tool does not create Linux-specific physics terrain data as it did in the the past. This causes a crash in the game DLL when an old mod runs a map compiled using the new <code>vbsp.exe</code>.
 
This issue will be addressed in a patch SDK release.
 
= See also =
 
* [[Source SDK Release Notes]]

Latest revision as of 18:30, 2 December 2006

This is a list of known and verified issues with the Source SDK release, and potential workarounds.

General issues

Visual Studio 2002 is no longer supported (Since 8/4/2006)

As of this SDK Release Visual Studio 2002 is no longer supported. We are sorry for the inconvenience that this causes our customers.

For those who are brave there is a patch that allows for VS 2002 compilation.

Note.pngNote:This patch is provided here as a convenience. Valve does not maintain or support it.

Hammer Editor issues

Direct shortcuts to hammer will not work (Since 8/4/2006)

With this version of the SDK you will get an error if you attempt to run hammer.exe from the 'sourcesdk\bin' directory. Here is the best way to work around this issue:

  1. Right-click on the Source SDK item on the Tools tab in Steam.
  2. Select Create desktop shortcut.
  3. Add -runhammer to the end of the steam.exe command line.
    For example: C:\Program Files\Valve\Steam\Steam.exe -applaunch 211 -runhammer
  4. Rename the desktop shortcut to something appropriate, such as "Hammer Editor".

This has the added benefit of actually launching the SDK Launcher before Hammer, making sure it is the latest version.

Note.pngNote:Shortcuts for Model Viewer and FacePoser can be created by following the same procedure and replacing -runhammer with one of these command line arguments: -runmodelviewer or -runfaceposer.

3D Lighting Preview View in Hammer causes strange behavior and crashes (Since 8/4/2006)

There is a main menu item for 3D Lighting Preview that should not be exposed at this point. Please do not use it as it does not work.

This issue is addressed and the fix will be available in the next release.

3D View in Hammer appears empty (Since 8/4/2006)

The newest release of Hammer requires that at least on Camera be placed in the map in order for the 3D Views to work. If you are experiencing empty 3D views simply place a camera in your map.

Error when running maps from within a mod (Since 8/4/2006)

When attempting to run a map from within Hammer you may come across the following error message:

MountAppFilesystemFailed.JPG

Here is the process for working around this issue until it is addressed in the SDK:

  1. On Hammer's Tools > Options > Build Tools page change the Game Executable to be:
    $SteamDir\steam.exe instead of $SteamUserDir\half-life 2\hl2.exe

    SteamFSError-Sol1.JPG
  2. From the Run Map dialog, prepend the -applaunch 215 parameter for the '$game_exe' command:
    SteamFSError-Sol2.JPG

What this will do is run Steam and instruct it to launch 'Source SDK base' and point it to the map defined by the remainder of the $game_exe parameters. One thing to look out for is that you will need to build the DLL's for your mod before running it.

SDK code issues

Error running a new mod (Since 8/4/2006)

Couldnotloadclient.JPG

In the new SDK it is necessary to build the client and server DLLs before running the mod. Please build them if you see this message when trying to run the mod.

From scratch mod exits when launching from Steam Menu (Since 8/4/2006)

Launching a (Make a mod from scratch) mod from the Steam menu enters the game, shows the game menu, dings, and then exits, no error. Although, launching from a command line works fine.

Well actually it should work fine. Though note that if you have compiled your DLLs in debug mode you have to add -allowdebug to the mod's launch options! The run_mod.bat already adds it.

See also

Retrieved from "https://developer.valvesoftware.com/w/index.php?title=Source_SDK_Known_Issues&oldid=96642"