Repository files navigation

The client app forMAC

1. Download the latest version fromreleases, or build the application yourself (if you know what you're doing)
2. Add-condebug -conclearlog -usercon -g15 to your TF2 launch options (Right click the game in your library ->Properties...)
3. Add the following lines to yourautoexec.cfg file (learn how to find yours here), substituting for a password of your choice, and save it.

ip 0.0.0.0rcon_password <password>net_start

4. If you use mastercomfig, you will have to put yourautoexec.cfg inside theoverrides folder instead (more information)
5. Launch TF2
6. Run the application
7. Click on the link in your console window or visitlocalhost:1984 in your browser
8. You should get a webpage with the UI in it, prompting for a Steam API key and an RCON password.
9. Get yourself a Steam Web API key fromhere
10. Enter the RCON password you set in your autoexec.
11. When you connect to a match it should show all the players in the match!
12. Navigate tohttps://megaanticheat.com/provision to get a Masterbase API key. You will need to sign in with your Steam account.
13. In the MegaAntiCheat UI, go to the preferences menu on the left sidebar.
14. Put your Masterbase API key into the respective text field.
15. Click the "Agree to TOS" checkbox and read the terms and conditions before agreeing.
16. Now any demo files you record will be automatically streamed to our central server!
17. Enable automatic demo recordings by going into TF2's advanced options and setting "Recording Mode" to "Auto-record all matches"

• Rcon connection error in the console window
  • Ensure yourautoexec.cfg is executing properly
  • Check step 4 ofUsage steps if you use Mastercomfig
  • Make sure you haven't accidentally made itautoexec.cfg.txt (you might need toshow file extensions)
  • When you launch TF2, open your console and look for a line that looks likeNetwork: IP 0.0.0.0, mode MP, dedicated No, ports 27015 SV / 27005 CL
    • If you see this line,autoexec.cfg it is being executed
    • If you do not have this line in your console, yourautoexec.cfg is not being executed
  • Restart TF2, then paste these commands into your console manually, substituting<password> with what you put earlier in yourautoexec.cfg file.
    • ip 0.0.0.0,rcon_password <password> andnet_start
    • Restart client-backend and see if it can connect afterwards
    • If it successfully connects after that, yourautoexec.cfg file is not executing
  • Another program may be using that port, you can try change the rcon port that MAC will use
    • This is common if you have installed iTunes before
    1. Add-port 27069 to your TF2 launch options
    2. In the web UI, go to settings and change the port number to27069
    3. Restart TF2 and client-backend
• RCon authentication error
  • Your rcon password is not being accepted
  • Try change the password you set in yourautoexec.cfg and update it in the web UI
  • Choose a password that does not contain any spaces or special characters, a single word is fine
  • The password is required to be set but does not have to be secure as nobody else will have access to your Rcon
• No players show up in the UI when I join a match
  • Check for an Rcon connection error in the console window and follow the steps above
• Missing launch options, but I'm not
  • Run the application with the flag--ignore-lanch-opts
• "No UI is bundled with this version of the app" or Error 404
  • Use the executable fromreleases
  • If you have compiled the program yourself andwant to compile it yourself
    • Run the appropriateinclude_ui script before compiling the application
    • This will requireNode to be installed, potentially among other things
    • Make sure it runs properly and doesn't throw any errors, if it does you can delete everything in theui folder and theui_temp folder if it exists
• Can't locate TF2 directory
  • Use the command suggested in the error
• Can't locate Steam directory
  • If you have previously installed Steam via Flatpak, ensure there are no residual files
  • May be in~/.var/app/
• I can't get an API key because I haven't bought any games
  • Only premium steam accounts (an account that has purchased something on it) can be issued Steam Web API keys
  • You can enter an empty key to the UI to skip adding a key, the app will still provide most functionality but will not have some features (such as looking up the steam profiles of players)

Documentation for the API can be found athttps://github.com/MegaAntiCheat/client-backend/wiki/API-Specification

Config files for the application can be found at:

• Windows:C:\Users\<Your Name>\AppData\Roaming\MAC\MACClient\config
• Mac OS: TODO - work out what this is, nobody games on MacOS
• Linux:~/.config/macclient/

1. Install Rust fromhttps://www.rust-lang.org/tools/install
2. Navigate to inside the project folder using your favourite command line interface
3. Build the UI by running the appropriateinclude_ui script, see the UI section below for more information
4. Run withcargo run

To include the provided frontend, run theinclude_ui.sh (linux/mac) orinclude_ui.bat (windows) before building with cargo. Some dependencies will need to be installed, they can be foundhere.

Alternatively, a custom web UI can be built into the project by placing any files in theui folder at compile time, and they will be served from the web interface. The web UI should include anindex.html file as this is where the root URL will redirect to.

File are served starting fromhttp://127.0.0.1:1984/ui/.

Always runcargo fmt and resolve any issues reported bycargo clippy before submitting your Merge Request.