# Network bridge setup guide

### 
Initial setup for BungeeCord

1. Add the plugin to your **proxys plugins folder**<br>

2. Add the plugin to **each of your Spigot/Paper/etc. servers plugins folders**<br>

3. Restart the proxy and all servers that are using ChatSentry

4. Proceed to the "after initial setup" section of this page

### Initial setup for Velocity

ChatSentry does not officially support Velocity, but you can use a an adapter called Snap to run it on Velocity proxies

1. Download [Snap](https://github.com/Phoenix616/Snap/releases) and add it to your **proxys plugins folder**<br>

2. Let Snap generate it's directories and add ChatSentry to Snap's plugins folder (**plugins/Snap/plugins**)

3. Add ChatSentry to **each of your Spigot/Paper/etc. servers plugins folders**<br>

4. Restart the proxy and all servers that are using ChatSentry

5. Proceed to the "after initial setup" section of this page<br>

### After initial setup

1. Enable network mode in one of your servers ChatSentry configs (see the block below)<br>
2. Run **/kcs rl** to reload the plugin and update your changes, and then run **/kcs rl** again to force-sync or schedule sync this servers files with the other servers. Double reloading like this is only necessary when turning network mode on<br>
3. **Done!** ChatSentry will now automagically synchronize cross-server with respect to your network mode settings.

```yaml
network:
  enable: true # set this to true
  sync-configs: true # optional
  sync-playerdata: true # optional
  global-admin-notifier-messages: true # optional
```

### Updating ChatSentry - when should I update the proxy jar and others?

As a general rule of thumb, you should make sure all your ChatSentry instances are running on the same plugin version to prevent issues. Since updates are released so frequently, you can usually safely ignore optimizations and minor bug fixes, **however any updates with config changes should be updated across all your servers**.

### Additional info

ChatSentry is not fully a proxy plugin, meaning it must be installed not just on the proxy, but on all Spigot/Paper/etc. servers as well. Adding the plugin to your proxy creates a data bridge allowing for cross server communication between ChatSentry instances on your network.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://wiki.chatsentry.xyz/network-bridge-setup-guide.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.