Skip to content

Eternal-ll/Ethereal-FAF-Client

Repository files navigation

Ethereal FAF Client

Unofficial FAForever client by Eternal-ll, based on C# WPF .NET 8.0 for Windows OS only.

Forum thread: https://forum.faforever.com/topic/4724/ethereal-faf-client-2-0

Legacy client v1.0 source code

Development

Requirements

  • .NET 8.0 SDK
  • Visual Studio 2022 or newer

Configuration

You must create JSON configuration file called "appsettings.Production.json". Configuration must contain servers with OAuth2 secrets to work properly.

  "Servers": [{
    "Name": "Server name",
    "Site": "https://example.com",
    "Lobby": {
      "IsWss": true, -- selector for TCP or WSS connection
      "Url": "wss://ws.faforever.com", -- WSS url
      "Host": null, -- TCP host
      "Port": 0 -- TCP port
    },
    "Replay": {
      "Host": "replay.com",
      "Port": "1000"
    },
    "Relay": {]
      "Host": "lobby.com",
      "Port": "2000"
    },
    "IRC": {
      "Host": "chat.com",
      "Port": "3000"
    },
    "API": "https://api.com/",
    "UserApi": "https://user.com/",
    "Content": "https://content.com/",
    "OAuth": {
      "BaseAddress": "https://auth.com/",
      "ResponseSeconds": 30,
      "ClientId": "", -- OAuth2 client-id
      "Scope": "", -- OAuth2 scope
      "RedirectPorts": [ ] -- localhost ports for OAUth2 callbacks with code
    },
    "Cloudfare": {
      "HMAC": {
        "Secret": "",
        "Param": ""
      }
    }
  }