CloudChatMC

模组

· 作者 itzbyteglitch

在任何 Minecraft 服务器中与朋友聊天——无需安装插件。由免费的 Cloudflare Worker 后端驱动,支持基于令牌的身份验证、全球聊天和私聊功能。

0 本站下载 0 关注 更新于 7 个月前

需要前置:Fabric API

最新 1.0.0 · 1.21.11 · Fabric

一键开服(送7天)

CloudChatMC

CloudChatMC 是一个客户端侧的 Fabric 模组,用于在你和你的好友之间建立一个私密、持久的聊天通道——完全独立于你们所游玩的任何 Minecraft 服务器。

无论你们身处不同的服务器、不同的世界,或者其中一人处于单人游戏模式,CloudChatMC 都能通过免费的 Cloudflare Worker 后端让你们保持连接。

功能特性

  • 全局聊天 — 一次性向所有已连接的好友发送消息
  • 私聊 — 向特定玩家发送私信
  • 在线追踪 — 使用 /ccmc online 查看当前谁已连接
  • 基于令牌的标识 — 每个玩家拥有唯一的令牌,无需登录
  • 加密消息 — 所有消息在发送前均经过编码
  • 自动重连 — 如果连接断开,会自动重新连接
  • 消息队列 — 游戏加载期间接收到的消息不会丢失
  • 配置命令 — 在游戏中更新令牌和服务器 URL,无需重启

命令

Command Description
/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

// 在此处添加您的令牌和玩家名称
// 格式: "TOKEN": "PlayerName"
// 生成强随机令牌 —— 避免使用特殊字符
// 示例:使用 32 个字符以上的字母数字字符串
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 {}
  }
}

```javascript
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 地址将是:wss://your-worker-name.your-subdomain.workers.dev


第 6 步 — 配置模组

在 .minecraft/config/cloudchatmc.json 中设置你的 Token 和 Worker 地址:

{
  "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

Token 提示

  • 每位玩家拥有唯一的 Token —— 切勿在不同玩家之间共享 Token
  • 使用长度在 32 位以上的纯字母数字字符串,不要包含特殊字符
  • 请妥善保管 Token —— 任何持有该 Token 的人都可以冒充该玩家连接
  • 你可以前往 String Generator 生成安全的 Token

前置要求

  • Minecraft 1.21.4-1.21.11
  • Fabric Loader 0.16.10+
  • Fabric API

为什么选择 CloudChatMC?

大多数跨服务器通信模组需要专用服务器或付费托管服务。CloudChatMC 基于 Cloudflare Workers 和 Durable Objects 构建,其免费额度非常慷慨——对于小型好友群组来说,它可以完全免费运行且无需维护。

许可证

GPL-3.0 — 可免费使用、修改和分发。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源