Compiling under VS2022: Difference between revisions
No edit summary |
(Updated page with TF2 branch info.) |
||
| Line 1: | Line 1: | ||
{{LanguageBar}} | {{LanguageBar}} | ||
{{TabsBar|main=Visual Studio}} | {{TabsBar|main=Visual Studio}} | ||
{{stub}} | {{stub}} | ||
== Multiplayer (TF2 branch) == | |||
The {{tf2branch|2|nt=1}} officially support compiling using Visual Studio 2022. See [[Setting up Source SDK Base 2013 Multiplayer]] for more information. | |||
== 2013 Singleplayer + Multiplayer Legacy == | |||
{{Note|Sorry that this article is a bit of a stub! I wanted to make sure it at least existed for those looking to use a modern compiler with the 2013 SDK. It is absolutely reasonable to use the latest compilers with the SDK! I would suggest using the diffs from the two GitHub repos linked on this page for figuring it out for your mod. | {{Note|Sorry that this article is a bit of a stub! I wanted to make sure it at least existed for those looking to use a modern compiler with the 2013 SDK. It is absolutely reasonable to use the latest compilers with the SDK! I would suggest using the diffs from the two GitHub repos linked on this page for figuring it out for your mod. | ||
<small>- [[User:Ozxybox]]</small> | <small>- [[User:Ozxybox]]</small> | ||
| Line 15: | Line 19: | ||
If necessary, these changes can also be made to work with VS2015—VS2019 by changing <code>$PlatformToolset</code> in <code>source_win32_base.vpc</code>. | If necessary, these changes can also be made to work with VS2015—VS2019 by changing <code>$PlatformToolset</code> in <code>source_win32_base.vpc</code>. | ||
== I'm starting from scratch! == | === I'm starting from scratch! === | ||
If you don't want to deal with setting up the project, or if you have problems compiling the source code because of certain errors, you can clone [https://github.com/Source-SDK-Resources/source-sdk-vs2022 this repo] since it's based on the official {{Src13|4}} repo with minimal changes to allow it to run without problems. Please disregard any "compile process successful but file not found" warning as it is meaningless. | If you don't want to deal with setting up the project, or if you have problems compiling the source code because of certain errors, you can clone [https://github.com/Source-SDK-Resources/source-sdk-vs2022 this repo] since it's based on the official {{Src13|4}} repo with minimal changes to allow it to run without problems. Please disregard any "compile process successful but file not found" warning as it is meaningless. | ||
| Line 22: | Line 26: | ||
Mapbase can be compiled with any version of Visual Studio, from 2013-2022. You can toggle support by editing {{path|\vpc_scripts\newer_vs_toolsets|vpc}} | Mapbase can be compiled with any version of Visual Studio, from 2013-2022. You can toggle support by editing {{path|\vpc_scripts\newer_vs_toolsets|vpc}} | ||
== Editing Existing Code == | === Editing Existing Code === | ||
If you need to edit an existing codebase (Such as the version of {{src13|3.1}} Valve provides on GitHub), you will need to edit or replace certain files. | If you need to edit an existing codebase (Such as the version of {{src13|3.1}} Valve provides on GitHub), you will need to edit or replace certain files. | ||
=== Running VPC === | ==== Running VPC ==== | ||
If you don't have Visual Studio 2013 on your computer, [[VPC]] will fail to run, as it can't find registry keys specific to older versions. | If you don't have Visual Studio 2013 on your computer, [[VPC]] will fail to run, as it can't find registry keys specific to older versions. | ||
| Line 36: | Line 40: | ||
{{Todo|Explain changes from here https://github.com/Source-SDK-Resources/source-sdk-vs2022/tree/master/mp/src/vpc_scripts}} | {{Todo|Explain changes from here https://github.com/Source-SDK-Resources/source-sdk-vs2022/tree/master/mp/src/vpc_scripts}} | ||
=== Fixing {{code|particles.lib}} === | ==== Fixing {{code|particles.lib}} ==== | ||
Once everything's compiling, you'll hit a snag with '''particles.lib'''. It defines the symbol _hypot, and when using VS 2022, that symbol is already being used. | Once everything's compiling, you'll hit a snag with '''particles.lib'''. It defines the symbol _hypot, and when using VS 2022, that symbol is already being used. | ||
| Line 46: | Line 50: | ||
[https://github.com/Source-SDK-Resources/source-sdk-vs2022/blob/7be91d3ddc4388ec43a60195f6d959682a256cbe/mp/src/game/client/client_base.vpc#L74| Example] | [https://github.com/Source-SDK-Resources/source-sdk-vs2022/blob/7be91d3ddc4388ec43a60195f6d959682a256cbe/mp/src/game/client/client_base.vpc#L74| Example] | ||
=== Fixing {{code|memoverride.cpp}} === | ==== Fixing {{code|memoverride.cpp}} ==== | ||
The main file that needs to be fixed for Source to work under VS 2022 is {{file|memoverride|cpp}}. Replace it with [https://github.com/Source-SDK-Resources/source-sdk-vs2022/blob/master/mp/src/public/tier0/memoverride.cpp this one]. | The main file that needs to be fixed for Source to work under VS 2022 is {{file|memoverride|cpp}}. Replace it with [https://github.com/Source-SDK-Resources/source-sdk-vs2022/blob/master/mp/src/public/tier0/memoverride.cpp this one]. | ||
| Line 52: | Line 56: | ||
{{Todo|Explain everything from here https://github.com/Source-SDK-Resources/source-sdk-vs2022/blob/master/mp/src/public/tier0/memoverride.cpp}} | {{Todo|Explain everything from here https://github.com/Source-SDK-Resources/source-sdk-vs2022/blob/master/mp/src/public/tier0/memoverride.cpp}} | ||
== In Recap == | === In Recap === | ||
Do what [[ | Do what [[Setting_up_Source_SDK_Base_2013_Singleplayer|this page]] asks you to do while ignoring any reference to Visual Studio 2013, fix the Registry keys problem with the fix from the same page, download '''particles.lib''' to {{path|<mp or sp>\src\lib\public}} from [https://github.com/SCell555/Source-PlusPlus/blob/HEAD/src/lib/public/particles.lib this], and finally, replace {{file|memoverride|cpp}} located at {{path|<mp or sp>\src\public\tier0}} with [https://github.com/Source-SDK-Resources/source-sdk-vs2022/blob/master/mp/src/public/tier0/memoverride.cpp this one]. Have fun making Source mods with updated software ;) | ||
[[Category:Tutorials]] | [[Category:Tutorials]] | ||
[[Category:Programming]] | [[Category:Programming]] | ||
[[Category:Source SDK FAQ]] | [[Category:Source SDK FAQ]] | ||
Revision as of 22:14, 2 July 2025
Multiplayer (TF2 branch)
The 
Team Fortress 2 engine branch officially support compiling using Visual Studio 2022. See Setting up Source SDK Base 2013 Multiplayer for more information.
2013 Singleplayer + Multiplayer Legacy
Note:Sorry that this article is a bit of a stub! I wanted to make sure it at least existed for those looking to use a modern compiler with the 2013 SDK. It is absolutely reasonable to use the latest compilers with the SDK! I would suggest using the diffs from the two GitHub repos linked on this page for figuring it out for your mod.
With Visual Studio 2013 being out of support, and harder to obtain, there is a lot of pressure to use a newer version of Visual Studio when working with Source SDK 2013. However, as the codebase does not support the changes brought about by later toolset versions, some work is required to get it functioning.
This article is primarily based on these two GitHub repos:
- https://github.com/Source-SDK-Resources/source-sdk-vs2022
- https://github.com/SCell555/Source-PlusPlus
If necessary, these changes can also be made to work with VS2015—VS2019 by changing $PlatformToolset in source_win32_base.vpc.
I'm starting from scratch!
If you don't want to deal with setting up the project, or if you have problems compiling the source code because of certain errors, you can clone this repo since it's based on the official 
Source 2013 repo with minimal changes to allow it to run without problems. Please disregard any "compile process successful but file not found" warning as it is meaningless.
Using 
Mapbase
Mapbase can be compiled with any version of Visual Studio, from 2013-2022. You can toggle support by editing 
\vpc_scripts\newer_vs_toolsets.vpc
Editing Existing Code
If you need to edit an existing codebase (Such as the version of Source 2013 Valve provides on GitHub), you will need to edit or replace certain files.
Running VPC
If you don't have Visual Studio 2013 on your computer, VPC will fail to run, as it can't find registry keys specific to older versions.
You can:
- Grab an edit of VPC that works for modern versions of Visual Studio, such as this one
- Add the registry keys VPC is looking for. See here.
Once ran, the generated VPC scripts will need to be modified to support the newer toolsets.
Fixing particles.lib
Once everything's compiling, you'll hit a snag with particles.lib. It defines the symbol _hypot, and when using VS 2022, that symbol is already being used.
The best solution for this is to go grab an edit of particles.lib that's been fixed. (Like this one)
If you're not a fan of that idea, one alternative could be telling VPC to allow multiple symbols to exist for the client project. This is not a great practice though! Example
Fixing memoverride.cpp
The main file that needs to be fixed for Source to work under VS 2022 is 
memoverride.cpp. Replace it with this one.
In Recap
Do what this page asks you to do while ignoring any reference to Visual Studio 2013, fix the Registry keys problem with the fix from the same page, download particles.lib to <mp or sp>\src\lib\public from this, and finally, replace memoverride.cpp located at <mp or sp>\src\public\tier0 with this one. Have fun making Source mods with updated software ;)