《炉石传说》架构设计分析：卡牌&技能数据

GameRes游资网授权发布 文 / 燕良@游戏开发

经过前面几次的尝试，我们对炉石的代码已经不陌生了。除了网络机制还没有了解以外，本机的逻辑已经比较熟悉了。

接下来继续向暴雪最NB的技能系统进发，我们的目标是：

• 分析技能的静态数据描述；
• 分析技能的运行时数据、逻辑组织；
  

这篇笔记主要记录对其分析数据。

静态数据组织

卡牌数据

• 卡牌的基本数据对于的AssetFamily为：AssetFamily.CardXML；
• 数据对于的资源包为“cardxml0.unity3d”；
• 资源包中的资源类型为：TextAsset；
• 资源加载使用的接口为：AssetLoader：LoadCardXml()；
• 运行时对应的数据类型为：EntityDef；
• xml文件中保存有多个Entity对象数据，具体数据例如：
  

牌实体

• 卡牌实体对象对应的AssetFamily为：AssetFamily.CardPrefab；
• 数据对应的资源包为“cards？.unity3d”，目前共有4个；
• 资源包中的资源类型为：Prefab；
• 资源加载对应的接口为：AssetLoader：LoadCardPrefab()；
• 卡牌资源使用CardID进行索引，例如“闪金镇步兵”对应“CardID="CS1_042"”；
• Prefab中的GameObject主要包含：Transform、Material、CardDef，这三个Component；
  

CardDef有很多CustomEditField，主要分为以下几类：

• EditType.SOUND_PREFAB；
• Material，主要是Portrait--头像；
• EditType.SPELL，其实是string类型，保存的是Spell对象的资源路径；
  

技能对象

• 技能对象对应的AssetFamily为：AssetFamily.Spell；
• 数据对应的资源包为“spells?.unity3d”，目前共有3个；
• 资源包中的资源类型为：Prefab；
• 资源加载对应的接口为：AssetLoader：LoadSpell()；
• 卡牌通过CardDef中指定相关技能资源的路径；
• Prefab中的GameObject主要包含：AudioClip、AudioSource、Material、ParticleSystem、ParticleSystemRenderer、Transform等组件；
• 涉及到的脚本主要有：PlayerMaker相关的类，Spell及其派生类、SoundDef；
  

我们看到Spell有很多的派生类，这里用到了一个小技巧：GetComponent()是可以把基类作为参数来获得子类对象的。例如，一个对象绑定了ArmorSpell对象，而ArmorSpell是Spell的派生类，那么gameObject.GetComponent<Spell>()是可以获得这个ArmorSpell对象的。

总结一下：

卡牌和技能相关的数据主要包括以上三种，其中EntityDef是使用“策划填表”或者类似的方式，而且卡牌和技能资源，则使用Unity编辑成Pefab。技能对象中用到了PlayerMaker插件。

本次分析涉及到的类，请详见下图。



主要的类

通过之前的分析，卡牌&技能涉及到几个类体系：Entity，Actor，Card，Spell，令人十分困惑，特别是前两者。在这里先略带武断的说一下这几个类的基本定位：

• Entity主要用来做网络数据同步用的；
• Actor主要处理客户端的渲染对象的控制，作为Component挂载在资源对象上；
• Spell是技能Prefab挂载的脚本；
• Card是卡牌Prefab挂载的脚本，在运行时处于中心地位，处理前3者的联系。
  

Entity

Entity是通过网络数据创建的，主要是Network.PacketID.POWER_HISTORY这个消息。详见GameState.CreateNewEntities()函数。因为Entity并不是MonoBehavior派生类，所以是new出来的，然后添加到GameState中管理（GameState.AddEntity()），网络传来的Entity数据主要是Tags（每个Tag是一个name->value对），然后调用Entity.InitEntity()；

Actor

• Actor也是一种资源，通过AssetLoader.LoadActor()加载；
• 对应于AssetFamily.Actor；
• 对应的资源包为“actor?.unity3d”，包内的为GameObject；
• Actor的加载入口是在：Card.DetermineActorThenTransitionToZone()
  

Spell

Spell的加载入口是在Entity.ProcessCardDefAssetRequest()

Card

• 在InitEntity中调用了Entity.InitCard()，它做的工作只是创建一个空的GameObject，然后使用AddComponent把Card添加上去。
• 真正的卡牌Prefab加载是在Entity.LoadCard()中进行的，这个函数是在处理PowerTask时GameState.OnShowEntity()中调用的；
• 具体的加载操作是通过 DefLoader.LoadCardDef()进行的，其内部再调用AssetLoader.LoadCardPrefab()来进行资源加载；
  

卡牌&技能的加载流程

Entity的创建，以及Card、Spell的加载，都由网络消息触发；整个过程比较复杂，主要是有很多异步回调，比较难用文字描述，请见下图：



相关阅读：《炉石传说》架构设计分析：启动流程与Scene管理