ACE Development

Code

1. Install Visual Studio 2022
   • Visual Studio minimum required version - VS Community 2022 17.x
   • When installing, the minimum required Workloads are:
     • .NET desktop development
   • When installing, the minimum required .NET desktop development components are:
     • Optional -> Development tools for .NET
   • When installing, the minimum required Individual components are:
     • .NET -> .NET 8.0 Runtime (Long Term Support)
     • .NET -> .NET Framework 4.7.2 targeting pack
     • .NET -> .NET Framework 4.8 SDK
     • .NET -> .NET SDK
     • Cloud, database, and server -> CLR data types for SQL Server
     • Code tools -> ClickOnce Publishing
     • Code tools -> NuGet package manager
     • Code tools -> Text Template Transformation
     • Compilers, build tools, and runtimes -> C# and Visual Basic Roslyn compilers
     • Compilers, build tools, and runtimes -> MSBuild
     • Development activities -> C# and Visual Basic
     • Development activities -> F# language support
   • When installing, the optional .NET desktop development components are:
     • Optional -> .NET profiling tools
     • Optional -> Just-In-Time debugger
2. Install Visual Studio 2019 (LEGACY INSTRUCTIONS)
   • Visual Studio minimum required version - VS Community 2019 16.8
   • When installing, the minimum required Workloads are:
     • .NET desktop development
   • When installing, the minimum required Individual components are:
     • .NET -> .NET 5.0 Runtime
     • .NET -> .NET Core 3.1 Runtime (LTS)
     • .NET -> .NET Framework 4.7.2 targeting pack
     • .NET -> .NET Framework 4.8 SDK
     • .NET -> .NET SDK
     • Cloud, database, and server -> CLR data types for SQL Server
     • Code tools -> Text Template Transformation
     • Compilers, build tools, and runtimes -> C# and Visual Basic Roslyn compilers
     • Compilers, build tools, and runtimes -> MSBuild
     • Development activities -> C# and Visual Basic
   • When installing, the optional Individual components are:
     • Debugging and testing -> .NET profiling tools
     • Debugging and testing -> Just-In-Time debugger
   • When installing, the optional Individual components required to publish are:
     • .NET desktop development -> Optional -> .NET development tools, which includes:
       • Code tools -> NuGet package manager
       • Development activities -> F# langauge support
3. Copy ACE.Server\Config.js.example to ACE.Server\Config.js and modify settings, such as passwords, database connections, file paths, and other server settings.
4. Open ACE.sln with Visual Studio
   • If you have not already, add nuget.org as a nuget package repository (See: https://learn.microsoft.com/en-us/nuget/consume-packages/install-use-packages-visual-studio#package-sources)
   • By default, Visual Studio will add undesirable using statements when you copy/paste text to use as a template. To avoid this, navigate to Tools > Options > Text Editor > C# > Advanced, and Un-Check "Add missing using directives on paste".
   • Build the solution. Your modified Config.js file will be copied to the output folder during the build process.    

Recommended Tools

• SQLYog on Github
• Hex Editor (Hexplorer or 010 Editor are both good)
• ACLogView on Github