Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Checking the stable version of the documentation...

BaseMaterial3D

Inherits: Material < Resource < RefCounted < Object

Inherited By: ORMMaterial3D, StandardMaterial3D

Default 3D rendering material.

Description

This provides a default material with a wide variety of rendering features and properties without the need to write shader code. See the tutorial below for details.

Tutorials

• Standard Material 3D

Properties

Color	albedo_color	Color(1, 1, 1, 1)
Texture2D	albedo_texture
bool	albedo_texture_force_srgb	false
bool	albedo_texture_msdf	false
float	alpha_antialiasing_edge
AlphaAntiAliasing	alpha_antialiasing_mode
float	alpha_hash_scale
float	alpha_scissor_threshold
float	anisotropy	0.0
bool	anisotropy_enabled	false
Texture2D	anisotropy_flowmap
bool	ao_enabled	false
float	ao_light_affect	0.0
bool	ao_on_uv2	false
Texture2D	ao_texture
TextureChannel	ao_texture_channel	0
Color	backlight	Color(0, 0, 0, 1)
bool	backlight_enabled	false
Texture2D	backlight_texture
bool	billboard_keep_scale	false
BillboardMode	billboard_mode	0
BlendMode	blend_mode	0
float	clearcoat	1.0
bool	clearcoat_enabled	false
float	clearcoat_roughness	0.5
Texture2D	clearcoat_texture
CullMode	cull_mode	0
DepthDrawMode	depth_draw_mode	0
Texture2D	detail_albedo
BlendMode	detail_blend_mode	0
bool	detail_enabled	false
Texture2D	detail_mask
Texture2D	detail_normal
DetailUV	detail_uv_layer	0
DiffuseMode	diffuse_mode	0
bool	disable_ambient_light	false
bool	disable_receive_shadows	false
float	distance_fade_max_distance	10.0
float	distance_fade_min_distance	0.0
DistanceFadeMode	distance_fade_mode	0
Color	emission	Color(0, 0, 0, 1)
bool	emission_enabled	false
float	emission_energy_multiplier	1.0
float	emission_intensity
bool	emission_on_uv2	false
EmissionOperator	emission_operator	0
Texture2D	emission_texture
bool	fixed_size	false
bool	grow	false
float	grow_amount	0.0
bool	heightmap_deep_parallax	false
bool	heightmap_enabled	false
bool	heightmap_flip_binormal	false
bool	heightmap_flip_tangent	false
bool	heightmap_flip_texture	false
int	heightmap_max_layers
int	heightmap_min_layers
float	heightmap_scale	5.0
Texture2D	heightmap_texture
float	metallic	0.0
float	metallic_specular	0.5
Texture2D	metallic_texture
TextureChannel	metallic_texture_channel	0
float	msdf_outline_size	0.0
float	msdf_pixel_range	4.0
bool	no_depth_test	false
bool	normal_enabled	false
float	normal_scale	1.0
Texture2D	normal_texture
Texture2D	orm_texture
int	particles_anim_h_frames
bool	particles_anim_loop
int	particles_anim_v_frames
float	point_size	1.0
float	proximity_fade_distance	1.0
bool	proximity_fade_enabled	false
bool	refraction_enabled	false
float	refraction_scale	0.05
Texture2D	refraction_texture
TextureChannel	refraction_texture_channel	0
float	rim	1.0
bool	rim_enabled	false
Texture2D	rim_texture
float	rim_tint	0.5
float	roughness	1.0
Texture2D	roughness_texture
TextureChannel	roughness_texture_channel	0
ShadingMode	shading_mode	1
bool	shadow_to_opacity	false
SpecularMode	specular_mode	0
bool	subsurf_scatter_enabled	false
bool	subsurf_scatter_skin_mode	false
float	subsurf_scatter_strength	0.0
Texture2D	subsurf_scatter_texture
float	subsurf_scatter_transmittance_boost	0.0
Color	subsurf_scatter_transmittance_color	Color(1, 1, 1, 1)
float	subsurf_scatter_transmittance_depth	0.1
bool	subsurf_scatter_transmittance_enabled	false
Texture2D	subsurf_scatter_transmittance_texture
TextureFilter	texture_filter	3
bool	texture_repeat	true
Transparency	transparency	0
bool	use_particle_trails	false
bool	use_point_size	false
Vector3	uv1_offset	Vector3(0, 0, 0)
Vector3