Q111: 如何与客户端同学协作？

// 游戏协议定义

// 基础定义
syntax = "proto3";

package game;

// ========== 通用消息 ==========

message Empty {}

// 错误信息
message Error {
    int32 code = 1;
    string message = 2;
}

// 位置信息
message Vector3 {
    float x = 1;
    float y = 2;
    float z = 3;
}

// ========== 登录协议 ==========

// 登录请求
message LoginRequest {
    string account = 1;
    string password = 2;
    string device_id = 3;
    string client_version = 4;
}

// 登录响应
message LoginResponse {
    int32 code = 1;
    string message = 2;
    string token = 3;
    repeated ServerInfo servers = 4;
}

message ServerInfo {
    int32 server_id = 1;
    string server_name = 2;
    string address = 3;
    int32 port = 4;
    int32 load = 5;
    bool is_recommend = 6;
}

// ========== 角色协议 ==========

// 创建角色请求
message CreateCharacterRequest {
    string name = 1;
    int32 class_id = 2;
    int32 gender = 3;
}

// 角色信息
message CharacterInfo {
    int64 character_id = 1;
    string name = 2;
    int32 level = 3;
    int32 class_id = 4;
    int32 exp = 5;
    Vector3 position = 6;
    int64 gold = 7;
}

// 创建角色响应
message CreateCharacterResponse {
    int32 code = 1;
    string message = 2;
    CharacterInfo character = 3;
}

// ========== 游戏消息 ==========

// 位置同步
message PositionSync {
    int64 entity_id = 1;
    Vector3 position = 2;
    float yaw = 3;
    uint32 timestamp = 4;
}

// 技能释放
message CastSkillRequest {
    int32 skill_id = 1;
    int64 target_id = 2;
    Vector3 target_position = 3;
}

// 技能释放通知
message CastSkillNotify {
    int64 caster_id = 1;
    int32 skill_id = 2;
    int64 target_id = 3;
    Vector3 position = 4;
    uint32 timestamp = 5;
}

// 伤害通知
message DamageNotify {
    int64 target_id = 1;
    int64 attacker_id = 2;
    int32 damage = 3;
    int32 current_hp = 4;
    bool is_critical = 5;
}

// ========== 聊天协议 ==========

// 聊天请求
message ChatRequest {
    int32 channel = 1;  // 1:世界 2:公会 3:私聊
    string content = 2;
    int64 target_id = 3;  // 私聊时使用
}

// 聊天消息
message ChatMessage {
    int64 sender_id = 1;
    string sender_name = 2;
    int32 channel = 3;
    string content = 4;
    uint32 timestamp = 5;
}

// 服务端消息定义
message ServerMessage {
    uint32 msg_id = 1;
    uint64 sequence = 2;
    oneof body {
        LoginResponse login_response = 10;
        CreateCharacterResponse create_character_response = 11;
        CharacterInfo character_info = 12;
        PositionSync position_sync = 20;
        CastSkillNotify cast_skill_notify = 21;
        DamageNotify damage_notify = 22;
        ChatMessage chat_message = 30;
        Error error = 100;
    }
}

LoginResponse {
    int32 code;         // 0:成功, 其他:失败
    string message;     // 提示信息
    string token;       // 登录令牌
    repeated ServerInfo servers; // 可选服务器列表
}