Up to date

This page is up to date for Godot 4.1. If you still find outdated information, please open an issue.

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