Unityでカードゲームのカードの効果のスクリプトの書き方がわからない

Question

前提・実現したいこと

Unityでカードゲームを作ろうとしています。
現在、デッキエディット画面がある程度完成し、今度は何から手を付けたらいいか分からなくなり、
カードの効果スクリプトを書いてみようと思い調べました。
しかしフェイズ移行や攻撃の仕方などを書いてあるものはあったりしたのですが、
求めているような結果が得られなかったため質問させていただきます。

現状、カードのステータス等はエクセルで管理し、Unityで読み取れるようにしてあります。
作ろうとしているカードゲームのシステムの雰囲気としては、シャドウバース等よりは遊戯王等に近く、
任意に起動させる効果や出された時の効果、永続的な効果や相手のターンにでも使える効果などがあります。
カード種類は大まかに
ユニット（効果を持つモンスターが大半）、
スペル（基本的に相手ターンにも使えるもの）、
アイテム（基本的に自分ターンに使えるもの）があります。

どのようにスクリプトを書いたらカード効果の実装を実現できるでしょうか。
ちなみにカードの枚数は数百種類あるので、それに適した書き方を教えてほしいです。

--2021/07/27追記
自分なりにカード効果の分析をして分けて考え、スクリプトに落とし込むにはこう処理するのでは、
というものを書きました。
カード効果の一例と分析結果を以下の画像に追記します。
カード効果

分析結果

Comments

[fana]

> カード効果の一例

の説明文が，私には全く意味不明なのですが，何となく「かなり複雑そう」に見えます．
「どう実装したら良いのだろう？」という状態なのであれば，
最初はもっともっとシンプルな効果のものを扱ってみたらどうでしょう？とか思いました．
（例示されたものが最もシンプルな部類の効果だったりするのかもしれないが…）

[fana]

別に本番で使う効果をいきなり実装せずとも良いのでしょうから，
例えば，
「効果：このカードをフィールド(?)に出したら，その瞬間にあなたは勝利する！」
みたいな，
単一の効果で，何か対象を選択するだとかいう面倒そうな話が出てこない
ようなのでも良いのではないかな，とか．

[wata3]

カードIDの一番初めがこのカードだったので手始めに作ってみたいな、と思っただけで、カードプールの中でもまあまあ複雑な部類だとは思います。

[mimi_no_naka]

はやる気持ちも分からなくも無いですがこの手の実装の第一段階としてイベント発火を作るのが肝です

回答やここでも言われていますが、簡単な効果を発動させたいタイミングで発動させるのが先決かなと思います
まずは発動条件満たしたらDebug.Log表示なりConsoleへ表示するところから始めて下さい
というかバニラカードで殴り合える段階からがスキル実装のスタートラインじゃないでしょうか

Answer 1

とりあえず至極シンプルな物を作ってみる，というのをやってみました．
（コンソールアプリですが．まぁどこかがごく一部でも何かしらの参考になれば）

この例は「どこにも面白さがない謎の一人遊び」みたいなやつですが，
まずはこのくらいの内容から始めてみると良いのではないかと．

ルール

• 毎ターン，デックからカードを１枚ドローして手札に加え，手札から１枚選んで場に出します．
• 何やかんやのカード効果によってスコアが増減します．スコアが目標値に達したら終了です．

(1)カード効果の発動処理の流れを考える

「いろんなタイミングでカードの効果が発動する」という話を，
「カードから各タイミングで発動すべき効果群を取得し，それらを実行する」という形で考えた．

登場人物として｛カード，カード効果，タイミング，カード効果の実装手段｝くらいが必要そうなので，
ざっくりとそれらの間の関係性をコード化：
（行数がちょっと多いので空行を除去したりしてます．見難いかも）

//カード効果の処理側からゲームデータにアクセスする手段
internal interface IGameContextForCardEffect
{	//※この例ではこれら全部を使ってるわけじゃないけど，効果がやりそうなことを並べてみた
	void AddToField( ICard Card );	//場にカードを出す
	void RemoveFromField( ICard Card ); //場のカードを除去する
	void AddToHand( ICard Card );	//手札にカードを加える
	void RemoveFromHand( ICard Card );	//手札からカードを除去する
	ICard DrawFromDeck();	//デックからカードを１枚引く
	int Score{	get;	set;	}	//スコア増減用
}
//カード効果
internal interface ICardEffect
{
	string Name{	get;	}	//効果名称
	string EffectText{	get;	}	//効果説明文
	ICard Owner{	get;	}	//どのカードの効果か？（※この例では使ってないけど）
	void Affect( IGameContextForCardEffect IGC );	//効果の実行
}
//カード効果を処理するタイミングの種類
enum EffectTiming
{
	AddedToHand,	//カードが手札に追加されたとき
	AddedToField,	//カードが場に出されたとき
	RemovedFromField,	//カードが場から除去されたとき
	AtTurnEnd_OnField	//ターン終了時にカードが場にあるとき
}
//カード
internal interface ICard_Readonly
{
	string Name{	get;	}	//カード名称
}
internal interface ICard : ICard_Readonly
{
	//引数タイミングで処理すべき効果群を返す．
	//効果は戻り値の並び順で処理される．
	//処理すべき効果が無い場合には空リストを返す
	List< ICardEffect > GetActiveEffects( EffectTiming Timing );
}

(2)カードの効果とカードを何種類か作ってみる

３種類の効果（ICardEffect の実装）を用意してみた：

//効果：スコアを増減させる
internal class CE_ScorePlus : ICardEffect
{
	public int dScore{	get;	private set;	}
	public CE_ScorePlus( ICard Owner, int dScore ){ this.Owner=Owner;	this.dScore=dScore; }
	#region ICardEffect
	public string Name{ get{	return "ScorePlus"; }	}
	public string EffectText{	get{	return "Scoreを " + dScore + " 増やす"; }	}
	public ICard Owner{ get;	private set;	}
	public void Affect(IGameContextForCardEffect IGC){	IGC.Score += dScore;	}
	#endregion
}
//効果：デックからカードを引いて手札に加える
internal class CE_DrawCard : ICardEffect
{
	public int nDraw{	get;	private set;	}
	public CE_DrawCard( ICard Owner, int nDraw ){	this.Owner=Owner;	this.nDraw=nDraw;	}
	#region ICardEffect
	public string Name{ get{	return "DrawCard";	}	}
	public string EffectText{	get{	return "カードを " + nDraw + " 枚引く"; }	}
	public ICard Owner{ get;	private set;	}
	public void Affect(IGameContextForCardEffect IGC)
	{
		for( int i=0; i<nDraw; ++i )
		{
			var C = IGC.DrawFromDeck();
			Console.WriteLine( C.Name + " をドロー" );
			IGC.AddToHand( C );
		}
	}
	#endregion
}
//効果：特定のカードを手札に加える
internal class CE_GetCard : ICardEffect
{
	public ICard CardToBeAdded{ get;	private set;	}
	public CE_GetCard( ICard Owner, ICard CardToBeAdded ){	this.Owner=Owner;	this.CardToBeAdded=CardToBeAdded;	}
	#region ICardEffect
	public string Name{ get{	return "GetCard";	}	}
	public string EffectText{	get{	return "カード " + CardToBeAdded.Name + " を得る";	}	}
	public ICard Owner{ get;	private set;	}
	public void Affect(IGameContextForCardEffect IGC){	IGC.AddToHand( CardToBeAdded ); }
	#endregion
}

カード（ICard の実装）も適当に数種類用意します．
とりあえずスコアを増やせるカードを２種類：

//カード[Kitten]
internal class C_Kitten : ICard
{
	public string Name{ get{	return "Kitten";	}	}
	public List<ICardEffect> GetActiveEffects(EffectTiming Timing)
	{	//ターン終了時にこのカードが場にあるとき，スコア+2．
		var Ret = new List<ICardEffect>();
		if( Timing == EffectTiming.AtTurnEnd_OnField ){ Ret.Add( new CE_ScorePlus( this, 2 ) ); }
		return Ret;
	}
}
//カード[WildCat]
internal class C_WildCat : ICard
{
	public string Name{ get{	return "Wild_Cat";	}	}
	public List<ICardEffect> GetActiveEffects(EffectTiming Timing)
	{	//このカードを場に出したとき，カードを１枚ドローする．
		//このカードが場から取り除かれるとき，スコア+1．
		var Ret = new List<ICardEffect>();
		switch( Timing )
		{
		case EffectTiming.AddedToField: Ret.Add( new CE_DrawCard( this, 1 ) );	break;
		case EffectTiming.RemovedFromField:		Ret.Add( new CE_ScorePlus( this, 1 ) ); break;
		default: break;
		}
		return Ret;
	}
}

効果が嬉しくない（スコアが減る，手札圧迫する）カードも作ってみる：

//カード[CatNapDisaster]
internal class C_CatNapDisaster : ICard
{
	public string Name{ get{	return "CatNapDisaster";	}	}
	public List<ICardEffect> GetActiveEffects(EffectTiming Timing)
	{	//このカードを手札に加えたとき｛スコア-3，カード[Meow]が手札に追加される｝
		var Ret = new List<ICardEffect>();
		if( Timing == EffectTiming.AddedToHand )
		{
			Ret.Add( new CE_ScorePlus( this, -3 ) );
			Ret.Add( new CE_GetCard( this, new C_Meow() ) );
		}
		return Ret;
	}
}
//カード[Meow]
internal class C_Meow : ICard
{	//[CatNapDisaster]の効果でのみ生み出される，何の効果も無いカード
	public string Name{ get{	return "Meow";	}	}
	public List<ICardEffect> GetActiveEffects(EffectTiming Timing){ return new List<ICardEffect>(); }
}

(3)動かす部分を作ってみる

ゲームのデータと処理を持つクラスを書いて…：

//ゲームデータと処理．IGameContextForCardEffectを実装．
internal class GameContext : IGameContextForCardEffect
{
	private List<ICard> m_Hand = new List<ICard>(); //手札
	private List<ICard> m_Field = new List<ICard>();	//場
	private Random m_Rnd = new Random();	//乱数用
	public int GoalScore{	get;	private set;	}	//目標スコア
	public int CurrentTurn{ get;	private set;	}	//現在のターン数
	public int nHandCard{	get{	return m_Hand.Count;	}	}	//手札の枚数
	public ICard_Readonly HandCard( int HandCardIndex ){	return m_Hand[HandCardIndex];	}	//手札情報参照用
	//ctor
	public GameContext( int GoalScore )	 //目標スコアを引数で指定
	{
		CurrentTurn = 1;
		Score = 0;
		this.GoalScore = GoalScore;
		for( int i=0; i<3; ++i ){	m_Hand.Add( DrawFromDeck() );	}	//初期手札3枚
	}
	//ゲーム終了判定
	public bool GoalCheck(){	return (Score>=GoalScore);	}
	//現状の表示
	public void ShowState()
	{
		Console.WriteLine( "Score {0}/{1}", Score, GoalScore );
		ShowPacket( "手札", m_Hand );
		ShowPacket( "場", m_Field );
	}
	//手札からカード１枚を場に出す
	public void MoveFromHandToField( int HandCardIndex )
	{
		var Card = m_Hand[HandCardIndex];
		RemoveFromHand( Card );
		AddToField( Card );
	}
	//ターン終了処理
	public void ToNextTurn()
	{
		while( m_Field.Count > 3 )	//場のカードが3枚以下になるよう，古い側から除去
		{
			Console.WriteLine( m_Field[0].Name + " を場から除去する" );
			RemoveFromField( m_Field[0] );
		}
		while( m_Hand.Count > 5 )	//手札が5枚以下になるよう，古い側から除去
		{
			Console.WriteLine( m_Hand[0].Name + " を手札から除去する" );
			RemoveFromHand( m_Hand[0] );
		}
		foreach( var C in m_Field ){	ProcCardEffects( C, EffectTiming.AtTurnEnd_OnField );	}
		++CurrentTurn;
	}
	//表示用の作業関数
	private static void ShowPacket( string PacketName, List<ICard> Tgt )
	{
		Console.WriteLine( PacketName );
		Console.Write( "  { " );
		foreach( var C in Tgt ){	Console.Write( C.Name + ", " ); }
		Console.WriteLine( "}" );
	}
	//カード効果の処理
	private void ProcCardEffects( ICard Card, EffectTiming Timing )
	{
		var Effects = Card.GetActiveEffects( Timing );
		if( Effects.Count == 0 )return;
		Console.Write( "カード効果：" + Card.Name );
		switch( Timing )
		{
		case EffectTiming.AddedToHand: Console.WriteLine( " が手札に加わったとき" );	break;
		case EffectTiming.AddedToField: Console.WriteLine( " が場に出たとき" ); break;
		case EffectTiming.RemovedFromField: Console.WriteLine( " が場から除去されたとき" ); break;
		case EffectTiming.AtTurnEnd_OnField: Console.WriteLine( " が場にある状態でターン終了時" );	break;
		default: throw new ArgumentException( "BUG" );
		}
		foreach( var E in Effects )
		{
			Console.WriteLine( "  -> " + E.Name + " : " + E.EffectText );
			E.Affect( this );
		}
	}
	#region IGameContextForCardEffect
	public int Score {	get;	set;	}
	public void AddToField(ICard Card){ m_Field.Add( Card );	ProcCardEffects( Card, EffectTiming.AddedToField ); }
	public void AddToHand(ICard Card){	m_Hand.Add( Card ); ProcCardEffects( Card, EffectTiming.AddedToHand );	}
	public void RemoveFromHand(ICard Card){ if( !m_Hand.Remove(Card) ){ throw new InvalidOperationException("BUG"); }	}
	public void RemoveFromField(ICard Card)
	{
		if( !m_Field.Remove(Card) ){	throw new InvalidOperationException("BUG"); }
		ProcCardEffects( Card, EffectTiming.RemovedFromField );
	}
	public ICard DrawFromDeck()
	{	//※デックの実装が面倒なのでてきとーにカードを生成して返している
		switch( m_Rnd.Next(3) )
		{
		case 0: return new C_WildCat();
		case 1: return new C_CatNapDisaster();
		default: return new C_Kitten();
		}
	}
	#endregion
}

あとは，こいつのメソッドを適当な順序で呼び出す処理をMainに書く：
（Console.ReadLine(); はコンソール出力を目視するための一時停止用）

static void Main(string[] args)
{
	var Game = new GameContext( 7 );
	var Rnd = new Random(); //※手札をてきとーに選ぶ用
	while( true )
	{
		Console.WriteLine( "----------" );
		Console.WriteLine( "Turn " + Game.CurrentTurn.ToString() + " 開始時" );
		Game.ShowState();
		Console.WriteLine();

		Console.ReadLine();
		if( Game.GoalCheck() )break;
		{//カードを１枚ドロー
			var C = Game.DrawFromDeck();
			Console.WriteLine( "[" + C.Name + " をドロー]" );
			Game.AddToHand( C );
		}
		if( Game.nHandCard > 0 )
		{//手札から場に１枚出す（てきとーに乱数で選んでる）
			int index = Rnd.Next( Game.nHandCard );
			Console.WriteLine( "[ {0}({1}) を場に出す]", Game.HandCard(index).Name, index );
			Game.MoveFromHandToField( index );
		}
		Console.WriteLine( "[ターン終了時処理]" );
		Game.ToNextTurn();
	}
	Console.WriteLine( "==終了==" );
	Console.ReadLine();
}

とりあえず以上で，カードを引いたり場に出したりしたタイミングで効果が発動する形にはなった．
（運が悪いとスコアがどんどんマイナス方向に行って永久に終わらなくなったりするので注意が必要）
（カード効果によってカードをドローしたらそのカードのドロー時効果がそこで発動したりしてわりとカオス）

Comments

[fana]

投稿に文字数制限があることを初めて知った．

投稿時にインデントのスペース4個を全部タブに置き換えることで制限をクリアできたけど
投稿結果ではタブはスペースに変換されてるみたいね．

[wata3]

ありがとうございました。
ここから要所要所調べながらUnityに落とし込んだりしようと思います。

[mimi_no_naka]

これを落とし込むのは現状の能力では厳し過ぎるので他の方の回答で出てた様にクリックイベントにでも実装した方が良いのではないかと思わなくもない

Answer 2

どのようにスクリプトを書いたらカード効果の実装を実現できるでしょうか。
ちなみにカードの枚数は数百種類あるので、それに適した書き方を教えてほしいです。

まずですね……。カードの枚数が数百種類あれば、
それだけ数百種類の困難（エラー、バグ、不具合など）もあると考えてください。

だって、パラメータがちょっと違うだけじゃないんでしょ？　それじゃつまんないし。
たぶん、カード固有の能力が一枚一枚にあるんでしょう？

たとえば、「AというカードはBというカードの効果を1.5倍にする。
しかしCのカードが先に発動していると、その効果は打ち消される」
みたいにきっと、複雑なルールになるのではないか、と予想します。

そういう複雑なルールを、単純なIF文の分岐で実装しようとすると、
ゴチャゴチャになってコードが破綻しやすく、制作も挫折しやすいです。

---

さらに、カードゲームはたった1枚の強力なカードでバランス崩壊することもあり、
カードの追加や強化／弱体化など、後からバランス調整したくなることと思います。

しかし、ただでさえ仕様が複雑なのに、後から仕様変更が重なるというのは、
プログラミングにおいて、非常に悪条件なのです。
メンテナンスも大変だから、ますます破綻しやすく、挫折しやすい。

---

じゃあ、どうすればいいか？　私がオススメする手法は、
まずは小さなプロトタイプから始めることです。

商業カードゲームの規模で、そのまま再現するのは大変だから、
たとえば、試作として「トランプ」から始めるとか。

そこで、カードをシャッフルするとか、山札から手札を配るとか、
プレイヤーが交代でカードを場に一枚ずつ捨てていくとか、
基本的な課題を完全にクリアしてから、本番に挑戦しようと。

---

私の考えでは、「カードゲーム」制作というのは、
高い設計力が要求されるジャンルです。

とくに固有の能力を持つカードが数百枚ともなると、
ゲームのルールが複雑に絡み合って、コードが破綻しがちです。

具体的にはたとえば、ご質問の効果関連では、たとえば「カードの効果発動の優先順位」とか、
「バフの効果持続ターン」とか、「対戦相手のAIによる、カード効果の認識と判断」とか、
いかにも条件分岐が複雑になりそうな部分があるかもしれません。勝手な想定ですが。
素朴なIF文の入れ子とフラグでは、書きたくない所です。
とくに長期間の修正を繰り返していくと、壮絶に汚くなりそう。

---

では、どうやって設計すればいいのか？
オブジェクト指向の設計技法が有効だと、私は考えています。
そもそもOOPはゲームと相性が良いですが、カードゲームとはさらに良いです。

これはあくまで実装アイディアの一例（別に必ず最善とは限らない）ですが、
たとえばカードの効果をオブジェクトにして、キューに並べる方式にすれば、
いろいろな判定が簡潔になります。どういうことか、見てみましょう。

たとえば、優先順位を並べ直すのは、効果オブジェクトを
詰めている配列なりを整列すればいいだけ。だし、
バフの持続ターンが2以上あれば、1減らしてキューに詰め直すとか。
AIがキューを走査すれば、先回りしてカード効果を認識できる。
（とくにこの「先回り」が、素朴なやり方だと実装が難しいポイント）

ので、（カードの使用と効果の発動タイミングでラグがある場合でも
状況認識できずに、ランダムにカードを選ぶ頭の悪いAIではなく、
発動したカードの効果によって、行動を変える賢いAIにできます。
これをIFの分岐とフラグで実装するのは、可能だけど辛いと思います。

まあもちろん、ゲームデザインやルールにもよるので、あくまで架空の例です。
仕様が不明だから、質問者の方が知りたいことと、きっとズレていることでしょう。
でも、カードゲームの複雑な効果発動を処理する、ひとつの具体例ではあります。

ちなみにこれは、デザインパターンの「コマンドパターン」の応用です。
それを聞いてパッと実装のイメージが思い浮かばないようなら、
やはりまずトランプとか小規模なゲームで試行錯誤してみましょう。

Answer 3

エクセルで管理しているという事はマスターからのデータ取得を想定していると思うのでカラムの値を変えれば同スキルで効果値は別に出来ます。数百種類程度は水増しで作れます

という話で大丈夫なのでしょうか？

正直なところこの回答では駄目だろうし、質問内容も何を聞きたいのか判らないです。
多分マスターデータの話をしても「カラムってなんですか？」と返されるんだろうなと予測しているくらいです。

カード種類は大まかに

ユニット（効果を持つモンスターが大半）、
スペル（基本的に相手ターンにも使えるもの）、
アイテム（基本的に自分ターンに使えるもの）があります。

こういう事を書き出していますがこれの何を聞きたいのでしょうか？
各カードの種類を判別する方法から聞きたいのか、使えるタイミングの判別を聞きたいのか、クラスの作り方から聞きたいのか...
そもそもどこまで出来ていて何を理解出来ているのかすら不明なので返答しようが無いです

質問する場合は数百種類などと誇大な事は書かずにまず最小単位の一種類作ってから聞いて下さい。
それの作りやデータの取得方法を見れば何かしらのアドバイスのしようもあります。

まずは**「自ターンで場にユニットカードを出して敵に1ダメージを与える効果」**の様に極単純なものを作ってそのコードを提示して下さい。

それくらい作れて当たり前だろと思うだろうし私もそう思うのですがそれ位のモノすら作れない人はここの質問者には相当数いるので回答者もそれくらいの温度感で対応してしまいます。
数百種類のスキル作成を質問するのはその温度感を払拭してからが良いかと思います。

※簡単と書きましたが自ターン敵ターンのステート管理にそれに伴う入力制限などキッチリ作ると専門卒上位でも結構な確率で一人では出来ないレベルではあります

Comments

[wata3]

タイトルにもあるように書き方がわからないので例に出された単純なものも書けないです。
それどころかどのようなワードで調べればほしい回答にたどり着くかすらわかってない状態なので質問させてもらいました。

[Tto777]

もう既にご覧になっている気もしますがこちらのサイトなどを参考にカードのクラス作成とフィールドにカードを出すまで実装してみると良いです

https://yuus01.info/game-make/unity_tcg_make4/
https://yuus01.info/game-make/unity_tcg_make5/

そして場にカードを出すイベントであるこの部分

public void OnEndDrag(PointerEventData eventData) // カードを離したときに行う処理
{
transform.SetParent(cardParent, false);
GetComponent<CanvasGroup>().blocksRaycasts = true; // blocksRaycastsをオンにする
//ここで例に挙げた「自ターンで場にユニットカードを出して敵に1ダメージを与える」スキル関数を呼び出す
}

まずはここで敵リーダーに1ダメージ与える処理を書いてスキル実装目指すと良いです。

Answer 4

カードの効果がどうのいう話が過去にあったのでリンクを示しておく．
参考になるのかどうかは不明ですが．