WEPPY

アセットとオブジェクト演出ガイド

アセット挿入、トウィーン、オーディオ、パーティクル、物理、環境(ライティング・地形)の演出フロー。

アセット挿入、トウィーンアニメーション、オーディオ、パーティクルエフェクト、物理コリジョングループ、ライティング・地形・空間クエリ・カメラでゲームワールドを構築します。

アセットとオブジェクト演出

対象ツール

ツール説明
manage_assetsCreator Store検索、モデル/パッケージ挿入、アセット情報
manage_tweenトウィーン作成、再生、一時停止、キャンセル
manage_animationアニメーション読み込み、再生、停止、トラック照会
manage_audioサウンド再生/停止/一時停止、オーディオリスナー設定
manage_effectsパーティクル放出、クリア、トグル
manage_physicsコリジョングループ登録、コリジョン可否設定

主なワークフロー

アセットでシーンを構成

「Creator Storeで'木'モデルを検索してWorkspaceに3つ配置して」

manage_assetssearch_insert で検索と挿入を一度に処理します。

インタラクティブな演出

「ドアをクリックすると3秒かけて開くトウィーンを作って」

manage_tweencreate でトウィーンを定義して play で再生します。同時に manage_audioplay でドアを開く効果音を追加します。

パーティクル+サウンドの組み合わせ

「ボス登場時に爆発パーティクルと効果音を再生して」

manage_effectsemit でパーティクルを放出し、manage_audioplay でサウンドを同時に再生します。

アクションリファレンス

Manage Assets

アクション説明
insertアセットIDでモデルを挿入
infoアセットのメタデータを取得
searchCreator Storeを検索
search_insert検索して最初の一致を挿入
insert_free無料モデルを挿入
insert_packageパッケージを挿入
export現在の選択をエクスポート

Manage Tween

アクション説明
create対象プロパティを持つトウィーンを作成
play作成したトウィーンを再生
pause実行中のトウィーンを一時停止
cancelトウィーンをキャンセル

Manage Animation

アクション説明
loadHumanoid/AnimationControllerにアニメーションを読み込む
play読み込まれたアニメーショントラックを再生
stop再生中のアニメーションを停止
get_tracks読み込まれたすべてのアニメーショントラックを一覧

Manage Audio

アクション説明
playサウンドを再生(必要に応じてSoundを作成)
stop再生中のサウンドを停止
pause再生中のサウンドを一時停止
resume一時停止中のサウンドを再開
set_listenerオーディオリスナーのタイプ/対象を設定

Manage Effects

アクション説明
emitParticleEmitterからパーティクルを放出
clearすべてのパーティクルをクリア
toggleエフェクトを有効化または無効化

Manage Physics

アクション説明
register_groupコリジョングループを登録
set_collidable2つのグループが衝突できるか設定
get_groups登録されたすべてのコリジョングループを一覧

ワールド環境

対象ツール

ツール説明
manage_lightingLighting、Atmosphere、Sky、時刻設定
manage_terrain地形生成・変更・ボクセルデータ管理
spatial_queryレイキャスト、地面探索、配置検証、ハイトマップ
manage_cameraカメラ情報取得、フォーカス移動、推奨ビュー、Editモードのビューポートスクリーンショット

主なワークフロー

ワールドの雰囲気を設定

「夕暮れの雰囲気に変えて。オレンジの空、霧の密度を上げて、時刻は18時に設定」

manage_lightingtime で時刻を設定、atmosphere で霧を調整、sky で空の色を変更します。

地形の構築

「マップ中央に半径200の草丘を作って、周りに水を満たして」

manage_terrainfill_ball で丘を作成し、fill_block で周辺の水エリアを満たします。

配置検証

「この建物を置ける平らな土地を探して」

spatial_queryfind_flat で適した位置を見つけ、check_placement で衝突の有無を確認して、manage_camerafocus_position で結果を視覚的に確認します。

アクションリファレンス

Manage Lighting

アクション説明
lightingLightingサービスのプロパティを設定
atmosphereAtmosphereのプロパティを設定
skySkyのプロパティを設定
terrain_propsTerrainの水・視覚プロパティを設定
time時刻を設定

Manage Terrain

アクション説明
fill_blockブロック形状の地形を充填
fill_ball球形状の地形を充填
fill_cylinder円柱形状の地形を充填
fill_wedgeくさび形状の地形を充填
clear_region領域の地形をクリア
clear_bounds境界の地形をクリア
replace_material領域のマテリアルを置換
colors_getマテリアルカラーを取得
colors_setマテリアルカラーを設定
read_voxel単一ボクセルデータを読み込む
read_voxels大量のボクセルデータを読み込む
write_voxels大量のボクセルデータを書き込む
generate手続き的地形を生成
smooth地形を滑らかにする

Spatial Query

アクション説明
raycast単一レイキャスト
find_ground地点の下の地面位置を探す
check_placement配置に衝突がないか確認
multi_raycast複数レイを一括キャスト
scan_area領域のハイトマップを生成
find_flat建設向けの平らな領域を探す
find_spawn適切なスポーン位置を探す
analyze_walkable移動可能領域グリッドを分析
spatial_mapすべてのBasePartの位置を取得
find_spaceオブジェクト向けの空きスペースを探す
boundsインスタンスのバウンディングボックスを取得
snap_grid位置をグリッドにスナップ
collisionAABBコリジョンを確認

Manage Camera(混合)

アクション説明
infoカメラの位置、回転、FOV、ビューポートサイズを取得
focus_pathカメラをインスタンスにフォーカス移動
focus_positionカメラを位置にフォーカス移動
suggest対象に対する推奨カメラビューを取得
screenshot現在のStudio EditモードのビューポートをPNG画像でキャプチャ(Editモード専用)