> For the complete documentation index, see [llms.txt](https://esmp-fun.gitbook.io/plugins/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://esmp-fun.gitbook.io/plugins/community-chat/readme.md).

# Community Chat

One chat for many communities: any number of Minecraft servers (Paper family, 26.x) and their Discords, talking in the same room — with shared moderation, account linking and item sharing.

Each community keeps its own independently hosted server and its own Discord. There is no proxy, no port forwarding and no shared hosting: every server makes a single outbound connection to one small relay, and the relay does the rest.

## Your download: two files

* **`ccsrv-relay.jar`** — the **hub**. One person (the network operator) runs it once, anywhere with Java 25: on your existing Minecraft hosting, a small VPS, or a PC for testing. It *is* the Discord bot. It is **not** a Minecraft plugin and never goes in a `plugins/` folder.
* **`ccsrv-spoke.jar`** — the **plugin**. Goes into the `plugins/` folder of every Minecraft server, like any other plugin; each server only needs a token. This is the only file the other communities ever receive.

In short: relay = the one room everyone talks in, spoke = each server's door into that room. Share `ccsrv-spoke.jar` freely with the communities in your network — but keep `ccsrv-relay.jar` to yourself; it's tied to your purchase.

## Where to start

* **Network operator** (the one person who sets it all up): [Set up the network](/plugins/community-chat/getting-started/set-up-the-network.md) — \~30 minutes, every config ready to copy-paste.
* **Community admins**: [Connect a server](/plugins/community-chat/getting-started/connect-a-server.md) — two lines in a config, two minutes.
* **Players**: [Daily use](/plugins/community-chat/using-it/daily-use.md) — sharing items, linking Discord, quiet mode.
* **Staff**: [Moderation](/plugins/community-chat/using-it/moderation.md) — network-wide punishments, automod, the mod-log.

Every setting, command and permission is listed under **Reference**. Something not working? [Troubleshooting](/plugins/community-chat/help/troubleshooting.md) has the fix.