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
No edit summary
No edit summary
 
(17 intermediate revisions by 2 users not shown)
Line 2: Line 2:


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.
== Current major issues ==
=== 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>.
Whenever TF2 Classic updates to the new SDK2013 version, you'll need to revert this.
=== "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.
You'll need to download and install this redistributable from Microsoft:
* https://aka.ms/vs/16/release/vc_redist.x86.exe
=== 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.


== TF2CDownloader-related issues ==
== TF2CDownloader-related issues ==
Line 12: Line 27:


=== (Linux) TF2CDownloader gives me an "Error loading Python lib"! ===
=== (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 22.04 and any other distribution with glibc 2.33 or newer. We plan to rebuild with an earlier version to support Ubuntu 20.04 and Debian 11 soon.
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.


=== Why are there so many errors when I run TF2CDownloader? ===
=== Why are there so many errors when I run TF2CDownloader? ===
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.
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.


=== I can't find the folder TF2CDownloader extracted! ===
=== "PermissionError: [Errno 13] Permission denied: ..." ===
If you ran the executable in a large and cluttered folder, like Downloads, 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.


=== TF2CDownloader froze! ===
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.
From time-to-time, we get a complaint of the prompt no longer updating, with no progress being made for an extended period of time. Some people resolve this by pressing a key on their keyboard at the prompt. You also may have to simply close the window and re-run the script, which will cause it to pick up where it left off.


== Manual installation issues ==
=== I can't find the folder TF2CDownloader extracted! ===
=== I get an error when I try to extract the ZIP! ===
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.
==== On Windows ====
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.
==== 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.
 
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:
 
<code>7zz x tf2classic-2.0.3.zip</code>
 
And move the extracted "tf2classic" folder to your sourcemods.


== Miscellaneous issues ==
== Miscellaneous issues ==
=== My game suddenly crashes when joining a map, when it didn't before! ===
You most likely joined a malicious server. An easy fix is to empty the <code>tf2classic\download</code> folder inside your game's folder, or more specifically, to remove any heavy <code>_particles.txt</code> files that appeared in the <code>tf2classic\download\maps</code> folder. These malicious servers won't be able to do anything else to your game or your computer.


These malicious servers disguises themselves as real existing server. An easy way to find which one of these servers are malicious is to see if it matches with a lot of these criteria:
=== RaiseJSException: Method call failed: Installs.OpenInstallWizard... ===
* A server with the same exact name already exists
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.
* Server often changes host name
* Server often changes port
* Total lack of server tags, except for <code>increased_maxplayers</code>
* Odd maximum player count (e.g. 55)
* Actual server line does not provide servers with said maximum player count (e.g. VaultF4 servers with 64 players does not exist)
* Only plays generic maps
* Plays generic maps despite using a custom weapon pack which requires use of special maps (e.g. it is not using a map ending with _v5_3_3)
* Ping which does not match server region
* Fake player count, the player list when viewing server info does not match the player count that's shown
* Downloads files with shady names for shock value
 
Considering these servers tends to change port extremely often, simply right clicking and blacklisting the server won't work permanently. Instead, blacklist the IP address with the port set to <code>:0</code> (e.g. <code>12.34.56.78:0</code>). This'll block every port of the IP address, and will cause the server to not escape your blacklist.
 
=== My textures are missing/It says it "could not load library client"! ===
The game didn't get fully extracted. If you're using TF2CDownloader, you may not have allowed it to fully finish before moving the extracted folder or playing the game. The prompt must say "Setup is over. Press Enter to continue" before you're safe to play.
 
If you installed the game manually, you may need to re-extract with a different tool.


=== I can't connect to any servers and all of the text starts with #TF! ===
=== I can't connect to any servers and all of the text starts with #TF! ===
Make sure your folder structure is correct. Inside your <code>sourcemods</code> folder, there should be a <code>tf2classic</code> folder, which should contain a <code>gameinfo.txt</code> file. If this doesn't perfectly line up, you extracted it incorrectly. If you have a path that looks like <code>sourcemods/tf2classic-2.0.3/tf2classic</code> or if all of your files are dumped loosely in <code>sourcemods</code>, that will cause this to happen.
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! ===
=== The launcher tells me that SDK2013 isn't installed, but it is! ===
Line 71: Line 54:
[[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 [[#Creating_a_symlink_on_Windows|here]] 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.
Line 120: Line 103:
# Run <code>record demo;stop</code>
# Run <code>record demo;stop</code>


=== See also ===
=== 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 ==
* [[Installation]]
* [[Installation]]
* [https://discord.gg/3zMk4vn Discord server] (post in the #technical-issues channel if your issue could not be resolved here)
* [https://discord.gg/3zMk4vn Discord server] (post in the #technical-issues channel if your issue could not be resolved here)


[[Category:Guides]]
[[Category:Guides]]