# Replication Server API

This page illustrates a few API you can use to interact with the Replication Server.

## Connection to a Replication Server

When the Replication Server is running, you connect to it using the `Connect` method.

#### Connect to a local Replication Server

Before you connect, make sure you've [baked](https://docs.coherence.io/2.0/manual/baking-and-code-generation). Then, (re)start a Replication Server for Worlds or Rooms. In this example, we're going for Worlds.

<figure><img src="https://215322450-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYYuUg3g2Mq8aiI7le9ai%2Fuploads%2F5sklE6xbdGnbcaM0hX7a%2Fimage.png?alt=media&#x26;token=715ed063-c937-4d27-aed7-83b127480b32" alt=""><figcaption></figcaption></figure>

```csharp
using Coherence;
using Coherence.Connection;
using Coherence.Toolkit;
using UnityEngine;

public class ConnectToLocal : MonoBehaviour
{
    void Start()
    {
        var Bridge = FindAnyObjectByType<CoherenceBridge>();
        
        var endpoint = new EndpointData
        {
            region = EndpointData.LocalRegion,
            host = "127.0.0.1",
            port = RuntimeSettings.Instance.LocalWorldUDPPort,
            schemaId = RuntimeSettings.Instance.SchemaID,
        };

        Bridge.Connect(endpoint);
    }
}
```

After trying to connect you might be interested in knowing whether the connection succeeded. The Connect call will run asynchronously and take around 100 ms to finish, or longer if you connect to a remote Server.

#### Respond to connection events

```csharp
using Coherence;
using Coherence.Connection;
using Coherence.Toolkit;
using UnityEngine;

public class ConnectToLocal : MonoBehaviour
{
    private CoherenceBridge Bridge;

    void Start()
    {
        Bridge = FindAnyObjectByType<CoherenceBridge>();
        Bridge.onConnected.AddListener(HandleConnected);
        Bridge.onDisconnected.AddListener(HandleDisconnected);
        Bridge.onLiveQuerySynced.AddListener(HandleLiveQuerySynced);

        var endpoint = new EndpointData
        {
            region = EndpointData.LocalRegion,
            host = "127.0.0.1",
            port = 32001,
            schemaId = RuntimeSettings.instance.SchemaID,
        };

        Bridge.Connect(endpoint);
    }

    private void HandleConnected(CoherenceBridge _) { /* ... */ }

    private void HandleLiveQuerySynced(CoherenceBridge _) { /* ... */ }

    private void HandleDisconnected(CoherenceBridge _, ConnectionCloseReason reason) { /* ... */ }

    private void OnDestroy()
    {
        Bridge.onConnected.RemoveListener(HandleConnected);
        Bridge.onDisconnected.RemoveListener(HandleDisconnected);
        Bridge.onLiveQuerySynced.RemoveListener(HandleLiveQuerySynced);
    }
}
```

{% hint style="info" %}
The OnLiveQuerySynced event is triggered when the initial game state has been synced to the client. More specifically, it is fired when all entities found by the Client's first Live Query have finished replicating. This is the last step of the connection process and is usually a good place to start the game simulation.
{% endhint %}

{% hint style="info" %}
To connect to Cloud-hosted Servers, see [Rooms API](https://docs.coherence.io/2.0/hosting/coherence-cloud/coherence-cloud-apis/rooms) and [Worlds API](https://docs.coherence.io/2.0/hosting/coherence-cloud/coherence-cloud-apis/worlds) documentation.
{% endhint %}

{% hint style="info" %}
Check **Run in Background** in the *Unity settings* under *Project Settings > Player* so that the Clients continue to run even when they're not the active window.
{% endhint %}

To connect with multiple Clients locally, publish a build for your platform (*File > Build and Run*, details in [Unity docs](https://docs.unity3d.com/Manual/PublishingBuilds.html)). Run the Replication Server and launch the build any number of times. You can also enter Play Mode in the Unity Editor.

{% hint style="info" %}
For Mac Users: You can open new instances of an application from the Terminal:

<pre class="language-bash"><code class="lang-bash"><strong>open -n &#x3C;path to .app>
</strong></code></pre>

{% endhint %}