カスタム武器を作る-ピストル編④

前回に引き続き、いよいよアビリティの編集です。

今回の記事で注射器銃はひとまず完成。

前回はこちら

yunyustarbound.hatenablog.com

武器ダメージのバランスは、バニラのアドベンチャー後半をベースにして書いていきます。

まずは基礎ダメージ値を設定しましょう。

"parameters">"primaryAbility"内に記載されている"baseDps"という値があります。

こちらをパラメータごと削除し、代わりに"baseDamage"を挿入します。

更に、同じ階層に存在する、"energyUsage"も変更します。

こちらはエネルギーの使用量ですが、デフォルトでは乱射するには高めの値になっている為、こちらを3に変えてみます。

次に、projectile(放射物)の挙動を変えていきましょう。

まず、先程と同階層内にある"projectileType"を変更します。このプロパティは一発毎の初弾として発射されるprojectileの種類を変える事が出来ます。

各projectileは、asset内のprojectilesフォルダに一つづつ独立したjson形式のファイル形式で格納されています。

デフォルトは"standardbullet"が設定されている為、銃を撃つごとにベーシックな銃弾が発射されます。

TF2の注射器銃の弾は、重力影響を受けて弧を描くように飛び、地面や壁に突き刺さったりしますが、Starboundでは弓のprojectileがちょうどこの挙動に近い為、今回は"ironarrow"を初弾のprojectileに設定します。

この状態で出力すると、projectileがstandardbulletからironarrowに変わっていることが確認できます。

次に、このprojectileに基本情報を盛り込んでいきましょう。

同じ階層の中に、"projectileParameters"というパラメータがあります。

f:id:yunyu_sb:20180225165020p:plain

このパラメータ内では、設定されたprojectileの威力・スピード・見た目・生存時間などの基本的な情報に加え、projectileが壊れた時に実行するアクション・projectileが定期的に実行するアクション・projectileが地形と衝突した時に行うアクション・projectileがエンティティに衝突した時のアクションなど、各タイミングに行うアクションを設定できます。

アクションの種類は

projectile (放射物)
particle (アニメーションや画像、テキストなど)
monster (モンスター。名前や見た目、挙動などのパラメータも変更可能)
sound (sfxフォルダやmusicフォルダ内の任意のoggを指定可能)

などがあり、任意のタイミングで任意のアクションを行うように設定が可能です。

個人的にはこのprojectileのコントロールがスターバウンドのjsonコーディングの中で一番自由度が高い部分でと思ってます。

今回はprojectileをコントロールして、元ネタ武器の

「敵に弾が当たった時、自分が回復する」という機能の再現を行っていきます。

初めから"knockbackRange"が挿入されてますが、使わないので消しましょう。

f:id:yunyu_sb:20180225170716p:plain

とりあえず"敵にヒットした時"という部分以外を先に完成させる為、以下の項目を書き込みましょう。

"power" : 10,

"speed" : 60,

"timeToLive" : 5,

"piercing" : false,

"processing" : ""

"power"はprojectileごと(ironarrowのみ)の威力、speedは60、timeToLiveは生存時間、piercingはエンティティ(プレイヤーやモンスター)を貫通するかどうかを示しています。

また"processing"は、Directivesコードを挿入することでprojectileの見た目を変更できます。今回は注射器の画像を使って見た目の変更をしてみましょう。

f:id:yunyu_sb:20180225172203p:plain

とりあえず描いたものがこちら。

これを武器画像の時と同様に、Drawable Generatorで読み込み、「Single Texture Directives」でDirectivesコードにします。

さて、これを直接貼り付けたいところです…が、仮にそれをやってしまうとこういう状態になります。

弾が見えなくなってしまいました。

これは、projectileの元画像よりも、差し替え後の画像のサイズが大きい事から、正常に色の置き換えが行えずにこのような現象が発生してしまっているという状態です。

そのため、画像差し替えを行う場合はDirectivesコードの前に、画像サイズを大きくするためのDirectivesコードを挿入しなければなりません。

それは"?scalenearest=数値"です。

これを画像のDirectivesコードの前に挿入します。数値の部分は、変更後の画像サイズに合わせて調整する必要があります。

今回の場合は、注射器の画像もまあまあ小さめなので、?scalenearest=2 (元画像のサイズを2倍)にしてみます。

f:id:yunyu_sb:20180225173540p:plain

無事注射器が発射されるようになりました。

それでは次に、「敵に弾が当たった時、自分が回復する」の部分を作っていきたいと思います。

まずはprojectileにタイミングアクションを設定する為のパラメータを追記します。

"actionOnHit" : [

],

先程の"processing"にコンマを打ってない(=最後尾のパラメータである)為、後ろに追加するよりは前に追加した方がコンマの足し引きを考えなくていいのでややこしくないかもしれません。(私は見やすさ的にタイミング関係は最後尾に書くクセがあるのですが)

という事で"power"の前に書いてみました。

この"actionOnHit"は、敵エンティティに親projectileがヒットした時、[ ]内のアクションを実行するというタイミング設定です。

そのため今の書き方の場合はironarrowがヒットした時に[ ]内を実行するという風になってます。

それでは次に、実行してほしいアクションを書きます。

これはprojectileアクションの記述方式です。

どのアクションも"action" : "アクションの種類"の記述で種類が決定されます。

"type"はprojectileアクションを行う際のprojectileの種類を設定できます。

今回は"tentaclefist"を使います。このprojectileはエイリアン系の触手銃で使われているprojectileで、撃ったあとに持ち主の所に戻って来る特性を持ちます。

"config"は"projectileParameters"と同じく、"power","speed","timeToLive"や各種タイミング指定とアクションが挿入できます。"config"自体を書かなかった場合、デフォルトのprojectileの設定になります。

これで注射器が敵に当たった場合、tentaclefistが発生するという挙動ができました。

ただ、この状態で敵を撃った時に分かるように、現在の状態のtentaclefistでは生まれてから戻ってくるまでの時間が結構かかってしまっています。

この後の回復処理をすばやく発生させるために、tentaclefistがすぐに帰ってくるようにconfigを編集しましょう。

"speed" : 100,

"onlyHitTerrain" : true,

"movementSettings" : {"collsionEnabled" : false},

"returning" : true,

"returnOnHit" : true,

"controlForce" : 100000,

"pickupDistance" : 3,

"snapDistance" : 0,

"maxDistance" : 0,

"ignoreTerrain" : true,

"minVelocity" : 1,

"stickTime" : 0,

"actionOnReap" : [ ]