roblox

roblox

Engine API Reference（クラス／プロパティの正確な情報源）： https://create.roblox.com/docs/reference/engine

エージェント向けドキュメントのインデックス一覧：

• https://create.roblox.com/docs/llms.txt（ここから始めて、Engine と Open Cloud のサブインデックスに進んでください）
• Engine 専用：https://create.roblox.com/docs/reference/engine/llms.txt

このハブスキルでは全体像を示し、専門分野ごとの SKILL.md エントリーポイントを案内します。各専門スキルは独自の詳細な references/ インデックスを備えているため、エージェントは必要な資料だけを読み込めます。

専門スキル

タスクに合ったスキルを選んでください。各専門スキルには、独自の詳細なリファレンスへのリンクがあります。

• roblox-core：サービス、型、シリアライズ、スクリプトの配置場所を選択します
• roblox-networking：リモートを設計し、クライアントからのリクエストを検証して、レプリケーションを制御します
• roblox-datastores：プレイヤーデータを保存し、同時書き込みに対処して、バージョンを復元します
• roblox-user-interfaces：レスポンシブな GUI を構築し、入力を処理して、UI エフェクトを追加します
• roblox-animation：リグをアニメーションさせ、IK を設定し、プロパティをトゥイーンして、マーカーイベントのタイミングを設定します
• roblox-vfx：パーティクル、フリップブック、ビーム、トレイル、ハイライトを構築します
• roblox-audio：オーディオグラフを構築し、エフェクトをミックスして、レガシーな Sound コードを移行します
• roblox-gamepasses：パス、プロダクト、サブスクリプション、譲渡、購入ポリシーを処理します
• roblox-open-cloud：REST API またはサポートされている HttpService 呼び出しを通じて、Roblox リソースを自動化します
• roblox-teleport：プレイヤーをプレイス間で移動させ、マッチメイキングを調整し、データを引き継ぎます
• roblox-rojo：ファイルシステムプロジェクトを設定し、Studio と同期して、プレイスをビルドおよびエクスポートします
• roblox-mcp：エージェントを Studio に接続し、インスタンスを調査し、スクリプトを編集して、プレイテストを行います
• roblox-physics：メカニズムを構築し、制約を選択して、物理の所有権を割り当てます
• roblox-npcs：NPC を移動させ、経路の遮断に対処し、巡回や追跡の動作を構築します
• roblox-testing：バグを再現し、テストを作成して、パフォーマンスをプロファイリングします

共通の制約

1. まずサーバー権限を優先します。 サーバーで検証またはシミュレーションを行います。クライアントは入力、予測、装飾的な表示に使用します。
2. クラウドと通信する処理はすべて失敗する可能性があります。 DataStore、Marketplace、Http などの呼び出しを pcall でラップします。一時的なエラーと恒久的なエラーへの対処方針を用意します。
3. アセットを事前読み込みします。 アニメーション、画像、サウンド、モデルには ContentProvider:PreloadAsync を使用します。
4. 最新の API を使用します。 Animator + LoadAnimation、task.* スケジューラー、TweenService、IKControl、CollectionService のタグ、Attributes などを使用します。非推奨の BodyMovers、wait/spawn/delay、Humanoid:LoadAnimation などは避けます。
5. 制限を守ります。 DataStore の予算は同時接続ユーザー数に応じて増えますが、有限です。パーティクルや透明な UI はフィルレートの負荷が高くなります。早い段階でプロファイリングを行います。
6. 保守しやすい構成にします。 権限処理には ServerScriptService、共有モジュールには ReplicatedStorage、クライアント UI のルートには StarterGui を使用し、モジュールの境界を明確にして、命名規則を統一します。
7. 難しい部分をテストします。 API アクセスはテスト用プレイスでのみ有効にして Studio でテストします。複数のデバイスクラスを使用します。エフェクトや UI は低いグラフィック品質でも確認します。複数のサーバーが同じキーを操作する状況での同時実行をテストします。

最新の API に関する注意事項

• 遅延イベント： Workspace.SignalBehavior = Enum.SignalBehavior.Deferred を設定する（または対応するプロジェクト設定を使用する）ことで、イベントをキューに入れてまとめて処理し、リエントランシーの問題を回避できます。
• チャット： 最新のチャットには TextChatService を使用してください。従来の Chat サービスも引き続き存在しますが、古い API です。
• MemoryStore： サーバー間で共有する短期間または高スループットのデータには MemoryStoreService を使用し、通常の DataStore は使用しないでください。
• Parallel Luau： 計算負荷の高い処理には Actor インスタンスと task.synchronize() ／ task.desynchronize() を使用し、共有状態のルールを慎重に守ってください。
• buffer 型： コンパクトなバイナリデータ、シリアル化、ビット／バイト操作には buffer Luau 型を使用してください。
• UI のセーフゾーン： デバイスのノッチやセーフエリアに対応するには、ScreenGui.ScreenInsets と関連プロパティを使用してください。
• ConfigService： ライブ設定や機能フラグには、一元化された設定システム（通常はカスタムの ConfigService モジュールまたは Configuration インスタンス）を使用してください。

ワークフロー

1. タスクを担当するスペシャリストを読み込みます。広範なアーキテクチャ作業では、architecture-principles.md も読んでください。
2. 対応する機能や障害について、そのスペシャリストの参照リンクを確認します。連携するシステムについては、cross-skill-integration.md を読んでください。
3. スクリプトの例をプロジェクトに合わせて調整し、成熟度ラベルを確認します。専用のテスト用エクスペリエンスで変更を検証してください。
4. 引き継ぐ前に、合格したチェック、Roblox との連携が必要なチェック、未解決の API またはポリシーに関する疑問を報告します。不確かな動作は、上記の公式情報源で確認してください。

参考資料一覧

• architecture-principles.md：システム全体にわたる権限の境界、データフロー、またはプロジェクト構造を決定します。
• cross-skill-integration.md：購入と永続化、またはアニメーションとエフェクトや UI を連携させます。