アセット挿入、トウィーンアニメーション、オーディオ、パーティクルエフェクト、物理コリジョングループ、ライティング・地形・空間クエリ・カメラでゲームワールドを構築します。
アセットとオブジェクト演出
対象ツール
| ツール | ティア | 説明 |
|---|---|---|
manage_assets | Pro | Creator Store検索、モデル/パッケージ挿入、アセット情報 |
manage_tween | Pro | トウィーン作成、再生、一時停止、キャンセル |
manage_animation | Pro | アニメーション読み込み、再生、停止、トラック照会 |
manage_audio | Pro | サウンド再生/停止/一時停止、オーディオリスナー設定 |
manage_effects | Pro | パーティクル放出、クリア、トグル |
manage_physics | Pro | コリジョングループ登録、コリジョン可否設定 |
主なワークフロー
アセットでシーンを構成
「Creator Storeで'木'モデルを検索してWorkspaceに3つ配置して」
manage_assets の search_insert で検索と挿入を一度に処理します。
インタラクティブな演出
「ドアをクリックすると3秒かけて開くトウィーンを作って」
manage_tween の create でトウィーンを定義して play で再生します。同時に manage_audio の play でドアを開く効果音を追加します。
パーティクル+サウンドの組み合わせ
「ボス登場時に爆発パーティクルと効果音を再生して」
manage_effects の emit でパーティクルを放出し、manage_audio の play でサウンドを同時に再生します。
アクションリファレンス
Manage Assets(Pro)
| アクション | 説明 | ティア |
|---|---|---|
insert | アセットIDでモデルを挿入 | Pro |
info | アセットのメタデータを取得 | Pro |
search | Creator 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)
| アクション | 説明 | ティア |
|---|---|---|
load | Humanoid/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)
| アクション | 説明 | ティア |
|---|---|---|
emit | ParticleEmitterからパーティクルを放出 | Pro |
clear | すべてのパーティクルをクリア | Pro |
toggle | エフェクトを有効化または無効化 | Pro |
Manage Physics(Pro)
| アクション | 説明 | ティア |
|---|---|---|
register_group | コリジョングループを登録 | Pro |
set_collidable | 2つのグループが衝突できるか設定 | Pro |
get_groups | 登録されたすべてのコリジョングループを一覧 | Pro |
ワールド環境
対象ツール
| ツール | ティア | 説明 |
|---|---|---|
manage_lighting | Pro | Lighting、Atmosphere、Sky、時刻設定 |
manage_terrain | Pro | 地形生成・変更・ボクセルデータ管理 |
spatial_query | Pro | レイキャスト、地面探索、配置検証、ハイトマップ |
manage_camera | 混合 | カメラ情報取得、フォーカス移動、推奨ビュー、Editモードのビューポートスクリーンショット |
主なワークフロー
ワールドの雰囲気を設定(Pro)
「夕暮れの雰囲気に変えて。オレンジの空、霧の密度を上げて、時刻は18時に設定」
manage_lighting の time で時刻を設定、atmosphere で霧を調整、sky で空の色を変更します。
地形の構築(Pro)
「マップ中央に半径200の草丘を作って、周りに水を満たして」
manage_terrain の fill_ball で丘を作成し、fill_block で周辺の水エリアを満たします。
配置検証(Pro)
「この建物を置ける平らな土地を探して」
spatial_query の find_flat で適した位置を見つけ、check_placement で衝突の有無を確認して、manage_camera の focus_position で結果を視覚的に確認します。
アクションリファレンス
Manage Lighting(Pro)
| アクション | 説明 | ティア |
|---|---|---|
lighting | Lightingサービスのプロパティを設定 | Pro |
atmosphere | Atmosphereのプロパティを設定 | Pro |
sky | Skyのプロパティを設定 | Pro |
terrain_props | Terrainの水・視覚プロパティを設定 | 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 |
collision | AABBコリジョンを確認 | Pro |
Manage Camera(混合)
| アクション | 説明 | ティア |
|---|---|---|
info | カメラの位置、回転、FOV、ビューポートサイズを取得 | Basic |
focus_path | カメラをインスタンスにフォーカス移動 | Basic |
focus_position | カメラを位置にフォーカス移動 | Basic |
suggest | 対象に対する推奨カメラビューを取得 | Basic |
screenshot | 現在のStudio EditモードのビューポートをPNG画像でキャプチャ(Editモード専用) | Pro |