Skip to content

Aurum settings

The settings are reached from a settings menu of entries, each of which opens a page of its own.

Open Settings opens the settings menu (AFMSettingsMenuScreen): the Menu Config’s Settings Menu Entries, drawn like the main menu. An entry with the Open Settings Page action opens one page (AFMSettingsScreen): a kicker in small capitals, its title, and the settings of its Settings Categories in one list on a stone plate, with the focused setting described on a parchment panel beside it. Behind a page the scene steps back, blurred and dimmed (theme: Page Blur, Page Dim).

The default pages are General (Gameplay and Accessibility), Video (Video and Graphics), Audio, Controls and Controller Layout.

The Video settings page: a kicker reading SETTINGS over the title VIDEO, a stone plate listing window mode, monitor, resolution, vertical sync, frame rate limit, render resolution and brightness under a Display heading, and a parchment panel on the right describing Window Mode.

A settings page. The parchment panel beside the list describes the focused setting.

  • Sliders are gold rules with tick marks and a diamond knob, option rows show < Value >, and the focused row warms under a gold rule.
  • Left and Right change values, Y resets the page to its defaults, Start (or the Apply hint) applies, and Back leaves. Leaving with changes that were not applied asks: Apply, Discard or Cancel.
  • With the mouse, the footer hints are buttons: Back, Reset to Defaults and Apply. Sliders can be clicked and dragged.
  • Open Settings Tabs on the menu subsystem shows every category on one screen with a tab each (Q and E, LB and RB), for games that prefer one tabbed screen. Menu Config > Settings Tabs sets its tabs, their names and visibility.
  • Open Settings Page (Title, Categories) on the menu subsystem opens a page from your own code.

Video settings go through UGameUserSettings. Everything else is stored in AFMUserSettings. Both are saved to GameUserSettings.ini and restored on the next launch.

Category Setting Id Values (default)
Video Window Mode WindowMode Fullscreen, Windowed Fullscreen, Windowed (Windowed Fullscreen)
Video Monitor Monitor One entry per monitor, “Monitor 2 - 2560 x 1440” (the primary monitor). Shown only when there is more than one
Video Resolution Resolution Supported resolutions. Shows the desktop resolution, locked, in Windowed Fullscreen
Video Vertical Sync VSync Off / On (Off)
Video Frame Rate Limit FrameRateLimit 30, 60, 90, 120, 144, 165, 240, Unlimited (Unlimited)
Video Render Resolution ResolutionScale Auto, 50% to Native (Auto)
Video Brightness Brightness 0 to 100% (50%)
Graphics Quality Preset QualityPreset Low, Medium, High, Epic, Cinematic (Epic). Shows Custom when the groups differ
Graphics Auto-Detect Settings AutoDetect Runs the engine hardware benchmark and applies the result, after asking
Graphics View Distance, Anti-Aliasing Quality, Shadows, Global Illumination, Reflections, Post Processing, Textures, Effects, Foliage, Shading ViewDistance, AntiAliasingQuality, Shadows, GlobalIllumination, Reflections, PostProcessing, Textures, Effects, Foliage, Shading Low to Cinematic (Epic)
Graphics Anti-Aliasing Method AntiAliasingMethod Off, FXAA, TAA, TSR (TSR)
Graphics Motion Blur MotionBlur Off / On (On)
Audio Master Volume MasterVolume 0 to 100% (100%)
Audio Music, Sound Effects, Dialogue, Interface MusicVolume, EffectsVolume, VoiceVolume, InterfaceVolume 0 to 100% (Music 80%, others 100%)
Audio Audio Preset AudioPreset Headphones, TV Speakers, Home Theater, Night Mode (TV Speakers)
Audio Mute in Background MuteWhenUnfocused Off / On (Off)
Controls Mouse Sensitivity MouseSensitivity 0.1 to 5.0 (1.0)
Controls Invert Mouse Y InvertMouseY Off / On (Off)
Controls Stick Sensitivity GamepadSensitivity 0.1 to 5.0 (1.0)
Controls Invert Stick Y InvertGamepadY Off / On (Off)
Controls Vibration Vibration Off / On (On)
Controls Key Bindings, Gamepad Bindings KeyBindings, GamepadBindings The rebinding sections. See Key rebinding and input
Controls Reset Key Bindings ResetKeyBindings Restores every binding to its default, after asking
Gameplay Field of View FieldOfView 60 to 120 degrees (90)
Gameplay Camera Shake CameraShake 0 to 100% (100%)
Gameplay Difficulty Difficulty The Menu Config’s Difficulties (Default Difficulty: Adventurer)
Gameplay Language Language Shown when two or more languages are available
Accessibility Subtitles Subtitles Off / On (On)
Accessibility Subtitle Size SubtitleSize Small, Medium, Large, Extra Large (Medium)
Accessibility Subtitle Background SubtitleBackground 0 to 100% (50%): the dark box behind subtitles
Accessibility Colour Blind Mode ColorBlindMode Off, Protanopia, Deuteranopia, Tritanopia (Off)
Accessibility Colour Correction Strength ColorBlindStrength 0 to 100% (100%)
Accessibility Interface Scale UIScale 75% to 150% (100%)
Accessibility HUD Opacity HudOpacity 20% to 100% (100%)
Accessibility HUD Safe Zone SafeZone 0 to 10% (0%): draws the HUD further in from the edges, for televisions that crop the picture
Accessibility Reduce Effects ReduceEffects Off / On (Off): turns off inked-in titles, page turns, flickering light and unrolling banners, and keeps fewer embers
Accessibility Held Interactions InteractMode Hold, Toggle (Hold)

Run AFM.ListSettings in the console to print every Id.

  • Window mode, monitor, resolution, vertical sync, frame rate limit, render resolution and the quality settings take effect with Apply. Everything else takes effect as the player changes it, so it can be tried out, and is saved with Apply.
  • Changing the monitor, the resolution or the window mode asks “Keep display settings?” and reverts by itself after 15 seconds.
  • The Video page always shows the window the game really has, also when it was started with -windowed, -ResX or -ResY, or switched with Alt+Enter.
  • Reset to Defaults (gamepad Y) resets every setting on the current page or tab, after a confirmation. The Language setting is saved as soon as it changes and is never reset.
  • Add Ids to Menu Config > Hidden Settings to remove built-in settings. KeyBindings and GamepadBindings hide the rebinding sections.
  • Choose what each settings page shows with its entry’s Settings Categories.
  • Add entries to Menu Config > Custom Settings: a Toggle, a list of Options or a Slider (Min, Max, Step Size, Format), in any category and Section, with a Default Value. They are saved with the other settings. Read them with Get Custom Setting Value or Get Custom Setting Bool, and set them from code with Set Custom Setting Value.

Get the Assetpro Settings Subsystem (Get Assetpro Settings Subsystem in Blueprint):

Function Returns
Get Mouse Sensitivity, Get Gamepad Sensitivity Sensitivity multiplier
Is Mouse Y Inverted, Is Gamepad Y Inverted Invert Y
Get Field Of View Degrees
Get Camera Shake Scale 0 to 1, multiply your camera shake scale by it
Get Difficulty, Set Difficulty An index into the Menu Config’s Difficulties (0 = Story to 3 = Legend by default)
Is Interact Toggle The Held Interactions setting: true for Toggle
Get Safe Zone The HUD Safe Zone, as a share of the screen (0 to 0.1)
Are Subtitles Enabled, Get Subtitle Scale, Get Subtitle Background Opacity The subtitle settings. The plugin’s subtitles follow them for you
Get Hud Opacity 0 to 1. The plugin’s HUD follows it for you
Are Effects Reduced Reduce Effects on or off: turn off your own flashing effects too
Get Volume The volume of a channel (Master, Music, Effects, Voice, Interface)
Get Custom Setting Value, Get Custom Setting Bool A custom setting

Listen to On Setting Changed, with the setting Id, or On Settings Applied to react to changes.

Window mode, monitor, resolution, vertical sync, frame rate limit, render resolution, scalability, anti-aliasing method, motion blur, brightness, volumes and the audio preset (through a sound mix on the Menu Config’s sound classes; Master volume always works), Mute in Background, subtitles and their size and background, colour blind correction, interface scale, HUD opacity and safe zone, Reduce Effects, vibration, and the Field of View on the player’s own view, with or without a Camera Component. Turn off Menu Config > Apply Field Of View To Camera if your game applies it itself.

For look sensitivity and invert Y, add the Assetpro Look Settings modifier to your Look action mappings (Device: Mouse or Gamepad).

Camera Shake, Difficulty and Held Interactions are stored for your game code to read.