mcpField
U
unity-urp

unity-urp

github.com/besty0728開発1.9k75 回インストール今日更新
リポジトリ

unity-urp について

unity-urp は、Unity の URP アセットとレンダラー機能を管理するスキルモジュールです。描画設定を行う開発者向けで、機能追加前に実行環境での利用可否を確認します。

主な機能

  1. 01URP アセットとレンダラーレイアウトの確認
  2. 02HDR、MSAA、スケール、シャドウ設定の編集
  3. 03レンダラーと機能の一覧表示
  4. 04レンダラー機能の追加・削除・切り替え

活用シーン

  1. 01アクティブな URP アセットの確認
  2. 02シャドウやカメラテクスチャ設定の調整
  3. 03レンダラー機能の管理

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/besty0728/unity-skills --skill unity-urp

インストール後、Claude Code で/unity-urpを入力して読み込まれたか確認します。

詳細

このモジュールのスキルを呼び出す前に: 名前や説明から推測したパラメーターを使ってスキルを呼び出そうとしている場合は、いったん止めて、このファイルを読むか、GET /skills/recommend?includeSchema=true でスキーマを取得してください。recommend/schema からすでにパラメーター定義を取得している場合は、そのまま dryRun に進めます。

トリガー

  • URP アセットの設定
  • レンダラー機能の追加または編集
  • URP のレンダリング設定の調整
  • URP アセットの設定、レンダラー機能の追加または編集、URP のレンダリング設定の調整

URP スキル

Unity 2022.3 以降(URP 14 および Unity 6 / URP 17)向けの、URP 固有のアセットおよびレンダラー機能の管理です。

動作モード

  • クエリスキル(urp_get_info、urp_list_renderers、urp_list_renderer_features)は SkillMode.SemiAuto です。許可なしで 3 つすべてのモードで実行されます。
  • 変更スキル(urp_set_asset_settings、urp_add_renderer_feature、urp_set_renderer_feature_active)は SkillMode.FullAuto です。Approval ではユーザーの許可が必要です(許可するとサーバー側で 1 回実行され、結果が返されます)。Auto / Bypass では直接実行されます。
  • urp_remove_renderer_feature には SkillOperation.Delete が設定されており、Approval / Auto モードでは自動的に禁止されます(NeverInSemi)。実行できるのは Bypass またはユーザーが管理する Allowlist のみです。

URP パッケージのスタブ

このモジュールは com.unity.render-pipelines.universal(URP)を対象にコンパイルされています。URP がインストールされていない場合、すべてのスキルはスタブ { error: "Universal Render Pipeline package … is not installed." }(RenderPipelineSkillsCommon.NoURP())を返します。このスタブは診断用のペイロードであり、許可の拒否ではありません。許可は不要で、NeverInSemi としても扱われません。このエラーが表示された場合は、まず project_get_render_pipeline を呼び出してください。

ガードレール

禁止事項:

  • このモジュールを ShaderGraph に使用しないでください
  • 任意のカスタムレンダラー機能を安全にインスタンス化できると想定しないでください
  • Unity 2022 と Unity 6 で、同じ組み込みレンダラー機能が公開されていると想定しないでください

ランタイム優先のルール:

  • urp_add_renderer_feature の前に、必ず urp_get_info を呼び出してください
  • urp_get_info.creatableRendererFeatures が返した名前のみを使用してください
  • RenderObjects、FullScreenPassRendererFeature、ScreenSpaceReflectionRendererFeature などを、あらゆる環境で利用可能なものとしてハードコードしないでください
  • urp_set_renderer_feature_active または urp_remove_renderer_feature を呼び出す前に、urp_list_renderer_features を使用して既存の機能名/インデックスを確認してください

検証済みの動作:

  • Unity 2022.3 と URP 14 の実環境では、作成可能な機能のセットが小さく、たとえば DecalRendererFeature と ScreenSpaceAmbientOcclusion のみの場合があります
  • Unity 6 と URP 17 の実環境では、より多くの機能が公開される場合があります

スキル

urp_get_info

アクティブな URP アセットとレンダラーの構成を調べます。

urp_set_asset_settings

HDR、MSAA、レンダースケール、シャドウ、カメラテクスチャなど、URP アセットの主要な設定を変更します。

urp_list_renderers

アクティブな URP アセット上のレンダラーデータアセットを一覧表示します。

urp_list_renderer_features

指定したレンダラーのレンダラー機能を一覧表示します。

urp_add_renderer_feature

安全な組み込みレンダラー機能をレンダラーに追加します。

urp_remove_renderer_feature

レンダラーからレンダラー機能を削除します。

urp_set_renderer_feature_active

レンダラー機能を有効または無効にします。


正確なシグネチャ

正確な名前、パラメーター、デフォルト値、戻り値は、このファイルではなく GET /skills/schema または unity_skills.get_skill_schema() で定義されています。

コメント