WEPPY

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

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

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

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

対象ツール

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

主なワークフロー

アセットでシーンを構成

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

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

インタラクティブな演出

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

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

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

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

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

アクションリファレンス

Manage Assets(Pro)

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

Manage Tween(Pro)

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

Manage Animation(Pro)

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

Manage Audio(Pro)

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

Manage Effects(Pro)

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

Manage Physics(Pro)

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

ワールド環境

対象ツール

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

主なワークフロー

ワールドの雰囲気を設定(Pro)

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

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

地形の構築(Pro)

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

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

配置検証(Pro)

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

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

アクションリファレンス

Manage Lighting(Pro)

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

Manage Terrain(Pro)

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

Spatial Query(Pro)

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

Manage Camera(混合)

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