传奇服务端假人模块开发技术实现路径

传奇服务端假人模块指在M2Server或同类引擎中内嵌模拟玩家行为的逻辑单元，使其无需真实客户端即可执行移动、战斗、交互等操作。该模块需深度集成于服务端主循环，通过角色状态机与事件驱动机制实现高仿真行为。

一、角色数据结构扩展
在PlayerObject类中新增IsDummy字段标识假人身份。假人账号可预置于UserDB.txt或数据库表，登录时由LoginSrv识别标记。其角色数据（坐标、血量、背包）与真实玩家共用同一套存储结构，但网络收发模块跳过Socket处理，直接调用内部函数更新状态。

二、行为控制核心逻辑
假人行为由独立线程或定时器驱动，每200毫秒执行一次决策循环。流程包括：环境扫描→目标选择→路径计算→动作执行。环境扫描读取当前地图怪物列表（MonsterList）及物品堆（ItemArray），依据预设规则过滤有效目标。例如道士假人优先锁定毒抗低的怪物，法师假人避开近身单位。

三、路径与移动实现
采用A*算法或预设路点系统。若地图为标准网格（如384x384），可构建二维障碍矩阵，实时计算最短路径。移动指令不依赖客户端上报，而是直接调用TPlayer::WalkTo(x, y)函数，同步更新地图单元格占用状态。跨地图传送通过TMap::Teleport接口完成，无需触发客户端动画。

四、战斗与技能调度
技能释放基于冷却计时器与条件判断。每个假人维护技能CD数组，如冰咆哮CD=3秒。攻击前校验距离（Math::Distance <= SkillRange）、蓝量（MP >= Cost）及目标存活状态。道士假人额外处理召唤兽生命周期，当神兽死亡且CD就绪时自动重召。所有伤害计算调用原版CombatEngine，确保数值一致性。

五、物品交互机制
捡物功能通过遍历地图物品链表实现。假人检测周围3格内物品，匹配名称白名单后调用TPlayer::PickUpItem(pItem)。背包满时触发丢弃策略：按价值排序，移除最低价值非绑定物品。使用药品通过TPlayer::UseItem(ItemID)模拟，阈值由配置文件定义（如HP<50%吃红）。

六、攻城与协同逻辑
沙巴克战期间，假人读取全局事件标志（g_SabukWarActive）。守方假人自动传送至皇宫坐标（324,310），进入战斗状态；攻方假人则沿预设进攻路线推进。行会归属通过Player->GuildName比对，敌我识别调用原版PK判断函数，避免误伤同会成员。

七、配置与调试接口
模块参数集中于!DummyConfig.txt，包含数量上限、默认职业、行为模式（守怪/攻城/挖矿）。GM命令如@adddummy 1 35 支持动态创建。日志输出至DummyLog.txt，记录目标选择、技能释放等关键节点，便于行为调优。

该模块完全运行于服务端进程，不依赖外部辅助或客户端注入，资源占用可控。假人行为逻辑可按职业、等级、装备动态调整，适用于压力测试、内容演示或单机增强场景。