UnityLaparoscopicSceneSimulator/.claude/commands/urp-render-pipeline.md

URP Render Pipeline (project-scoped)

URP 14.0.11-specific render-pipeline work. Translates HDRP-flavoured requests into URP-safe operations.

When to use

Load before touching URP assets, Volume profiles, reflection probes, color space, fog, skybox, or any HDRP-flavoured request.

URP assets inventory (do not move)

• Assets/Settings/URP-Balanced.asset + URP-Balanced-Renderer.asset
• Assets/Settings/URP-HighFidelity.asset + URP-HighFidelity-Renderer.asset
• Assets/Settings/URP-Performant.asset + URP-Performant-Renderer.asset
• Assets/Settings/SampleSceneProfile.asset — Volume profile (post-processing overrides live here)
• Assets/Settings/TexturesSettings.asset

Confirm which URP asset is current before changing it:

mcp__UnityMCP__manage_graphics(action="pipeline_get_info")

Translating HDRP concepts to URP

HDRP concept	URP equivalent	Notes
HDRP Volume with Bloom/Vignette/DoF/etc.	URP Volume with same override names	Use volume_set_effect
Exposure in EV (physical)	ColorAdjustments.postExposure (stops, ±1.0)	Fix lighting if range > 1.0
Sky and Fog Volume	RenderSettings.fog + URP setup	URP fog is limited; document limitation
HDRP ReflectionProbe every-frame	URP ReflectionProbe Refresh Mode = Via Scripting	Document when re-bake is needed
PlanarReflectionProbe	Not available in URP 14; use ReflectionProbe or render feature	Propose render feature with approval
Ray-traced reflections / path tracer	Not available in URP	Refuse; suggest baked probe + roughness modulation

Volume profile: how to add / edit overrides

1. Locate the active profile: mcp__UnityMCP__manage_graphics(action="volume_get_info").
2. Add missing override: mcp__UnityMCP__manage_graphics(action="volume_add_effect", profile_path="Assets/Settings/SampleSceneProfile.asset", effect="Bloom").
3. Set parameters: mcp__UnityMCP__manage_graphics(action="volume_set_effect", effect="Bloom", parameters={"threshold": 1.0, "intensity": 0.25, "scatter": 0.7}).

URP 14 override names: Bloom, Vignette, ChromaticAberration, DepthOfField, MotionBlur, PaniniProjection, LensDistortion, FilmGrain, Tonemapping, ColorAdjustments, LiftGammaGain, ChannelMixer, ShadowsMidtonesHighlights, SplitToning, WhiteBalance, HDROverrides, ScreenSpaceAmbientOcclusion, ScreenSpaceShadows.

Laparoscope-friendly starting profile

Override	Starting values
Bloom	intensity 0.1–0.3, threshold ~1.0, scatter 0.7
Vignette	intensity 0.2–0.4, smoothness 0.3–0.5
DepthOfField	mode Gaussian, gaussianStart 0.05–0.1, gaussianEnd 0.3–0.5, gaussianMaxRadius 1.0–2.0
Tonemapping	Neutral or ACES
ColorAdjustments	postExposure ~0, contrast +0.05 to +0.15
LensDistortion	intensity 0.05–0.15
ChromaticAberration	intensity 0.05–0.1

These are starting values. Verify by screenshot.

Lighting bake workflow

mcp__UnityMCP__manage_graphics(action="bake_start")
# poll until done:
mcp__UnityMCP__manage_graphics(action="bake_status")

After baking: read_console for lightmap errors, then screenshot.

Hard limits

• Do not swap the active URP asset without explicit approval.
• Do not add a renderer feature without a bounded change statement and explicit approval.
• Vignette.intensity ≤ 0.5 (above this, looks like a damaged lens, not a scope).
• LensDistortion.intensity ≤ 0.2.