multiplayer-building

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Multiplayer Building

多人建造

Networking layer for multiplayer building games.

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

Quick Start

快速开始

javascript

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);

javascript

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);

Reference

参考资料

See

references/multiplayer-networking.md

for:

Authority model comparison
Delta compression strategy
Conflict resolution approaches
Large structure synchronization

详见

references/multiplayer-networking.md

文档，内容包括：

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

Scripts

脚本文件

```
scripts/delta-compression.js
```
- Only sync changed state (Source engine pattern)
```
scripts/client-prediction.js
```
- Optimistic placement with rollback
```
scripts/conflict-resolver.js
```
- Handle simultaneous builds (first-write, timestamp, lock-based)
```
scripts/building-network-manager.js
```
- Complete server/client system

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

Architecture

架构设计

Server-authoritative with client prediction:

Client predicts placement locally (ghost piece)
Server validates and confirms/rejects
Client reconciles with server state
Delta compression syncs only changes

服务器权威型架构结合客户端预测：

客户端本地预测放置（虚影部件）
服务器验证并确认/拒绝
客户端与服务器状态协调一致
增量压缩仅同步变更内容