Skip to content

Add Custom Terrain Materials documentation page - #1572

Open
julia-rbx wants to merge 1 commit into
mainfrom
docs-agents/add-custom-terrain-materials
Open

julia-rbx wants to merge 1 commit into
mainfrom
docs-agents/add-custom-terrain-materials

Conversation

@julia-rbx

Copy link
Copy Markdown
Contributor

Summary

  • Adds a new content/en-us/parts/terrain-materials.md page covering the 62-slot Expanded Terrain system
  • Content focuses exclusively on topics not already documented: enabling ExpandedTerrain, programmatic Terrain API (SetMaterialSlot, GetMaterialSlot, ResetMaterialSlot, WriteVoxelChannels), performance improvements, known issues, and terrain roadmap
  • Cross-links to parts/materials.md for Material Manager and MaterialVariant workflows instead of duplicating that content
  • Adds navigation entry in content/common/navigation/engine/guides.yaml under the existing Terrain entry
  • Adds a cross-link from the "Terrain materials" section of parts/terrain.md to the new page

Overlap analysis

Verified by grep that none of the new API methods (SetMaterialSlot, GetMaterialSlot, ResetMaterialSlot, WriteVoxelChannels) or the ExpandedTerrain property appear on any existing page. Sections covering Material Manager, MaterialVariant creation, and Material Generator are intentionally omitted (cross-linked only) since they are already well-documented in parts/materials.md.

Test plan

  • Verify the new page renders correctly in the docs site
  • Confirm navigation entry appears under Parts > Terrain
  • Confirm cross-links from terrain.md and within the new page resolve correctly
  • Review code sample for accuracy against the current Terrain API

New page covering the 62-slot Expanded Terrain system with content
not duplicated elsewhere: enabling ExpandedTerrain, programmatic
Terrain API (SetMaterialSlot, GetMaterialSlot, ResetMaterialSlot,
WriteVoxelChannels), performance improvements, known issues, and
roadmap. Cross-links to existing materials.md for Material Manager
and MaterialVariant workflows.
@julia-rbx
julia-rbx requested a review from a team as a code owner September 30, 2026 04:08
@github-actions github-actions Bot added engine guides Changes the Engine guides navigation Changes the navigation labels Sep 30, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

engine guides Changes the Engine guides navigation Changes the navigation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant