build_run_pin_ff.md

Table of Contents

1. Some Notes
2. Getting and Installing Visual Studio
   1. Download
   2. Install
3. Opening and Building PIN In Visual Studio
   1. Github repository URL
   2. Opening repository in Visual Studio
   3. Building PIN
   4. Final Setup for PIN
      1. Setup Multiple Startup Projects
      2. Enable developer certificates
      3. Running
4. Editing firefall.ini for PIN’s Servers
5. Running Firefall

Some Notes

• PIN is not supported
• Expect issues and brokenness, consider it a “demo”
• This installation is about 10GB not including Firefall itself
• Downloading PIN as zip will not work
• The Melding Wars site
• PIN GitHub Repository
• The Melding Wars GitHub Organization

Getting and Installing Visual Studio

Download

• Grab Visual Studio Community 2019 from https://visualstudio.microsoft.com/vs/

Install

• Just continue through the install without selecting any “Workloads” or “Components”
• Skip sign in or not
• Select any theme
• Complete installation

Opening and Building PIN In Visual Studio

Github repository URL

• Copy the PIN repository URL from Github https://github.com/themeldingwars/PIN

• Optionally copy the repository url here: https://github.com/themeldingwars/PIN.git

Opening repository in Visual Studio

• Start Visual Studio if it isn’t running
• Select “Clone a repository”
• Paste the repository URL into “Repository Location” NOTE: The URL should end with .git
• Click “Clone” and give it a few seconds to load the project
• You should see the following:

• If not, select the “Solution Explorer” tab at the bottom

Building PIN

• Double click “PIN.sln” in “Solution Explorer”
• You should see a prompt like the following:

• Hit “Install” and install, this will grab the needed components to build PIN
• After the installation is complete and Visual Studio has restarted, right click “Solution ‘PIN’” in the Solution Explorer and “Build Solution”

• Give it a bit and you should see the following in the lower output section, indicating the build was successful ========== Build: 18 succeeded, 0 failed, 0 up-to-date, 0 skipped ==========

Final Setup for PIN

Setup Multiple Startup Projects

• Select “Set Startup Projects” under the “Project” menu item

• Select “Multiple startup projects” and set “Action” to “Start” for the following:
  1. GameServer
  2. MatrixServer
  3. WebHostManager

• Hit “Apply” and “OK”

Enable developer certificates

• Open cmd.exe and type or paste in: dotnet dev-certs https --trust
• Install the certificate

Running

• Finally, click the “Start” button near the top of Visual Studio, 3 console windows should appear like so

• Congratulations! PIN is now running!

Editing firefall.ini for PIN’s Servers

• Navigate to the Steam’s installation of Firefall (eg. C:\Program Files (x86)\Steam\steamapps\common\Firefall)
• Open firefall.ini with notepad or whatever and add the following:

  [Config]
  OperatorHost = "localhost:4400"
  
  [FilePaths]
  AssetStreamPath = "http://localhost:4401/AssetStream/%ENVMNEMONIC%-%BUILDNUM%/"
  VTRemotePath = "http://localhost:4401/vtex/%ENVMNEMONIC%-%BUILDNUM%/static.vtex"
  
  [UI]
  PlayIntroMovie = false

Running Firefall

• Navigate to system\bin\ from the Firefall directory and run FirefallClient.exe
• If Firefall fails to run you’ll need the patched executable
  • It can be downloaded from https://files.catbox.moe/6h96mi.zip
  • If the download URL is dead you can obtain it from the Discord server
  • MD5 and SHA256 checksums are below

    ~/ff_patched🔥 md5sum PatchedClient.exe && sha256sum PatchedClient.exe
    7ae15b1bae8ae53cf24d2596061356ad  PatchedClient.exe
    e4e0f44267f9ab398ffafd3a970a099d7059aed7628bb3a690ab07b17dcc8797  PatchedClient.exe

  • Drop PatchedClient.exe into the bin\ directory (same as FirefallClient.exe)
• Now start Firefall via PatchedClient.exe
• Optionally, rename FirefallClient.exe to FirefallClientBACKUP.exe and PatchedClient.exe to FirefallClient.exe, in order to launch from Steam
• FINALLY! At the login screen within Firefall, put anything into the login form and login.
• Enjoy.