口袋觉醒跨服系统完整部署与配置教程：从架构搭建到活动上线全流程

一、跨服系统架构与支持活动

1.1 整体架构原理

• 游戏服务器：负责玩家的日常游戏逻辑，将跨服相关请求转发到跨服服务器
• 跨服服务器：负责跨服匹配、战斗执行、排名计算和奖励发放
• 数据流向：玩家数据从游戏服同步到跨服服，战斗结果从跨服服回传到游戏服

1.2 支持的跨服活动类型

二、核心配置文件详解

2.1 跨服服务总控：service.csv

• servers设为all或留空：所有服务器都可以参与该活动
• endDate设为0：活动永久开启，不会自动关闭
• 同一活动可以配置多条记录：实现不同服务器组的独立跨服

2.2 各活动独立配置目录

三、跨服活动开启完整步骤

3.1 步骤一：配置总控文件 service.csv

1. 打开总控配置文件：

   notepad d:\KOAI\pokemon\game\cross\service.csv

2. 在文件末尾添加跨服对战的配置：

   10001,onlinefight,game.cn.1;game.cn.2;game.cn.3;game.cn.4,20260603,onlinefight.cn.1,,20260703

3. 保存文件并关闭。

3.2 步骤二：配置活动详细参数

1. 打开跨服对战的基础配置文件：

   notepad d:\KOAI\pokemon\game\cross\online_fight\base.csv

2. 修改活动规则：

   ID,title,startTime,endTime,matchInterval,maxPlayers,minPlayers,entryLevel,entryCost
   1,跨服对战,20:00,22:00,300,100,2,30,{type=item,id=1001,count=10}

   • matchInterval：匹配间隔，单位秒（300 秒 = 5 分钟）
   • entryLevel：玩家最低进入等级
   • entryCost：每次参与消耗的道具
3. 配置周奖励（weekly_award.csv）：

   rank,minRank,maxRank,rewards
   1,1,3,{item=1001,count=1000;item=2001,count=10}
   2,4,10,{item=1001,count=500;item=2001,count=5}
   3,11,50,{item=1001,count=200}
   4,51,200,{item=1001,count=100}

4. 保存所有修改的文件。

3.3 步骤三：转换配置为 Lua 格式

3.4 步骤四：配置跨服服务器

1. 打开跨服服务器配置文件：

   notepad d:\KOAI\lyzwlkjvip_口袋新世纪\服务端\mnt\pokemon\release\cross\defines.json

2. 添加跨服对战的服务节点：

   {
       "onlinefight.cn.1": {
           "host": "0.0.0.0",
           "port": 10001,
           "max_connections": 10000,
           "log_level": "info"
       },
       "crossarena.cn.1": {
           "host": "0.0.0.0",
           "port": 10002,
           "max_connections": 5000,
           "log_level": "info"
       }
   }

   • host设为0.0.0.0表示监听所有网卡
   • port必须与之前的端口规划一致
3. 保存文件。

3.5 步骤五：配置客户端入口

1. 配置功能解锁：

   notepad d:\KOAI\pokemon\game\sysopen.csv

   添加：

   100,cross_fight,30,0,20260603

   表示玩家等级达到 30 级且日期达到 2026-06-03 时自动解锁跨服对战。

2. 配置 UI 入口（可选）：

   如果客户端没有默认显示跨服入口，需要修改 UI 配置文件：

   notepad d:\KOAI\MyLuaGame\res\uijson\city.json

   添加跨服按钮的配置。

3.6 步骤六：启动跨服服务

1. 检查 Supervisor 配置：

   notepad d:\KOAI\lyzwlkjvip_口袋新世纪\服务端\mnt\pokemon\deploy_dev\supervisord.dir\cross_server.ini

   确保配置正确：

   [program:cross_server]
   command=/usr/bin/python /mnt/pokemon/release/src/cross/server.py
   directory=/mnt/pokemon/release
   user=root
   autostart=true
   autorestart=true
   stdout_logfile=/mnt/pokemon/logs/cross_server.log
   stderr_logfile=/mnt/pokemon/logs/cross_server_err.log

2. 启动跨服相关服务：

   # 重新加载Supervisor配置
   supervisorctl reread
   supervisorctl update
   
   # 按顺序启动服务
   supervisorctl start crossdb_server      # 跨服数据库
   supervisorctl start crosslobby_server   # 跨服大厅
   supervisorctl start cross_server        # 跨服主服务
   supervisorctl start online_fight_forward_server  # 跨服对战转发
   
   # 检查服务状态
   supervisorctl status | grep cross

3. 配置防火墙开放端口：

   # 开放跨服端口范围
   firewall-cmd --zone=public --add-port=10001-10006/tcp --permanent
   firewall-cmd --reload

3.7 步骤七：热更新到客户端

四、常见跨服活动配置模板

4.1 跨服竞技场（crossarena）

# service.csv
3001,crossarena,all,20260603,crossarena.cn.1,,0

# arena/base.csv
ID,startTime,endTime,seasonDuration,entryLevel,refreshCost
1,00:00,23:59,7,35,{type=item,id=1001,count=5}

# arena/daily_award.csv
rank,minRank,maxRank,rewards
1,1,10,{item=1001,count=100;item=3001,count=10}
2,11,50,{item=1001,count=50;item=3001,count=5}
3,51,200,{item=1001,count=20}

4.2 跨服挖矿（crossmine）

# service.csv
4001,crossmine,game.cn.1;game.cn.2,20260603,crossmine.cn.1,,20260610

# mine/base.csv
ID,openTime,closeTime,entryLevel,energyCost,maxEnergy
1,08:00,22:00,25,10,100

# mine/boss.csv
ID,bossID,hp,spawnTime,award
1,9999,10000000,20:00,{item=2001,count=1;item=1001,count=500}

五、跨服服务器部署要求

5.1 硬件配置推荐

5.2 完整服务启动流程

六、测试与问题排查

6.1 服务端测试

# 检查跨服服务健康状态
curl http://localhost:10001/health

# 查看跨服活动配置是否加载成功
mongo game_db --eval "db.cross_service.find({service:'onlinefight'}).pretty()"

# 实时查看跨服日志
tail -f /mnt/pokemon/logs/cross_server.log

# 查看端口是否正常监听
netstat -tlnp | grep :10001

6.2 客户端测试

1. 启动客户端，登录一个 30 级以上的账号
2. 检查主界面是否显示 “跨服对战” 入口
3. 点击进入，查看活动时间和规则是否正确
4. 尝试匹配对手，测试战斗是否正常
5. 查看奖励发放是否正确

6.3 常见问题与解决方案

七、上线前检查清单

服务端配置检查

•  service.csv 中所有活动的 ID 唯一且不重复
•  各活动的 servers 字段正确包含参与服务器
•  defines.json 中的端口与 service.csv 的 cross 标识对应
•  防火墙已开放 10001-10006 端口
•  Supervisor 配置正确，所有服务设置为 autostart=true

客户端配置检查

•  所有 CSV 文件已转换为 Lua 格式
•  sysopen.csv 中已添加跨服功能的解锁配置
•  热更新补丁已生成并上传到服务器
•  版本号已更新（version.plist）

功能测试检查

•  不同等级的玩家都能正确看到 / 隐藏跨服入口
•  匹配功能正常，能成功进入战斗
•  战斗结束后能正确返回结果和发放奖励
•  排名系统正常更新
•  活动结束后能正确关闭并发放赛季奖励

总结