ModSync - Chat-Based Mod Synchronization

A plugin for Mage Arena that synchronizes mods between host and clients.

Features

• **Spawns a rune on the floor
• **spawns lightning on the player
• **5 seconds before it can be triggered

How It Works

For Hosts:

1. Say rune mine and it will spawn a rune on the floor and it will have 5 seconds before it can be triggered

For Clients:

1. Say rune mine and it will spawn a rune on the floor and it will have 5 seconds before it can be triggered

Installation

1. Install BepInEx for Mage Arena
2. Place ModSync.dll in the BepInEx/plugins folder

Usage

For Hosts:

• Say rune mine and it will spawn a rune on the floor and it will have 5 seconds before it can be triggered

For Clients:

• Say rune mine and it will spawn a rune on the floor and it will have 5 seconds before it can be triggered

Configuration

public static string modsync = "all"; // Requires matching on both host and client - This is what is considered when syncing lobbies
public static string modsync = "host"; // Only required on host - These do not count for syncing lobbies
public static string modsync = "client"; // Only required on client - These do not count for syncing lobbies

here is an example of how an all mod should act:

namespace ExampleMod
{
    [BepInPlugin("com.example.mymod", "My Example Mod", "1.0.0")]
    [BepInProcess("MageArena.exe")]
    [BepInDependency("com.magearena.modsync", BepInDependency.DependencyFlags.HardDependency)]
    public class ExampleMod : BaseUnityPlugin
    {
        // This mod requires both client and host to have it
        public static string modsync = "all";
        
        private void Awake()
        {
            // ModSync dependency is guaranteed by BepInEx hard dependency
            // If ModSync is not present, this mod won't even load
            Logger.LogInfo("ModSync found! Initializing mod...");
            // Your mod initialization code here
        }
    }
}

Note the Bepinex Hard Dependency. This is REQUIRED for mods that can be considered cheats.

Troubleshooting

Common Issues:

1. Timeout Errors

   • Players without ModSync will timeout after 8-10 seconds.
   • This is expected behavior for players without the mod.

2. Mod Mismatches

   • Check that all required mods are installed. Mods with the "all" tag are considered for syncing.
   • Verify mod versions match between host and client
   • Turn off Lock Lobby if experiencing many mod mismatch issues.

3. Host doesnt have ModSync

   • Two potentional causes here. Either the host doesnt have modsync, or you are not matching the mods/versions of mods of the host.
   • Unfortunately a known bug for the visual alert to be wrong in this instance. Check log if you need detailed reports.

Debugging:

• Enable BepInEx logging to see detailed ModSync messages
• Check the game logs for [ModSync] entries

Donations

Donations are never required, but appreciated. The mod will always remain free and up-to-date.

Support Development

Modding Discord & Support

You can submit issues or questions in the modding discord, on my mod-releases thread.