# RenderSettings

Roblox Engine API class from Roblox Studio 0.744.0.7441077 (version-7aaa6838d36c4448).

- Inherits from, nearest first: [Instance](https://rapi.sleaze.dev/classes/Instance.md), [Object](https://rapi.sleaze.dev/classes/Object.md)
- Tags: Not browsable, Not creatable, Not replicated, Service
- Memory category: Instances
- HTML page: https://rapi.sleaze.dev/classes/RenderSettings/
- Roblox documentation: https://create.roblox.com/docs/reference/engine/classes/RenderSettings

A singleton settings class that exposes rendering configuration for graphics quality, framerate management, and debug visualization in Roblox Studio.

## Properties

### MeshCacheSize

```luau
RenderSettings.MeshCacheSize: number
```

- Tags: Plugin security

The size in bytes of the mesh cache.

### AutoFRMLevel

```luau
RenderSettings.AutoFRMLevel: number
```

- Tags: Plugin security

Sets the starting quality level of the framerate manager.

### EnableFRM

```luau
RenderSettings.EnableFRM: boolean
```

- Tags: Hidden, Not replicated, Plugin security, Load only

Toggles the enabled state of the framerate manager.

### MeshPartDetailLevel

```luau
RenderSettings.MeshPartDetailLevel: Enum.MeshPartDetailLevel
```

- Tags: Plugin security

Studio only. Used to visually verify the quality of `MeshParts` at lower level of detail at close range.

### ReloadAssets

```luau
RenderSettings.ReloadAssets: boolean
```

- Tags: Plugin security

Whether Roblox Studio will automatically reload changes that are made to files in Roblox's `content` folder.

### RenderCSGTrianglesDebug

```luau
RenderSettings.RenderCSGTrianglesDebug: boolean
```

- Tags: Plugin security

Whether a wireframe of polygons will be shown on all [`PartOperation`](https://rapi.sleaze.dev/classes/PartOperation.md) objects.

### ShowBoundingBoxes

```luau
RenderSettings.ShowBoundingBoxes: boolean
```

- Tags: Plugin security

Whether bounding boxes are rendered around each individual rendered entity in the scene.

### ViewMode

```luau
RenderSettings.ViewMode: Enum.ViewMode
```

- Tags: Plugin security

Studio only. Selects a debug rendering visualization overlay for the viewport.

### Enable VR Mode

```luau
RenderSettings.Enable VR Mode: boolean
```

- Tags: Plugin security

Toggles whether virtual reality (VR) mode is enabled.

### ExportMergeByMaterial

```luau
RenderSettings.ExportMergeByMaterial: boolean
```

- Tags: Plugin security

Sets whether materials should be generated per part, or per unique appearance in Roblox's exporter.

### FrameRateManager

```luau
RenderSettings.FrameRateManager: Enum.FramerateManagerMode
```

- Tags: Plugin security

Specifies the behavior of the framerate manager.

### GraphicsMode

```luau
RenderSettings.GraphicsMode: Enum.GraphicsMode
```

- Tags: Plugin security

The graphics API that Roblox will use on startup.

### EagerBulkExecution

```luau
RenderSettings.EagerBulkExecution: boolean
```

- Tags: Plugin security

Whether all scene updates will be given an unlimited budget, regardless of how computationally expensive it may be.

### EditQualityLevel

```luau
RenderSettings.EditQualityLevel: Enum.QualityLevel
```

- Tags: Plugin security

Sets the graphics quality level in Roblox Studio.

### QualityLevel

```luau
RenderSettings.QualityLevel: Enum.QualityLevel
```

- Tags: Plugin security

Controls the quality level in Roblox Studio.

## Methods

### GetMaxQualityLevel

```luau
RenderSettings:GetMaxQualityLevel(): number
```

- Tags: Plugin security

Returns the maximum quality level.

Returns: The total number of quality levels available in the rendering system.

## Inherited members

- From [Instance](https://rapi.sleaze.dev/classes/Instance.md): `Archivable`, `archivable`, `Attributes`, `AttributesReplicate`, `AttributesSerialize`, `HistoryId`, `Name`, `Parent`, `PredictionMode`, `PropertyStatusStudio`, `RobloxLocked`, `SerializedOverrides`, `SourceAssetId`, `Tags`, `UniqueId`, `numExpectedDirectChildren`, `DataCost`, `Capabilities`, `DefinesCapabilities`, `IsInSandbox`, `Sandboxed`, `AddTag`, `ClearAllChildren`, `Clone`, `Destroy`, `FindFirstAncestor`, `FindFirstAncestorOfClass`, `FindFirstAncestorWhichIsA`, `FindFirstChild`, `FindFirstChildOfClass`, `FindFirstChildWhichIsA`, `FindFirstDescendant`, `GetActor`, `GetAttribute`, `GetAttributeChangedSignal`, `GetAttributes`, `GetChildren`, `GetDebugId`, `GetDescendants`, `GetFullName`, `GetStyled`, `GetStyledPropertyChangedSignal`, `GetTags`, `HasTag`, `IsAncestorOf`, `IsDescendantOf`, `IsPropertyModified`, `QueryDescendants`, `RemoveTag`, `ResetPropertyToDefault`, `SetAttribute`, `WaitForChild`, `Remove`, `children`, `clone`, `destroy`, `findFirstChild`, `getChildren`, `isDescendantOf`, `remove`, `AncestryChanged`, `AttributeChanged`, `ChildAdded`, `ChildRemoved`, `DescendantAdded`, `DescendantRemoving`, `Destroying`, `StyledPropertiesChanged`, `childAdded`
- From [Object](https://rapi.sleaze.dev/classes/Object.md): `ClassName`, `className`, `GetPropertyChangedSignal`, `IsA`, `isA`, `Changed`
