landscape-auto-material

name	landscape-auto-material
display_name	Landscape Auto-Material System
description	Create production-quality landscape materials with the master-material + material-function + material-instance paradigm, RVT, and auto-layering. Use when the user asks for an auto/procedural landscape material, slope/altitude/distance-based layer blending, Runtime Virtual Textures, biome configuration via instances, or layer material functions. For basic layer-blend materials load landscape-materials.
vibeue_classes	["MaterialService","MaterialNodeService","LandscapeMaterialService","RuntimeVirtualTextureService"]
unreal_classes	["MaterialExpressionMaterialFunctionCall","MaterialExpressionRuntimeVirtualTextureOutput","MaterialExpressionRuntimeVirtualTextureSample","RuntimeVirtualTexture","RuntimeVirtualTextureVolume","MaterialFunction","MaterialInstanceConstant","LandscapeLayerInfoObject","MaterialExpressionFunctionInput","MaterialExpressionFunctionOutput"]
keywords	["auto material","auto layer","master material","material function","material instance","runtime virtual texture","RVT","altitude blend","slope blend","distance blend","biome","landscape material","layer function","production landscape workflow","parametric material","function input","function output","bulk parameters"]

Landscape Auto-Material System Skill

When to Use This Skill

Use this skill when you need production-quality landscape materials with:

• A master material → material instance workflow (artists change parameters, not graphs)
• Automatic layer blending by slope, altitude, or distance
• Material functions for reusable logic (layer sampling, color correction, etc.)
• Runtime Virtual Textures for scalable landscape rendering
• Biome configuration through material instances (swap textures/thresholds, same master)

For simple prototyping with 2-5 painted layers, load the landscape-materials skill instead (the engine's AgentSkillToolset GetSkills exposes it).

Architecture Overview

The Master Material Paradigm

Master Material (M_Landscape_Master)
 ├── Material Functions (reusable logic blocks)
 │   ├── MF_AutoLayer     ── auto-selects layers by altitude/slope
 │   ├── MF_Slope_Blend   ── slope mask (0=flat, 1=steep)
 │   ├── MF_Altitude_Blend ── height mask (0=below, 1=above)
 │   ├── MF_Layer_Grass    ── per-layer texture sampling
 │   ├── MF_Layer_Rock     ── per-layer texture sampling
 │   ├── MF_RVT            ── Runtime Virtual Texture output
 │   └── MF_Distance_Blend ── LOD transitions
 ├── Exposed Parameters (50+ scalar/vector/texture/switch)
 └── Material Outputs (BaseColor, Normal, Roughness, WPO, RVT)

Material Instance (MI_Landscape_Biome_01)
 ├── Inherits master material graph
 ├── Overrides parameters only (no graph editing)
 └── Different biomes = different instances of same master

Why this is better than manual graph building:

• Reusability: Material functions used across multiple masters
• Artist-friendly: Biome artists edit parameters in instances, never touch the graph
• Performance: Compiled once in master, instances are cheap
• Maintainability: Fix a function → all materials using it update

Critical Rules

🚨 Inspect Before Modifying Existing Materials or Functions

Before modifying an existing master material or material function, MUST export and review its current state:

import unreal, json

# For materials:
graph = json.loads(unreal.MaterialNodeService.export_material_graph("/Game/Materials/M_Landscape_Master"))
print()
 expr  graph[]:
    name = expr.get()  expr.get()  expr.get()
    ()


func_info = unreal.MaterialNodeService.get_function_info()
func_graph = json.loads(unreal.MaterialNodeService.export_function_graph())