一、什么是传奇三端互通
三端互通指同一套服务端程序同时支持电脑客户端、安卓手机端、苹果手机端登陆，角色数据完全同步，玩家在不同设备上操作同一个账号角色，装备、等级、背包实时一致。区别于传统手游模拟器方案，三端互通需要服务端引擎本身具备多平台协议转发能力，而非靠第三方转接工具。
二、主流三端互通引擎对比
GOM引擎三端版
GOM 1108以上版本推出GOM三端扩展包，底层采用Lua脚本+ProtoBuf通讯协议。服务端核心不变，但需要额外部署网关程序处理手机端连接。优点是对原版GOM版本兼容性好，大量商业版本可直接转换；缺点是需要购买授权，免费版限制在线人数且带弹窗。
GEE引擎三端版
GEE从2022年起主推三端架构，提供完整的安卓iOS客户端源码，服务端用C++编写，脚本沿用GEE语法。优点是UI自定义程度高，手机端支持高清素材自动适配；缺点是更新频率快，老版本升级到三端版需重写部分NPC脚本和地图加载逻辑。
HGE引擎(英雄引擎)
专为三端互通设计的引擎，服务端基于LuaJit，客户端用Unity开发。优势在于跨平台原生支持，无需额外网关，手机端性能优化较好；劣势是生态较小，现成版本少，需要自己搭建基础框架。
Legend引擎(传奇永恒衍生)
基于UE4底层重构的三端引擎，画面效果接近传奇类手游水准，但配置要求高，手机端发热明显，适合做高画质版本而非复古服。
其他小众引擎
LEG三端版、Blue三端魔改版、V8引擎等，但稳定性不如前三者，社区资源匮乏。
三、三端互通完整架设步骤
第一步 选择引擎并准备环境
以GEE三端版为例，下载完整服务端包，包含：
• MirServer文件夹(服务端核心)
• 安卓客户端源码(Android Studio项目)
• iOS客户端源码(Xcode项目)
• 网关程序(GateServer)
• 补丁工具(PAK/WIL转PNG)
服务器操作系统推荐Windows Server 2019及以上，内存不低于8GB，带宽至少10Mbps。需要安装Java运行环境(用于登录器生成)、MySQL或SQLite数据库(视引擎而定)。
第二布 配置服务端核心文件
打开MirServer目录，依次配置：
1. DBServer——数据库连接字符串，指定角色数据存放路径
2. LoginGate——监听端口默认7000，不要与其他服务冲突
3. SelGate——角色选择网关，端口7100
4. RunGate——游戏逻辑网关，端口7200
5. M2Server——核心启动程序，打开后进入“选项→功能设置→三端互通”勾选启用，填写手机端连接密钥
关键一步：在Mir200\Setup.txt中添加三端参数：
ThreeTerminal=1
MobilePort=7201
MobileKey=yourkey123
第三步 编译手机客户端
安卓端用Android Studio打开客户端源码，修改：
• app\src\main\java\com\legend\client\LoginActivity.java中的服务器IP为你公网IP
• res\values\strings.xml中的游戏名称
• 替换app\src\main\assets下的lui.pkg和data.pkg(界面布局文件)
• 生成签名APK，注意targetSdkVersion设为29以上，否则安卓13无法安装
iOS端用Xcode打开，修改：
• LegendClient\Network\SocketManager.mm中的连接地址
• Info.plist中的App Transport Security添加例外域名
• 打包IPA需付费开发者账号，企业签名可用但易掉签
第四步 部署网关与端口映射
手机端无法直连服务端，必须通过网关中转：
• 将GateServer.exe放在独立服务器或同机不同端口
• 配置GateServer.ini：
ListenPort=8080
TargetHost=127.0.0.1
TargetPort=7200
EncryptKey=yourkey123
• 路由器做端口映射：外网8080→内网网关IP:8080，外网7200→内网M2:7200
• 防火墙放行上述端口，TCP协议
第五步 测试联调
1. 先启动本地PC端登录器，确认能正常进游戏
2. 手机安装APK，用4G网络连接公网IP:8080
3. 如果卡在“正在连接”界面，检查网关日志报错，常见原因是密钥不匹配或端口未放行
4. 成功进入后创建角色，PC端刷新列表应能看到同一角色
四、三端互通特殊设置要点
UI自适应调整
手机屏幕比例16:9为主流，但全面屏比例多样。在客户端源码中找到ResolutionManager类，设置基准分辨率为1920*1080，UI控件按百分比定位而非固定像素。背包、技能栏、聊天框在手机上需缩小至原始大小的60%，通过lua/ui/config.lua调整缩放系数。
操作模式差异化
PC端鼠标点击移动+快捷键施法，手机端需要虚拟摇杆+技能按钮。在服务端脚本中判断客户端类型：
if ClientType == "mobile" then
-- 开启自动拾取
-- 增加攻击目标锁定按钮
-- 简化交易、摆摊操作流程
end
GEE引擎自带GetClientType()函数，GOM需通过插件实现。
数据库同步机制
三端互通的核心难点在于实时同步。确保所有玩家数据读写走统一数据库，不要用文件型数据库(如Access)，必须用MySQL或MSSQL。在DBServer配置中设置：
DatabaseType=mysql
DatabaseHost=127.0.0.1
DatabasePort=3306
DatabaseName=legenddb
每个角色上线时从数据库拉取数据，下线时写入，中间变更通过MQTT或Redis缓存，避免频繁IO导致卡顿。
素材处理差异
PC端使用WIL/PAK格式素材，手机端不支持这些格式，需要用引擎提供的工具批量转换为PNG序列帧。转换后放入客户端assets\res\monster、npc、item等对应目录。注意文件名保持与WIL索引号一致，否则显示空白。
五、常见问题排查
手机端黑屏/白屏
• 检查assets\lui.pkg是否损坏，重新用LuiEditor打包
• 确认显卡渲染模式设置为OpenGL ES 3.0
• 部分华为鸿蒙系统需关闭“增强渲染”选项
PC能进手机进不去
• 网关IP写成了127.0.0.1，应写服务器内网IP
• 手机端连接端口写错，应与Gateway监听端口一致
• 运营商封锁了非标端口，改用443或8080等常用端口
角色数据不同步
• 数据库连接超时，增大timeout值到30秒
• 两个客户端同时在线时，检查是否开启了双写，应在M2中关闭“本地缓存”
• 物品掉落延迟，调整RunGate的SendBufferSize到65536
苹果端安装失败
• 未添加UDID到开发者证书
• 使用了免费的7天签名过期
• iOS 16以上需开启开发者模式才能侧载
三端互通的本质是让服务端协议层兼容多平台，引擎决定了80%的工作量。新手建议从GEE三端版起步，社区有现成的客户端源码和转换工具，不需要从头写渲染层。熟练后再根据需求换HGE或Legend做定制。
