mcpField
M
multiplayer-building

multiplayer-building

github.com/bbeierle12开发966 次安装1 天前更新
代码仓库

关于 multiplayer-building

面向多人建造游戏的网络层，采用服务器权威模式并支持客户端预测。它结合状态差量同步、客户端校正和可配置的同时建造冲突处理。

主要功能

  1. 01服务器权威的建造状态
  2. 02支持回滚的客户端预测
  3. 03仅同步变更状态
  4. 04多种冲突解决策略

适用场景

  1. 01同步玩家间的建筑变更
  2. 02在服务器确认前预测放置
  3. 03处理同时进行的建造操作

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/bbeierle12/skill-mcp-claude --skill multiplayer-building

安装后在 Claude Code 中输入/multiplayer-building确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

_meta.json
references/
multiplayer-networking.md
scripts/
building-network-manager.js
client-prediction.js
conflict-resolver.js
delta-compression.js

详细介绍

多人建造

用于多人建造游戏的网络层。

快速入门

import { BuildingNetworkServer, BuildingNetworkClient } from './scripts/building-network-manager.js';

// Server
const server = new BuildingNetworkServer(buildingSystem, {
  tickRate: 20,
  conflictStrategy: 'first_write'
});
server.start();

// Client
const client = new BuildingNetworkClient(buildingSystem);
client.connect('ws://server:8080');
const localPiece = client.placeRequest('wall', position, rotation);

参考资料

请参阅 references/multiplayer-networking.md，了解：

  • 权威模型对比
  • 增量压缩策略
  • 冲突解决方法
  • 大型结构同步

脚本

  • scripts/delta-compression.js - 仅同步变更的状态（Source 引擎模式）
  • scripts/client-prediction.js - 采用回滚机制进行乐观放置
  • scripts/conflict-resolver.js - 处理同时建造的情况（先写入、时间戳、基于锁）
  • scripts/building-network-manager.js - 完整的服务端/客户端系统

架构

服务端权威，搭配客户端预测：

  1. 客户端在本地预测放置（幽灵部件）
  2. 服务端验证并确认或拒绝
  3. 客户端与服务端状态协调
  4. 增量压缩仅同步变更

评论

支持 Markdown