65 lines
4.8 KiB
Markdown
65 lines
4.8 KiB
Markdown
---
|
||
title: "Godot Multiplayer Engineer Agent Personality"
|
||
type: source
|
||
tags: []
|
||
date: 2026-05-01
|
||
---
|
||
|
||
## Source File
|
||
- [[Agent/agency-agents/game-development/godot/godot-multiplayer-engineer.md]]
|
||
|
||
## Summary（用中文描述）
|
||
- 核心主题：Godot 4 网络多人游戏开发 Agent 人格定义——专注于 MultiplayerAPI、场景复制、ENet/WebRTC 传输、RPC 和权威模型
|
||
- 问题域：如何在 Godot 4 中构建安全、可扩展的实时多人游戏网络系统
|
||
- 方法/机制：服务器权威架构 + RPC 安全模式 + MultiplayerSpawner/MultiplayerSynchronizer 协同 + 延迟测试
|
||
- 结论/价值：提供完整的 Godot 多人游戏开发规范，覆盖从基础 ENet 搭建到高级 WebRTC P2P 连接的完整技术栈
|
||
|
||
## Key Claims（用中文描述）
|
||
- 服务器（peer ID 1）必须拥有所有游戏关键状态（位置、生命值、分数、物品状态），客户端无权直接修改
|
||
- 使用 `set_multiplayer_authority()` 显式设置权威节点，不能依赖默认值
|
||
- 所有状态变更必须用 `is_multiplayer_authority()` 守卫，非权威节点不得修改复制状态
|
||
- `@rpc("any_peer")` 仅用于客户端到服务器请求，函数内部必须进行服务器端验证
|
||
- `@rpc("authority")` 仅允许权威节点调用，用于服务器到客户端的确认
|
||
- `@rpc("call_local")` 同时在本地执行，用于调用方也应体验的效果
|
||
- 动态生成的网络节点必须使用 `MultiplayerSpawner`，禁止手动 `add_child()`
|
||
- `MultiplayerSynchronizer` 的所有属性路径必须在节点进入场景树时有效，无效路径静默失败
|
||
|
||
## Key Quotes
|
||
> "MANDATORY: The server (peer ID 1) owns all gameplay-critical state — position, health, score, item state" — 核心权威模型原则
|
||
> "`@rpc(\"any_peer\")` allows any peer to call the function — use only for client-to-server requests that the server validates" — RPC 安全性核心规则
|
||
> "Don't `add_child()` networked nodes manually — use MultiplayerSpawner or peers won't receive them" — 场景生成关键约束
|
||
> "Test under latency: It works on localhost — test it at 150ms before calling it done" — 延迟测试标准
|
||
|
||
## Key Concepts
|
||
- [[MultiplayerAPI]]：Godot 4 的核心多人游戏 API，管理网络连接、权威和 RPC 通信
|
||
- [[Server-Authoritative Architecture]]：服务器权威架构——所有游戏逻辑在服务器执行，客户端仅发送输入和接收状态
|
||
- [[RPC (Remote Procedure Call)]]：远程过程调用，通过 `@rpc()` 装饰器实现节点间的跨网络方法调用
|
||
- [[MultiplayerSpawner]]：Godot 4 组件，自动在所有对等节点间复制动态生成的网络节点
|
||
- [[MultiplayerSynchronizer]]：Godot 4 组件，将权威节点的状态变化同步到所有对等节点
|
||
- [[ENet]]：轻量级 UDP 可靠传输协议，用于 Godot 的 C/S 和 P2P 网络连接
|
||
- [[WebRTC]]：用于浏览器导出的 P2P 多人大规模连接方案，配合 STUN/TURN 实现 NAT 穿透
|
||
- [[Authority Model]]：权威模型——每个网络节点有唯一的权威持有者（服务器或特定客户端），只有权威才能修改状态
|
||
- [[Scene Replication]]：场景复制——通过网络同步动态生成/销毁的节点及其状态
|
||
- [[Delta Compression]]：增量压缩——仅传输变化的字段而非完整状态，节省带宽
|
||
|
||
## Key Entities
|
||
- [[Godot]]：开源游戏引擎，版本 4 提供了全新的多人游戏 API（MultiplayerAPI、MultiplayerSpawner、MultiplayerSynchronizer）
|
||
- [[Nakama]]：（提及）开源游戏服务器，可与 Godot 集成提供匹配、大厅、排行榜和 DataStore 功能
|
||
- [[NetworkManager]]：（代码中的 Autoload 示例）管理 ENet 服务器/客户端创建、连接和断开的核心网络管理器
|
||
- [[Player]]：（代码中的节点示例）服务器权威的玩家角色节点，通过 RPC 接收输入、同步状态
|
||
|
||
## Connections
|
||
- [[Unity Multiplayer Engineer]] ← similar_concept ← [[Godot Multiplayer Engineer]]
|
||
- 两者都遵循服务器权威模型和 RPC 安全模式，但各自使用不同引擎的原生 API
|
||
- [[Game Designer]] ← documents_requirements ← [[Godot Multiplayer Engineer]]
|
||
- Game Designer 定义的多人游戏需求由 Multiplayer Engineer 实现网络同步方案
|
||
- [[Technical Artist]] ← coordinates_with ← [[Godot Multiplayer Engineer]]
|
||
- 技术美工需要了解网络同步对视觉效果的影响（如预测、插值）
|
||
|
||
## Contradictions
|
||
- 与 [[Unity Multiplayer Engineer]] 冲突：
|
||
- 冲突点：权威模型的具体实现细节
|
||
- 当前观点（Godot）：使用 `set_multiplayer_authority(peer_id)` 显式设置权威，每个节点独立管理
|
||
- 对方观点（Unity）：通过 NetCode/MLAPI 的 NetworkObject 和 Owner 机制管理权威
|
||
- 说明：两者核心原则一致（服务器权威、RPC 验证），但实现 API 不同，不构成实质冲突
|