RLS Studios
ProjectsPatreonCommunityDocsAbout
Join Patreon
BeamNG Modding Docs

Guides

Reference

Server CommandsGE UtilitiesGame Engine MainNavigation GraphScreenshot CaptureServerServer ConnectionSpawnpoint ManagerSimulation TimeVehicle SpawningSuspension Frequency Tester
Editor AI TestsEditor AI VisualizationEditor – Assembly Spline ToolAsset BrowserAsset DeduplicatorAsset Management ToolSFX Previewer (Audio Events List)Audio Ribbon EditorAutoSaveBarriers EditorBiome ToolBuilding EditorBulk RenameCamera BookmarksCamera TransformCamera Path EditorCEF HelperCo-Simulation Signal EditorCrawl Data EditorCreate Object ToolDataBlock EditorDecal EditorDecal Spline EditorDocumentation HelperDrag Race EditorDrift Data EditorDrive Path EditorDynamic Decals Tool (Vehicle Livery Creator)Engine Audio DebugExtensions DebugExtensions EditorFFI Pointer Leak TestFile DialogFlowgraph EditorForest EditorForest ViewEditor Gizmo HelperEditor Ground Model Debug HelperEditor Headless Editor TestEditor Icon OverviewEditor ImGui C DemoEditor InspectorEditor Layout ManagerEditor Level SettingsEditor Level ValidatorEditor LoggerEditor Log HelperEditor MainEditor Main MenuEditor Main ToolbarEditor Main UpdateMap Sensor EditorMaster Spline EditorMaterial EditorMeasures Inspector HeaderMesh Editor (Base)Mesh Road EditorMesh Spline EditorMission EditorMission PlaybookMission Start Position EditorMulti Spawn Manager (Vehicle Groups)Navigation Mesh EditorEditor News MessageObject Tool (Object Select Edit Mode)Object To Spline EditorParticle EditorPerformance Profiler / Camera RecorderPhysics ReloaderPrefab Instance EditorEditor PreferencesRace / Path EditorRally EditorRaycast Test Editor ToolRenderer Components Editor ToolRender Test Editor ToolResource Checker Editor ToolRiver EditorRoad Architect EditorRoad DecorationsRoad Editor (Decal Road)Road Network ExporterRoad River Cache HandlerRoad River GUIRoad Spline EditorRoad Template EditorRoad UtilitiesScene TreeScene ViewScreenshot Creator BootstrapScript AI EditorScript AI ManagerSensor Configuration EditorSensor DebuggerShape EditorShortcut LegendSidewalk Spline EditorSites EditorSlot Traffic EditorSuspension Audio DebugTech Server ManagerTerraform ToolTerrain And Road ImporterTerrain EditorTerrain Materials EditorText EditorTool ManagerTool ShortcutsTraffic DebugTraffic ManagerTraffic Signals EditorUndo History ViewerVehicle Bridge TestVehicle Detail ViewerVehicle Editor MainEditor - VisualizationEditor Viz HelperEditor Water Object HelperEditor Windows Manager
Tool Utilities - Fit PolylineEditor Tool Utilities – GeometryEditor Tool Utilities – GizmoEditor Tool Utilities – Material Selection ManagerEditor Tool Utilities – Mesh Audition ManagerEditor Tool Utilities – Perlin NoiseEditor Tool Utilities – Polygon DrawingEditor Tool Utilities – Ramer-Douglas-PeuckerEditor RenderingEditor Tool Utilities – Ribbon InputEditor Tool Utilities – Riverbed TerraformingEditor Tool Utilities – Road Design StandardsEditor Tool Utilities – Simplex NoiseEditor Tool Utilities – Skeleton (Image Vectorisation)Editor Tool Utilities – Spline InputEditor Tool Utilities – Spline Mask ExportEditor Tool Utilities – StyleEditor Tool Utilities – Terrain PainterEditor Tool Utilities – Util

UI

Resources

BeamNG Game Engine Lua Cheat SheetGE Developer RecipesMCP Server Setup

// RLS.STUDIOS=true

Premium Mods for BeamNG.drive. Career systems, custom vehicles, and immersive gameplay experiences.

Index

HomeProjectsPatreon

Socials

DiscordPatreon (RLS)Patreon (Vehicles)

© 2026 RLS Studios. All rights reserved.

Modding since 2024

API ReferenceGE ExtensionseditortoolUtilities

Editor Tool Utilities – Material Selection Manager

Utility for selecting materials with image thumbnails and a search bar. Used across road/decal tools to pick terrain or decal materials.

Utility for selecting materials with image thumbnails and a search bar. Used across road/decal tools to pick terrain or decal materials.

Public API

FunctionSignatureDescription
M.getTexObj`(absPath) → texturefalse
M.registerWindow()Registers the material selection editor window
M.openWindow()Shows the material selection window
M.closeWindow()Hides the material selection window
M.handleMaterialSelectionSubWindow(isDecal, onSelectMaterialFunct)Renders the material selector UI with search filter, image previews, and click callback

Code Examples

local matMgr = require('editor/toolUtilities/materialSelectionMgr')

-- Register and open the material selection window
matMgr.registerWindow()
matMgr.openWindow()

-- Render the material selection sub-window each frame
-- isDecal=false filters for 'RoadAndPath' tagged materials
-- isDecal=true  filters for 'decal' tagged materials
matMgr.handleMaterialSelectionSubWindow(false, function(materialName)
  log('I', 'matMgr', 'Selected material: ' .. materialName)
  mySpline.material = materialName
  matMgr.closeWindow()
end)

-- Get a texture object for preview rendering
local tex = matMgr.getTexObj('/art/terrains/grass_diffuse.dds')
if tex and tex.texId then
  im.Image(tex.texId, im.ImVec2(64, 64))
end

See Also

  • Tool Utilities - Fit Polyline - Related reference
  • Editor Tool Utilities – Geometry - Related reference
  • Editor Tool Utilities – Gizmo - Related reference
  • World Editor Guide - Guide

Editor Tool Utilities – Gizmo

Utility module for managing the editor axis gizmo (translate/rotate) for spline-editing tools. Handles drag callbacks, undo/redo integration, and local/world alignment switching.

Editor Tool Utilities – Mesh Audition Manager

Utility for previewing and selecting static meshes (DAE files) with a rotating 3D camera audition view and a searchable list window.

On this page

Public APICode ExamplesSee Also