RLS Studios
ProjectsPatreonCommunityDocsAbout
Join Patreon
BeamNG Modding Docs

Guides

Reference

Server CommandsGE UtilitiesGame Engine MainNavigation GraphScreenshot CaptureServerServer ConnectionSpawnpoint ManagerSimulation TimeVehicle SpawningSuspension Frequency Tester
Client CanvasCaustics PostFXChromatic Lens PostFXClient CoreDepth of Field PostFXEdge AA PostFXPostFx Flash EffectPostFx Fog EffectsPostFx FXAA Anti-AliasingGamma PostFXPostFx Glow EffectShadow Maps InitClient LightingPostFx Light Ray EffectAdvanced Lighting - Light VisualizationPostFx Masked Screen BlurMotion Blur PostFXObjects Required for StartupClient Parse ArgsClient PostFX ManagerRender ManagerAdvanced Lighting - ShadersBasic Lighting - Shadow FilterAdvanced Lighting - Shadow VisualizationPostFx SMAA Anti-AliasingPostFx SSAO (Screen-Space Ambient Occlusion)PostFx Turbulence EffectPostFx Utilities

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 ExtensionsClient

PostFx Utilities

Utility module for loading and saving post-processing effect preset files via file dialogs.

Utility module for loading and saving post-processing effect preset files via file dialogs.


Overview

Returns a standard M module with two functions for managing .postfx preset files. Uses editor_fileDialog for native file browser integration and delegates to postFxModule for actual preset serialization.


Public API

FunctionArgsReturnsDescription
M.loadPresets--Opens file dialog to select and load a .postfx preset file
M.savePresets--Opens file dialog to save current post effect settings as .postfx

Usage Example

-- Load a preset file via dialog
local utils = require("client/postFx/utils")
utils.loadPresets()

-- Save current settings
utils.savePresets()

Internal Flow

-- Load flow:
-- 1. editor_fileDialog.openFile() → user picks file
-- 2. Callback receives {filepath, path}
-- 3. postFxModule.loadPresetFile(filepath)

-- Save flow:
-- 1. editor_fileDialog.saveFile() → user picks destination
-- 2. Callback receives {filepath, path}
-- 3. postFxModule.savePresetFile(filepath)

State

VariableTypeDescription
lastUsedFolderstringRemembers last directory for file dialogs (starts as "/")

Dependencies

  • editor_fileDialog - Native file open/save dialogs
  • postFxModule - PostEffect preset serialization (load/save .postfx files)

Notes

  • File filter is {"Post Effect Settings", ".postfx"}
  • The last-used folder persists within the session but not across restarts
  • Both functions log at info level with tag 'postfx'

See Also

  • PostFx SSAO - SSAO settings (saveable via presets)
  • PostFx Light Ray - Light ray settings (saveable via presets)

PostFx Turbulence Effect

Screen-space turbulence distortion post-processing effect. Applies a heat-haze or ripple distortion to the back buffer.

Activity Manager

Simple activity launcher. Maps activity names to startup functions. Currently only supports `ContinueFreeroam`.

On this page

OverviewPublic APIUsage ExampleInternal FlowStateDependenciesNotesSee Also