This plugin joins your Minecraft server's chat to a shared chat network, so your players can talk with players on other servers and in Discord.
It is free to download and always will be.
Want to see it working first? You can borrow our hub and be talking to our Discord in about two minutes. See Try it before you set anything up.
A community is one Minecraft server together with its Discord server. Each community keeps its own players, its own Discord and its own rules.
They all meet at a hub. The hub is a separate program that one person runs. It holds everything together, handles the moderation, and does the talking to Discord.
flowchart LR
A["<b>Your community</b><br/>Minecraft server + Discord"] <--> HUB
B["<b>Someone else's</b><br/>Minecraft server + Discord"] <--> HUB
HUB(["<b>THE HUB</b><br/>one person runs this"])
HUB <--> C["<b>A third</b><br/>Minecraft server + Discord"]
HUB <--> D["<b>And a fourth</b><br/>Minecraft server + Discord"]
Everything flows both ways. Something said in any Minecraft server or any Discord reaches all the others.
The plugin in this repository is the piece that goes on the Minecraft server. The Discord side needs no plugin at all, just a bot invited to the server.
You need two things, and only the person running the hub can give them to you:
- The hub address. It looks like
wss://chat.esmp.fun- Your server's token. A long secret, different for every server
Ask them for both before you install anything. Without them this plugin has nothing to connect to.
You do not need a hub of your own to see this working. Borrow one of ours.
1. Install the plugin on any test server (steps below), using this address:
hub:
url: "wss://chat.esmp.fun"
token: "PICK ONE FROM THE LIST BELOW"2. Pick any token from this list:
| Slot | Token |
|---|---|
| 1 | try9173aae8bece2cde6a7849bfae39e2320af1 |
| 2 | trye8d8e2748b934a6298e18bffed8a5d740c98 |
| 3 | try3fd005c3bbe6369b5d778374c54ca55bb8d9 |
| 4 | try3388f16af8ea0342e948e2fb978677a33b78 |
| 5 | tryba2867a79b52619c32d1d3724ceaba1b8ffd |
3. Type something in your server's chat. It appears in the #play-esmp-fun
channel of our Discord, tagged with the slot you picked:
[TRY1] YourName » hello from my test server
4. Come and see it, and talk back:
- Discord: https://discord.gg/q2AHcnDgJq
- Minecraft:
play.esmp.fun
Join the Minecraft server too and you will see the whole thing from both ends. Chat on your test server, watch it arrive in game on ours, and reply.
Want to see several servers talking to each other? Use a different token on each one. That is what the five slots are for.
Please read:
- These tokens are public and shared. If a slot suddenly disconnects you, someone else took it. Pick another.
- They are rotated regularly, so a token you saved last week will stop working. Come back here for a current one.
- The strictest moderation setting is switched on for these slots. That is partly to keep our Discord tidy and partly so you can see the filter working.
- These are for trying it out. For a real network you want your own hub, so that your chat is yours and nobody else can join it.
Step 1. Download communitychat-connector.jar from
Releases.
Step 2. Put that file in your server's plugins folder.
Step 3. Start your server. The console will tell you it is not set up yet:
=========================================================
CommunityChat is NOT connected yet.
Easiest fix: join the server and run /cchat setup
Paste in the two things your network operator sent you
(the address and this server's token) and press Connect.
=========================================================
That is expected. It is waiting for the two things you were given.
Step 4. Join your server and type:
/cchat setup
A window opens with two boxes. Put the address in one, your token in the other, and press Connect.
Step 5. Check it worked:
/cchat status
A good result looks like this:
✔ Connected to the 'The ESMP Network' network as Survival, 2 of 3 servers online.
Anything else, see When it will not connect.
Everything above can be done by hand instead. Open this file:
plugins/CommunityChat/config.yml
Near the top you will find this:
hub:
url: "ws://127.0.0.1:8377"
token: "CHANGE-ME"Replace both values with the ones you were given, keeping the quote marks:
hub:
url: "wss://chat.esmp.fun"
token: "try9173aae8bece2cde6a7849bfae39e2320af1"(That is try-it-out slot 1, so those exact lines work as they are. For a real network, use the address and token you were given instead.)
Then type /cchat reload in game. You do not need to restart the server.
The two spaces in front of url and token matter. If you delete them the file
stops working.
Messages from other servers arrive tagged, so nobody is confused about where they came from:
[SMP] Steve » anyone on tonight?
[CRE] Discord Alex » just finished the build
They also get:
| Command | What it does |
|---|---|
/link |
Connects their Discord account to their Minecraft one, everywhere in the network |
/ctoggle |
Hides network chat for them, if they only want local chat |
/sc <message> |
Staff only. A private channel across every server in the network |
Deaths, advancements and joins can be shared to Discord too, if the network wants that. Players can also hold an item and share it, and it turns up in Discord with its name and enchantments.
- Paper, Purpur or Folia, version 26.1 or newer. It will not run on Spigot, and on anything older than 26.1 it refuses to start rather than half working.
- Java 25, which those server versions need anyway.
- A hub to connect to.
Run /cchat status. It tells you which of these it is.
| What you see | What it means |
|---|---|
✖ Not set up yet |
The token is still CHANGE-ME. Go back to step 4. |
… Not connected to the network right now |
The address is wrong, or the hub is switched off. The lines under it say which. |
unknown token in the console |
The hub does not recognise your token. Ask for a fresh one. |
The plugin is missing from /plugins |
Your server is older than 26.1, so it refused to load. |
Still stuck? Ask whoever runs the network first. They can see their side of the connection, which is usually where the answer is.
Then you need the other half. One person runs a hub and everyone else just uses this plugin.
- Run it yourself. Buy once at esmp.fun and host the hub anywhere that stays switched on. It is not a Minecraft plugin, so it needs its own small home. A spare slot on your host, a cheap Discord bot plan, or a small Linux box will all do.
- Let us run it. From $7.89 a month we keep the hub running and updated, and give you the address and tokens to hand out.
- Documentation: esmp-fun.gitbook.io/plugins
- Email: support@esmp.fun
Bug reports about this plugin are welcome in Issues. Questions about a particular network's rules or settings are for whoever runs that network.