ci: bump SDK version

This avoids restarting the game when encountering an unknown issue.

.vscode/settings.json

@@ -0,0 +1,28 @@
+{
+    "cSpell.words": [
+        "allmaps",
+        "anavoi",
+        "Behaviour",
+        "currentmap",
+        "Dont",
+        "Gaboule",
+        "gamemode",
+        "GBSU",
+        "gmenu",
+        "hlapi",
+        "maplist",
+        "netstandard",
+        "Newtonsoft",
+        "playercount",
+        "protontricks",
+        "rotationconfig",
+        "serverip",
+        "serverpassword",
+        "serverport",
+        "vsync",
+        "winecfg",
+        "WINEDLLOVERRIDES",
+        "winhttp",
+        "ZeroTier"
+    ]
+}

Addons/GBSUClient.cs

@@ -0,0 +1,32 @@
+using GB.Core;
+using GB.Networking.Utils;
+using GB.Platform.Lobby;
+using UnityEngine;
+
+namespace GBSU.Addons;
+
+public class GBSUClient : MonoBehaviour
+{
+    public static void JoinServer(string serverip, int serverport)
+    {
+        if (!Helper.hosting)
+        {
+            LobbyManager.Instance.LobbyStates.IP = serverip;
+            LobbyManager.Instance.LobbyStates.Port = serverport;
+            LobbyManager.Instance.LobbyStates.CurrentState = LobbyState.State.Ready | LobbyState.State.InGame;
+            LobbyManager.Instance.LocalBeasts.SetupNetMemberContext(true);
+            MonoSingleton<Global>.Instance.UNetManager.LaunchClient(serverip, serverport);
+        }
+        else
+        {
+            GBSUGui.PushError("You are currently hosting a game! Please stop your server before attempting to join.");
+        }
+    }
+
+    // this method should be used when something has went wrong
+    // because players can just use the escape menu to exit
+    public static void DisconnectFromServer()
+    {
+        GBNetUtils.DisconnectSelf(false);
+    }
+}

Addons/GBSUGui.cs

@@ -1,10 +1,7 @@
+using System;
+using System.IO;
 using BepInEx;
-using CoreNet.Config;
-using GB.Config;
-using GB.Core;
-using GB.Game;
 using GB.Platform.Lobby;
-using HarmonyLib;
 using UnityEngine;
 
 #pragma warning disable IDE0051 // Private member is unused
@@ -14,28 +11,13 @@ namespace GBSU.Addons;
 public class GBSUGui : MonoBehaviour
 {
     private bool menu_shown;
+    private static bool error_shown;
     //private string _currentMap;
     public Rect gmenu = new(Screen.width / 2, 0, 385f, 690f);
+    public Rect error_dialog = new(Screen.width / 2, 0, 520f, 175f);
+    private static string error_msg = "Unknown error!";
 
     readonly IInputSystem inputSystem = UnityInput.Current;
-    string serverip = null;
-    int serverport = 0;
-    string currentmap;
-    int vsync_switch;
-    bool hosting = false;
-    private void Start()
-    {
-        if (CommandLineParser.Instance.KeyExists("-ip"))
-        {
-            serverip = CommandLineParser.Instance.GetValueForKey("-ip", true);
-        }
-        if (CommandLineParser.Instance.KeyExists("-port"))
-        {
-            int.TryParse(CommandLineParser.Instance.GetValueForKey("-port", true), out serverport);
-        }
-
-        vsync_switch = QualitySettings.vSyncCount;
-    }
     private void Update()
     {
         if (inputSystem.GetKeyDown(KeyCode.RightShift))
@@ -43,8 +25,6 @@ public class GBSUGui : MonoBehaviour
             //Plugin.Log.LogInfo("Toggling GBSU menu...");
             ToggleMenu();
         }
-
-        currentmap = UnityEngine.SceneManagement.SceneManager.GetActiveScene().name;
     }
 
     private void ToggleMenu()
@@ -66,7 +46,7 @@ public class GBSUGui : MonoBehaviour
         GUI.skin.label.alignment = TextAnchor.UpperLeft;
 
         GUILayout.Label($@"==Guide==
-Set CLI arguments: -ip, -port, -servername, -serverpassword
+Set CLI arguments: -ip, -port (optionally -maplist)
 
 [Hosting]
 1. Create a config in Gang Beasts_Data/Config/Rotation/config.json
@@ -79,40 +59,53 @@ Set CLI arguments: -ip, -port, -servername, -serverpassword
         {
             Application.Quit(0);
         }
-        if (serverip != null && serverport != default)
+        if (GUI.Button(new Rect(320f, 45f, 55f, 30f), "Menu"))
+        {
+            Helper.SwitchToMenu();
+        }
+        if (Helper.serverip != null)
         {
             if (GUI.Button(new Rect(20f, 260f, 170f, 30f), "Host"))
             {
                 if (LobbyManager.Instance.LobbyStates.SelfState == LobbyState.Game.Menu)
                 {
-                    hosting = true;
+                    if (File.Exists(Helper.GameConfigPath))
-                    
+                    {
-                    AudioListener.volume = 0; // mute game audio
+                        try
-
+                        {
-                    Plugin.AddServerComp(); // add custom GBSU server component
+                            GBSUServer.StartServer();
-
+                        }
-                    RotationConfig gameConfig = GBConfigLoader.LoadRotationConfig("config.json", true); // load rotation config from Config/Rotation/config.json
+                        catch (Exception e)
-                    ServerConfig serverConfig = NetConfigLoader.LoadServerConfig(); // load default server config, becauuse it can be overrided by args like -ip and -port
+                        {
-                    MonoSingleton<Global>.Instance.UNetManager.LaunchServer(serverConfig); // launch the server with the server config
+                            PushError("Looks like you've caught a bug! Please send your log file to us :)\n" + e);
-                    MonoSingleton<Global>.Instance.UNetManager.GetComponent<GameManagerNew>().ChangeRotationConfig(gameConfig, 0); // set server's rotationconfig
+                            GBSUServer.StopServer();
+                        }
+                    }
+                    else
+                    {
+                        PushError(@$"No config.json could be found in {Helper.RotationFolderPath}
+Make sure to download a file from the examples given and rename it to config.json.
+{Helper.FilesInRotationDir()}");
+                    }
+                }
+                else
+                {
+                    PushError("Please stay on the main menu to begin hosting. Tip: You might need to exit your lobby.");
                 }
             }
             if (GUI.Button(new Rect(195f, 260f, 170f, 30f), "Join"))
             {
                 if (LobbyManager.Instance.LobbyStates.SelfState == LobbyState.Game.Online)
                 {
-                    if (!hosting && serverip != null && serverport != 0)
+                    GBSUClient.JoinServer(Helper.serverip, Helper.serverport);
-                    {
+                }
-                        LobbyManager.Instance.LobbyStates.IP = serverip;
+                else
-                        LobbyManager.Instance.LobbyStates.Port = serverport;
+                {
-                        LobbyManager.Instance.LobbyStates.CurrentState = LobbyState.State.Ready | LobbyState.State.InGame;
+                    PushError("Failed to join lobby! Please select the Online option in-game before joining.");
-                        LobbyManager.Instance.LocalBeasts.SetupNetMemberContext(true);
-                        MonoSingleton<Global>.Instance.UNetManager.LaunchClient(serverip, serverport);
-                    }
-
                 }
             }
         }
+
         if (GUI.Button(new Rect(20f, 295f, 170f, 30f), "Cap FPS to 60"))
         {
             Application.targetFrameRate = 60;
@@ -123,38 +116,49 @@ Set CLI arguments: -ip, -port, -servername, -serverpassword
         }
         if (GUI.Button(new Rect(20f, 330f, 170f, 30f), "Toggle VSync"))
         {
-            if (vsync_switch == 0)
+            Helper.FlipVSync();
-            {
-                vsync_switch = 1;
-            }
-            else
-            {
-                vsync_switch = 0;
-            }
-
-            QualitySettings.vSyncCount = vsync_switch;
         }
-        
+        if (Helper.hosting)
+        {
+            if (GUI.Button(new Rect(195f, 330f, 170f, 30f), "Stop server"))
+            {
+                GBSUServer.StopServer();
+            }
+        }
+
         GUI.Label(new Rect(20f, 365f, 365f, 400f), $@"
 
-Current map: {currentmap}
+Current map: {UnityEngine.SceneManagement.SceneManager.GetActiveScene().name}
 Lobby State: {LobbyManager.Instance.LobbyStates.SelfState}
-Vsync: {QualitySettings.vSyncCount}
+VSync: {QualitySettings.vSyncCount}
 Target FPS: {Application.targetFrameRate}
 {UpdateScoreDisplay()}
 
 
 Made with <3 by anavoi at Gaboule Community
 Free and open-source software under GPLv3.
-Our source code is availaible at git.gaboule.com/Gaboule/GBSU
+Our source code is available at git.gaboule.com/Gaboule/GBSU
 Please refer to the documentation for more information.");
 
         GUI.DragWindow(new Rect(0, 0, 10000, 10000));
     }
 
+    private void ShowError(int window)
+    {
+        GUI.skin.label.alignment = TextAnchor.MiddleCenter;
+
+        GUILayout.Label(error_msg);
+
+        if (GUI.Button(new Rect(420f, 135f, 85f, 30f), "Close"))
+        {
+            error_shown = false;
+        }
+
+        GUI.DragWindow(new Rect(0, 0, 10000, 10000));
+    }
     private string UpdateScoreDisplay()
     {
-        if (hosting)
+        if (Helper.hosting)
         {
             string scoreString = "Score:\n";
             foreach (var pair in Plugin.GameScore)
@@ -166,11 +170,25 @@ Please refer to the documentation for more information.");
         return null;
     }
 
+    public static void PushError(string message)
+    {
+        Plugin.Log.LogError(message);
+
+        // Push this error to the UI
+        error_msg = message;
+        error_shown = true;
+    }
+
     public void OnGUI()
     {
         if (menu_shown)
         {
-            gmenu = GUILayout.Window(121, gmenu, ShowOurWindow, $"{Plugin.PluginName} [{Plugin.PluginVersion}]");
+            gmenu = GUILayout.Window(121, gmenu, ShowOurWindow, $"{MyPluginInfo.PLUGIN_NAME} [{MyPluginInfo.PLUGIN_VERSION}]");
+        }
+
+        if (error_shown)
+        {
+            error_dialog = GUILayout.Window(122, error_dialog, ShowError, "An error occurred!");
         }
     }
-}
+}

Addons/GBSUServer.cs

@@ -1,3 +1,6 @@
+using CoreNet.Config;
+using GB.Config;
+using GB.Core;
 using GB.Game;
 using HarmonyLib;
 using UnityEngine;
@@ -23,12 +26,45 @@ public class GBSUServer : MonoBehaviour
         //_gmInit = AccessTools.Method(typeof(GameMode), "Init");
         localSingleGang = Traverse.Create(nameof(GameMode)).Field("localSingleGang");
         gameTimer = Traverse.Create(nameof(GameMode)).Field("timer");
+
+        AudioListener.volume = 0; // mute game audio
     }
     void SetLocalGangToOff()
     {
-        localSingleGang.SetValue(false);
+        localSingleGang?.SetValue(false);
     }
 
+    public static void StartServer()
+    {
+        if (!Helper.hosting)
+        {
+            Helper.hosting = true;
+
+            Plugin.AddServerComp(); // add custom GBSU server component
+
+            RotationConfig gameConfig = GBConfigLoader.LoadRotationConfig(null); // the argument doesn't matter as we do stuff in the method
+            ServerConfig serverConfig = NetConfigLoader.LoadServerConfig(); // load default server config, because it can be overridden by args like -ip and -port
+            MonoSingleton<Global>.Instance.UNetManager.LaunchServer(serverConfig); // launch the server with the server config
+            MonoSingleton<Global>.Instance.UNetManager.GetComponent<GameManagerNew>().ChangeRotationConfig(gameConfig, 0); // set server's rotationconfig
+        }
+    }
+
+    public static void StopServer()
+    {
+        // WIP: At the moment the only way to stop the server is to exit/kill the game
+        Helper.hosting = false;
+
+        AudioListener.volume = Helper.saved_volume; // restore volume
+
+        // stop network listener
+        MonoSingleton<Global>.Instance.UNetManager.StopServer();
+
+        // destroy GBSU server comp
+        Plugin.DestroyServerComp();
+
+        // go back to main menu
+        Helper.SwitchToMenu();
+    }
     /*
     public string GetRemainingRoundTime()
     {

Addons/Helper.cs

@@ -1,9 +1,21 @@
 using System;
+using System.IO;
+using GB.Core;
+using GB.Networking.Utils;
+using GB.Platform.Lobby;
+using UnityEngine;
 using UnityEngine.Analytics;
+using UnityEngine.SceneManagement;
 
 namespace GBSU.Addons;
 public class Helper
 {
+    public static string RotationFolderPath = BepInEx.Paths.BepInExRootPath + "/config/GBSU/";
+    public static string GameConfigPath = RotationFolderPath + "config.json";
+    public static string serverip = null;
+    public static int serverport = 5999;
+    public static bool hosting = false;
+    public static float saved_volume;
     public static void DisableAnalytics()
     {
         // Try disabling analytics https://docs.unity3d.com/ScriptReference/Analytics.Analytics-deviceStatsEnabled.html
@@ -14,7 +26,93 @@ public class Helper
         }
         catch (Exception e)
         {
-            Plugin.Log.LogInfo("Failed to disable analytics: " + e.Message);
+            Plugin.Log.LogWarning("Failed to disable analytics: " + e.Message);
         }
     }
-}
+    public static void CreateRotationFolder()
+    {
+        try
+        {
+            Plugin.Log.LogInfo("Creating rotation folder at " + RotationFolderPath);
+            Directory.CreateDirectory(RotationFolderPath);
+        }
+        catch (Exception e)
+        {
+            Plugin.Log.LogError("Could not create rotation folder path: " + e.Message);
+        }
+    }
+    public static string FilesInRotationDir()
+    {
+        // https://stackoverflow.com/a/14877330
+        DirectoryInfo d = new(RotationFolderPath);
+        FileInfo[] files = d.GetFiles();
+        int number = files.Length;
+
+        // no files?
+        if (number == 0)
+        {
+            return @"No files were found in the directory.";
+        }
+        else
+        {
+            string names = "";
+
+            foreach (FileInfo file in files)
+            {
+                names = file.Name + " " + names;
+            }
+
+            return $"There are {number} files: {names}";
+        }
+    }
+
+    public static void FlipVSync()
+    {
+        if (QualitySettings.vSyncCount == 0)
+        {
+            QualitySettings.vSyncCount = 1;
+        }
+        else
+        {
+            QualitySettings.vSyncCount = 0;
+        }
+    }
+
+    public static void CheckCustomRotationPath()
+    {
+        // Did the host request to use their own rotation config path?
+        if (CommandLineParser.Instance.KeyExists("-maplist"))
+        {
+            GameConfigPath = CommandLineParser.Instance.GetValueForKey("-maplist");
+            Plugin.Log.LogInfo("Set custom rotation config path at " + GameConfigPath);
+        }
+    }
+
+    public static void SwitchToMenu()
+    {
+        if (hosting)
+        {
+            GBSUGui.PushError("Please press the Stop server button instead!");
+        }
+        else
+        {
+            // uhm, time to panic!
+
+            // let's begin by disconnecting if theres an active connection
+            try
+            {
+                GBNetUtils.DisconnectSelf(false);
+            }
+            catch (Exception e)
+            {
+                Plugin.Log.LogWarning("Couldn't disconnect from server:\n" + e);
+            }
+
+            // go back to main menu
+            SceneManager.LoadScene(Global.MENU_SCENE_NAME);
+
+            // make sure our lobby state is menu
+            LobbyManager.Instance.LobbyStates.SelfState = LobbyState.Game.Menu;
+        }
+    }
+}

GBSU.csproj

@@ -4,7 +4,7 @@
     <TargetFramework>netstandard2.0</TargetFramework>
     <AssemblyName>GBSU</AssemblyName>
     <Product>Gang Beasts Server Utility</Product>
-    <Version>1.0.1</Version>
+    <Version>1.1.0</Version>
     <AllowUnsafeBlocks>true</AllowUnsafeBlocks>
     <LangVersion>latest</LangVersion>
     <RestoreAdditionalProjectSources>
@@ -21,7 +21,7 @@
     <PackageReference Include="BepInEx.PluginInfoProps" Version="2.*" />
     <PackageReference Include="UnityEngine.Modules" Version="2020.3.5" IncludeAssets="compile" />
   </ItemGroup>
-  
+
   <ItemGroup Condition="'$(TargetFramework.TrimEnd(`0123456789`))' == 'net'">
     <PackageReference Include="Microsoft.NETFramework.ReferenceAssemblies" Version="1.0.2" PrivateAssets="all" />
   </ItemGroup>
@@ -42,5 +42,8 @@
   <Reference Include="UnityEngine.CoreModule">
     <HintPath>ref/UnityEngine.CoreModule.dll</HintPath>
   </Reference>
+  <Reference Include="Newtonsoft.Json.dll">
+    <HintPath>ref/Newtonsoft.Json.dll</HintPath>
+  </Reference>
   </ItemGroup>
 </Project>

Patches/ConfigLoader.cs

@@ -0,0 +1,35 @@
+using System;
+using System.IO;
+using GB.Config;
+using GBSU.Addons;
+using HarmonyLib;
+using Newtonsoft.Json;
+
+namespace GBSU.Patches;
+
+[HarmonyPatch]
+class ConfigLoaderPatch
+{
+    [HarmonyPatch(typeof(GBConfigLoader), "LoadRotationConfig")]
+    private static bool Prefix(ref RotationConfig __result)
+    {
+        string text = ""; // contents of file
+
+        Plugin.Log.LogInfo("Loading custom rotation config...");
+
+        // Reading from file
+        try
+        {
+            text = File.ReadAllText(Helper.GameConfigPath);
+            Plugin.Log.LogDebug("Provided rotation config:\n" + text);
+            RotationConfig rc = JsonConvert.DeserializeObject<RotationConfig>(text);
+            __result = rc;
+        }
+        catch (Exception e)
+        {
+            GBSUGui.PushError("Couldn't read game config file. A few details:\n" + e);
+        }
+
+        return false; // skip
+    }
+}

Patches/MultiplayerPatches.cs

@@ -50,7 +50,6 @@ class HandleScorePatch
             Plugin.Log.LogDebug("Done processing all scores!");
         }
 
-        Plugin.Log.LogInfo("Not letting HandleScore run...");
         return false;
     }
 }

Plugin.cs

@@ -1,71 +1,108 @@
-using System.Collections.Generic;
+using System.Collections.Generic;
-using System.Reflection;
+using System.Reflection;
-using BepInEx;
+using BepInEx;
-using BepInEx.Logging;
+using BepInEx.Logging;
-using GBSU.Addons;
+using GBSU.Addons;
-using HarmonyLib;
+using HarmonyLib;
-using HarmonyLib.Tools;
+using HarmonyLib.Tools;
-using UnityEngine;
+using UnityEngine;
-
+
-#pragma warning disable IDE0051 // Private member is unused
+#pragma warning disable IDE0051 // Private member is unused
-
+
-namespace GBSU;
+namespace GBSU;
-
+
-[BepInPlugin(PluginGUID, PluginName, PluginVersion)]
+[BepInPlugin(MyPluginInfo.PLUGIN_GUID, MyPluginInfo.PLUGIN_NAME, MyPluginInfo.PLUGIN_VERSION)]
-[BepInProcess("Gang Beasts.exe")]
+[BepInProcess("Gang Beasts.exe")]
-public class Plugin : BaseUnityPlugin
+public class Plugin : BaseUnityPlugin
-{
+{
-    public static Dictionary<string, int> GameScore = [];
+    public static Dictionary<string, int> GameScore = [];
-    private static GameObject _gbsuCompContainer;
+    private static GameObject _gbsuCompContainer;
-    internal static ManualLogSource Log;
+    internal static ManualLogSource Log;
-    
+
-    public static GameObject GBSUCompContainer
+    public static GameObject GBSUCompContainer
-    {
+    {
-        get
+        get
-        {
+        {
-            if (_gbsuCompContainer == null)
+            if (_gbsuCompContainer == null)
-            {
+            {
-                _gbsuCompContainer = new GameObject("GBSUSingletons");
+                _gbsuCompContainer = new GameObject("GBSUSingletons");
-            }
+            }
-
+
-            return _gbsuCompContainer;
+            return _gbsuCompContainer;
-        }
+        }
-        set
+        set
-        {
+        {
-            Destroy(_gbsuCompContainer);
+            Destroy(_gbsuCompContainer);
-            _gbsuCompContainer = value;
+            _gbsuCompContainer = value;
-        }
+        }
-    }
+    }
-    private void Awake()
+    private void Awake()
-    {
+    {
-        // Plugin startup logic
+        // Plugin startup logic
-        Log = base.Logger;
+        Log = base.Logger;
-        Log.LogInfo($"\n------\nPlugin {PluginName} [{PluginVersion}] is loaded!\n------\n");
+        Log.LogInfo($"\n------\nPlugin {MyPluginInfo.PLUGIN_NAME} [{MyPluginInfo.PLUGIN_VERSION}] is loaded!\n------\n");
-
+
-        HarmonyFileLog.Enabled = true;
+        HarmonyFileLog.Enabled = true;
-        var harmony = new Harmony(PluginGUID);
+        var harmony = new Harmony(MyPluginInfo.PLUGIN_GUID);
-        harmony.PatchAll(Assembly.GetExecutingAssembly());
+        harmony.PatchAll(Assembly.GetExecutingAssembly());
-
+
-        GBSUCompInit();
+        GBSUCompInit();
-
+
-        Helper.DisableAnalytics(); // thank me later
+        Helper.DisableAnalytics(); // thank me later
-    }
+
-
+        // create server config path
-    private static void GBSUCompInit()
+        Helper.CreateRotationFolder();
-    {
+
-        // Create a container that wont lose our objects
+        Log.LogDebug("Server game config should be found at " + Helper.GameConfigPath);
-        GBSUCompContainer = new GameObject("GBSUSingletons");
+
-        DontDestroyOnLoad(GBSUCompContainer);
+        // Parse CLI arguments
-        GBSUCompContainer.hideFlags = HideFlags.DontUnloadUnusedAsset;
+        if (CommandLineParser.Instance.KeyExists("-ip"))
-        GBSUCompContainer.AddComponent<GBSUGui>();
+        {
-    }
+            Helper.serverip = CommandLineParser.Instance.GetValueForKey("-ip", false);
-
+        }
-    public static void AddServerComp()
+        else
-    {
+        {
-        GBSUCompContainer.AddComponent<GBSUServer>();
+            GBSUGui.PushError("Couldn't find the -ip CLI argument. Please refer to the documentation.");
-    }
+        }
-
+        if (CommandLineParser.Instance.KeyExists("-port"))
-    public const string PluginGUID = "com.gaboule.plugins.gbsu";
+        {
-    public const string PluginName = "Gang Beasts Server Utility";
+            int.TryParse(CommandLineParser.Instance.GetValueForKey("-port", false), out Helper.serverport);
-    public const string PluginVersion = "1.0.1";
+        }
-}
+
+        // "-maplist" CLI
+        Helper.CheckCustomRotationPath();
+
+        // store app volume in a variable to restore it if needed
+        Helper.saved_volume = AudioListener.volume;
+    }
+
+    private static void GBSUCompInit()
+    {
+        // Create a container that wont lose our objects
+        GBSUCompContainer = new GameObject("GBSUSingletons");
+        DontDestroyOnLoad(GBSUCompContainer);
+        GBSUCompContainer.hideFlags = HideFlags.DontUnloadUnusedAsset;
+        GBSUCompContainer.AddComponent<GBSUGui>();
+    }
+
+    public static void AddServerComp()
+    {
+        DestroyServerComp();
+        Log.LogDebug("Adding GBSUServer component");
+        GBSUCompContainer.AddComponent<GBSUServer>();
+    }
+
+    public static void DestroyServerComp()
+    {
+        Component[] comps = GBSUCompContainer.GetComponents(typeof(Component));
+        foreach (var comp in comps)
+        {
+            Log.LogDebug("iterating thru singleton comps");
+            if (comp is GBSUServer)
+            {
+                Log.LogDebug("GBSUServer component was found! Destroying it");
+                Destroy(comp);
+            }
+        }
+    }
+}

README.md

@@ -4,7 +4,7 @@ This mod allows you to connect to a Gang Beasts server in recent versions (throu
 **NOTICE: This is not a "Cement" mod, and we don't want to be affiliated with their developers. This mod is standalone, and will work best on its own!**
 
 # Features
-- LAN (ethernet switches at LAN parties) and Online (port forwarding, Zerotier, Wireguard) multiplayer
+- LAN (Ethernet switches at LAN parties) and Online (port forwarding, ZeroTier, Wireguard) multiplayer
 - Custom score handling made by the server (we don't want to use the game's score handler)
 
 # Installation
@@ -31,11 +31,13 @@ Press `Right Shift` to open the mod GUI. Because of how the game is made, you ne
 
 ## Server (host)
 ### Setting up the server
-1. Open the `Gang Beasts_Data` folder in the "server" game instance files.
+1. Open the `BepInEx` folder in the "server" game instance files.
-2. Create two new folders: `Config/Rotation`
+2. Create a `GBSU` folder in `config`.
-3. Download the [one of the config files](https://git.gaboule.com/Gaboule/GBSU/src/branch/main/docs/configs) and place it inside the `Rotation` folder.
+3. Download the [one of the config files](https://git.gaboule.com/Gaboule/GBSU/src/branch/main/docs/configs) and place it inside the `GBSU` folder.
 4. Rename the file to `config.json`
 
+**Tip: your config file can also be anywhere else! Use the -maplist argument followed by the path to the file,** for example `-ip 192.168.1.2 -port 5999 -maplist "/home/user/mycustomconfig.json"`
+
 ### Configuring your custom server settings
 * If you set `"random": true`, the map order will be randomized.
 * Some maps may have different names in-game compared to their actual titles. Make sure to refer to the [`allmaps` configs](https://git.gaboule.com/Gaboule/GBSU/src/branch/main/docs/configs) for the map names.
@@ -45,7 +47,7 @@ Once the config file is in place, host your server by pressing the **Host** butt
 
 ## Client (player)
 1. In the game menu, choose **Online**.
-2. If you're planning to team up with friends, make sure your [server config]() is set to the `gang` gamemode and choose a shared color. Otherwise, use a different color than your friends.
+2. If you're planning to team up with friends, make sure your server config is set to the `gang` gamemode and choose a shared color. Otherwise, use a different color than your friends.
 3. Open the mod menu and press **Join**.
 
 # Troubleshooting
@@ -62,8 +64,19 @@ On Steam, simply put `WINEDLLOVERRIDES="winhttp.dll=n,b" %command%` in your laun
 
 If it's still not working, try using `winecfg` for your prefix or `protontricks` and go to the libraries tab in Wine Configuration. Simply add `winhttp` as an override and check if it's correctly set as "native, then builtin" (or "n,b").
 
+# Known issues
+- This mode uses the game's netcode. It is poorly made, and you get noticeable latency on localhost (RTT is 10ms). It seems that there's no client-side prediction.
+- The custom score handler only tracks through colors, and is only visible on the host side.
+
+# Contact us
+## Need help?
+Ask us on [Matrix](https://matrix.to/#/#gbsu:gaboule.com).
+
+## Feature requests or bug reports
+Want a new feature? Found a bug? [Open an issue!](https://git.gaboule.com/Gaboule/GBSU/issues) Please note that a Gaboule account is currently required. This will change once Forgejo supports federation. Alternatively, feel free to reach out to us for general feedback or questions.
+
 # Developer information
 - The mod is made for BepInEx 5
 - The targeted Unity version is `2020.3.5f1`
 - The TFM is `netstandard2.0`
-- The mod is built using .NET SDK `9.0.103`
+- The mod is built using .NET SDK `9.0.304`