PlacementPresentationProfile3D

Optional look for the 3D placement preview: how the ghost is shaded and a ring on the ground under it. Assign it in ObjectPlacementSettings3D.presentation_profile. It only changes how the preview looks, never where or whether an object can be placed. Without a profile the preview uses the plain valid/invalid tint.

Source: addons/grid_placement/resources/presentation/placement_presentation_profile_3d.gd

Syntax

class PlacementPresentationProfile3D extends Resource

Members

Name	Kind	Summary
ghost_alpha_scale	Property	Multiplies the opacity of the ghost's valid and invalid colors.
ghost_detail_tint	Property	How strongly the ghost is tinted with the valid or invalid color. 1.0 is a flat tint; lower values show more of the object's own materials.
ghost_valid_emission	Property	Emission added to valid previews (alpha is the energy multiplier; 0 disables). Keeps the ghost readable over dark, textured surfaces.
ghost_blocked_emission	Property	Emission added to blocked previews (alpha is the energy multiplier).
ghost_rim_strength	Property	Rim light strength (0 disables). A rim reads the piece silhouette against busy backgrounds without obscuring its surface.
ghost_rim_tint	Property	How much the rim is tinted by the surface albedo (0 is white, 1 is albedo).
enable_contact_ring	Property	Draws a ring on the ground under grid placement previews. For smooth placement, use ObjectPlacementSettings3D.smooth_enable_contact_ring; it uses the ring colors and shape set here.
ring_valid_color	Property	Ring color while the pending placement is valid.
ring_blocked_color	Property	Ring color while the pending placement is blocked.
ring_inner	Property	Inner radius fraction of the ring (0.78 leaves a 22% band at the edge).
ring_softness	Property	Ring edge softness in UV units.
ring_pad	Property	Extra radius beyond the preview's horizontal extent, in meters.
ring_pulse_speed	Property	Pulse speed in radians per second; 0 disables the pulse.
ring_pulse_amount	Property	Pulse depth as a fraction of ring alpha.
ring_shader	Property	Optional custom ring shader. It must expose the `ring_color`, `ring_inner`, `ring_softness`, `pulse_speed`, and `pulse_amount` uniforms.