All content in this course uses:

「Creator Kit：コーディング入門」のスクリプトテンプレートで消費アイテム、装備品、武器の効果をカスタマイズします。

ゲームをカスタマイズする

このチュートリアルは、「Creator Kit：コーディング入門」のゲームをさらにカスタマイズするためのリファレンスガイドです。

スクリプトテンプレートを使って、以下のような部品を作成するために役立つガイダンスを提供します。

使用することで効果が発生する使用可能なアイテム（最後のチュートリアルで扱ったライフ回復ポーションなど）

装備することで効果が発生する装備品

武器攻撃時に効果を発揮する武器

このチュートリアルは、「Creator Kit：コーディング入門」で扱ったゲームをさらにカスタマイズするためのリファレンスガイドです。

以下の作成に役立つスクリプトテンプレートに関するガイダンスを提供します。

このガイドは、ステップバイステップのガイドではなく、ゲームの理解を深め、実験を行うために役立つツールとなるように構成しています。他の Unity チュートリアルで学んだことを応用するためにも役立つかもしれません。

このガイドの構成は次のとおりです。


 Unity エディターでアイテムタイプを作成する方法

 アイテムのカスタムの効果を持たせるスクリプトを作る方法、およびそれを使うための基本的なガイダンス

 アイテムに効果を適用する方法

「Creator Kit：コーディング入門」のチュートリアルは終了しましたが、学習を続ける仲間はたくさんいます。疑問に思うことが出てきた時や、または他の学習者がこのチュートリアルで扱ったゲームを使ってどんなことをしているのかを知りたいと思った時などには、「Creator Kit：コーディング入門」の

Unity フォーラムの公式スレッド

に参加されてみることをおすすめします。

ゲームのカスタマイズ

Usable Item（使用可能なアイテム）とは何か

使用可能なアイテムとは、プレイヤーが持ち物リストの中でダブルクリックして使うことのできるアイテムのことを指します（たとえば、ライフ回復ポーション）。

Unity エディターで使用可能なアイテムを作成する方法

エディターで使用可能なアイテムを作成するには、以下のようにします。

 プロジェクトウィンドウで、 

Assets/Creator Kit - Beginner Code/Prefabs/InGameItem

 プロジェクトウィンドウを右クリックし、コンテキストメニューから 

 を選択する。画面上部のメインメニューの 

 からこのメニューにアクセスすることもできる。


この手順を行うと、新しく使用可能なアイテムのアセットが作成されます。

 プロジェクトウィンドウで、新しくできた使用可能なアイテムを右クリックし、

 を選択する。アイテムに覚えやすい名前を付ける。




 使用可能なアイテムが選択されたままの状態でインスペクターを見ると、次のフィールド（公開変数）が表示されている。

持ち物リスト内でアイテムを表すために使われるスプライト。World Object Prefab（後述）が設定されていない場合は、ゲームの世界でアイテムを表すためにもこのスプライトが使われる。


ゲーム内でアイテムの上に表示されるアイテムの名前、およびプレイヤーの持ち物リストのツールチップに表示されるアイテムの名前。


プレイヤーの持ち物リストのツールチップに表示されるアイテムの説明。


ゲームの世界に使用可能なアイテムが配置された時に、そのアイテムをゲームの世界の中に表示するために生成される 3D ゲームオブジェクト。これを空（null）のままにすると、代わりに Item Sprite が使用されます。


（使用時の効果）を一覧表示するドロップダウンメニュー。新しい使用時の効果を作成すると、ここに表示されます。アイテム使用時の効果を選択して、使用可能なアイテムに追加します。




次のステップでは、アイテムを使用した時の効果を記述する Usage Effect スクリプトを作成し、それを使用可能なアイテムに適用する方法を学習します。

Usable Item（使用可能なアイテム）を作成する

Usage Effect（使用時の効果）スクリプトとは何ですか？

使用時の効果スクリプトは、使用可能なアイテムがプレイヤーの持ち物リストの中でダブルクリックされたときに何が起こるかを決めるものです。作成した使用時の効果は、エディターの使用可能なアイテムアセットに追加されます。


新しい使用時の効果スクリプトを作成する方法

Creator Kit で新しく使用時の効果スクリプトを作成するには、以下のようにします。

 NameWindow ダイアログボックスが開くので、使用時の効果スクリプトに名前をつけ、

 にスクリプトが作成され、エディターで選択された状態になります。

 プロジェクトウィンドウで、スクリプトをダブルクリックしてコードエディターで開く。

Creator Kit に、アイテムの使用時の効果を作成するために役立つテンプレートスクリプトが用意されています。

 は、使用時の効果スクリプトの名前を入れるプレースホルダーです。

使用時の効果をカスタマイズする方法

使用時の効果をカスタマイズするには、

 関数に命令を追加する必要があります。


 には、アイテムを使用したキャラクターの 

 が含まれています。このゲームでは、アイテムを使用できるキャラクターはヘラジカのキャラクター 1 人だけです。この引数を使用して、ステータス、持ち物リスト、および装備しているアイテムにアクセスし、それらを変更できます。


カスタムの CharacterData クラスについて詳しく知る方法

 クラスの詳細を知りたい方は、以下の手順に従ってください。

 Unity エディターで、メインメニューの 

 ローカルドキュメントガイドの上部のメニューバーで、

使用可能なアイテムの戻り値を設定する方法

Use 関数は、ブール値（true または false）を返します。以下のような意味を持つように設定します。

オブジェクトが使用され、プレイヤーの持ち物リストから削除された場合は true（オブジェクトが複数ある場合、所持数を 1 つ減らす）。


オブジェクトを使用できない場合は false（たとえば、ライフを追加する前にライフがすでに最大値になっているかどうかをテストして、ライフが最大値の時はライフ回復ポーションが無駄にならないように false を返すという処理が可能）。

Usage Effect（使用時の効果）スクリプトを書く

使用時の効果スクリプトを変更したら、その使用時の効果をエディターで使用可能なアイテムに追加できます。



 プロジェクトウィンドウで、作成した使用可能なアイテムを選択する（ファイルパスは 

 フィールドを探す。ドロップダウンメニューから使用時の効果を選択する。




 フィールドに説明を追加する。


（macOS）を押して、変更を保存する。


 再生モードで使用可能なアイテムをテストする。


使用時の効果を削除する場合は、インスペクターの 

 フィールドの右側にあるマイナスボタン（

使用可能なアイテムに使用時の効果スクリプトを適用する

Equipped Item（装備アイテム）とは何か

装備アイテムは、装備時にプレイヤーキャラクターに特定の属性を与えるアイテムです（武器は追加機能を備えた特別な種類の装備アイテムです。これについては、このガイドの後の部分で個別に説明します）。

装備アイテムには以下の情報を与えることができます。


最小ステータス要件。プレイヤーがそのアイテムを装備できるために必要なあるステータスの最小値を満たすまでは、アイテムを装備できないようにします（たとえば、プレイヤーの HP が 5 を超えている場合にのみ装備できるアイテムを作ることができる）。


装備時の効果。アイテムを装備している間、プレイヤーキャラクターに付与される効果です（たとえば、ステータスを上げる）。

Unity エディターで装備アイテムを作成する方法

エディターで装備アイテムを作成するには、以下のようにします。

 を選択する。または、画面上部のメニューの 

これにより、新しく装備アイテムのアセットが作成されます。

 プロジェクトウィンドウで、新しくできた装備アイテムを右クリックし、

 装備アイテムが選択されていると、インスペクターに以下のフィールド（公開変数）が表示される。

持ち物リスト内でアイテムを表すために使われるスプライト。World Object Prefab（後述）が設定されていない場合は、ゲームの世界でアイテムを表すためにもこのスプライトが使われる。  

ゲーム内でアイテムの上に表示されるアイテムの名前、およびプレイヤーの持ち物リストのツールチップに表示されるアイテムの名前。  

プレイヤーの持ち物リストのツールチップに表示されるアイテムの説明。  

ゲームの世界に使用可能なアイテムが配置された時に、そのアイテムをゲームの世界の中に表示するために生成される 3D ゲームオブジェクト。これを空（null）のままにすると、代わりに Item Sprite が使用されます。

装備アイテムを着用できる装備スロット（「Head」（頭）など）。

アイテムを装備するために必要な最小の 

（防御）ステータスの値。プレイヤーがこれらのステータスの最小値を満たしていない場合、持ち物リスト内のアイテムをダブルクリックしても何も起こらない。

（装備時の効果）を一覧表示するドロップダウンメニュー。新しい効果を作成すると、ここに表示される。装備時の効果を選択して、装備アイテムに追加する。



次のステップでは、装備時の効果スクリプトを作成し、それを装備アイテムに適用する方法を学習します。

Equipped Item（装備アイテム）を作成する

Equipped Effect（装備時の効果）スクリプトとは何ですか？

装備時の効果スクリプトは、カスタムの効果を指定しておき、プレイヤーがアイテムを装備したときにそれを有効にするものです。エディターで、装備アイテムまたは武器に追加します。


新しい装備時の効果スクリプトを作成する方法

「Creator Kit：コーディング入門」のテンプレートから新しい装備効果スクリプトを作成するには、以下のようにします。

 NameWindow ダイアログボックスが開くので、装備時の効果スクリプトに名前を付けて 

 にスクリプトが作成され、エディターで選択された状態になります。 


 プロジェクトウィンドウで、スクリプトをダブルクリックしてコードエディタで開く。

Creator Kit に、装備時の効果を作成するために役立つテンプレートスクリプトが用意されています。 

 は、装備時の効果スクリプトの名前を入れるプレースホルダーです。

装備時の効果をカスタマイズする方法

装備時の効果スクリプトでカスタマイズできる関数は 2 つあります。






この関数は、プレイヤー（user）がアイテムを装備したときに呼び出されます。この関数を使用して効果をプレイヤーに与えます。たとえば、キャラクターの強さに +1 の修正をかける、などです。

ここで使う修正値を格納しておくために private 変数を使うことができます。



この関数は、プレイヤー（user）がアイテムの装備を外したときに呼び出されます。この機能を使用して、装備がプレイヤーキャラクターに与える影響を無効にします。

Equipped Effect（装備時の効果）スクリプトを書く

装備時の効果スクリプトを変更したら、エディターの装備アイテムに追加できます。

 プロジェクトウィンドウで、作成した装備アイテムを選択する（ファイルパスは 

フィールドを探す。ドロップダウンメニューから装備時の効果を選択する。




フィールドに説明を追加する。


 再生モードで装備アイテムをテストする。

装備時の効果を削除する場合は、インスペクターの 

フィールドの右側にあるマイナスボタン（

装備時の効果スクリプトを装備アイテムに適用する

武器は、キャラクターの武器スロットに装備できる特別な装備アイテムです。

装備アイテムに通常の装備アイテムの機能に加えて、武器としての機能を与えることができます。武器は以下のようなステータスを持ちます。

攻撃アクションに関連するステータス：

（武器で攻撃したときの効果）：武器が敵キャラクターにダメージを与えたときに起こる現象をカスタマイズできる。

Unity エディターで武器を作成する方法

エディターで武器を作成するには、以下のようにします。

これにより、新しく武器アセットが作成されます。

 プロジェクトウィンドウで、新しくできた武器を右クリックし、

 を選択する。武器に覚えやすい名前を付ける。




 武器が選択されていると、装備アイテムに表示されるすべての項目に加えて、インスペクターに以下のフィールド（公開変数）が表示される。

Weapon Stats（武器のステータス）：

武器の攻撃速度。これは、攻撃の間のクールダウン時間を表します。値が小さいほど、次の攻撃の出が早くなります。値が 0 の場合、最初のアニメーションが終了するとすぐに次の攻撃を実行できます。


武器が与えられる最小のダメージ量。キャラクターのステータス修正の影響を受けません。与えるダメージは、この Minimum Damage と次の Maximum Damage の間のランダムな値になります。


武器が与えられる最大のダメージ量。キャラクターのステータス修正の影響を受けません。与えるダメージは、Minimum Damage と Maximum Damage の間のランダムな値になります。


武器が敵キャラクターにダメージを与えることができる距離。攻撃を試みた時に標的のキャラクターがこの距離よりも遠くにいる場合、ダメージを与えることはできません。


（武器の攻撃時の効果）を一覧表示するドロップダウンメニュー。新しい効果を追加するとここに表示されます。武器の攻撃時の効果を選択して、武器に追加します。

次のステップでは、武器の攻撃時の効果スクリプトを作成して武器に適用する方法を学習します。

Weapon（武器）を作成する

Weapon Attack Effect（武器の攻撃時の効果）スクリプトとは何か

武器の攻撃時の効果スクリプトは、武器がターゲットに当たったときに発生する効果をカスタマイズし、これを武器に付与するものです。武器に追加して使います。

新しい武器の攻撃時の効果スクリプトを作成する方法

「Creator Kit：コーディング入門」のテンプレートから新しい武器の攻撃時の効果スクリプトを作成するには、以下のようにします。


Beginner Code > Create Weapon Attack Effect

 NameWindow ダイアログボックスが開くので、武器の攻撃時の効果スクリプトに名前を付けて 

 プロジェクトウィンドウで、スクリプトをダブルクリックしてコードエディタで開く。

Creator Kit に、武器の攻撃時の効果を作成するために役立つテンプレートスクリプトが用意されています。 

は、武器の攻撃時の効果スクリプトの名前を入れるプレースホルダーです。

武器の攻撃時の効果をカスタマイズする方法

武器の攻撃時の効果スクリプトでカスタマイズできる関数は 2 つあります。


1.  OnAttack(CharacterData target, CharacterData user, ref Weapon.AttackData attackData)

この関数には、武器が敵に当たったときに何が起こるかを制御する命令を記述します。

 関数を使用して、標的にダメージを与えたり、必要な効果を適用したりできます。



2.  void OnPostAttack(CharacterData target, CharacterData user, Weapon.AttackData data)

この関数は、すべての OnAttack 関数の命令が実行された後に呼び出されます。これにより、OnAttack ですべての効果が適用された後、標的が受けるダメージの合計量に応じて、その後に発生することをカスタマイズできます。

たとえば、この関数を使用して、敵に与えたダメージの一部を、プレイヤーキャラクターが吸収してライフを回復させるといったことができます。



カスタムの Weapon.AttackData クラスの詳細について

を使用すると、敵が受けたダメージの量を参照できます。

クラスの詳細を参照するには、以下の手順に従ってください。


 Unity エディターの画面上のメニューの 

 左側のメニューでリンクを選択する。

Weapon Attack Effect（武器の攻撃時の効果）スクリプトを書く

武器の攻撃時の効果スクリプトを変更したら、エディターで武器に追加できます。

 プロジェクトウィンドウで、作成した武器を選択する（ファイルパスは Assets/Creator Kit - Beginner Code/Prefabs/InGameItem）。


 フィールドを探す。ドロップダウンメニューから武器の攻撃時の効果を選択する。




 武器の攻撃時の効果について 

 再生モードで武器をテストする。


武器の攻撃時の効果を削除する場合は、インスペクターの Script フィールドの右側にあるマイナスボタン（

Unity バージョン 2020.3