Materiales
Gobu nombra sus materiales como Unreal:
| Gobu | Qué es | Archivo |
|---|---|---|
| Material | El código: un shader_type y sus funciones. | .material |
| MaterialInstance | Usa un Material y guarda los valores de sus parámetros. Es lo que se asigna a las mallas. | .tres |
| MaterialFunction | Funciones reutilizables que se incluyen con #include. | .materialfn |
| LayeredMaterial | Un material hecho de una pila de capas, sin código. | .tres |
StandardMaterial3D, CanvasItemMaterial y los materiales de cielo funcionan como siempre. Los
proyectos guardados con los nombres de antes (.gdshader, ShaderMaterial, ShaderInclude)
siguen cargando; al guardarlos se escriben los nuevos.
La biblioteca de materiales
Sección titulada «La biblioteca de materiales»Abre el menú de un hueco de material en el Inspector y elige Material Library…: la Material
Library se abre en una ventana flotante. Muestra materiales listos por categoría
(Real-world y Stylized), con un buscador (wood, metal, gold, toon…).

Haz clic en un material: se copia al proyecto (res://Materials/) y se pone en ese hueco. La
copia es tuya para editarla; la biblioteca no cambia. La copia aparece en el panel Assets cuando el
sistema de archivos se vuelve a escanear.

La biblioteca viene con el editor, ya compilada: aplicar un material nunca espera a que se compile un shader.
LayeredMaterial: capas en lugar de un grafo
Sección titulada «LayeredMaterial: capas en lugar de un grafo»Un LayeredMaterial es una pila de capas, como en Spline o en un editor de imágenes. Créalo en cualquier hueco de material (New LayeredMaterial) y usa Add Layer:
| Capa | Qué añade |
|---|---|
| Color | Un color plano. |
| Gradient | Dos colores según la altura, el ancho, la profundidad, la distancia o el ángulo de vista. |
| Noise | Ruido value, Perlin, celular o fractal entre dos colores. |
| Fresnel | Un color en los bordes. |
| Texture | Una textura por UV o triplanar (no necesita UV). |
| Matcap | Una textura matcap. |
| Pattern | Rayas, ajedrez, lunares o rejilla. |
Cada capa tiene un modo de mezcla (normal, multiply, screen, overlay, soft light, add), una opacidad y un destino (el color de la superficie o su emisión). La tarjeta de arriba se dibuja sobre las de abajo; se reordenan con las flechas. Shading elige PBR, sin sombreado o toon.

Cambiar un color o un valor es instantáneo. Los materiales con la misma estructura de capas comparten un único programa compilado, así que una escena con muchos sigue siendo barata.
Para seguir en código, en el menú del recurso: Convert to MaterialInstance.
Escribir materiales: las funciones gobu://
Sección titulada «Escribir materiales: las funciones gobu://»Los materiales se escriben en el lenguaje de shaders (shader_type spatial;, void fragment()…).
El motor incluye una biblioteca de funciones que se pueden usar desde cualquier material:
shader_type spatial;#include "gobu://triplanar.materialfn"#include "gobu://noise.materialfn"
uniform sampler2D rock : source_color;
void fragment() { vec3 world = (INV_VIEW_MATRIX * vec4(VERTEX, 1.0)).xyz; vec3 n = mat3(INV_VIEW_MATRIX) * NORMAL; ALBEDO = gobu_triplanar(rock, world, n, 0.5, 4.0).rgb; ALBEDO *= 0.8 + 0.2 * gobu_value_noise3d(world * 2.0);}| Módulo | Funciones |
|---|---|
noise | value, perlin, simplex, worley, fbm; actores MaterialX mx_noise3d, mx_fractal3d… |
color | luminancia, HSV, cambio de tono, saturación, contraste, sRGB ↔ lineal, degradados |
uv | repetición, rotación, polares, remolino, flipbook, desplazamiento, parallax |
triplanar | proyección de texturas y normal maps sin UV |
normal | mezcla de normales, normales a partir de una altura |
blend | modos de mezcla (multiply, screen, overlay…), mezcla por altura |
lighting | fresnel, borde, rampa toon, difuso envolvente, UV de matcap |
wind | viento en los vértices y temblor de hojas |
sdf2d | formas 2D, unión suave, relleno y contorno sin dientes |
billboard | billboards que miran a la cámara |
En el editor de materiales, el menú Library muestra cada función con su descripción: al elegir
una añade el #include (si falta) y la llamada en el cursor. #include "gobu:// también se
autocompleta.

Solo las funciones que llamas acaban en el shader compilado.
Maestros y static switches
Sección titulada «Maestros y static switches»Los materiales de la biblioteca son instancias de unos pocos maestros (M_Surface, M_Toon,
M_Water, M_Glass, M_Foliage…). Un maestro declara switches para las opciones:
shader_type spatial;#pragma switch USE_TRIPLANAR
uniform sampler2D albedo : source_color;
void fragment() {#ifdef USE_TRIPLANAR // ...#else ALBEDO = texture(albedo, UV).rgb;#endif}Una MaterialInstance suya muestra su maestro en Shader, y un grupo Switches con una casilla
por cada uno. Un switch
apagado no cuesta nada: no se compila (a diferencia de un if sobre un uniform). Las instancias
con los mismos switches comparten un programa compilado, y el inspector solo muestra los
parámetros de los switches activos.
