Author Topic: Modding prerequisites (Visual Studio 2017)  (Read 944 times)

ai_enabled

  • AtomicTorch Founder
  • Hero Member
  • *****
  • Posts: 1169
    • View Profile
Modding prerequisites (Visual Studio 2017)
« on: April 30, 2018, 02:25:36 am »
You can develop mods by using Client or Server, but we suggest to use CryoFall Editor as it including both Client and Server in a single executable (and some other awesome developer features as well)!
If you own the game on Steam you can download CryoFall Editor from Steam.
If you have an atomictorch.com account and own the game you could download CryoFall Editor from My Games and Items page.

  • Install Visual Studio 2017 (any edition, including free Community edition). Enable .NET desktop development, but before continuing installation, please ensure that you've checked ".NET Framework 4.7.1 targeting pack".
  • If you already have VS2017 installed, please launch Visual Studio Installer -> Modify -> Individual components—and ensure that ".NET Framework 4.7.1 targeting pack" is checked and installed.
  • Download and install CryoFall Modding SDK extension for VS2017
  • Extract <game folder>/Core/Core.cpk archive file - you can do this by executing a CMD script located in the same folder. If you prefer to extract it manually (it's a simple Zip archive), please delete the original file after extraction and rename the extracted folder to "Core.cpk".

After that, you can open the game solution file with VS2017. It's located in <game folder>/Core/Core.cpk/.


A few important notes:
  • The CryoFall custom game engine (called Renkei) supports live reloading of C# & XAML code (as well as all the visual and audio assets) so it's not necessary to restart the game to observe the changes!
  • XAML Designer is not supported (though it can work fine in most cases) and it's recommended to disable it (Visual Studio Options, XAML designer, uncheck "Enable XAML Designer").
  • If you want to debug your code with breakpoints, please go to Visual Studio Options, Debugging, uncheck "Require source files to exactly match the original version" (because the game includes C# compiler which performs some code-generation and so resulting C# files do not match the original C# files - but it's not a problem for step-by-step debugging as the C# code lines kept intact).

If you're intending to make just a customized game server (custom rates, etc) and don't want to produce any mods, please follow this guide.

Regards!
« Last Edit: April 10, 2019, 05:11:55 am by ai_enabled »

ai_enabled

  • AtomicTorch Founder
  • Hero Member
  • *****
  • Posts: 1169
    • View Profile
Re: Modding prerequisites (Visual Studio 2017)
« Reply #1 on: April 09, 2019, 06:55:20 am »
The guide has been updated. Enjoy!