Skip to content
Skills Library
Programming · Building & coding

engine-settings

/engine-settings

Configure Unreal Engine core settings — rendering, physics, audio, garbage collection, console variables (cvars), and scalability levels (EngineSettingsService). Use when the user asks to change engine/rendering settings, set a console variable (r.*, etc.), adjust scalability/quality levels, or read engine config categories.

Repository
vibeue ↗
Licence
MIT
Last repository change
26.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
2
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 26.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Configure Unreal Engine core settings — rendering, physics, audio, garbage collection, console variables (cvars), and scalability levels (EngineSettingsService). Use when the user asks to change engine/rendering settings, set a console variable (r.*, etc.), adjust scalability/quality levels, or read engine config categories.

Original author description

Configure Unreal Engine core settings — rendering, physics, audio, garbage collection, console variables (cvars), and scalability levels (EngineSettingsService). Use when the user asks to change engine/rendering settings, set a console variable (r.*, etc.), adjust scalability/quality levels, or read engine config categories.

How it works

  1. Critical Rules
  2. Browsing registered settings
  3. Workflows
  4. Data Structures
  5. Sample scripts (run via executepythoncode)
Original SKILL.md headings · 146 lines, 503 words
SKILL.md preview
---
name: engine-settings
display_name: Engine Settings System
description: Configure Unreal Engine core settings — rendering, physics, audio, garbage collection, console variables (cvars), and scalability levels (EngineSettingsService). Use when the user asks to change engine/rendering settings, set a console variable (r.*, etc.), adjust scalability/quality levels, or read engine config categories.
vibeue_classes:
  - EngineSettingsService
unreal_classes:
  - RendererSettings
  - PhysicsSettings
  - AudioSettings
---

# Engine Settings Skill

> 🔀 **Registered settings moved to the engine.** Category-based registered-setting access
> (`list_categories` / `list_settings` / `get_setting` / `set_setting`) is now Unreal 5.8's native
> **`ConfigSettingsToolset`** — reach it with `call_tool` (run `describe_toolset` on
> `ConfigSettingsToolset` for its actions/params). VibeUE's `EngineSettingsService` was trimmed to
> the delta the engine doesn't cover: **console variables (cvars), scalability levels, raw engine
> INI read/write, and config save**. Use those from `execute_python_code` as shown below.

## Critical Rules

### ⚠️ CVars (VibeUE) vs Registered Settings (engine toolset)

- **CVars** (console variables) → `unreal.EngineSettingsService.get_console_variable` /
  `set_console_variable` (kept in VibeUE).
- **Registered settings** (category + key, e.g. RendererSettings) → engine
  **`ConfigSettingsToolset`** via `call_tool`. `EngineSettingsService.get_setting` /
  `set_setting` / `list_categories` / `list_settings` were removed in the 5.8 consolidation.

```python
# CVars (names like r.ReflectionMethod) — VibeUE
value = unreal.EngineSettingsService.get_console_variable("r.ReflectionMethod")
unreal.EngineSettingsService.set_console_variable("r.ReflectionMethod", "1")

# Registered settings (category-based) — use the engine ConfigSettingsToolset via call_tool.
# Raw INI is also still available in VibeUE when you know the section/key:
value = unreal.EngineSettingsService.get_engine_ini_value(
    "/Script/Engine.RendererSettings", "bEnableRayTracing", "Engine.ini")
```

### ⚠️ Check Read-Only Before Setting CVars

```python
info = unreal.ConsoleVariableInfo()
if unreal.EngineSettingsService.get_console_variable_info("r.MaxQualityMode", info):
    if not info.is_read_only:
        unreal.EngineSettingsService.set_console_variable(info.name, "1")
```

### ⚠️ Some Settings Require Restart

`set_console_variable` / `set_engine_ini_value` return an `FEngineSettingResult` whose
`requires_restart` flag tells you whether the change takes effect immediately. (Registered-setting
results come from the engine `ConfigSettingsToolset` instead.)

---

## Browsing registered settings

Listing categories and the settings inside them is now an engine **`ConfigSettingsToolset`** job —
call it via `call_tool` and run `describe_toolset` for the available actions. These engine
categories cover rendering, physics, audio, GC, networking, collision, AI, input, and the rest.

For everything VibeUE still owns, see the cvar / INI / scalability workflows below.

---

## Workflows

### Enable Ray Tracing

```python
import unreal
import json

rt_settings = {
    "r.RayTracing": "1",
    "r.RayTracing.Shadows": "1",
    "r.RayTracing.Reflections": "1",
    "r.ReflectionMethod": "1"
}
result = unreal.EngineSettingsService.set_console_variables_from_json(json.dumps(rt_settings))
unreal.EngineSettingsService.save_all_engine_config()
```

### Optimize for Performance

```python
import unreal
import json

# Set overall scalability to Low (0)
unreal.EngineSettingsService.set_overall_scalability_level(0)

# Disable expensive features
perf_settings = {
    "r.RayTracing": "0",
    "r.VolumetricFog": "0",
    "r.MotionBlurQuality": "0",
    "r.Shadow.MaxResolution": "512"
}
unreal.EngineSettingsService.set_console_variables_from_json(json.dumps(perf_settings))
```

### Search CVars

```python
import unreal

shadows = unreal.EngineSettingsService.search_console_variables("shadow", 100)
for cvar in shadows:
    print(f"{cvar.name}: {cvar.value} ({cvar.type})")
```

### Set Engine INI Values

```python
import unreal

result = unreal.EngineSettingsService.set_engine_ini_value(
    "/Script/EngineSettings.GameMapsSettings",
    "GameDefaultMap",
    "/Game/Maps/Lvl_Main.Lvl_Main",
    "DefaultEngine.ini"
)
```

---

## Data Structures

> **Python Naming Convention**: C++ types like `FEngineSettingResult` are exposed as `EngineSettingResult` in Python (no `F` prefix).

### EngineSettingResult (returned by set_* and INI write methods)
- `success`, `error_message`
- `modified_settings`, `failed_settings`
- `requires_restart`

### ConsoleVariableInfo
- `name`, `value`, `default_value`, `description`
- `type`, `flags`, `is_read_only`

VibeUE `EngineSettingsService` covers:
- **Rendering optimization**: Adjust r.* cvars, ray tracing, shadows
- **Performance profiling**: GC cvars (gc.*), streaming, scalability
- **Quality presets**: Apply overall or per-group scalability levels
- **Raw engine INI**: read/write sections directly when you know the key

For browsing/editing *registered* settings by category (physics, audio, collision, AI, input
classes, etc.), use the engine **`ConfigSettingsToolset`** via `call_tool`.

## Sample scripts (run via `execute_python_code`)

- **`scripts/set_cvars.txt`** — read scalability and set a console variable.
Files in this package (2)
  • SKILL.md 5 KB
  • scripts/set_cvars.txt 1 KB

Versions

The database has no other skills named engine-settings.

Database snapshot: 13.11.2026 · package version a7bffd6aca75 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 90unreal-project-audit
    Use when the task is to inspect Unreal project structure, plugins, assets, and build settings.
  • 100unreal
    Use this skill when the user says 'unreal', 'unreal engine 5', 'UE5', 'blueprint', 'UObject', 'gameplay ability system', 'nanite', 'lumen', 'unreal replication'. Guides Unreal Engine 5 projects: UObject/Actor framework, C++ vs Blueprint, rendering (Nanite/Lumen), Chaos physics,…
  • 100scenario-unreal-expert
    Use when an agent drives Unreal Engine 5.8 on a Mac for any task: Editor Python (the unreal module), headless UnrealEditor-Cmd -run=pythonscript jobs, Epic's Unreal MCP server, the Remote Control API, console commands and cvars; when a script breaks on 5.8 (EditorLevelLibrary,…
  • 100project-settings
    Configure Unreal Engine project settings and editor preferences — UI appearance, toolbar icons, scale, colors, and any UDeveloperSettings subclass (ProjectSettingsService). Use when the user asks to change a project setting or editor preference, configure a UDeveloperSettings…
  • 100unreal
    SpacetimeDB Unreal Engine client SDK reference. Use when building Unreal Engine clients that connect to SpacetimeDB.
  • 95game-development
    Game development with Unity, Unreal Engine, and Godot. Use when building games, implementing game mechanics, physics, AI, or working with game engines.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.