
CloudChatMC
在任何Minecraft服务器之间与朋友聊天——无需插件。由免费的Cloudflare Worker后端提供支持,具备基于令牌的身份验证、全局聊天和私密消息功能。
CloudChatMC
CloudChatMC 是一个客户端 Fabric 模组,可在你和你的朋友之间创建一条私密、持久的聊天隧道 —— 完全独立于你们正在游玩的任何 Minecraft 服务器。
无论你们身处不同的服务器、不同的世界,还是其中一人在单人游戏中,CloudChatMC 都会通过免费的 Cloudflare Worker 后端让你们保持联系。
功能
- 全局聊天 —— 一次性向所有已连接的朋友发送消息
- 私信 —— 向指定玩家发送直接消息
- 在线追踪 —— 使用
/ccmc online查看当前已连接的用户 - 基于令牌的身份验证 —— 每位玩家拥有唯一令牌,无需登录
- 加密消息 —— 所有消息在发送前都会进行编码
- 自动重连 —— 连接断开后自动重新连接
- 消息队列 —— 游戏加载期间收到的消息不会丢失
- 配置命令 —— 在游戏内更新令牌和服务器 URL,无需重启
命令
| 命令 | 描述 |
|---|---|
/ccmc msg <message> |
向所有已连接的玩家发送全局消息 |
/ccmc pm <player> <message> |
向指定玩家发送私信 |
/ccmc online |
显示所有当前已连接的玩家 |
/ccmc status |
显示你当前的连接状态 |
/ccmc config <token> <url> |
在运行时更新令牌和 WebSocket URL |
/ccmc help |
显示所有可用命令 |
设置
CloudChatMC 需要一个 Cloudflare Worker 后端来中继消息。按照以下步骤托管你自己的后端 —— 它完全免费。
第 1 步 — 创建 Cloudflare Worker
- 前往 Cloudflare Dashboard 并免费注册
- 前往 Workers & Pages → Create
- 使用任意名称创建一个新的 Worker(例如
cloudchatmc)
第 2 步 — 设置 Wrangler CLI
npm install -g wrangler
wrangler login
mkdir cloudchatmc-worker
cd cloudchatmc-worker
第 3 步 — 创建 wrangler.toml
name = "your-worker-name"
main = "worker.js"
compatibility_date = "2024-01-01"
[[durable_objects.bindings]]
name = "CHAT_ROOM"
class_name = "ChatRoom"
[[migrations]]
tag = "v1"
new_sqlite_classes = ["ChatRoom"]
将 your-worker-name 替换为你为 Worker 指定的名称。
第 4 步 — 创建 worker.js
// Add your tokens and player names here
// Format: "TOKEN": "PlayerName"
// Generate strong random tokens — avoid special characters
// Example: use alphanumeric strings of 32+ characters
const TOKENS = {
"token_for_player1": "Player1",
"token_for_player2": "Player2",
"token_for_player3": "Player3",
"token_for_admin": "Admin"
};
export class ChatRoom {
constructor(state, env) {
this.clients = new Map();
}
async fetch(request) {
if (request.headers.get("Upgrade") !== "websocket") {
return new Response("WebSocket only", { status: 400 });
}
const url = new URL(request.url);
const token = url.searchParams.get("token");
if (!token || !TOKENS[token]) {
return new Response("Unauthorized", { status: 401 });
}
const username = TOKENS[token];
const existing = this.clients.get(username);
if (existing) {
try { existing.close(1000, "Replaced by new connection"); } catch {}
this.clients.delete(username);
}
const [client, server] = new WebSocketPair();
server.accept();
this.clients.set(username, server);
this.broadcast({ type: "join", user: username });
server.addEventListener("message", (event) => {
let data;
try {
data = JSON.parse(event.data);
} catch {
return;
}
if (data.type === "broadcast") {
this.broadcast({ type: "msg", from: username, data: data.data });
} else if (data.type === "private") {
const target = this.clients.get(data.to);
if (target) {
try {
target.send(JSON.stringify({
type: "pm",
from: username,
data: data.data
}));
} catch {
this.clients.delete(data.to);
this.safeSend(server, { type: "error", message: "Player not online" });
}
} else {
this.safeSend(server, { type: "error", message: "Player not online" });
}
} else if (data.type === "list") {
this.safeSend(server, {
type: "list",
users: [...this.clients.keys()]
});
}
});
server.addEventListener("close", () => {
this.clients.delete(username);
this.broadcast({ type: "leave", user: username });
});
server.addEventListener("error", () => {
this.clients.delete(username);
});
return new Response(null, { status: 101, webSocket: client });
}
broadcast(obj) {
const msg = JSON.stringify(obj);
const dead = [];
for (const [name, ws] of this.clients) {
try {
ws.send(msg);
} catch {
dead.push(name);
}
}
for (const name of dead) this.clients.delete(name);
}
safeSend(ws, obj) {
try { ws.send(JSON.stringify(obj)); } catch {}
}
}
export default {
async fetch(request, env) {
if (request.headers.get("Upgrade") !== "websocket") {
return new Response("WebSocket only", { status: 400 });
}
const url = new URL(request.url);
const token = url.searchParams.get("token");
if (!token || !TOKENS[token]) {
return new Response("Unauthorized", { status: 401 });
}
const id = env.CHAT_ROOM.idFromName("global");
const room = env.CHAT_ROOM.get(id);
return room.fetch(request);
}
};
第 5 步 — 部署
wrangler deploy
你的 Worker URL 将是:wss://your-worker-name.your-subdomain.workers.dev
第 6 步 — 配置模组
在以下位置设置你的令牌和 Worker URL:.minecraft/config/cloudchatmc.json
{
"token": "YOUR_TOKEN_HERE",
"url": "wss://your-worker-name.your-subdomain.workers.dev"
}
或使用游戏内命令:
/ccmc config YOUR_TOKEN wss://your-worker-name.your-subdomain.workers.dev
令牌提示
- 每位玩家拥有自己唯一的令牌 —— 切勿在玩家之间共享令牌
- 使用较长的字母数字字符串(32+ 个字符),不要包含特殊字符
- 请对令牌保密 —— 任何拥有令牌的人都可以以该玩家的身份连接
- 你可以在 String Generator 生成安全的令牌
要求
- Minecraft 1.21.4-1.21.11
- Fabric Loader 0.16.10+
- Fabric API
为什么选择 CloudChatMC?
大多数跨服务器通信模组需要专用服务器或付费托管。CloudChatMC 使用带有 Durable Objects 的 Cloudflare Workers,其免费额度非常充裕 —— 对于小型好友群体来说,完全免费运行,且无需任何维护。
许可证
GPL-3.0 —— 可自由使用、修改和分发。
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。