Toggle menu
Toggle preferences menu
Toggle personal menu
Not logged in
Your IP address will be publicly visible if you make any edits.

Troubleshooting: Difference between revisions

From TF2 Classified Wiki
Undo revision 663 for now
Tag: Undo
No edit summary
 
(26 intermediate revisions by 3 users not shown)
Line 3: Line 3:
Make sure you've completely followed the instructions listed at the [[Installation]] page before attempting to solve your problem here.
Make sure you've completely followed the instructions listed at the [[Installation]] page before attempting to solve your problem here.


== Utility for resolving general download/extraction issues ==
== Current major issues ==
'''The fastest and easiest way to download and extract the game is to use our dedicated downloader.''' If you're dealing with extraction issues, or if your download is slow, corrupted, or getting interrupted, this is a great alternative to try.
=== Game crashes after the Valve intro/"Failed to apply client patches!" ===
This is a new issue caused by the recent SDK2013 update, and TF2 Classic not having been updated yet. To temporarily fix this, right click ''Source SDK Base 2013 Multiplayer'' on Steam, click Properties, go to Beta, and select <code>previous2021</code>.


Note that this application is likely to trigger a false-positive on some antiviruses. This is a known issue with applications created with PyInstaller. You'll need to make an exemption for it. If Chrome blocks it, you may need to use Edge, Firefox, etc.
Whenever TF2 Classic updates to the new SDK2013 version, you'll need to revert this.


Ensure that you have at least 15GB of free space available on the drive that you run this tool on.
=== "Could not load library client. Try restarting. If that doesn't work, verify the cache." ===
This is a new 2.0.4 issue caused by our crashpad handler requiring libraries that not all users have.


* Download for Windows: https://wiki.tf2classic.com/misc/TF2CDownloader.exe
You'll need to download and install this redistributable from Microsoft:
* Download for Linux (suitable for desktops and dedicated servers): https://wiki.tf2classic.com/misc/TF2CDownloader
* https://aka.ms/vs/16/release/vc_redist.x86.exe


Place the executable wherever you would like to extract TF2Classic (your sourcemods folder would be the best pick), then double-click it. After running it, you'll see the progress in a command prompt window.
=== Microstuttering/Network judder ===
This is a new 2.0.4 issue, the cause is currently unknown but we're looking into it. Let us know if you encounter this, along with any relevant information.


'''On Linux only''', you'll have to run it from the terminal. Right-click in the folder where you extracted it to open the context menu, click "Open in Terminal", then run <code>chmod +x ./TF2CDownloader</code> followed by <code>./TF2CDownloader</code>
== TF2CDownloader-related issues ==


After the download finishes, it'll automatically extract the downloaded archive into a "tf2classic" folder, in whatever directory the executable was placed in. Once the extraction finishes, the window will close.
=== (Windows) SmartScreen blocked TF2CDownloader! ===
It does this for every unsigned application. To sign it would cost us somewhere around $800 per year, so we don't. On the SmartScreen pop-up, click "More info", then "Run anyways".


If the executable is not in your sourcemods folder, you should move the extracted "tf2classic" folder there after it's done.
=== (Windows) It says TF2CDownloader is missing libraries! ===
This happens on Windows 7. We do not and cannot support Windows 7, you must install the game manually.


Then, follow step 4 of http://tf2classic.com/download to finalize your installation.
=== (Linux) TF2CDownloader gives me an "Error loading Python lib"! ===
This happens when the application was built with a version of glibc that's newer than what your distribution carries. Currently, we support Ubuntu 20.04 and any other distribution with glibc 2.31 or newer.
,
=== (Linux) TF2CDownloader downloads a .meta4 file, then crashes when it can't find a .tar.zst file ===
This happens if your version of aria2 was compiled without metalink support. If you're on a Gentoo Linux-based distribution, you can fix it by setting the <code>metalink</code> USE flag for aria2 and then rebuilding it.


== I get an error when I try to extract the game! ==
=== Why are there so many errors when I run TF2CDownloader? ===
=== On Windows ===
Those are normal. The output is extremely verbose. The first thing TF2CDownloader does is check if the game file already exists for the purpose of verifying it. It usually doesn't exist, which causes it to produce a "Checksum error". Then, if any mirrors are failing, timing out, missing, or otherwise having issues, it'll produce an error when it attempts to contact them as well. These are ''not'' fatal errors, and are expected in its course of operation.
This error is known to occur when using Windows Explorer's built-in ZIP extractor. You're required to instead use third-party archivers (see below) to extract the game's files.


Tested and supported options include [https://www.7-zip.org/ 7-Zip], [https://peazip.github.io/ PeaZip], and [https://www.winzip.com/en/ WinZip (not free)]. WinRAR will likely also work, however it is discouraged as it's been known to randomly botch extractions in the past, along with being proprietary.
=== "PermissionError: [Errno 13] Permission denied: ..." ===
=== On Linux ===
This problem is due to older versions of libzip not supporting ZIP files compressed using LZMA, affecting numerous archive managers. The <code>unzip</code> command '''will not work'''.


On KDE Plasma-based distributions, you should open Ark, click on "Settings" from the toolbar, click "Configure Ark...", and in the "Plugins" section of the configuration window, uncheck "Libzip plugin". Apply your changes and re-attempt extraction. It should fall back to using the P7Zip backend, which will work fine.
If you're updating, make sure the game and the launcher are closed, then try again. If the game is already closed, open task manager, and terminate "hl2.exe". The game not properly terminating by itself is a bug.


Generically, you should install 7-Zip and extract through the CLI. On Ubuntu 22.04+ or Debian 12+, install the "7zip" package. On Arch Linux or Manjaro, install "7-zip" from the AUR. Then run:
=== I can't find the folder TF2CDownloader extracted! ===
If you're not extracting into your sourcemods, your extraction directory is a large and cluttered folder, ''and'' you're sorting by the modified date, you likely won't find the folder it extracted easily. You should instead sort the folder alphabetically, and then scroll until you find the "tf2classic" folder, so you can move it to your sourcemods. Pressing F5 to refresh the folder's contents may also be useful.


<code>7zz x tf2classic-2.0.3.zip</code>
== Miscellaneous issues ==


And move the extracted "tf2classic" folder to your sourcemods.
=== RaiseJSException: Method call failed: Installs.OpenInstallWizard... ===
This error most likely comes up when trying to launch TF2 Classic but Source SDK Base 2013 Multiplayer isn't installed. [[Installation#Step 1: Downloading SDK 2013 Multiplayer|Read the first step of the instructions]] to install it.


== The launcher tells me that SDK2013 isn't installed, but it is! ==
=== I can't connect to any servers and all of the text starts with #TF! ===
The folder of your game (which should contain a <code>gameinfo.txt</code> file) should be named <code>tf2classic</code>. If it is named <code>tf2classic-latest</code> or if all of your files are dumped loosely in <code>sourcemods</code>, that will cause this to happen. Note that if Steam's running, restart it after renaming the folder, or else an error will occur if you attempt to launch the game via Steam.
 
=== The launcher tells me that SDK2013 isn't installed, but it is! ===
This can happen if Source SDK Base 2013 Multiplayer is installed onto a separate drive from the Steam client. The correct drive will almost always be <code>C:\</code>. Any other drive letters are bound to cause issues. You can move it as shown below:
This can happen if Source SDK Base 2013 Multiplayer is installed onto a separate drive from the Steam client. The correct drive will almost always be <code>C:\</code>. Any other drive letters are bound to cause issues. You can move it as shown below:
[[File:MoveSDK.png|400px|center]]
[[File:MoveSDK.png|400px|center]]
For advanced users, it's also possible to create a symlink from its expected location in the common folder on your <code>C:\</code> drive to its real location on another drive. See instructions further down on the page for how to create one.
For advanced users, it's also possible to create a symlink from its expected location in the common folder on your <code>C:\</code> drive to its real location on another drive. See instructions [[#Creating_a_symlink_on_Windows|here]] for how to create one.
 
rest
== The launcher says that SDK2013 needs to be updated, but it is! ==
=== The launcher says that SDK2013 needs to be updated, but it is! ===
You should try to launch SDK2013 from Steam once. Even if Steam claims it's fully installed, it may still require validation or other work, which Steam will only perform when you try to run it. After launching and closing it again, restart the launcher.
You should try to launch SDK2013 from Steam once. Even if Steam claims it's fully installed, it may still require validation or other work, which Steam will only perform when you try to run it. After launching and closing it again, restart the launcher.


== The launcher doesn't work! ==
=== The launcher doesn't work! ===
If you run into any issues with the launcher, you're safe to ignore it entirely. The game should appear in your Steam library if it was installed correctly, and you can launch it through there instead.
If you run into any issues with the launcher, you're safe to ignore it entirely. The game should appear in your Steam library if it was installed correctly, and you can launch it through there instead.


== My game doesn't appear in my Steam library! ==
=== My game doesn't appear in my Steam library! ===
First, restart Steam completely if you haven't since installing the game. Right-click Steam in your system tray, then click "Exit" from the menu that appears. ''Or'' click the Steam button in the top-left of the window, and click "Exit" from the dropdown. Then start Steam again, and see if it appears.
First, restart Steam completely if you haven't since installing the game. Right-click Steam in your system tray, then click "Exit" from the menu that appears. ''Or'' click the Steam button in the top-left of the window, and click "Exit" from the dropdown. Then start Steam again, and see if it appears.


Line 75: Line 86:
Note that any external disk used for running games '''must be readable and writable by your user, and you must have execute permissions.''' If this is an NTFS disk, follow Valve's guide on preparing it: https://github.com/ValveSoftware/Proton/wiki/Using-a-NTFS-disk-with-Linux-and-Windows.
Note that any external disk used for running games '''must be readable and writable by your user, and you must have execute permissions.''' If this is an NTFS disk, follow Valve's guide on preparing it: https://github.com/ValveSoftware/Proton/wiki/Using-a-NTFS-disk-with-Linux-and-Windows.


== My textures are missing/It says it "could not load library client"! ==
=== (Linux) My game can't connect to servers!/My in-game overlay doesn't work! ===
Re-extract the game, it might have gotten corrupted during extraction. If you used WinRAR or WinZip, try 7-Zip or PeaZip instead. If that doesn't work, delete your local copy, redownload a fresh archive of the game, and reinstall.
 
== (Linux) My game can't connect to servers!/My in-game overlay doesn't work! ==
On Linux, ''TF2C'' requires a special launch option to function properly. Right-click the game in your Steam library, click "Properties", then paste this into the Launch Options field:
On Linux, ''TF2C'' requires a special launch option to function properly. Right-click the game in your Steam library, click "Properties", then paste this into the Launch Options field:


Line 85: Line 93:
This should fix the overlay, and allow you to connect to game servers.
This should fix the overlay, and allow you to connect to game servers.


== "The server you are trying to connect to is running an older version of the game." ==
=== "The server you are trying to connect to is running an older version of the game." ===
This error is partially erroneous. Most commonly, the server isn't running an older version of the game, you are. If you downloaded ''TF2C'' 2.0.0 from some third-party mirror, you'll receive this error when connecting to official servers. Hence, you'll need to reinstall the game from an archive using the latest version of the game.
This error is partially erroneous. Most commonly, the server isn't running an older version of the game, you are. If you downloaded an older version of the game yourself, you'll receive this error when connecting to official servers. Hence, you'll need to reinstall the game from an archive using the latest version of the game.


== Players are invisible in my game! ==
=== Players are invisible in my game! ===
This tends to happen if your network is unreliable or your game stutters. It's possible to run a command to fix this, though you'll need to run this command every time it happens.
This tends to happen if your network is unreliable or your game stutters. It's possible to run a command to fix this, though you'll need to run this command every time it happens.


Line 94: Line 102:
# Press the ~ (tilde) key on your keyboard to open the console.
# Press the ~ (tilde) key on your keyboard to open the console.
# Run <code>record demo;stop</code>
# Run <code>record demo;stop</code>
=== The game is stuck on "Retrieving server info" but I can hear in-game sounds! ===
This problem happens if you're running the game with Intel Graphics instead of using a dedicated GPU.
The solution is to lower the graphic settings until the problem no longer shows up.


== See also ==
== See also ==