All content in this course uses:

カスタムのライフ回復スクリプトを作成し、public 変数でプレイヤーの HP 増加量を調整できるようにします。

ライフ回復ポーションをカスタマイズする

このチュートリアルでは、ここまで学んだことを応用して、以下のことを行います。

カスタムのライフ回復エフェクトのスクリプトを作成する

テンプレートとなるスクリプトの内容を確認する

プレイヤーのライフポイント（HP）を上げるための新しい命令を書く

HP の増分を public 変数に変更します

このチュートリアルを終えると、この Creator Kit のゲームに登場するライフ回復ポーションのカスタムエフェクトを作成する手順を一通りなぞることができます。

Unity 用の C# スクリプトを作成するための基本的な概念について説明したので、実際にスクリプトを書いてゲームプレイを作ることができます。

このチュートリアルでは、ゲーム中に登場するポーションの効果を記述して、ポーションを使うとプレイヤーキャラクターのライフポイントを 10 増やすようにします。

プレイヤー体験をカスタマイズする

この Creator Kit には、アイテムの効果を作成するために使用できる簡単なテンプレートスクリプトが含まれています。

テンプレートから新しいスクリプトを作成して開くには、以下のようにします。


 スペースなしで名前を入力し（たとえば「AddHealthEffect」）、

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

Assets/Creator Kit - Beginner Code/Scripts/ItemEffects

スクリプトファイルをダブルクリックして、スクリプトエディターで開きます。

基本的なコードは以下のようになります。

新しいスクリプトファイルを作成して開く

これまでに学んだことをすべて使用して、この小さなスクリプトの要素を確認しましょう。

 で始まっています。前と同じく、これらは一旦考えないことにしましょう。


6 行目は、前のステップで指定したものと同じ名前が入ったクラス宣言です。ダイアログウィンドウでの入力によって、これが追加されました。


 と呼ばれる別のクラスから派生しています。これは、この Creator Kit のために作成されたクラスで、ゲーム内のアイテムに関連するすべてを制御します。これらの効果に必要な共通コードを提供し、選択した効果の個別の機能の開発に集中できるようにします。

 という関数の宣言です。関数を分解してみましょう。

 は public bool 型の関数である。bool 変数型は、true または false の 2 つのブール値のいずれかを格納する。



という見慣れないキーワードがある。その名前が示すように、このキーワードは基本クラスの同じ関数（ここでは UsableItem.UsageEffect）を上書き（override）するために使用される。これにより、任意の Use 関数で機能する汎用的なコードを記述できる。



オブジェクトが使用されると、この関数はゲームによって呼び出され、その中のすべての命令を実行します。ゲームはオブジェクトが使用されているかどうかをチェックするため、ブール値を返します。使用されている場合は、持ち物リストから削除されます。


この機能を使って、プレイヤーのライフが満タンの時には falseを返して、ポーションが使われないようにすることもできます。

テンプレートスクリプトの内容を確認する

これで、スクリプトが Assets フォルダーにでき、コンパイルされてゲームコードの一部になります。これは、ゲーム内のライフ回復ポーションにこのスクリプトを割り当てることができるようになったことを意味します。


Assets/Creator Kit - Beginner Code/Prefabs /ItemDatabase

 ドロップダウンメニューを使用して、 

 を選択します。これは、下の Script フィールドに表示されます。

 フィールドに、効果の説明を追加する（たとえば、「10HP 回復」）。

このフィールドが表示されるのは、基本クラスに持ち物リストの UI の内容を格納する description 変数があるためです。先ほど作った効果クラスはこのクラスから派生しているため、Description フィールドが表示されます。


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

ライフ回復ポーションに効果を追加する

 スクリプトに戻って、実際に効果を発生させる関数を作成する必要があります。

関数が実行する必要があることと、使用可能なツールを確認しましょう。

というキャラクターのステータスを制御するための特別なシステムがあります。あるゲームオブジェクトに 

スクリプトがコンポーネントとしてアタッチされている場合、そのゲームオブジェクトは Creator Kit の 

にアクセスできます。


キャラクターのライフの状態を変更するには、

 関数を使います。この関数を使用すると、

 がアタッチされたゲームオブジェクトの状態を変更できます。

ライフ回復ポーションを使用するときにプレイヤーキャラクターのライフの値を変更するには、効果を発生させる関数で以下のことを行う必要があります。

 ドット演算子をもう 1 つ使用して、Stats 内にある 

 関数の引数として int 値を渡し、回復するプレイヤーキャラクターのライフの量を決める。


このプロセスにおいては、効果を発生させる関数は「return false;」ではなく、「

」で終わります。アイテムは消費され、プレイヤーの持ち物リストから消えます。


ドット演算子を使用して効果を発生させる関数を記述してみましょう。記述が終わったら、次のステップに進んで解答を確認してください。独力で記述できないと思われる場合は、先に次のステップに進んで解答を確認しても構いません。

効果を発生させる関数を書く

効果を発生させる関数は以下のようになります。

アイテムの効果を発生させる関数の記述を確認する

次に、ライフ回復量を変数に変更してみます。以下の情報を参考にしてください。

ライフ回復量の変数には整数を格納する必要があるため、変数の型は 

 にする。こうすると、Unity エディターでインスペクターのフィールドとして表示されるようになる。

関数の宣言より前に変数を宣言する。

なかなか完成できないようであれば、

を確認し、参考にしてください。

まずはこの置き換えをやってみてから、次のステップに進んで解答を確認してください。

ライフ回復量を変数に変更する

修正されたスクリプトは以下のようになります。

（macOS）を押して、変更を保存しましょう。

これで、Unity エディターからこの変数を編集できます。




 フィールドの下に公開変数の 

 フィールドが表示されている。

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


 再生ボタンを押して再生モードに入り、ゲームへの変更をテストする。


これで終わりです。完成しました！

スクリプトの変更内容を確認する

このチュートリアルでは、このプロジェクトでこれまで学んだ内容を応用して、以下の活動を行いました。

カスタムのライフ回復効果を発生させるスクリプトを作成する

HP の増分の値を Unity エディターで変更できる変数にする

おめでとうございます。これで、Unity ではじめての C# コードを作成し、「Creator Kit：コーディング入門」の主要部分を修了したことになります。

もう少し Rancho Rodadora にいませんか？

この学習プロジェクトの主要なチュートリアルは完了しましたが、まだまだ学ぶことがたくさんあります。

最後のチュートリアルは、この Creator Kit に合わせて作成したスクリプトのテンプレートを使って、ゲームをカスタマイズするためのリファレンスガイドです。これを使って、さまざまなアイテムやエフェクトを作成できます。

さらなる学びを始める準備はいいですか？

「Creator Kit：コーディング入門」で学んだ内容は、奥深い Unity と C# スクリプティングの世界に踏み出す第一歩にすぎません。

このプロジェクトの続きに学ぶ内容としては、以下の 2 つをおすすめいたします。

Unity Version 2020.3