シャドウバースの公開資料にあるカードスキル設計の詳細を理解したいです

Question

背景

カードゲームのスキル（カード効果）の設計方法についてご質問がございます。

株式会社Cygamesさんから公開されている、「【CEDEC 2019 フォローアップ】Shadowverse流開発手法 ～QAコスト削減と堅牢性強化を実現するプランナーによるテスト駆動開発～」という資料の中で、同社が開発しているデジタルカードゲーム「シャドウバース」のカードスキルは、以下の仕組みで構成しているとされています。

https://speakerdeck.com/cygames/shadowverseliu-kai-fa-shou-fa-qakosutoxue-jian-tojian-lao-xing-qiang-hua-woshi-xian-surupurannaniyorutesutoqu-dong-kai-fa

知りたいこと

こちらのスキル構成に関しまして、実際のスクリプトでは、5つの要素に対して対応するメソッド（振る舞い）がたくさん用意されており、カード側で自身のスキルを満たすように、各要素のメソッドを組み合わせて呼び出すといったイメージなのでしょうか。

例えば5つの要素のうち、「Skill=メイン挙動の指定」の要素なら、対応するメソッド（振る舞い）は以下のようなイメージです。

func ダメージを与える()
{
}

func 回復する()
{
}

試してみたこと

現在自分でもカードゲームを作っておりまして、自分の場合のスキルの設計は以下のようになっております。
（開発環境：Unity + C#）

• 各カードは、効果クラス（Ability）で効果の情報を持つ。
• Abilityクラスの中身は以下の通り。

using System.Collections;
using System.Collections.Generic;
using UnityEngine;

[System.Serializable]
public class Ability
{
    public Timing Timing;           // 発動タイミング  例）　召喚した時、破壊された時、ターン開始時、・・・
    public string AbilityName;      // スキルタイプ   例）　ダメージを与える、回復する、カードを引く、・・・
    public Target Target;           // 発動対象　    例）　相手フォロワー、相手リーダー、味方フォロワー、・・・
    public string TargetCondition;  // 発動対象条件  例）　コストX以下、体力X以下、・・・
    public int TargetOption;        // 対象オプション  例）　「発動対象条件」のXに当てはまる数値です.
    public int AbilityAmount;       // 効果点数      例）　ダメージ量、回復量、ドロー枚数、・・・
}

public enum Timing
{
    ON_PLAYED,
    ON_DESTROYED,
    ON_TURN_START,
    ON_TURN_END
}

public enum Target
{
    ALLIED_PLAYER,
    ENEMY_PLAYER,
    RANDOMLY_ALLIED_UNIT,
    RANDOMLY_ENEMY_UNIT,
    ALL_ALLIED_UNITS,
    ALL_ENEMY_UNITS,
    ALL_UNITS,
    ALL,
    SELECT,
    SELF,
    NONE
}

• 各カードクラス（CardLogic）は、このAbilityクラスのリストを持つ。
• リストにしているのは、1枚のカードが複数の効果（＝複数のAbility）を持つ場合があるため。

using System.Collections;
using System.Collections.Generic;
using UnityEngine;

[System.Serializable]
public class CardLogic
{
    ...
    
    public List<Ability> Abilities;

    ...

これにより、例えば以下のようなスキルは実装できています。

• 召喚時：カードを1枚引く。
• 召喚時：相手フォロワー1体に3ダメージを与える。

しかし例えば、

• 召喚時：このフォロワーの攻撃力が５以上なら「疾走」を持つ。７以上なら「守護」を持つ。１０以上なら「破壊不能」を持つ。
• 召喚時：デッキからスペルカードを1枚手札に加える。その後、相手プレイヤーにXダメージを与える。Xは手札に加えたスペルカードのコストに等しい。

のように、「Abilityクラスの要素で当てはめにくいスキル」や、「直前の効果の結果を参照して新しい効果を発動するスキル」などの実装はもう少し工夫が必要かも、、、と思う様になってきました。
複雑なスキルに関しては、個別にメソッドやクラスを作るべきなのでしょうか。。。（それだとメソッドやクラスが多くなり、カード種類の増加に耐えられなくなってしまう？？）

今後、いろんなスキルのカードを作ってみたいと思っております！

何卒アドバイス等いただけると幸いです。

参考文献

• Shadowverse流開発手法 ～QAコスト削減と堅牢性強化を実現するプランナーによるテスト駆動開発～
• HearthStoneなどのカードゲームのスクリプトの構成はどうなっているのか
• カードゲームのカード効果について

Answer 1

こちらのスキル構成に関しまして、実際のスクリプトでは、5つの要素に対して対応するメソッド（振る舞い）がたくさん用意されており、カード側で自身のスキルを満たすように、各要素のメソッドを組み合わせて呼び出すといったイメージなのでしょうか。

実際のスクリプトがどうなっているのかは分かりませんが、基本的にはメソッドを組み合わせて実装する思われます。

---

ここからは複雑なスキルを実装する際の個人的な考えを書きます。

複雑なスキルに実装する時に、一番大事なのは「複雑なスキルは、分解して一つ一つの動作にする」ということだと思います。

例で挙げられた「召喚時：このフォロワーの攻撃力が５以上なら「疾走」を持つ。７以上なら「守護」を持つ。１０以上なら「破壊不能」を持つ。」というスキルを分解してみます。

1. 召喚時：このフォロワーの攻撃力が５以上なら「疾走」を持つ。
2. 召喚時：このフォロワーの攻撃力が７以上なら「守護」を持つ。
3. 召喚時：このフォロワーの攻撃力が1０以上なら「破壊不能」を持つ。

すると、この3つの処理に分けられます。そうすると、複雑なスキルも単純なスキルの集まりで表現することができるようになります。

そうすれば、他の複雑なスキルも同様に考えることができます。

例に挙げられた「召喚時：デッキからスペルカードを1枚手札に加える。その後、相手プレイヤーにXダメージを与える。Xは手札に加えたスペルカードのコストに等しい。」というスキルについても分解してみます。

1. 召喚時: デッキからスペルカードを1枚手札に加える。
2. 召喚時: 相手プレイヤーにXダメージを与える。Xは手札に加えたカードのコスト

ここで、1の処理は他のスキル同様に実装することができますが、2の処理は直前に加えたカードの情報を得る必要があります。

「直前のスキルの結果」を参照する効果や「あるカードが場に出た回数」を参照する効果などの専用の処理が必要なものは個別の処理が必要だと思われます。

Comments

[massu2357]

早速ご回答いただき、ありがとうございます！

なるほどです。
確かに複雑なスキル文章であっても、要素分解することで既存のクラスやメソッドを使って実現できそうですね！

「召喚時：このフォロワーの攻撃力が５以上なら「疾走」を持つ。」であれば、スキルは以下のようにできそうです！（Cygamesさんの公開資料のスキル構成に当てはめてみます）

===================================================
Skill（メイン挙動） ：疾走能力の付与
Timing（発動タイミング） ：召喚時
Condition（発動条件） ：このスキルを持つフォロワーの攻撃力がX以上なら
Target（対象） ：このスキルを持つフォロワー
Option（数値などの細かい制御） ：X=5
===================================================

[massu2357]

また、
「召喚時：デッキからスペルカードを1枚手札に加える。その後、相手プレイヤーにXダメージを与える。Xは手札に加えたスペルカードのコストに等しい。」
に関しましても、仰っていただいたように要素分解で対応できそうです。

直前のスキルの効果の参照に関しては、1つ前の効果を保持しておくクラスなんかを用意しておき、一時的にそのクラスのプロパティに情報を格納しておけば、直前の効果内容を参照する効果であっても、そのクラスから情報を引き出すことで実現できそうですね。

[massu2357]

ご回答いただいた内容を踏まえまして、自分の設計方針でも対応できそうなイメージがつきました。

ありがとうございます。