---
title: Unity Crossfire Plugin
description: "Github URL: [https://github.com/NamazuStudios/crossfire](https://github.com/NamazuStudios/crossfire) A peer-to-peer networking plugin for Unity built on Unity Netcode for GameObjects and Unity [WebRTC](https://namazustudios.com/glossary/webrtc/). It handles [WebRTC](https://namazustudios.com/glossary/webrtc/) connection negotiation, signaling, host election, and real-time connection monitoring through a single `NetworkSessionManager` component. This plugin requires a running instance of [Crossfire](https://github.com/namazuStudios/crossfire) on [Elements](https://github.com/NamazuStudios/elements). ## Requirements - Unity…"
url: "https://namazustudios.com/docs/game-engine-client-support/unity/crossfire/"
updated: "2026-08-13"
category: "Game Engine & Client Support / Unity"
---

# Unity Crossfire Plugin

Github URL:
[https://github.com/NamazuStudios/crossfire](https://github.com/NamazuStudios/crossfire)

A peer-to-peer networking plugin for Unity built on Unity Netcode for GameObjects and Unity [WebRTC](https://namazustudios.com/glossary/webrtc/). It handles [WebRTC](https://namazustudios.com/glossary/webrtc/) connection negotiation, signaling, host election, and real-time connection monitoring through a single `NetworkSessionManager` component.

This plugin requires a running instance of [Crossfire](https://github.com/namazuStudios/crossfire) on [Elements](https://github.com/NamazuStudios/elements).

## Requirements

- Unity 2022.3 or later
- [Unity Netcode for GameObjects](https://docs-multiplayer.unity3d.com/netcode/current/about/) via Package Manager (`com.unity.netcode.gameobjects`)
- [Unity WebRTC](https://docs.unity3d.com/Packages/com.unity.webrtc@3.0/manual/index.html) via Package Manager (`com.unity.WebRTC`)
- [Newtonsoft Json](https://www.newtonsoft.com/json) via Package Manager (`com.unity.nuget.newtonsoft-json`)
- WebSocket Sharp (pre-compiled, included in the Plugins folder)

## Installation

1. Import the required packages via the Unity Package Manager.
2. Place the `NetworkSessionManager` prefab in your scene, or add a `NetworkSessionManager` component to a GameObject manually.
3. Assign a `NetworkManager` to the `NetworkSessionManager` in the Inspector.
4. Set the `serverHost` field in the `NetworkSessionConfig` to the base URL of your Crossfire server (for example, `ws://localhost:8080/app/ws/crossfire`).

> **Warning:** The `NetworkSessionManager` calls `DontDestroyOnLoad` on startup. To avoid duplicates when reloading scenes, either place it only in a one-time initialization scene, or check for an existing instance before creating one.

## Quick Start

```
public class GameManager : MonoBehaviour
{
    [SerializeField] private NetworkSessionManager sessionManager;

    void Start()
    {
        sessionManager.OnPlayerJoined += player =>
            Debug.Log($"{player.profileId} joined");

        sessionManager.OnAllPlayersConnected += () =>
            Debug.Log("All players ready - start gameplay");

        sessionManager.OnConnectionError += error =>
            Debug.LogError($"Network error: {error}");

        // profileId and sessionToken come from your auth flow (e.g. Elements login)
        sessionManager.StartSession("player123", "auth-token");
        sessionManager.FindOrCreateMatch("default");
    }
}
```

A fuller example using the [Elements Codegen client](https://namazustudios.com/docs/add-ons/game-engines/unity/elements-codegen/) is in `Scripts/Test/NetworkTestViewController.cs`.

## Documentation

- [Events Reference](file:///Users/keithhudnall/Documents/workspace/Elements/github/unity-crossfire-plugin/Assets/Namazu%20Studios/Assets/Namazu%20Studios/Crossfire/docs/events.md) - all events, parameter semantics, and usage examples
- [Configuration](file:///Users/keithhudnall/Documents/workspace/Elements/github/unity-crossfire-plugin/Assets/Namazu%20Studios/Assets/Namazu%20Studios/Crossfire/docs/configuration.md) - Inspector fields, CrossfireConstants, and tuning
- [Architecture](file:///Users/keithhudnall/Documents/workspace/Elements/github/unity-crossfire-plugin/Assets/Namazu%20Studios/Assets/Namazu%20Studios/Crossfire/docs/architecture.md) - state machine, component responsibilities, and local testing
- [Extending the Plugin](file:///Users/keithhudnall/Documents/workspace/Elements/github/unity-crossfire-plugin/Assets/Namazu%20Studios/Assets/Namazu%20Studios/Crossfire/docs/extending.md) - custom transports, custom signaling, and best practices

## Support

For questions or issues, open a GitHub issue with your Unity version, the relevant error logs, and a description of the steps to reproduce.