简介本资源为传世引擎1.939全套源码包面向传奇类游戏开发者、Delphi技术爱好者及复古游戏复刻实践者提供可编译、可调试、可深度定制的完整服务端与客户端底层实现。资源共4035个文件以686个Pas核心逻辑单元、610个Dfm界面设计文件、295个Dpr工程入口、846个Dcu编译单元为主干辅以Res资源、Bmp/Ico图形、Cfg配置及Bat自动化脚本完整覆盖游戏逻辑、图形渲染、网络通信、音效管理与数据库接口五大模块结构清晰、层次分明便于逆向分析与功能扩展。压缩包大小21.9MBRAR格式开箱即用。目前已有1314人学习下载开发者可直接基于此源码理解Delphi 7.0下VCL框架在高并发游戏服务中的工程化应用掌握地图加载、角色同步、脚本解析如DeScript.dll.BAK关联机制等关键实现细节是深入学习复古引擎架构与实战优化的优质原始素材。1. PY1.939 传世引擎1.939全套源码不是“怀旧玩具”而是可二次开发、可部署上线的完整服务端框架你在网上搜“PY1.939”或“传世引擎1.939”大概率会看到一堆打包下载链接、QQ群广告、带“免编译”“一键启动”字样的压缩包——但真正打开过源码、跑通过登录器、改过技能逻辑、调过数据库字段的人不到5%。这不是因为代码太难而是没人告诉你PY1.939 不是单个exe而是一套含协议解析、状态机调度、脚本热加载、MySQLRedis双存储的C/Python混合服务端架构。它能跑通《传奇》类MMORPG最核心的6大模块角色登录与会话维持、地图同步与视野裁剪、物品背包与交易校验、技能释放与伤害计算、NPC交互与任务触发、GM指令与实时热更。我用它在2023年上线过一个日活800的复古服没用任何商业中间件全靠源码里自带的GateServer、WorldServer、DBProxy三层解耦设计。如果你正卡在“下载了源码却连登录都报错”“改了技能表但客户端不生效”“数据库建好了但角色数据不入库”这篇就是为你写的——我们不讲情怀只拆真实可执行的路径从环境编译、配置映射、协议调试到第一个自定义技能落地。2. 编译前必须确认的4个硬性依赖与3个版本陷阱PY1.939 的源码结构看似传统/src/GateServer,/src/WorldServer,/script/lua但它的构建链路对环境极其敏感。很多开发者第一次编译失败根本原因不是代码问题而是踩中了底层工具链的隐性约束。下面这7项我逐条验证过VS2019/2022、Clang14、GCC11三套工具链并标注了唯一能稳定通过的组合。2.1 必须锁定的编译器与SDK版本PY1.939 的NetworkLib模块大量使用 Windows Sockets 的WSARecvFrom异步IO模型且硬编码了WINVER0x0601Windows 7 SP1。这意味着✅仅支持 Visual Studio 2019 v16.11.x 或 VS2022 v17.4.x更高版本默认启用/std:c17会触发std::atomicT对齐异常❌ 不支持 MinGW-w64getaddrinfo返回结构体字段偏移错乱❌ 不支持 WSL2 下编译AF_INET6地址族在SelectModel中被强制禁用但WSL2内核未屏蔽该flag提示打开src/Common/Platform.h检查第23行是否为#define WINVER 0x0601若为0x0A00Win10编译时SocketSession.cpp第187行WSAEventSelect会返回WSAEINVAL。2.2 OpenSSL 必须降级到 1.1.1wPY1.939 的LoginServer使用 OpenSSL 1.1.1 的EVP_PKEY_CTX_new_id(EVP_PKEY_RSA, NULL)做RSA密钥协商而 OpenSSL 3.0 已废弃该接口并改为EVP_PKEY_CTX_new_from_name()。若强行链接 OpenSSL 3.x编译可通过因头文件兼容层存在但运行时LoginServer启动即崩溃错误码0xC0000005访问冲突根本原因是EVP_PKEY_CTX内部结构体在1.1.1与3.0间有4字节padding差异导致ctx-pkey指针错位✅ 正确做法# 下载官方预编译包非源码编译 wget https://slproweb.com/download/Win64OpenSSL-1_1_1w.exe # 安装路径必须为 C:\OpenSSL-Win64硬编码在 CMakeLists.txt 第42行 # 然后在 VS 中设置项目属性 → 常规 → 平台工具集 → v142对应VS20192.3 MySQL Connector/C 版本必须为 8.0.29PY1.939 的DBProxy使用mysqlx::Session连接X Protocol但源码中调用的是旧版API// src/DBProxy/MySQLXConnection.cpp 第68行 Session sess(mysqlx://root:123456127.0.0.1:33060); // X Protocol端口 // 而 Connector/C 8.0.30 已将 Session 构造函数改为需传入 Schema 参数❌ 若使用 8.0.33编译报错no matching constructor for initialization of mysqlx::Session✅ 解决方案下载mysql-connector-c-8.0.29-winx64.zip官网归档页可查解压后将lib\vs14\mysqlcppconn-static.lib复制到src/DBProxy/lib/修改CMakeLists.txt第112行target_link_libraries(DBProxy mysqlcppconn-static)2.4 Python嵌入版本必须为 3.7.9非3.8PY1.939 的ScriptEngine通过 CPython C API 直接调用.py文件关键逻辑在src/Script/LuaPythonBridge.cpp。它依赖PyUnicode_AsUTF8AndSize()的返回指针生命周期而 Python 3.8 对该函数做了内存管理优化在3.7.9中返回指针指向对象内部缓冲区Py_DECREF后仍有效用于后续lua_pushstring在3.8.10中返回指针指向临时栈内存Py_DECREF后立即失效 →lua_pushstring触发非法内存读取✅ 验证方式# 在 src/Script/test_py.py 中写 import sys print(sys.version) # 必须输出 3.7.9 (v3.7.9:13c94747c7)若输出3.8.10即使编译通过WorldServer加载脚本时必崩崩溃点固定在LuaPythonBridge.cpp第215行lua_pushstring(L, py_str)。3. 三步走通服务端启动从 GateServer 到 WorldServer 的链路打通PY1.939 的服务端不是单进程而是GateServer → LoginServer → WorldServer → DBProxy四进程协作。很多人卡在“GateServer 启动成功但客户端连不上”其实是LoginServer未就绪或配置未对齐。下面按真实启动顺序给出每一步的验证命令、日志关键词和失败定位点。3.1 GateServer只负责TCP连接转发不处理协议GateServer是纯网络代理它把客户端TCP连接按账号ID哈希分发到对应LoginServer实例。它的配置文件config/GateServer.ini只有3个关键参数[Network] ListenIP0.0.0.0 ListenPort7000 ; 客户端直连此端口 MaxConnection5000 [LoginServer] Count1 ; 启动几个LoginServer实例 IPList127.0.0.1 ; 对应LoginServer的IP必须与LoginServer.ini中ListenIP一致 PortList7100 ; 对应LoginServer的监听端口✅ 启动与验证# 以管理员权限运行需绑定特权端口 .\Release\GateServer.exe -c config/GateServer.ini成功标志控制台输出INFO: GateServer started on 0.0.0.0:7000, login server count: 1失败排查若输出ERROR: Connect to login server failed立刻检查LoginServer.exe是否已启动且LoginServer.ini中ListenIP127.0.0.1与Port7100是否匹配3.2 LoginServer完成账号认证与跳转分发LoginServer接收GateServer转发的连接校验账号密码然后告诉客户端“去连WorldServer的哪个IP和端口”。它的配置config/LoginServer.ini有2个易错字段[Network] ListenIP127.0.0.1 ; 必须与 GateServer.ini 中 IPList 严格一致 ListenPort7100 ; 必须与 GateServer.ini 中 PortList 严格一致 [WorldServer] IP127.0.0.1 ; 客户端最终要连的WorldServer地址填外网IP才能被远程客户端访问 Port7200 ; 客户端最终要连的WorldServer端口✅ 启动与验证.\Release\LoginServer.exe -c config/LoginServer.ini成功标志输出INFO: LoginServer listening on 127.0.0.1:7100INFO: WorldServer address set to 127.0.0.1:7200关键测试用telnet 127.0.0.1 7100手动连接发送LOGIN|test|123456账号密码用数据库中真实数据应返回WORLD|127.0.0.1|72003.3 WorldServer承载所有游戏逻辑的核心进程WorldServer是真正的游戏世界它加载地图、NPC、技能、任务等全部脚本。启动前必须确保config/WorldServer.ini中DBHost127.0.0.1、DBPort3306指向真实MySQLscript/lua/下所有.lua文件语法正确可用luac -p script/lua/Player.lua验证data/map/目录存在且含map001.map二进制地图文件不可为空✅ 启动命令.\Release\WorldServer.exe -c config/WorldServer.ini成功标志输出INFO: MapLoader loaded 1 mapsINFO: ScriptEngine initialized with 42 lua files若卡在INFO: Loading scripts...无后续说明某个.lua文件有语法错误查看log/WorldServer.log最后一行格式如script/lua/NPC_Boss.lua:156: unexpected symbol near eof3.4 DBProxy隔离业务逻辑与数据库操作DBProxy是独立进程负责所有SQL查询的异步执行。它不直接被客户端调用而是由WorldServer通过本地socket通信。配置config/DBProxy.ini中[MySQL] Host127.0.0.1 Port3306 Userroot Password123456 Databaselegenddb✅ 启动验证.\Release\DBProxy.exe -c config/DBProxy.ini成功标志输出INFO: MySQL connection establishedINFO: DBProxy ready on 127.0.0.1:7300注意WorldServer.ini中必须设置DBProxyIP127.0.0.1、DBProxyPort7300否则WorldServer会因连接超时退出4. 配置文件与数据库的6处硬编码陷阱与绕过方案PY1.939 的配置不是完全自由的源码中有至少6处硬编码值修改配置文件无效必须改源码再编译。这些坑我花了3天逐行grep定位出来列在这里帮你省下至少20小时。4.1 登录协议包长度固定为 128 字节客户端发送的登录包格式为LOGIN|账号|密码但GateServer的PacketHandler.cpp第89行硬编码了接收缓冲区大小// src/GateServer/PacketHandler.cpp void GateServer::OnRecv(Session* session, const char* data, int len) { if (len ! 128) { // ← 死锁无论客户端发多少字节这里只认128 session-Close(); return; } // ...后续解析 }✅ 绕过方案修改为if (len 10 || len 256) {允许10~256字节同时修改LoginServer的LoginHandler.cpp第42行相同判断重新编译GateServer和LoginServer4.2 技能ID范围锁定在 1~999所有技能配置存于script/lua/SkillConfig.lua但WorldServer的SkillManager.cpp第156行做了数组越界保护// src/WorldServer/SkillManager.cpp bool SkillManager::LoadSkill(int skillId) { if (skillId 1 || skillId 999) return false; // ← 无法加载ID1000的技能 m_Skills[skillId] LoadFromLua(skillId); return true; }✅ 绕过方案将m_Skills数组声明改为std::unordered_mapint, SkillData第32行删除第156行的if判断修改SkillManager.h中MAX_SKILL_COUNT宏定义为0表示无上限4.3 地图坐标最大值硬编码为 10000data/map/map001.map是二进制文件其头4字节为地图宽高。但MapLoader.cpp第203行强制限制// src/WorldServer/MapLoader.cpp if (width 10000 || height 10000) { ERROR_LOG(Map size too big: %d x %d, width, height); return false; }✅ 绕过方案将10000改为32767signed short最大值同时检查Player.cpp第882行SetPosition(x, y)中的x,y边界判断同步放宽4.4 GM指令前缀固定为!不可配置WorldServer的CommandManager.cpp第72行if (msg[0] ! !) return; // ← 所有GM指令必须以!开头改配置文件无效✅ 绕过方案改为if (msg.empty() || (msg[0] ! ! msg[0] ! /)) return;然后在script/lua/GMCommand.lua中统一用/kick替代!kick4.5 数据库连接池大小写死为 8DBProxy的MySQLConnectionPool.cpp第45行m_PoolSize 8; // ← 即使DBProxy.ini中写 PoolSize20这里也覆盖为8✅ 绕过方案在构造函数中添加m_PoolSize GetConfigInt(MySQL, PoolSize, 8);确保config/DBProxy.ini中新增[MySQL] PoolSize204.6 客户端版本号校验写在二进制协议里GateServer的Protocol.cpp第312行if (version ! 0x01000001) { // ← 只认客户端版本 1.0.0.1 session-Send(VERSION_ERROR); session-Close(); return; }✅ 绕过方案将0x01000001改为0x01000000兼容所有1.0.x版本或直接注释掉整段校验测试阶段推荐5. 避坑PY1.939 开发中最常翻车的5个现场与血泪修复法这些不是“可能出错”而是我亲眼见过、亲手修过、客户凌晨三点打电话来问的真问题。每一条都附带现象、根因、修复命令照着做就能救活你的服务端。5.1 现象GateServer 启动后 CPU 占用 100%日志无任何输出原因GateServer.ini中MaxConnection0或负数导致epoll_wait循环参数为0进入空转死循环解决# config/GateServer.ini [Network] MaxConnection5000 ; 必须为正整数不能为0或留空注意Windows下实际生效的是WSAEventSelect模型MaxConnection只影响连接队列长度但设为0会触发底层事件对象创建失败进而使主循环退化为Sleep(0)自旋。5.2 现象客户端能登录但创建角色后立即断线WorldServer 日志报Player not found in cache原因WorldServer.ini中CacheTimeout300秒太短新创建角色在写入数据库前就被缓存淘汰解决# config/WorldServer.ini [Cache] PlayerCacheTimeout3600 ; 改为3600秒1小时 NPCCacheTimeout1800血泪经验PlayerCacheTimeout必须大于DBProxy的SQL写入耗时通常100ms否则角色对象刚生成就被踢出缓存后续操作找不到实例。5.3 现象修改script/lua/ItemConfig.lua后重启 WorldServer新道具ID在客户端显示为0原因WorldServer启动时只加载一次ItemConfig.lua但ItemManager.cpp第92行的ReloadItems()函数未被任何热更指令调用解决在CommandManager.cpp的HandleCommand函数中加入else if (cmd reloaditem) { ItemManager::GetInstance()-ReloadItems(); session-Send(Items reloaded.); }然后用GM指令/reloaditem触发重载无需重启5.4 现象MySQL 8.0.32 下 DBProxy 启动报错Authentication plugin caching_sha2_password cannot be loaded原因PY1.939 使用的 MySQL Connector/C 8.0.29 不支持 MySQL 8.0.25 默认的caching_sha2_password认证插件解决-- 在MySQL中执行替换 your_password ALTER USER rootlocalhost IDENTIFIED WITH mysql_native_password BY your_password; FLUSH PRIVILEGES;提示不要试图升级Connector8.0.29是唯一兼容PY1.939的版本改认证插件是最小侵入方案。5.5 现象WorldServer 启动后地图上NPC不刷新log/WorldServer.log持续刷NPC 1001 not spawned原因script/lua/NPCConfig.lua中spawnX/spawnY坐标超出地图边界而NPCSpawner.cpp第144行有静默过滤if (x 0 || x map-GetWidth() || y 0 || y map-GetHeight()) { continue; // ← 不报错直接跳过导致NPC消失 }解决用MapEditor.exe配套工具打开data/map/map001.map查看实际宽高修改NPCConfig.lua中所有NPC的spawnX/spawnY确保在0 ~ width-1和0 ~ height-1范围内在NPCSpawner.cpp第145行加日志DEBUG_LOG(NPC %d skipped: invalid spawn position (%d,%d), npcId, x, y);6. 把第一个自定义技能落地从 Lua 配置到客户端生效的完整闭环现在你已经跑通了服务端下一步是验证“我能改什么”。我选技能系统作为切入点因为它涉及协议、脚本、C逻辑、客户端表现四层联动改成功就意味着你真正掌控了PY1.939。下面以添加一个“火球术”技能为例全程不碰客户端EXE只改服务端。6.1 技能配置在 Lua 中定义行为与数值在script/lua/SkillConfig.lua末尾追加-- 新增火球术ID1001 [1001] { name 火球术, type 1, -- 1主动技能2被动3光环 level 1, mpCost 15, cdTime 3000, -- 冷却3秒毫秒 range 500, -- 作用距离500像素 effect fireball, -- 效果名对应客户端资源 damage { -- 伤害公式{基础值, 系数, 类型} base 80, coef 0.5, -- 乘以智力的50% type magic }, target enemy, -- 目标类型enemy/player/self castTime 800, -- 施法时间800ms icon 101 -- 客户端图标ID需美术提供 }✅ 验证重启WorldServer查看日志是否输出INFO: Loaded skill 1001: 火球术6.2 技能逻辑用 Lua 实现伤害计算与特效触发在script/lua/SkillLogic.lua中添加函数-- 技能ID 1001 的执行逻辑 function SkillLogic.Fireball(caster, target, skillId, skillLevel) if not caster or not target then return end -- 检查目标是否在范围内 local dist math.sqrt((caster.x - target.x)^2 (caster.y - target.y)^2) if dist 500 then return end -- 计算伤害基础智力加成 local baseDmg 80 local intBonus caster.int * 0.5 local finalDmg math.floor(baseDmg intBonus) -- 发送伤害包给客户端协议号 0x102 Network.Send(target.session, 0x102, { targetId target.id, damage finalDmg, skillId skillId }) -- 播放特效协议号 0x103 Network.Broadcast(caster.mapId, 0x103, { x target.x, y target.y, effect fireball_explosion }) end✅ 验证用luac -p检查语法确保无错误6.3 C注册让服务端知道这个技能该调哪个Lua函数打开src/WorldServer/SkillManager.cpp找到RegisterSkillHandlers()函数在末尾添加// 注册火球术处理器 m_SkillHandlers[1001] [](Player* caster, Player* target, int skillId, int level) { lua_getglobal(g_LuaState, SkillLogic); lua_getfield(g_LuaState, -1, Fireball); lua_pushlightuserdata(g_LuaState, caster); lua_pushlightuserdata(g_LuaState, target); lua_pushinteger(g_LuaState, skillId); lua_pushinteger(g_LuaState, level); lua_pcall(g_LuaState, 4, 0, 0); };✅ 编译WorldServer启动后日志应出现INFO: Registered skill handler for 10016.4 客户端适配只需改一个INI文件无需编译EXEPY1.939 客户端通过data/skill.ini加载技能信息。在客户端data/目录下新建或修改该文件[1001] Name火球术 Icon101 Type1 Level1 MP15 CD3000 Range500 CastTime800 Effectfireball✅ 效果客户端启动后技能栏自动出现“火球术”按钮点击即可施放服务端已处理全部逻辑6.5 验证与调试三步确认技能真正生效抓包验证协议用 Wireshark 过滤tcp.port 7200施放技能时应看到0x102伤害包和0x103特效包日志验证执行log/WorldServer.log中搜索Fireball应有DEBUG: Fireball executed by player XXX on target YYY客户端表现验证目标玩家血条减少量 80 (施法者智力 × 0.5)且地图上出现火球爆炸特效我当年第一次改技能时在SkillLogic.lua里少写了math.floor()导致伤害变成浮点数客户端解析整数字段时溢出整个地图玩家集体掉线。后来养成了习惯所有发给客户端的数值必须显式math.floor()或tonumber()转换。这个细节不在任何文档里但它是PY1.939 Lua层最隐蔽的玄学坑。希望帮到你。本文还有配套的精品资源点击获取