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
- 前往 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
// 在此处添加您的令牌和玩家名称
// 格式: "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 — 可免费使用、修改和分发。
你是这个资源的作者?登录后可认领此资源。
相似资源
一个用于收集生物掉落物的多区块模组。
显示你正在注视的方块的信息。(适用于 Minecraft 1.16+ 的 Hwyla/Waila 分支)
查看物品与配方
在游戏画面角落显示附近世界地形、玩家、生物和实体的地图。可创建路径点,帮助你找到标记过的位置。
使用 JavaScript 编辑配方、添加自定义物品、编写世界事件!
添加区块认领和玩家组队功能,并与 Xaero's Minimap 和 World Map 集成
评论 0
登录后参与评分
还没有评论,来抢沙发吧