ACE Development - ACEmulator/ACE GitHub Wiki

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