CloudChatMC

CloudChatMC

在任何Minecraft服务器之间与朋友聊天——无需插件。由免费的Cloudflare Worker后端提供支持,具备基于令牌的身份验证、全局聊天和私密消息功能。

管理

CloudChatMC

Source Code Issues Modrinth CurseForge

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

  1. 前往 Cloudflare Dashboard 并免费注册
  2. 前往 Workers & Pages → Create
  3. 使用任意名称创建一个新的 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 —— 可自由使用、修改和分发。