|
一、分身的设计理念：临时存在的复制体，不是伙伴也不是宠物
理解分身系统，先要理解分身和英雄、宠物的本质区别。
英雄是玩家的第二角色，永久存在，有独立的职业、性别、名字、等级、装备，能和主体配合释放合击。英雄是 "另一个你"，是长期伙伴。
宠物是玩家收服的怪物，可以有多只，能升级能穿装备能拾取，死亡后需要复活，可以变成蛋交易。宠物是 "你养的伙伴"，也是长期存在的。
分身不一样。分身是临时存在的复制体—— 召唤出来存在一段时间，时间到了自动消失，或者被杀死后消失。分身没有独立的等级和装备系统，它的属性是从主体继承来的，外观也是复制主体的（可以定制）。分身不是伙伴，是一个 "临时战斗单位"，用完就没了。
这个定位决定了分身系统的接口设计非常简洁 —— 不需要创建、删除、改名、升级、穿装备这些长期伙伴才需要的接口。分身只需要三个操作：召唤出来、看看有哪些、杀掉。生命周期完全由时间和战斗决定，不需要玩家长期管理。
这种 "极简接口 + 丰富参数" 的设计思路很聪明。分身的核心需求就是 "召唤一个和我类似的临时单位帮我打架"，所有的差异化都通过召唤参数来实现 —— 存在多久、几个、继承多少属性、长什么样、多少血、带什么 BUFF。参数覆盖了所有可能的自定义维度，接口只需要一个召唤函数。
二、召唤参数：十三个参数覆盖了复制体的所有维度
recallself 接口有十三个参数，看起来多，但其实可以分成几组，每组管一个维度。
第一组是基础生存参数：时间和数量。 time 是分身存在的秒数，到时间自动消失。 num 是召唤几个分身。这两个参数决定了分身的基本规模 —— 存在多久、有多少个。做技能的时候，低级技能召唤 1 个存在 10 秒，高级技能召唤 3 个存在 30 秒，就是调这两个参数。
第二组是属性继承参数：attrPro 和 hpMax。 attrPro 是继承人物属性的百分比，比如填 80 就是分身拥有主体 80% 的属性。这个参数是分身系统的核心 —— 分身不需要自己配属性，直接从主体按比例继承，主体越强分身越强。这个设计让分身的强度和玩家挂钩，玩家装备好等级高分身就厉害，不需要单独平衡分身的属性。
hpMax 是后来加的参数（引擎 64_24.05.23 新增），可以直接指定分身的血量数值，填 0 表示按继承百分比算。这个参数给了更精细的控制 —— 有时候你不想分身血量按主体比例来（比如主体血太厚分身也太厚就不平衡了），可以直接指定一个固定血量。两个参数配合，既可以简单地按比例继承，也可以精细地单独指定血量。
第三组是外观定制参数：color、dressLook、weaponLook、dressEffect、weaponEffect。 这五个参数控制分身长什么样。 color 是分身的颜色（0-255，0 不改变），可以让分身和主体有颜色区分。 dressLook 和 weaponLook 可以改变分身的衣服和武器外观， dressEffect 和 weaponEffect 改变衣服和武器的特效。
这组参数的意义在于：分身不一定非要和主体长得一模一样。你可以让分身穿不同的衣服、拿不同的武器、有不同的颜色和特效，做 "幻影"" 化身 ""灵体" 等不同视觉风格的分身。比如做一个 "暗影分身" 技能，分身是黑色的（color 设成深色），穿黑衣服，就和主体有明显区分。做 "光明分身" 就用白色或金色。外观定制让分身的视觉表现有了足够的差异化空间。
第四组是 BUFF 参数：buffID。 这个也是后来加的（引擎 64_24.05.23 新增），可以给分身附加 BUFF，多个 BUFF 用 #号连接。这个参数的意义是：分身召唤出来的时候自动带上指定的 BUFF，不需要你召唤后再一个个加。做 "狂暴分身"" 护盾分身 " 等特殊分身的时候，召唤时直接带上对应的 BUFF，一步到位。
十三参数分四组，每组管一个维度 —— 生存、属性、外观、BUFF。这个参数设计覆盖了 "召唤一个复制体" 可能需要自定义的所有方面。而且从更新时间来看，这个系统还在迭代 ——hpMax 和 buffID 都是后来加的，说明引擎开发者在根据实际需求不断完善分身的自定义能力。
三、分身的管理：列表和清除，简单直接
分身的管理只有两个接口： clonelist 获取分身列表， killcopyself 杀死所有分身。
clonelist 返回玩家所有分身的对象列表，拿到列表之后可以遍历每个分身做操作 —— 查血量、改属性、加 BUFF、移动位置等等。因为分身本质上是一个游戏对象（和玩家、怪物类似），拿到对象之后很多通用接口都能用。
killcopyself 杀死玩家所有分身，返回分身列表。这个接口的应用场景是：玩家切换地图、下线、或者技能结束时，需要手动清除分身。虽然分身有时间限制会自动消失，但有时候需要提前清除 —— 比如玩家用了另一个分身技能，要先杀掉旧分身再召唤新的；或者玩家进了安全区，分身不应该跟着进去。
两个管理接口都很简单，因为分身的生命周期本来就不需要复杂管理 —— 召唤出来自动存在，时间到自动消失，需要提前清除就杀掉。不需要像宠物那样有召唤、收回、复活、变蛋、删除等一堆操作。
这里有个值得注意的设计： killcopyself 返回的是分身列表，而不是简单的成功 / 失败。这意味着你在杀死分身之后还能拿到被杀死的分身对象，可以做一些收尾操作 —— 比如播放死亡特效、给玩家反馈、记录日志。虽然大部分场景可能不需要这个返回值，但留着总比没有好，需要的时候能用。
四、分身和英雄、宠物的对比：三种召唤物的定位差异
把分身、英雄、宠物放在一起对比，能更清楚地理解分身系统的定位。
英雄是永久第二角色：独立职业性别名字等级装备，合击技能，长期管理，接口中等（二十个左右）。
宠物是可养成伙伴：多只、升级、装备、拾取、变蛋交易、复活，长期管理，接口多（五十个左右）。
分身是临时复制体：继承主体属性、临时存在、外观可定制、不需要管理，接口极少（三个）。
- 需要一个长期的、和主体平级的战斗伙伴 → 英雄
- 需要可养成、可收集、可交易的宠物 → 宠物
- 需要一个临时的、和主体类似的战斗单位 → 分身
这种分层设计很合理。如果所有召唤物都用一套系统，接口会非常复杂，很多功能对某些召唤物来说是多余的（比如分身不需要升级和穿装备）。分开成三个系统，每个系统只做自己需要的功能，接口简洁，职责清晰。
分身系统的极简设计恰恰是它的优势 —— 因为分身不需要那些复杂的管理功能，所以三个接口就够了。开发者用起来也简单，不需要记一堆接口，召唤、查列表、清除，三个操作搞定。
五、应用场景：技能、道具、特殊玩法
分身系统的应用场景非常广，核心思路是 "召唤一个和玩家类似的临时单位"。
最经典的是技能。 法师的 "分身术"、战士的 "幻影斩"、道士的 "元神出窍"，本质上都是召唤分身。不同职业的分身技能可以通过参数差异化 —— 法师分身继承魔法属性高，战士分身继承物理攻击高，道士分身继承道术。技能等级影响分身的数量、存在时间、属性继承比例。
道具类应用。 消耗品 "分身卷轴"，使用后召唤几个分身帮忙战斗一段时间。"幻影药水"，喝了之后召唤一个和自己一模一样的幻影迷惑敌人。这些道具通过调用 recallself 实现，参数根据道具品质调整。
特殊玩法。 比如 "试炼之地" 里玩家可以召唤自己的分身作为对手，和自己对战；"镜像副本" 里 BOSS 可以召唤玩家的分身来打玩家；"双人合体" 技能两个玩家互相召唤对方的分身协同作战。这些玩法都基于分身系统的 "复制玩家" 能力。
迷惑和战术应用。 PVP 中召唤分身可以迷惑敌人 —— 敌人不知道哪个是真身哪个是分身，攻击选择会出错。分身还能吸引怪物仇恨，让主体有时间输出或逃跑。这些战术应用不需要额外的接口支持，分身的基本行为（会攻击、会被攻击）就天然支持。
应用场景的多样性，正是因为分身系统的参数设计足够灵活。同样是 recallself，调不同的参数就能实现完全不同的效果 ——1 个存在 5 秒继承 50% 属性的是 "诱饵分身"，3 个存在 30 秒继承 100% 属性带 BUFF 的是 "终极分身术"。接口不变，参数千变万化。
六、几个实际使用中的心得和坑
把分身系统过完，结合传奇类游戏的开发经验，总结几个心得和容易踩的坑。
第一，分身的属性继承是按主体当前属性算的，召唤后主体属性变化分身不会跟着变。 比如玩家召唤了分身之后换了装备、加了 BUFF，主体属性变了，但已经召唤出来的分身属性还是召唤时的数值。做技能平衡的时候要注意这一点 —— 如果玩家可以先换装召唤分身再换回来，可能会利用这个机制刷出高属性分身。如果不想让玩家这么玩，可以在召唤时锁定装备或者加限制。
第二，分身死亡或时间到了之后， clonelist 就拿不到了。 不要把分身对象存下来长期使用，分身是临时的，随时可能消失。需要操作分身的时候每次都从 clonelist 重新拿，不要缓存。
第三，killcopyself 会杀死所有分身，不能只杀指定的一个。 如果你需要只清除某个特定分身（比如玩家手动解散一个），这个接口做不到，它是全杀。需要单杀的话，可能要从 clonelist 拿到特定分身对象，然后用怪物 / 玩家系统的击杀接口来处理（如果分身对象支持的话）。或者设计成分身只能全部清除，不能单个解散。
第四，外观定制参数填 0 或空表示不改变，不要填 0 以为是 "清除外观"。 dressLook、weaponLook 这些参数填 0 就是不改变外观，分身穿和主体一样的衣服武器。如果想让分身不穿衣服（如果支持的话），可能需要特殊的值，0 不是 "无" 而是 "不变"。
第五，buffID 参数多个 BUFF 用 #号连接，注意格式。 不要用逗号或其他分隔符，必须是 #号。而且 BUFFID 要确认是有效的，无效的 BUFFID 可能导致召唤失败或者 BUFF 不生效。
第六，分身的 AI 行为引擎内置，脚本不能直接控制。 文档里没有给分身的行为控制接口（比如设置攻击模式、移动目标），说明分身的 AI 是引擎内置的 —— 自动攻击附近敌人、跟随主体之类的。脚本只能通过召唤参数和通用对象接口间接影响分身，不能直接控制分身的行为。做需要精细控制分身行为的玩法时，要先确认引擎内置的 AI 能不能满足需求。
第七，注意分身和主体的区分。 分身继承主体外观，如果不改颜色和外观，玩家和敌人可能分不清哪个是真身。建议至少给分身一个不同的颜色，或者加个特殊特效，让分身可辨识。不然 PVP 中分身太多会导致视觉混乱，玩家体验不好。
第八，分身数量不要太多，注意性能。 num 参数虽然可以填大数字，但召唤太多分身会影响服务器性能 —— 每个分身都是一个独立的战斗单位，需要 AI 计算、碰撞检测、网络同步。一般技能召唤 1-3 个比较合理，特殊玩法最多也不要超过 5-6 个。做技能设计的时候要在效果和性能之间平衡。
| 
