SWG-Source · swgsais · Jul 11, 2026 · Jul 14, 2026 · Jul 14, 2026 · Jul 15, 2026
diff --git a/.clang-format b/.clang-format
@@ -0,0 +1,42 @@
+---
+Language: Cpp
+BasedOnStyle: Microsoft
+
+# SWG source uses Allman braces and tab-based indentation.
+BreakBeforeBraces: Allman
+UseTab: Always
+IndentWidth: 4
+TabWidth: 4
+AccessModifierOffset: -4
+NamespaceIndentation: All
+IndentCaseLabels: true
+
+# Keep source-oriented declarations stable while formatting touched ranges.
+PointerAlignment: Right
+SortIncludes: Never
+ColumnLimit: 0
+
+# Braced constructs must not collapse back onto one line.
+AllowShortBlocksOnASingleLine: Never
+AllowShortFunctionsOnASingleLine: None
+AllowShortIfStatementsOnASingleLine: Never
+AllowShortLoopsOnASingleLine: false
+...
+---
+Language: ObjC
+BasedOnStyle: Microsoft
+BreakBeforeBraces: Allman
+UseTab: Always
+IndentWidth: 4
+TabWidth: 4
+AccessModifierOffset: -4
+NamespaceIndentation: All
+IndentCaseLabels: true
+PointerAlignment: Right
+SortIncludes: Never
+ColumnLimit: 0
+AllowShortBlocksOnASingleLine: Never
+AllowShortFunctionsOnASingleLine: None
+AllowShortIfStatementsOnASingleLine: Never
+AllowShortLoopsOnASingleLine: false
+...
diff --git a/.gitignore b/.gitignore
@@ -29,6 +29,8 @@ src/game/server/application/SwgDatabaseServer/src/shared/generated/Schema.h
 exe/win32/.exe
 .kdev*
 lib/
+!src/external/3rd/library/JUCE-8.0.14/modules/juce_audio_formats/codecs/oggvorbis/libvorbis-1.3.7/lib/
+!src/external/3rd/library/JUCE-8.0.14/modules/juce_audio_formats/codecs/oggvorbis/libvorbis-1.3.7/lib/**
 obj/
 *.kdev4
 .depend
@@ -77,4 +79,43 @@ src/external/3rd/library/udplibrary/UdpLibrary.cpp.PVS-Studio.cfg
 src/external/3rd/library/udplibrary/UdpLibrary.cpp.PVS-Studio.cmd
 src/external/3rd/library/udplibrary/UdpLibrary.cpp~RF869406.TMP
 src/external/3rd/library/wolfssl/
-src/build/win32/.vs/*
+src/build/win32/.vs/*
+
+# Self-contained x64 client dependencies and compatibility libraries.
+!deps/
+!deps/x64/
+!deps/x64/**
+!deps/win32/
+!deps/win32/**
+!deps/build-prerequisites/
+!deps/build-prerequisites/**
+!mss64-stub/
+!mss64-stub/**
+
+# Prepared Qt 3 source is vendored, but its generated build products are not.
+!deps/qt3-win64-src/
+!deps/qt3-win64-src/**
+deps/source-cache/
+deps/qt3-win64-src/.qmake.cache
+deps/qt3-win64-src/.qtwinconfig
+deps/qt3-win64-src/bin/*.dll
+deps/qt3-win64-src/bin/*.exe
+deps/qt3-win64-src/lib/
+deps/qt3-win64-src/misc/configure/tmp/
+deps/qt3-win64-src/misc/link_includes/tmp/
+deps/qt3-win64-src/qmake/tmp/
+deps/qt3-win64-src/src/.qmake.internal.cache
+deps/qt3-win64-src/src/Makefile
+deps/qt3-win64-src/src/Makefile.main
+deps/qt3-win64-src/src/moc/Makefile
+deps/qt3-win64-src/src/moc/*.obj
+deps/qt3-win64-src/src/tmp/
+
+# Local MSBuild and helper outputs.
+src/build/win32/x64/
+**/build/win32/x64/
+**/x64/Release/
+scripts/__pycache__/
+mss64-stub/*.exp
+deps/x64/lib/lgLcd.lib
+deps/x64/lib/lgLcd_stubs.obj
diff --git a/Directory.Build.props b/Directory.Build.props
@@ -0,0 +1,35 @@
+<?xml version="1.0" encoding="utf-8"?>
+<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
+  <!-- Keep command-line project builds deterministic while allowing callers to
+       select either Win32 or x64 explicitly. -->
+  <PropertyGroup>
+    <Platform Condition="'$(Platform)' == ''">x64</Platform>
+    <SwgAudioBackend Condition="'$(SwgAudioBackend)' == ''">Juce</SwgAudioBackend>
+  </PropertyGroup>
+  <PropertyGroup Condition="'$(Platform)' == 'x64'">
+    <SwgDependenciesDir>$(MSBuildThisFileDirectory)deps\x64</SwgDependenciesDir>
+    <SwgX64DependenciesDir>$(SwgDependenciesDir)</SwgX64DependenciesDir>
+    <SwgCompatibilityDependencies>swg-stubs.lib;vivoxSharedWrapper.lib;libxml2.lib;pcre.lib;</SwgCompatibilityDependencies>
+    <SwgAudioBackendDependencies Condition="'$(SwgAudioBackend)' == 'Miles'">mss64.lib;</SwgAudioBackendDependencies>
+    <SwgPlatformLibraryDirectories>$(DXSDK_DIR)Lib\x64;$(WindowsSDK_LibraryPath_x64);$(SwgDependenciesDir)\lib;$(MSBuildThisFileDirectory)mss64-stub;</SwgPlatformLibraryDirectories>
+  </PropertyGroup>
+  <PropertyGroup Condition="'$(Platform)' == 'Win32'">
+    <SwgDependenciesDir>$(MSBuildThisFileDirectory)deps\win32</SwgDependenciesDir>
+    <SwgCompatibilityDependencies>vivoxSharedWrapper.lib;libxml2.lib;pcre.lib;</SwgCompatibilityDependencies>
+    <SwgPlatformLibraryDirectories>$(DXSDK_DIR)Lib\x86;$(WindowsSDK_LibraryPath_x86);$(SwgDependenciesDir)\lib;</SwgPlatformLibraryDirectories>
+  </PropertyGroup>
+  <ItemDefinitionGroup Condition="'$(Platform)' == 'x64'">
+    <ClCompile>
+      <AdditionalIncludeDirectories>$(TargetDir);%(AdditionalIncludeDirectories)</AdditionalIncludeDirectories>
+      <PreprocessorDefinitions>_HAS_AUTO_PTR_ETC=1;_SILENCE_STDEXT_HASH_DEPRECATION_WARNINGS;%(PreprocessorDefinitions)</PreprocessorDefinitions>
+    </ClCompile>
+  </ItemDefinitionGroup>
+  <ItemDefinitionGroup Condition="'$(Platform)' == 'Win32'">
+    <ClCompile>
+      <PreprocessorDefinitions>_HAS_AUTO_PTR_ETC=1;_SILENCE_STDEXT_HASH_DEPRECATION_WARNINGS;%(PreprocessorDefinitions)</PreprocessorDefinitions>
+    </ClCompile>
+    <Link>
+      <AdditionalLibraryDirectories>$(MSBuildThisFileDirectory)src\external\3rd\library\stlport453\lib\win32;%(AdditionalLibraryDirectories)</AdditionalLibraryDirectories>
+    </Link>
+  </ItemDefinitionGroup>
+</Project>
diff --git a/Directory.Build.targets b/Directory.Build.targets
@@ -0,0 +1,57 @@
+<?xml version="1.0" encoding="utf-8"?>
+<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
+  <Target Name="ValidateSwgBuildProperties" BeforeTargets="PrepareForBuild">
+    <Error Condition="'$(SwgAudioBackend)' != 'Juce' and '$(SwgAudioBackend)' != 'Miles'"
+           Text="SwgAudioBackend must be Juce or Miles (received '$(SwgAudioBackend)')." />
+  </Target>
+
+  <PropertyGroup Condition="'$(Platform)' == 'x64'">
+    <OutDir>$(MSBuildThisFileDirectory)src\build\win32\x64\$(Configuration)\</OutDir>
+    <IntDir>$(OutDir)obj\$(MSBuildProjectName)\</IntDir>
+    <SwgOutputSuffix Condition="'$(Configuration)' == 'Release'">r</SwgOutputSuffix>
+    <SwgOutputSuffix Condition="'$(Configuration)' == 'Optimized'">o</SwgOutputSuffix>
+    <SwgOutputSuffix Condition="'$(Configuration)' == 'Debug'">d</SwgOutputSuffix>
+    <TargetName Condition="'$(MSBuildProjectName)' == 'SwgClient'">SwgClient_$(SwgOutputSuffix)</TargetName>
+    <TargetName Condition="'$(MSBuildProjectName)' == 'Direct3d9'">gl05_$(SwgOutputSuffix)</TargetName>
+    <TargetName Condition="'$(MSBuildProjectName)' == 'Direct3d9_ffp'">gl06_$(SwgOutputSuffix)</TargetName>
+    <TargetName Condition="'$(MSBuildProjectName)' == 'Direct3d9_vsps'">gl07_$(SwgOutputSuffix)</TargetName>
+    <TargetName Condition="'$(MSBuildProjectName)' == 'Direct3d11'">gl11_$(SwgOutputSuffix)</TargetName>
+    <TargetName Condition="'$(MSBuildProjectName)' == 'Headless'">gl00_$(SwgOutputSuffix)</TargetName>
+  </PropertyGroup>
+
+  <ItemDefinitionGroup Condition="'$(Platform)' == 'x64'">
+    <ClCompile>
+      <AssemblerListingLocation>$(IntDir)</AssemblerListingLocation>
+      <ObjectFileName>$(IntDir)</ObjectFileName>
+      <PrecompiledHeaderOutputFile>$(IntDir)$(MSBuildProjectName).pch</PrecompiledHeaderOutputFile>
+      <ProgramDataBaseFileName>$(IntDir)$(MSBuildProjectName).pdb</ProgramDataBaseFileName>
+    </ClCompile>
+    <ResourceCompile>
+      <ResourceOutputFileName>$(IntDir)%(Filename).res</ResourceOutputFileName>
+    </ResourceCompile>
+    <Bscmake>
+      <OutputFile>$(IntDir)$(MSBuildProjectName).bsc</OutputFile>
+    </Bscmake>
+  </ItemDefinitionGroup>
+
+  <ItemDefinitionGroup Condition="'$(Platform)' == 'x64' and '$(ConfigurationType)' == 'StaticLibrary'">
+    <Lib>
+      <OutputFile>$(OutDir)$(TargetName)$(TargetExt)</OutputFile>
+    </Lib>
+  </ItemDefinitionGroup>
+
+  <ItemDefinitionGroup Condition="'$(Platform)' == 'x64' and '$(ConfigurationType)' == 'DynamicLibrary'">
+    <Link>
+      <OutputFile>$(OutDir)$(TargetName)$(TargetExt)</OutputFile>
+      <ImportLibrary>$(OutDir)$(TargetName).lib</ImportLibrary>
+      <ProgramDatabaseFile>$(OutDir)$(TargetName).pdb</ProgramDatabaseFile>
+    </Link>
+  </ItemDefinitionGroup>
+
+  <ItemDefinitionGroup Condition="'$(Platform)' == 'x64' and '$(ConfigurationType)' == 'Application'">
+    <Link>
+      <OutputFile>$(OutDir)$(TargetName)$(TargetExt)</OutputFile>
+      <ProgramDatabaseFile>$(OutDir)$(TargetName).pdb</ProgramDatabaseFile>
+    </Link>
+  </ItemDefinitionGroup>
+</Project>
diff --git a/README.md b/README.md
@@ -1,19 +1,60 @@
 # Client/Tools Repo
 This repository contains the source for the SWG Client as well as the tools that support certain aspects of development.
 
-## Build Instructions
-This repository is configured for use with Visual Studio using msbuild/solutions and is currently ONLY compatible with **Visual Studio 2013**. To setup your environment, acquire the community or professional edition (NOT the express edition) of Visual Studio 2013 and clone this repository to your machine. Open Visual Studio 2013 and use `File > Open > Project/Solution` and navigate to the path where you cloned the repository then select the solution file located at `src/build/win32/swg.sln`. Please note that all SWG applications are only compatible with win32.
+## Build Instructions
+The legacy Win32 projects were originally configured for **Visual Studio 2013**. The gameplay client can now be built as Win32 or x64 with both the Direct3D 9 and Direct3D 11 renderer plug-ins. SDL3 multi-controller input is enabled in both architectures. JUCE audio is the default build choice; the legacy Miles path remains selectable.
 
 The project has 3 configurations for building the applications:
 * **Release** which is the version intended for public dissemination and gameplay. You may recognize this as the `_r` in the client name `SwgClient_r.exe`. 
 * **Optimized** which is similar to the release client but has additional options and displays in-game for testing and is ideal for Quality Assurance or Support related activities. For example, this configuration allows for additional options like targeting static world objects, printing object information in the user interface, and releasing the camera from player attachment for custom views.
 * **Debug** which is a development client that has extra features for testing and extensive logging and reporting. This build isn't particularly useful for any present application.
 
-At present, only the `Release` version of the projects will build, but we're working on cleaning up the remainder of the configurations. As a temporary solution to accessing the features of the optimized version, you can set the constant in `production.h` to `0` regardless of the configuration. 
+`Release` is the primary validated configuration. `Optimized` and `Debug` remain available for development and may expose pre-existing tool or third-party dependency issues.
 
-To build the client, find the `SwgClient` project in solution explorer and right click then select `Build`. Note that other projects may have similar names (like `ClientGame`) but these are shared across multiple tools. The actual game client you need for playing the game is the `SwgClient` project.
-
-## Shared Files
+To build the client, find the `SwgClient` project in solution explorer and right click then select `Build`. Note that other projects may have similar names (like `ClientGame`) but these are shared across multiple tools. The actual game client you need for playing the game is the `SwgClient` project.
+
+### Client Build Script
+
+Check the build environment:
+
+```powershell
+.\scripts\Test-ClientBuildPrerequisites.ps1
+```
+
+The required environment is Visual Studio or Build Tools with the selected MSVC toolset, a Windows SDK, and the Microsoft DirectX SDK (June 2010). Architecture-specific SDL3 inputs and the x64 compatibility libraries are vendored under `deps`.
+
+Build the complete Release matrix (Win32 and x64, with DX9 and DX11) using JUCE audio:
+
+```powershell
+.\scripts\Build-Client.ps1
+```
+
+Build a specific architecture and require a specific renderer output:
+
+```powershell
+.\scripts\Build-Client.ps1 -Architecture x86 -Renderer DX9
+.\scripts\Build-Client.ps1 -Architecture x64 -Renderer DX11
+```
+
+Select the legacy audio path instead of the default JUCE backend:
+
+```powershell
+.\scripts\Build-Client.ps1 -Architecture All -AudioBackend Miles
+```
+
+`-Architecture` accepts `x86`, `x64`, or `All`; `-Renderer` accepts `DX9`, `DX11`, or `All`; and `-AudioBackend` accepts `Juce` or `Miles`. A gameplay-client solution build produces its renderer dependencies together, while `-Renderer` controls which output set the script requires and verifies. The script also checks every selected executable and renderer DLL for the expected PE machine type.
+
+JUCE 8 modules are dual-licensed under AGPLv3 or the commercial JUCE license. Distributors must select and comply with an applicable JUCE licensing path; see `src/external/3rd/library/JUCE-8.0.14/LICENSE.md`. A Miles build requires a compatible licensed Miles runtime; the included x64 compatibility stubs satisfy the build but are not a full audio implementation.
+
+SDL input is enabled by default and supports multiple independent controllers. See the [multi-controller input guide](docs/inputreborn.md) for runtime configuration and keymap compatibility.
+
+## Source Style
+
+First-party C and C++ use Allman braces with tab-based indentation. The repository `.clang-format` file is the formatting authority for new and changed first-party source. Vendored dependencies under `deps` and `src/external/3rd` retain their upstream formatting so they remain reviewable against their source releases.
+
+Numeric values that encode a limit, capacity, interval, unit conversion, binary layout, or other policy must use a typed, descriptive `constexpr` instead of an untyped enum or an unexplained literal. Literal values may remain where they are intrinsic to an API, a mathematical identity, an indexed component, or a data table; non-obvious derivations should be documented beside the owning constant.
+
+## Shared Files
 Please note that certain projects and files are prepended with `shared` which means they are files that are used in both the game engine ([the `src` repository](https://github.com/swg-source/src)) and the client. There are many enums, for instance, that must match between the client and server or there may be crashes, errors, unintended functionality or some combination thereof. ***If you make changes to any of these shared files, you must make the changes both in the src and in client-tools.***
 
 ## Deprecated Components

diff --git a/deps/build-prerequisites/manifest.json b/deps/build-prerequisites/manifest.json
@@ -0,0 +1,112 @@
+{
+  "schemaVersion": 1,
+  "profile": "win32-x64-dx9-dx11",
+  "cachePath": "deps/source-cache/build-prerequisites",
+  "visualStudio": {
+    "versionRange": "[18.0,19.0)",
+    "platformToolset": "v145",
+    "workload": "Microsoft.VisualStudio.Workload.VCTools",
+    "requiredComponents": [
+      "Microsoft.Component.MSBuild",
+      "Microsoft.VisualStudio.Component.VC.Tools.x86.x64"
+    ]
+  },
+  "windowsSdk": {
+    "minimumVersion": "10.0.19041.0"
+  },
+  "vendoredInputs": [
+    "deps/win32/include/SDL3/SDL.h",
+    "deps/win32/bin/SDL3.dll",
+    "deps/win32/lib/SDL3.lib",
+    "deps/x64/include/SDL3/SDL.h",
+    "deps/x64/include/libjpeg-turbo/jpeglib.h",
+    "deps/x64/bin/SDL3.dll",
+    "deps/x64/lib/d3d9.lib",
+    "deps/x64/lib/d3dx9.lib",
+    "deps/x64/lib/dinput8.lib",
+    "deps/x64/lib/dpvs.lib",
+    "deps/x64/lib/dsound.lib",
+    "deps/x64/lib/DxErr.lib",
+    "deps/x64/lib/dxguid.lib",
+    "deps/x64/lib/jpeg-static.lib",
+    "deps/x64/lib/lcdui.lib",
+    "deps/x64/lib/libEverQuestTCG.lib",
+    "deps/x64/lib/libMozilla.lib",
+    "deps/x64/lib/libxml2.lib",
+    "deps/x64/lib/pcre.lib",
+    "deps/x64/lib/SDL3.lib",
+    "deps/x64/lib/vivoxSharedWrapper.lib",
+    "deps/x64/lib/swg-stubs.lib",
+    "deps/x64/lib/graphics-stubs.lib",
+    "deps/x64/lib/tzname_compat.lib",
+    "mss64-stub/mss64.lib",
+    "mss64-stub/mss64.dll",
+    "src/external/3rd/library/JUCE-8.0.14/modules/juce_core/juce_core.cpp",
+    "src/external/3rd/library/JUCE-8.0.14/modules/juce_audio_devices/juce_audio_devices.cpp",
+    "src/external/3rd/library/JUCE-8.0.14/modules/juce_audio_formats/juce_audio_formats.cpp",
+    "src/external/3rd/library/JUCE-8.0.14/modules/juce_audio_formats/codecs/oggvorbis/libvorbis-1.3.7/lib/analysis.c",
+    "src/external/3rd/library/JUCE-8.0.14/modules/juce_audio_formats/codecs/oggvorbis/libvorbis-1.3.7/lib/books/coupled/res_books_51.h",
+    "src/external/3rd/library/JUCE-8.0.14/modules/juce_audio_formats/codecs/oggvorbis/libvorbis-1.3.7/lib/modes/setup_44.h",
+    "src/external/3rd/library/JUCE-8.0.14/modules/juce_audio_formats/codecs/oggvorbis/libvorbis-1.3.7/lib/vorbisfile.c"
+  ],
+  "packages": [
+    {
+      "id": "visual-studio-build-tools",
+      "displayName": "Visual Studio Build Tools 2026",
+      "fileName": "vs_BuildTools.exe",
+      "url": "https://aka.ms/vs/18/stable/vs_BuildTools.exe",
+      "sourceReferenceUrl": "https://aka.ms/vs/stable/vs_BuildTools.exe",
+      "scopes": ["build"],
+      "mutable": true,
+      "bytes": null,
+      "sha256": null,
+      "expectedPublisher": "Microsoft Corporation",
+      "installMode": "visual-studio",
+      "installArguments": [
+        "--quiet",
+        "--wait",
+        "--norestart",
+        "--nocache",
+        "--add",
+        "Microsoft.VisualStudio.Workload.VCTools",
+        "--includeRecommended"
+      ]
+    },
+    {
+      "id": "windows-10-sdk",
+      "displayName": "Windows 10 SDK 10.0.19041",
+      "fileName": "winsdksetup.exe",
+      "url": "https://go.microsoft.com/fwlink/?linkid=2311805",
+      "scopes": ["build"],
+      "mutable": true,
+      "bytes": null,
+      "sha256": null,
+      "expectedPublisher": "Microsoft Corporation",
+      "installMode": "interactive"
+    },
+    {
+      "id": "directx-sdk-june-2010",
+      "displayName": "DirectX SDK (June 2010)",
+      "fileName": "DXSDK_Jun10.exe",
+      "url": "https://download.microsoft.com/download/a/e/7/ae743f1f-632b-4809-87a9-aa1bb3458e31/DXSDK_Jun10.exe",
+      "scopes": ["build"],
+      "mutable": false,
+      "bytes": 599455936,
+      "sha256": "705271DC83BFEE54D9B94E028426E288D5F070784B7446D164F48ECFBB2A02CB",
+      "expectedPublisher": "Microsoft Corporation",
+      "installMode": "interactive"
+    },
+    {
+      "id": "directx-runtime-june-2010",
+      "displayName": "DirectX End-User Runtimes (June 2010)",
+      "fileName": "directx_Jun2010_redist.exe",
+      "url": "https://download.microsoft.com/download/8/4/a/84a35bf1-dafe-4ae8-82af-ad2ae20b6b14/directx_Jun2010_redist.exe",
+      "scopes": ["runtime"],
+      "mutable": false,
+      "bytes": 100275120,
+      "sha256": "053F76DCBB28802E23341B6A787E3B0791C0FA5C8D4D011B1044172DBF89C73B",
+      "expectedPublisher": "Microsoft Corporation",
+      "installMode": "directx-redist"
+    }
+  ]
+}