【魚３Dモデル、セットアップツール付き】ワールド専用　魚が自由に泳ぎ回る！FishAIシステム　アクアリウム用

FishAI　UdonScript　System（フィシュAIウドンスクリプトシステム）

①商品説明　

FishAIは複雑な遊泳アニメーションを作らなくてもプログラムが自動的にいろいろな方向へランダムに泳ぎ回り、モデルさえあればまるで魚が意志をもって動き出したかのような遊泳モーションを作れるアクアリウム用プログラムシステムになります。

具体的に遊泳座標とアニメーション制御をするFishAI、遊泳範囲を決めるFishArea、FishAIを束ねて制御するFishmanagerという３つのスクリプトによって構成されます。

主な機能

・四角形水槽対応（または球）

・ランダム遊泳

・滑らかな旋回

・遊泳範囲制限

・遊泳速度設定

・旋回速度設定

・上下遊泳設定

・遊泳アニメーション速度連動

・ランダムスポーン

・ランダム初期方向

・AI更新分散処理対応

・UdonSharp対応

使用例

・水族館

・ホームワールドの水槽

・アクアリウム

・海中

同封スクリプト

【FishArea.cs】

魚が泳ぐ範囲を管理します。

遊泳範囲設定

ランダム座標生成

範囲判定

範囲内へ補正

通常は水槽ごとに1つまたは複数設置します。

【FishManager.cs】

複数の魚AIを分散更新します。

大量の魚が同時にAI判断を行わないため、負荷を抑えることができます。

【FishAI.cs】

魚本体へ追加するAIです。

ランダム遊泳

目的地変更

滑らかな旋回

遊泳アニメーション再生

FishManagerとの連携

②　導入手順（セットアップツール導入）

１まずはUnityプロジェクトにこちらのFishAIsystemをインポートしてください。

2　Unity上のToolsタブからADONOS→FishAIsystemSetupwindowを実行してください

３水槽のサイズを設定してください。単位がｍなので１ｍ四方の水槽だとＸ１　Ｙ１　Ｚ１　となります。マージンは0.2～１がおすすめ。小さい水槽ほどマージンは低くしてください。

４　サイズとマージンを設定したらFishAIsystemをセットアップを実行してください。

５　完了のメッセージを確認したら生成されたFishAIsystemに３つのゲームオブジェクトが入っているか確認してください。

６　fishContainerに泳がせたい魚のモデルをすべて入れてください。

７　魚を入れたら再びセットアップツールの下の魚をセットアップを実行してください（魚とアニメーターを自動検出してマネージャーとfishAIを組み込みます）

８正常に完了したらメッセージが出てきて入れた魚と検出された魚が合っているか確認し導入完了です。

※　遊泳エリアを複数作って魚ごとに変える場合

①ツールを使わずに一つ一つ設定していきます。プレハブフォルダに入っているfishareaをヒエラルキーに任意の数入れます（この時名前を変えてわかりやすくしてください）

②魚のモデルにFishAIのコンポーネントを追加してfishareaの欄にその魚のフィッシュエリアを選択してください。続いてアニメーターも選択してください。

③FishAIの設定をしたら次にプレハブをフォルダからFishmanagerをヒエラルキーに入れてマネージャーのインスペクターからターゲット欄にFishAIの入っているすべての魚を追加してください

※今開発中ですがこちらも一括セットアップできるように改良予定です

慣れてきたら遊泳範囲や魚を複数設定して大きな水族館を作ってみましょう。入れすぎると重くなる可能性はありますが50匹程度なら軽いまま動作しました（スペックや環境により変わる可能性があります）

③　FishAI　推薦設定

小型魚系

Move Speed

1.5

Turn Speed

45

Forward Bias

0.4

中型魚

Move Speed

1.0

Turn Speed

25

Forward Bias

0.6

大型魚

Move Speed

0.5

Turn Speed

6

Forward Bias

0.85

推奨環境

Unity 2022

VRChat SDK3 Worlds

UdonSharp

Built-in Render Pipeline

同封魚モデル

ツノダシ　△4080　頂点数7439

ナンヨウハギ　△2062　頂点数3588

ブリ　　△5192　頂点数9172

コガネシマアジ　△2050　頂点数3939

④　Q＆A

Q魚が遊泳範囲より外に飛び出してしまう…

A.ターンスピードが小さすぎませんか？ここが小さいと魚が大回りになり範囲から飛び出すことがあります。turnspeedの数値を上げるか遊泳範囲のBOXサイズを変更してみてください。

Q　魚のひれなどのモーションが動かない

A.こちらの商品に入っている魚でしたらanimatorがコンポーネントについているのを確認してください。またアニメーションのLoop、Loopポーズにチェックが入っているか確認後FishAIのFishanimatorにそのアニメーターが入っているか確認してください。

Q　FishAIが作動しない（魚が動かない）

A.FishAIのコンポーネントが魚に入っているか確認後Fishmanagerにその魚のゲームオブジェクトが選択されているか確認してください。サンプルを使っても動かないようでしたらUdon#本体の不具合若しくはUnityproject環境の不具合が考えられます。

こちらのFishAIを使ったワールドがあります。気になる方はチェックしてみてください。

https://vrchat.com/home/launch?worldId=wrld_3af9fc5d-d409-4e85-aeac-d764700842e4

禁止事項

スクリプトコードやシェーダーコードの転用、販売禁止します。そのほかあど式アセット利用規約に従います。

バージョン情報

2026/08/17　Ver1.1　一括セットアップツール及びツール開発＆導入