Skip to content

Dodaios is an open-source agent OS for your desktop: it runs your coding agents, browser and apps by voice or chat, on your own machine. Formerly Personal Jarvis.

claude/game settings (#950)

Ruben Lütke4b25d14d276d
diff --git a/docs/game-settings.md b/docs/game-settings.md
new file mode 100644
index 0000000000..f6fa1b02e9
--- /dev/null
+++ b/docs/game-settings.md
@@ -0,0 +1,54 @@
+# Game settings
+
+Settings → **Game settings** keeps a player's own settings for each game in
+one place: mouse sensitivity, keybinds, audio, video and gameplay. A converter
+carries a hip-fire sensitivity from one game to every other game at the same
+cm/360.
+
+## Games
+
+Fortnite, Call of Duty (Black Ops 6 / Warzone), Rainbow Six Siege X, Valorant,
+Counter-Strike 2, Apex Legends, Overwatch 2, Battlefield 6, PUBG, Marvel
+Rivals, The Finals, Escape from Tarkov, Destiny 2, ARC Raiders and Rocket
+League.
+
+The settings of each game live in `dodaios/games/catalog.json`: setting names
+as the game prints them, ranges, defaults where they could be verified (`null`
+otherwise), the default PC keybinds, where the game keeps its own config file,
+and the mouse **yaw** used for conversion. Adding a game is one entry there;
+the page needs no change.
+
+Each setting has a `type`: `slider` (min/max), `number`, `select` (options),
+`toggle` or `text`.
+
+## Sensitivity
+
+`yaw` is the number of degrees the camera turns per mouse count at
+sensitivity 1, in the game's own units:
+
+```
+cm/360 = 360 * 2.54 / (dpi * sens * yaw)
+sens_b = sens_a * yaw_a * dpi_a / (yaw_b * dpi_b)
+```
+
+Games whose sensitivity is not linear (Battlefield 6, PUBG, ARC Raiders,
+Rocket League) have `yaw: null` and are left out of the converter. Only
+hip-fire converts; scoped and ADS multipliers depend on each game's field of
+view.
+
+## Storage and API
+
+Profiles are saved in `<data dir>/games/profiles.json` (`dodaios/games/store.py`),
+checked against the catalog before they are written.
+
+| Method | Path | Does |
+|--------|------|------|
+| GET | `/api/games` | games, which have a profile, default DPI |
+| GET | `/api/games/{id}` | one game's definition and profile |
+| PUT | `/api/games/{id}/profile` | merge `values`, `keybinds`, `dpi` (`reset_dpi`), `notes`; `null` resets a field |
+| DELETE | `/api/games/{id}/profile` | forget the profile |
+| PUT | `/api/games/dpi` | default mouse DPI |
+| POST | `/api/games/convert` | `{game_id, sens, dpi?, to_dpi?}` → the same cm/360 in every linear game |
+
+The app does not write into the games' own config files; the page shows
+where each game keeps them.
diff --git a/dodaios/games/__init__.py b/dodaios/games/__init__.py
new file mode 100644
index 0000000000..8edb14a8a0
--- /dev/null
+++ b/dodaios/games/__init__.py
@@ -0,0 +1,6 @@
+"""Game settings: per-game profiles (sensitivity, keybinds, audio, video,
+gameplay) and a mouse-sensitivity converter between games (docs/game-settings.md).
+
+``catalog`` ships the researched settings of each game, ``store`` keeps the
+user's own values, ``sensitivity`` does the cm/360 maths.
+"""
diff --git a/dodaios/games/catalog.json b/dodaios/games/catalog.json
new file mode 100644
index 0000000000..154f371889
--- /dev/null
+++ b/dodaios/games/catalog.json
@@ -0,0 +1,5361 @@
+{
+ "version": 1,
+ "researched": "2026-10-27",
+ "formula": "cm_per_360 = 360 * 2.54 / (dpi * sens * yaw)",
+ "games": [
+ {
+ "id": "fortnite",
+ "name": "Fortnite",
+ "publisher": "Epic Games",
+ "yaw": 0.005555,
+ "yaw_note": "Degrees per count per 1% of 'Mouse Sensitivity X' (percent scale, e.g. 6.4% = legacy 0.064). Y axis is separate; Targeting/Scope are % multipliers of X/Y.",
+ "sens_key": "mouse_sens_x",
+ "config_file": "%LOCALAPPDATA%\\FortniteGame\\Saved\\Config\\WindowsClient\\GameUserSettings.ini (UE INI; graphics). Sens/keybinds also cloud-synced to the Epic account (ClientSettings.Sav).",
+ "sources": [
+ "https://senslab.pro/sensitivity",
+ "https://csdb.gg/sensitivity-converter/",
+ "https://www.mouse-sensitivity.com/n/fortnite/"
+ ],
+ "sections": [
+ {
+ "id": "mouse",
+ "settings": [
+ {
+ "key": "mouse_sens_x",
+ "label": "Mouse Sensitivity X",
+ "type": "slider",
+ "min": 0,
+ "max": 100,
+ "step": 0.1,
+ "default": null,
+ "note": "Percent value; typical competitive 5-10%"
+ },
+ {
+ "key": "mouse_sens_y",
+ "label": "Mouse Sensitivity Y",
+ "type": "slider",
+ "min": 0,
+ "max": 100,
+ "step": 0.1,
+ "default": null,
+ "note": "Usually equal to X"
+ },
+ {
+ "key": "targeting_sens",
+ "label": "Targeting Sensitivity",
+ "type": "slider",
+ "min": 0,
+ "max": 100,
+ "step": 0.1,
+ "default": null,
+ "note": "% multiplier while aiming down sights"
+ },
+ {
+ "key": "scope_sens",
+ "label": "Scope Sensitivity",
+ "type": "slider",
+ "min": 0,
+ "max": 100,
+ "step": 0.1,
+ "default": null,
+ "note": "% multiplier while scoped"
+ },
+ {
+ "key": "building_sens",
+ "label": "Building Mode Sensitivity Multiplier",
+ "type": "slider",
+ "min": 0,
+ "max": 100,
+ "step": 0.1,
+ "default": null,
+ "note": "Shown when advanced/multiplier options are enabled"
+ },
+ {
+ "key": "edit_sens",
+ "label": "Edit Mode Sensitivity Multiplier",
+ "type": "slider",
+ "min": 0,
+ "max": 100,
+ "step": 0.1,
+ "default": null,
+ "note": "Shown when advanced/multiplier options are enabled"
+ }
+ ]
+ },
+ {
+ "id": "audio",
+ "settings": [
+ {
+ "key": "main_volume",
+ "label": "Main Volume",
+ "type": "slider",
+ "min": 0,
+ "max": 100,
+ "default": null
+ },
+ {
+ "key": "music_volume",
+ "label": "Music Volume",
+ "type": "slider",
+ "min": 0,
+ "max": 100,
+ "default": null
+ },
+ {
+ "key": "sfx_volume",
+ "label": "Sound Effects Volume",
+ "type": "slider",
+ "min": 0,
+ "max": 100,
+ "default": null
+ },
+ {
+ "key": "dialogue_volume",
+ "label": "Dialogue Volume",
+ "type": "slider",
+ "min": 0,
+ "max": 100,
+ "default": null
+ },
+ {
+ "key": "voice_chat_volume",
+ "label": "Voice Chat Volume",
+ "type": "slider",
+ "min": 0,
+ "max": 100,
+ "default": null
+ },
+ {
+ "key": "visualize_sfx",
+ "label": "Visualize Sound Effects",
+ "type": "toggle",
+ "default": false
+ }
+ ]
+ },
+ {
+ "id": "video",
+ "settings": [
+ {
+ "key": "window_mode",
+ "label": "Window Mode",
+ "options": [
+ "Fullscreen",
+ "Windowed Fullscreen",
+ "Windowed"
+ ],
+ "type": "select",
+ "default": null
+ },
+ {
+ "key": "resolution",
+ "label": "Resolution",
+ "type": "text",
+ "default": null
+ },
+ {
+ "key": "frame_rate_limit",
+ "label": "Frame Rate Limit",
+ "options": [
+ "30",
+ "60",
+ "120",
+ "144",
+ "165",
+ "240",
+ "Unlimited"
+ ],
+ "type": "select",
+ "default": null
+ },
+ {
+ "key": "rendering_mode",
+ "label": "Rendering Mode",
+ "options": [
+ "DirectX 11",
+ "DirectX 12",
+ "Performance"
+ ],
+ "type": "select",
+ "default": null
+ },
+ {
+ "key": "quality_presets",
+ "label": "Quality Presets",
+ "options": [
+ "Low",
+ "Medium",
+ "High",
+ "Epic",
+ "Auto"
+ ],
+ "type": "select",
+ "default": null
+ },
+ {
+ "key": "resolution_3d",
+ "label": "3D Resolution",
+ "type": "slider",
+ "min": 25,
+ "max": 100,
+ "default": 100
+ },
+ {
+ "key": "view_distance",
+ "label": "View Distance",
+ "options": [
+ "Near",
+ "Medium",
+ "Far",
+ "Epic"
+ ],
+ "type": "select",
+ "default": null
+ },
+ {
+ "key": "aa_super_res",
+ "label": "Anti-Aliasing & Super Resolution",
+ "options": [
+ "Off",
+ "FXAA",
+ "TAA",
+ "TSR",
+ "NVIDIA DLSS",
+ "AMD FSR",
+ "Intel XeSS"
+ ],
+ "type": "select",
+ "default": null
+ },
+ {
+ "key": "nvidia_reflex",
+ "label": "NVIDIA Reflex Low Latency",
+ "options": [
+ "Off",
+ "On",
+ "On + Boost"
+ ],
+ "type": "select",
+ "default": null
+ },
+ {
+ "key": "vsync",
+ "label": "Vsync",
+ "type": "toggle",
+ "default": false
+ },
+ {
+ "key": "motion_blur",
+ "label": "Motion Blur",
+ "type": "toggle",
+ "default": null
+ }
+ ]
+ },
+ {
+ "id": "gameplay",
+ "settings": [
+ {
+ "key": "toggle_sprint",
+ "label": "Toggle Sprint",
+ "type": "toggle",
+ "default": null
+ },
+ {
+ "key": "sprint_by_default",
+ "label": "Sprint by Default",
+ "type": "toggle",
+ "default": null
+ },
+ {
+ "key": "turbo_building",
+ "label": "Turbo Building",
+ "type": "toggle",
+ "default": true
+ },
+ {
+ "key": "auto_pickup_weapons",
+ "label": "Auto Pick Up Weapons",
+ "type": "toggle",
+ "default": null
+ },
+ {
+ "key": "reset_building_choice",
+ "label": "Reset Building Choice",
+ "type": "toggle",
+ "default": null
+ },
+ {
+ "key": "mark_danger_targeting",
+ "label": "Mark Danger When Targeting",
+ "type": "toggle",
+ "default": null
+ }
+ ]
+ }
+ ],
+ "keybinds": [
+ {
+ "id": "move_forward",
+ "action": "Move Forward",
+ "default": "W"
+ },
+ {
+ "id": "move_back",
+ "action": "Move Back",
+ "default": "S"
+ },
+ {
+ "id": "move_left",
+ "action": "Move Left",
+ "default": "A"
+ },
+ {
+ "id": "move_right",
+ "action": "Move Right",
+ "default": "D"
+ },
+ {
+ "id": "jump",
+ "action": "Jump",
+ "default": "Space"
+ },
+ {
+ "id": "crouch",
+ "action": "Crouch",
+ "default": "Left Ctrl"
+ },
+ {
+ "id": "sprint",
+ "action": "Sprint",
+ "default": "Left Shift"
+ },
+ {
+ "id": "reload_rotate",
+ "action": "Reload / Rotate",
+ "default": "R"
+ },
+ {
+ "id": "use",
+ "action": "Use",
+ "default": "E"
+ },
+ {
+ "id": "harvesting_tool",
+ "action": "Harvesting Tool",
+ "default": "1"
+ },
+ {
+ "id": "weapon_slot_1",
+ "action": "Weapon Slot 1",
+ "default": "2"
+ },
+ {
+ "id": "weapon_slot_2",
+ "action": "Weapon Slot 2",
+ "default": "3"
+ },
+ {
+ "id": "weapon_slot_3",
+ "action": "Weapon Slot 3",
+ "default": "4"
+ },
+ {
+ "id": "weapon_slot_4",
+ "action": "Weapon Slot 4",
+ "default": "5"
+ },
+ {
+ "id": "weapon_slot_5",
+ "action": "Weapon Slot 5",
+ "default": "6"
+ },
+ {
+ "id": "wall",
+ "action": "Wall",
+ "default": "F1"
+ },
+ {
+ "id": "floor",
+ "action": "Floor",
+ "default": "F2"
+ },
+ {
+ "id": "stairs",
+ "action": "Stairs",
+ "default": "F3"
+ },
+ {
+ "id": "roof",
+ "action": "Roof",
+ "default": "F4"
+ },
+ {
+ "id": "edit",
+ "action": "Edit",
+ "default": "G"
+ },
+ {
+ "id": "toggle_building_mode",
+ "action": "Toggle Building Mode",
+ "default": "Q"
+ },
+ {
+ "id": "place_marker",
+ "action": "Place Marker",
+ "default": "Middle Mouse"
+ },
+ {
+ "id": "map",
+ "action": "Map",
+ "default": "M"
+ },
+ {
+ "id": "inventory",
+ "action": "Inventory",
+ "default": "I"
+ }
+ ]
+ },
+ {
+ "id": "cod_bo6",
+ "name": "Call of Duty: Black Ops 6 / Warzone",
+ "publisher": "Activision",
+ "yaw": 0.0066,
+ "yaw_note": "Degrees per count per 1.00 of 'Mouse Sensitivity' (same scale as MW2019+ and Warzone). ADS depends on ADS Sensitivity Multiplier + Monitor Distance Coefficient + ADS FOV setting.",
+ "sens_key": "mouse_sens",
+ "config_file": "Documents\\Call of Duty\\players\\ (BO6 options text files, e.g. s.1.0.cod24.txt0/.txt1; partly cloud-synced to the Activision account; file names unverified)",
+ "sources": [
+ "https://senslab.pro/sensitivity",
+ "https://csdb.gg/sensitivity-converter/",
+ "https://www.gfinityesports.com/article/best-keyboard-and-mouse-settings-for-black-ops-6",
+ "https://www.callofduty.com/blog/2020/11/Black-Ops-Cold-War-Controls-and-Settings-PC"
+ ],
+ "sections": [
+ {
+ "id": "mouse",
+ "settings": [
+ {
+ "key": "mouse_sens",
+ "label": "Mouse Sensitivity",
+ "type": "slider",
+ "min": 0.01,
+ "max": 100,
+ "step": 0.01,
+ "default": null,
+ "note": "Hip-fire"
+ },
+ {
+ "key": "ads_multiplier",
+ "label": "ADS Sensitivity Multiplier",
+ "type": "slider",
+ "min": 0.01,
+ "max": 2.0,
+ "step": 0.01,
+ "default": 1.0,
+ "note": "Global multiplier while aiming"
+ },
+ {
+ "key": "ads_transition",
+ "label": "ADS Sensitivity Transition Timing",
+ "options": [
+ "Instant",
+ "Gradual"
+ ],
+ "type": "select",
+ "default": "Gradual",
+ "note": "Options: Instant / Gradual"
+ },
+ {
+ "key": "monitor_distance_coeff",
+ "label": "Monitor Distance Coefficient",
+ "type": "slider",
+ "min": 0,
+ "max": 3,
+ "step": 0.01,
+ "default": 1.33,
+ "note": "1.33 = vertical-match style scaling; 0 = focal-length"
+ },
+ {
+ "key": "vertical_mult",
+ "label": "Vertical Aim Sensitivity Multiplier",
+ "type": "number",
+ "step": 0.01,
+ "default": 1.0,
+ "note": "Label may vary by title"
+ },
+ {
+ "key": "custom_zoom_sens",
+ "label": "Custom Sensitivity Per Zoom",
+ "type": "toggle",
+ "default": false,
+ "note": "Toggle unlocking per-zoom-level multipliers"
+ }
+ ]
+ },
+ {
+ "id": "audio",
+ "settings": [
+ {
+ "key": "audio_mix",
+ "label": "Audio Mix",
+ "options": [
+ "Home Theater",
+ "Headphones",
+ "Headphones Bass Boost",
+ "Night Mode",
+ "Treble Boost",
+ "Bass Boost"
+ ],
+ "type": "select",
+ "default": "Home Theater",
+ "note": "Presets include Home Theater, Headphones, Headphones Bass Boost, Night Mode, Treble Boost, Bass Boost (list varies per title)"
+ },
+ {
+ "key": "master_volume",
+ "label": "Master Volume",
+ "type": "slider",
+ "min": 0,
+ "max": 100,
+ "default": null
+ },
+ {
+ "key": "music_volume",
+ "label": "Music Volume",
+ "type": "slider",
+ "min": 0,
+ "max": 100,
+ "default": null
+ },
+ {
+ "key": "dialogue_volume",
+ "label": "Dialogue Volume",
+ "type": "slider",
+ "min": 0,
+ "max": 100,
+ "default": null
+ },
+ {
+ "key": "effects_volume",
+ "label": "Effects Volume",
+ "type": "slider",
+ "min": 0,
+ "max": 100,
+ "default": null
+ },
+ {
+ "key": "voice_chat_volume",
+ "label": "Voice Chat Volume",
+ "type": "slider",
+ "min": 0,
+ "max": 100,
+ "default": null
+ }
+ ]
+ },
+ {
+ "id": "video",
+ "settings": [
+ {
+ "key": "display_mode",
+ "label": "Display Mode",
+ "options": [
+ "Fullscreen Exclusive",
+ "Fullscreen Borderless",
+ "Windowed"
+ ],
+ "type": "select",
+ "default": null
+ },
+ {
+ "key": "resolution",
+ "label": "Display Resolution",
+ "type": "text",
+ "default": null
+ },
+ {
+ "key": "fov",
+ "label": "Field of View",
+ "type": "slider",
+ "min": 60,
+ "max": 120,
+ "default": 80
+ },
+ {
+ "key": "ads_fov",
+ "label": "ADS Field of View",
+ "options": [
+ "Affected",
+ "Independent"
+ ],
+ "type": "select",
+ "default": null
+ },
+ {
+ "key": "weapon_fov",
+ "label": "Weapon Field of View",
+ "options": [
+ "Default",
+ "Wide"
+ ],
+ "type": "select",
+ "default": "Default"
+ },
+ {
+ "key": "frame_rate_limit",
+ "label": "Custom Frame Rate Limit",
+ "type": "slider",
+ "min": 30,
+ "max": 300,
+ "default": null
+ },
+ {
+ "key": "nvidia_reflex",
+ "label": "NVIDIA Reflex Low Latency",
+ "options": [
+ "Off",
+ "On",
+ "On + Boost"
+ ],
+ "type": "select",
+ "default": null
+ },
+ {
+ "key": "upscaling",
+ "label": "Upscaling / Sharpening",
+ "options": [
+ "Off",
+ "FidelityFX CAS",
+ "NVIDIA DLSS",
+ "AMD FSR 3",
+ "Intel XeSS"
+ ],
+ "type": "select",
+ "default": null
+ },
+ {
+ "key": "vsync",
+ "label": "V-Sync (Gameplay)",
+ "type": "toggle",
+ "default": false
+ },
+ {
+ "key": "quality_preset",
+ "label": "Quality Presets",
+ "options": [
+ "Minimum",
+ "Low",
+ "Balanced",
+ "High",
+ "Ultra",
+ "Extreme",
+ "Custom"
+ ],
+ "type": "select",
+ "default": null
+ }
+ ]
+ },
+ {
+ "id": "gameplay",
+ "settings": [
+ {
+ "key": "movement_mode",
+ "label": "Movement mode (Sprint/Tactical Sprint Behavior)",
+ "options": [
+ "Tap to Sprint",
+ "Auto Sprint",
+ "Auto Tactical Sprint"
+ ],
+ "type": "select",
+ "default": null
+ },
+ {
+ "key": "aim_down_sight_behavior",
+ "label": "Aim Down Sight Behavior",
+ "options": [
+ "Hold",
+ "Toggle"
+ ],
+ "type": "select",
+ "default": "Hold"
+ },
+ {
+ "key": "crouch_behavior",
+ "label": "Crouch Behavior",
+ "options": [
+ "Toggle",
+ "Hold"
+ ],
+ "type": "select",
+ "default": null
+ },
+ {
+ "key": "camera_movement",
+ "label": "Camera Movement (First Person)",
+ "options": [
+ "Least (50%)",
+ "Less (75%)",
+ "Default (100%)"
+ ],
+ "type": "select",
+ "default": "Default (100%)"
+ },
+ {
+ "key": "auto_move_forward",
+ "label": "Automatic Airborne Mantle / Automatic Ground Mantle",
+ "type": "toggle",
+ "default": null
+ }
+ ]
+ }
+ ],
+ "keybinds": [
+ {
+ "id": "move_forward",
+ "action": "Move Forward",
+ "default": "W"
+ },
+ {
+ "id": "move_back",
+ "action": "Move Back",
+ "default": "S"
+ },
+ {
+ "id": "move_left",
+ "action": "Move Left",
+ "default": "A"
+ },
+ {
+ "id": "move_right",
+ "action": "Move Right",
+ "default": "D"
+ },
+ {
+ "id": "jump_mantle",
+ "action": "Jump / Mantle",
+ "default": "Space"
+ },
+ {
+ "id": "sprint_tactical_sprint",
+ "action": "Sprint / Tactical Sprint",
+ "default": "Left Shift"
+ },
+ {
+ "id": "crouch_slide",
+ "action": "Crouch / Slide",
+ "default": "C"
+ },
+ {
+ "id": "prone_dive",
+ "action": "Prone / Dive",
+ "default": "Left Ctrl",
+ "note": "verify: community presets differ (Z / Ctrl)"
+ },
+ {
+ "id": "reload",
+ "action": "Reload",
+ "default": "R"
+ },
+ {
+ "id": "interact",
+ "action": "Interact",
+ "default": "F",
+ "note": "verify in game"
+ },
+ {
+ "id": "melee",
+ "action": "Melee",
+ "default": "V",
+ "note": "verify in game"
+ },
+ {
+ "id": "lethal_equipment",
+ "action": "Lethal Equipment",
+ "default": "G",
+ "note": "verify in game"
+ },
+ {
+ "id": "tactical_equipment",
+ "action": "Tactical Equipment",
+ "default": "Q",
+ "note": "verify in game"
+ },
+ {
+ "id": "field_upgrade",
+ "action": "Field Upgrade",
+ "default": "X",
+ "note": "verify in game"
+ },
+ {
+ "id": "weapon_slot_1",
+ "action": "Weapon Slot 1",
+ "default": "1"
+ },
+ {
+ "id": "weapon_slot_2",
+ "action": "Weapon Slot 2",
+ "default": "2"
+ },
+ {
+ "id": "next_previous_weapon",
+ "action": "Next / Previous Weapon",
+ "default": "Mouse Wheel"
+ },
+ {
+ "id": "fire",
+ "action": "Fire",
+ "default": "Left Mouse"
+ },
+ {
+ "id": "aim_down_sights",
+ "action": "Aim Down Sights",
+ "default": "Right Mouse"
+ },
+ {
+ "id": "scoreboard",
+ "action": "Scoreboard",
+ "default": "Tab"
+ },
+ {
+ "id": "map_warzone",
+ "action": "Map (Warzone)",
+ "default": "M"
+ }
+ ]
+ },
+ {
+ "id": "r6_siege_x",
+ "name": "Rainbow Six Siege X",
+ "publisher": "Ubisoft",
+ "yaw": 0.00572957795,
+ "yaw_note": "Degrees per count per 1 of 'Mouse Sensitivity Horizontal' (MouseYawSensitivity) with default MouseSensitivityMultiplierUnit = 0.02 in GameSettings.ini; scale yaw by (unit/0.02) if changed. ADS per scope is a % of hip-fire.",
+ "sens_key": "mouse_sens_h",
+ "config_file": "Documents\\My Games\\Rainbow Six - Siege\\<profile-id>\\GameSettings.ini (INI; [INPUT] holds MouseYawSensitivity/MousePitchSensitivity/MouseSensitivityMultiplierUnit)",
+ "sources": [
+ "https://senslab.pro/sensitivity",
+ "https://csdb.gg/sensitivity-converter/",
+ "https://www.mouse-sensitivity.com/forums/topic/361-tom-clancys-rainbow-six-siege/",
+ "https://prosettings.net/guides/rainbow-six-options/",
+ "https://www.magicgameworld.com/?p=101831"
+ ],
+ "sections": [
+ {
+ "id": "mouse",
+ "settings": [
+ {
+ "key": "mouse_sens_h",
+ "label": "Mouse Sensitivity Horizontal",
+ "type": "slider",
+ "min": 1,
+ "max": 100,
+ "step": 1,
+ "default": null,
+ "note": "MouseYawSensitivity in GameSettings.ini"
+ },
+ {
+ "key": "mouse_sens_v",
+ "label": "Mouse Sensitivity Vertical",
+ "type": "slider",
+ "min": 1,
+ "max": 100,
+ "step": 1,
+ "default": null,
+ "note": "MousePitchSensitivity"
+ },
+ {
+ "key": "multiplier_unit",
+ "label": "MouseSensitivityMultiplierUnit (ini only)",
+ "type": "number",
+ "min": 0,
+ "default": 0.02,
+ "note": "Not in menu; scales all mouse sens"
+ },
+ {
+ "key": "ads_1x",
+ "label": "Aim Down Sights 1.0x",
+ "type": "slider",
+ "min": 1,
+ "max": 200,
+ "step": 1,
+ "default": null,
+ "note": "Per-zoom ADS sliders since Shadow Legacy (1.0x, 1.5x, 2.0x, 2.5x, 3.0x, 4.0x, 5.0x, 12.0x)"
+ },
+ {
+ "key": "ads_25x",
+ "label": "Aim Down Sights 2.5x",
+ "type": "slider",
+ "min": 1,
+ "max": 200,
+ "step": 1,
+ "default": null
+ }
+ ]
+ },
+ {
+ "id": "audio",
+ "settings": [
+ {
+ "key": "master_volume",
+ "label": "Master Volume",
+ "type": "slider",
+ "min": 0,
+ "max": 100,
+ "default": null
+ },
+ {
+ "key": "music_volume",
+ "label": "Music Volume",
+ "type": "slider",
+ "min": 0,
+ "max": 100,
+ "default": null
+ },
+ {
+ "key": "sfx_volume",
+ "label": "Sound Effects Volume",
+ "type": "slider",
+ "min": 0,
+ "max": 100,
+ "default": null
+ },
+ {
+ "key": "voice_chat_volume",
+ "label": "Voice Chat Volume",
+ "type": "slider",
+ "min": 0,
+ "max": 100,
+ "default": null
+ },
+ {
+ "key": "dynamic_range",
+ "label": "Dynamic Range",
+ "options": [
+ "Presets like Night Mode",
+ "TV",
+ "Hi-Fi; Siege X reworked audio",
+ "verify labels"
+ ],
+ "type": "select",
+ "default": null,
+ "note": "Presets like Night Mode / TV / Hi-Fi; Siege X reworked audio, verify labels"
+ }
+ ]
+ },
+ {
+ "id": "video",
+ "settings": [
+ {
+ "key": "display_mode",
+ "label": "Display Mode",
+ "options": [
+ "Fullscreen",
+ "Borderless",
+ "Windowed"
+ ],
+ "type": "select",
+ "default": null
+ },
+ {
+ "key": "resolution",
+ "label": "Resolution",
+ "type": "text",
+ "default": null
+ },
+ {
+ "key": "fov",
+ "label": "Field of View",
+ "type": "slider",
+ "min": 60,
+ "max": 90,
+ "default": null,
+ "note": "Vertical FOV"
+ },
+ {
+ "key": "aspect_ratio",
+ "label": "Aspect Ratio",
+ "options": [
+ "Auto",
+ "16:9",
+ "16:10",
+ "4:3",
+ "5:4"
+ ],
+ "type": "select",
+ "default": "Auto"
+ },
+ {
+ "key": "frame_rate_limit",
+ "label": "Frame Rate Limit",
+ "type": "number",
+ "min": 30,
+ "default": null
+ },
+ {
+ "key": "vsync",
+ "label": "VSync",
+ "options": [
+ "Off",
+ "On",
+ "Interval 2"
+ ],
+ "type": "select",
+ "default": null
+ },
+ {
+ "key": "nvidia_reflex",
+ "label": "NVIDIA Reflex Low Latency",
+ "options": [
+ "Off",
+ "On",
+ "On + Boost"
+ ],
+ "type": "select",
+ "default": null
+ },
+ {
+ "key": "upscaling",
+ "label": "Upscaling (DLSS / FSR / XeSS)",
+ "options": [
+ "Off",
+ "NVIDIA DLSS",
+ "AMD FSR",
+ "Intel XeSS"
+ ],
+ "type": "select",
+ "default": null
+ },
+ {
+ "key": "texture_quality",
+ "label": "Texture Quality",
+ "options": [
+ "Low",
+ "Medium",
+ "High",
+ "Very High",
+ "Ultra"
+ ],
+ "type": "select",
+ "default": null
+ },
+ {
+ "key": "render_scaling",
+ "label": "Render Scaling",
+ "type": "slider",
+ "min": 25,
+ "max": 100,
+ "default": 100
+ }
+ ]
+ },
+ {
+ "id": "gameplay",
+ "settings": [
+ {
+ "key": "aim_mode",
+ "label": "Aim Down Sights (Toggle/Hold)",
+ "options": [
+ "Hold",
+ "Toggle"
+ ],
+ "type": "select",
+ "default": "Hold"
+ },
+ {
+ "key": "lean_mode",
+ "label": "Lean (Toggle/Hold)",
+ "options": [
+ "Hold",
+ "Toggle"
+ ],
+ "type": "select",
+ "default": "Hold"
+ },
+ {
+ "key": "crouch_mode",
+ "label": "Crouch (Toggle/Hold)",
+ "options": [
+ "Hold",
+ "Toggle"
+ ],
+ "type": "select",
+ "default": null
+ },
+ {
+ "key": "raw_input",
+ "label": "Raw Input (ini: RawInputMouseKeyboard)",
+ "type": "toggle",
+ "default": true
+ }
+ ]
+ }
+ ],
+ "keybinds": [
+ {
+ "id": "move_forward",
+ "action": "Move Forward",
+ "default": "W"
+ },
+ {
+ "id": "move_back",
+ "action": "Move Back",
+ "default": "S"
+ },
+ {
+ "id": "move_left",
+ "action": "Move Left",
+ "default": "A"
+ },
+ {
+ "id": "move_right",
+ "action": "Move Right",
+ "default": "D"
+ },
+ {
+ "id": "lean_left",
+ "action": "Lean Left",
+ "default": "Q"
+ },
+ {
+ "id": "lean_right",
+ "action": "Lean Right",
+ "default": "E"
+ },
+ {
+ "id": "sprint",
+ "action": "Sprint",
+ "default": "Left Shift"
+ },
+ {
+ "id": "crouch",
+ "action": "Crouch",
+ "default": "C"
+ },
+ {
+ "id": "prone",
+ "action": "Prone",
+ "default": "Left Ctrl"
+ },
+ {
+ "id": "walk",
+ "action": "Walk",
+ "default": "Left Alt"
+ },
+ {
+ "id": "reload",
+ "action": "Reload",
+ "default": "R"
+ },
+ {
+ "id": "interact",
+ "action": "Interact",
+ "default": "F"
+ },
+ {
+ "id": "melee",
+ "action": "Melee",
+ "default": "V"
+ },
+ {
+ "id": "operator_gadget_primary_gadget",
+ "action": "Operator Gadget (primary gadget)",
+ "default": "Middle Mouse",
+ "note": "older guide; verify"
+ },
+ {
+ "id": "secondary_gadget",
+ "action": "Secondary Gadget",
+ "default": "G"
+ },
+ {
+ "id": "primary_weapon",
+ "action": "Primary Weapon",
+ "default": "1"
+ },
+ {
+ "id": "secondary_weapon",
+ "action": "Secondary Weapon",
+ "default": "2"
+ },
+ {
+ "id": "observation_tools",
+ "action": "Observation Tools",
+ "default": "5"
+ },
+ {
+ "id": "deploy_drone",
+ "action": "Deploy Drone",
+ "default": "6"
+ },
+ {
+ "id": "ping",
+ "action": "Ping",
+ "default": "Z"
+ },
+ {
+ "id": "switch_ability_mode",
+ "action": "Switch Ability Mode",
+ "default": "B"
+ },
+ {
+ "id": "drop_defuser",
+ "action": "Drop Defuser",
+ "default": "X"
+ },
+ {
+ "id": "scoreboard",
+ "action": "Scoreboard",
+ "default": "Tab"
+ }
+ ]
+ },
+ {
+ "id": "valorant",
+ "name": "Valorant",
+ "publisher": "Riot Games",
+ "yaw": 0.07,
+ "yaw_note": "Degrees per count per 1.0 of 'Sensitivity: Aim'. FOV fixed (103 horizontal), so no FOV setting.",
+ "sens_key": "aim_sens",
+ "config_file": "%LOCALAPPDATA%\\VALORANT\\Saved\\Config\\<account-id>\\Windows\\GameUserSettings.ini (graphics only); sensitivity, keybinds and crosshair are stored server-side on the Riot account.",
+ "sources": [
+ "https://senslab.pro/sensitivity",
+ "https://csdb.gg/sensitivity-converter/"
+ ],
+ "sections": [
+ {
+ "id": "mouse",
+ "settings": [
+ {
+ "key": "aim_sens",
+ "label": "Sensitivity: Aim",
+ "type": "slider",
+ "min": 0.001,
+ "max": 10,
+ "step": 0.001,
+ "default": null,
+ "note": "Typical pro range 0.2-0.6 at 800 DPI"
+ },
+ {
+ "key": "scoped_mult",
+ "label": "Scoped Sensitivity Multiplier",
+ "type": "slider",
+ "min": 0.01,
+ "max": 5,
+ "step": 0.001,
+ "default": 1.0
+ },
+ {
+ "key": "ads_mult",
+ "label": "ADS Sensitivity Multiplier",
+ "type": "slider",
+ "min": 0.01,
+ "max": 5,
+ "step": 0.001,
+ "default": 1.0
+ },
+ {
+ "key": "raw_input_buffer",
+ "label": "Raw Input Buffer",
+ "type": "toggle",
+ "default": false,
+ "note": "Toggle"
+ }
+ ]
+ },
+ {
+ "id": "audio",
+ "settings": [
+ {
+ "key": "overall_volume",
+ "label": "Overall Volume",
+ "type": "slider",
+ "min": 0,
+ "max": 100,
+ "default": null
+ },
+ {
+ "key": "sfx_volume",
+ "label": "Sound Effects Volume",
+ "type": "slider",
+ "min": 0,
+ "max": 100,
+ "default": null
+ },
+ {
+ "key": "vo_volume",
+ "label": "Voice-Over Volume",
+ "type": "slider",
+ "min": 0,
+ "max": 100,
+ "default": null
+ },
+ {
+ "key": "music_volume",
+ "label": "Music Volume",
+ "type": "slider",
+ "min": 0,
+ "max": 100,
+ "default": null
+ },
+ {
+ "key": "voice_incoming",
+ "label": "Incoming Volume (Voice Chat)",
+ "type": "slider",
+ "min": 0,
+ "max": 100,
+ "default": null
+ },
+ {
+ "key": "hrtf",
+ "label": "Enable HRTF",
+ "type": "toggle",
+ "default": false
+ }
+ ]
+ },
+ {
+ "id": "video",
+ "settings": [
+ {
+ "key": "display_mode",
+ "label": "Display Mode",
+ "options": [
+ "Fullscreen",
+ "Windowed Fullscreen",
+ "Windowed"
+ ],
+ "type": "select",
+ "default": null
+ },
+ {
+ "key": "resolution",
+ "label": "Resolution",
+ "type": "text",
+ "default": null
+ },
+ {
+ "key": "limit_fps_always",
+ "label": "Limit FPS Always",
+ "type": "toggle",
+ "default": false
+ },
+ {
+ "key": "max_fps_always",
+ "label": "Max FPS Always",
+ "type": "slider",
+ "min": 30,
+ "max": 1000,
+ "default": null
+ },
+ {
+ "key": "nvidia_reflex",
+ "label": "NVIDIA Reflex Low Latency",
+ "options": [
+ "Off",
+ "On",
+ "On + Boost"
+ ],
+ "type": "select",
+ "default": null
+ },
+ {
+ "key": "multithreaded",
+ "label": "Multithreaded Rendering",
+ "type": "toggle",
+ "default": true
+ },
+ {
+ "key": "material_quality",
+ "label": "Material Quality",
+ "options": [
+ "Low",
+ "Med",
+ "High"
+ ],
+ "type": "select",
+ "default": null
+ },
+ {
+ "key": "texture_quality",
+ "label": "Texture Quality",
+ "options": [
+ "Low",
+ "Med",
+ "High"
+ ],
+ "type": "select",
+ "default": null
+ },
+ {
+ "key": "detail_quality",
+ "label": "Detail Quality",
+ "options": [
+ "Low",
+ "Med",
+ "High"
+ ],
+ "type": "select",
+ "default": null
+ },
+ {
+ "key": "anti_aliasing",
+ "label": "Anti-Aliasing",
+ "options": [
+ "None",
+ "MSAA 2x",
+ "MSAA 4x",
+ "FXAA"
+ ],
+ "type": "select",
+ "default": null
+ },
+ {
+ "key": "vsync",
+ "label": "VSync",
+ "type": "toggle",
+ "default": false
+ }
+ ]
+ },
+ {
+ "id": "gameplay",
+ "settings": [
+ {
+ "key": "minimap_rotate",
+ "label": "Rotate",
+ "type": "toggle",
+ "default": null
+ },
+ {
+ "key": "minimap_centered",
+ "label": "Keep Player Centered",
+ "type": "toggle",
+ "default": null
+ },
+ {
+ "key": "show_corpses",
+ "label": "Show Corpses",
+ "type": "toggle",
+ "default": true
+ },
+ {
+ "key": "show_blood",
+ "label": "Show Blood",
+ "type": "toggle",
+ "default": true
+ },
+ {
+ "key": "crosshair_profile",
+ "label": "Crosshair Profile",
+ "type": "text",
+ "default": null
+ }
+ ]
+ }
+ ],
+ "keybinds": [
+ {
+ "id": "move_forward",
+ "action": "Move Forward",
+ "default": "W"
+ },
+ {
+ "id": "move_back",
+ "action": "Move Back",
+ "default": "S"
+ },
+ {
+ "id": "move_left",
+ "action": "Move Left",
+ "default": "A"
+ },
+ {
+ "id": "move_right",
+ "action": "Move Right",
+ "default": "D"
+ },
+ {
+ "id": "walk",
+ "action": "Walk",
+ "default": "Left Shift"
+ },
+ {
+ "id": "crouch",
+ "action": "Crouch",
+ "default": "Left Ctrl"
+ },
+ {
+ "id": "jump",
+ "action": "Jump",
+ "default": "Space"
+ },
+ {
+ "id": "use_object",
+ "action": "Use Object",
+ "default": "F"
+ },
+ {
+ "id": "equip_primary_weapon",
+ "action": "Equip Primary Weapon",
+ "default": "1"
+ },
+ {
+ "id": "equip_secondary_weapon",
+ "action": "Equip Secondary Weapon",
+ "default": "2"
+ },
+ {
+ "id": "equip_melee_weapon",
+ "action": "Equip Melee Weapon",
+ "default": "3"
+ },
+ {
+ "id": "equip_spike",
+ "action": "Equip Spike",
+ "default": "4"
+ },
+ {
+ "id": "use_equip_ability_1",
+ "action": "Use/Equip Ability: 1",
+ "default": "C"
+ },
+ {
+ "id": "use_equip_ability_2",
+ "action": "Use/Equip Ability: 2",
+ "default": "Q"
+ },
+ {
+ "id": "use_equip_ability_signature",
+ "action": "Use/Equip Ability: Signature",
+ "default": "E"
+ },
+ {
+ "id": "use_equip_ability_ultimate",
+ "action": "Use/Equip Ability: Ultimate",
+ "default": "X"
+ },
+ {
+ "id": "reload",
+ "action": "Reload",
+ "default": "R"
+ },
+ {
+ "id": "drop_equipped_item",
+ "action": "Drop Equipped Item",
+ "default": "G"
+ },
+ {
+ "id": "inspect_weapon",
+ "action": "Inspect Weapon",
+ "default": "Y"
+ },
+ {
+ "id": "ping",
+ "action": "Ping",
+ "default": "Z"
+ },
+ {
+ "id": "use_spray",
+ "action": "Use Spray",
+ "default": "T"
+ },
+ {
+ "id": "toggle_map",
+ "action": "Toggle Map",
+ "default": "M"
+ },
+ {
+ "id": "scoreboard",
+ "action": "Scoreboard",
+ "default": "Tab"
+ }
+ ]
+ },
+ {
+ "id": "cs2",
+ "name": "Counter-Strike 2",
+ "publisher": "Valve",
+ "yaw": 0.022,
+ "yaw_note": "m_yaw 0.022 degrees per count per 1.0 of 'sensitivity'. FOV fixed at 90 (4:3 horizontal), not adjustable.",
+ "sens_key": "sensitivity",
+ "config_file": "Steam\\userdata\\<steamid3>\\730\\local\\cfg\\cs2_user_convars_0_slot0.vcfg (+ cs2_user_keys_0_slot0.vcfg, cs2_machine_convars.vcfg); custom autoexec at <game>\\csgo\\cfg\\autoexec.cfg.",
+ "sources": [
+ "https://csdb.gg/sensitivity-converter/",
+ "https://senslab.pro/sensitivity"
+ ],
+ "sections": [
+ {
+ "id": "mouse",
+ "settings": [
+ {
+ "key": "sensitivity",
+ "label": "Mouse Sensitivity",
+ "type": "slider",
+ "min": 0.01,
+ "max": 8,
+ "step": 0.01,
+ "default": 1.25,
+ "note": "convar 'sensitivity'; console allows beyond the slider"
+ },
+ {
+ "key": "zoom_sensitivity_ratio",
+ "label": "Zoom Sensitivity",
+ "type": "slider",
+ "min": 0,
+ "max": 2,
+ "step": 0.01,
+ "default": 1.0,
+ "note": "convar zoom_sensitivity_ratio (scoped weapons)"
+ },
+ {
+ "key": "m_yaw",
+ "label": "m_yaw (console)",
+ "type": "number",
+ "default": 0.022,
+ "note": "Horizontal yaw; m_pitch also 0.022"
+ }
+ ]
+ },
+ {
+ "id": "audio",
+ "settings": [
+ {
+ "key": "master_volume",
+ "label": "Master Volume",
+ "type": "slider",
+ "min": 0,
+ "max": 100,
+ "default": null
+ },
+ {
+ "key": "main_menu_volume",
+ "label": "Main Menu Volume",
+ "type": "slider",
+ "min": 0,
+ "max": 100,
+ "default": null
+ },
+ {
+ "key": "round_start_volume",
+ "label": "Round Start Volume",
+ "type": "slider",
+ "min": 0,
+ "max": 100,
+ "default": null
+ },
+ {
+ "key": "round_end_volume",
+ "label": "Round End Volume",
+ "type": "slider",
+ "min": 0,
+ "max": 100,
+ "default": null
+ },
+ {
+ "key": "ten_second_volume",
+ "label": "Ten Second Warning Volume",
+ "type": "slider",
+ "min": 0,
+ "max": 100,
+ "default": null
+ },
+ {
+ "key": "voice_volume",
+ "label": "Voice Volume (voice chat)",
+ "type": "slider",
+ "min": 0,
+ "max": 100,
+ "default": null
+ },
+ {
+ "key": "eq_profile",
+ "label": "EQ Profile",
+ "options": [
+ "Natural",
+ "Crisp",
+ "Smooth"
+ ],
+ "type": "select",
+ "default": "Natural",
+ "note": "Natural / Crisp / Smooth"
+ }
+ ]
+ },
+ {
+ "id": "video",
+ "settings": [
+ {
+ "key": "display_mode",
+ "label": "Display Mode",
+ "options": [
+ "Fullscreen",
+ "Windowed",
+ "Fullscreen Windowed"
+ ],
+ "type": "select",
+ "default": null
+ },
+ {
+ "key": "aspect_ratio",
+ "label": "Aspect Ratio",
+ "options": [
+ "Normal 4:3",
+ "Widescreen 16:9",
+ "Widescreen 16:10"
+ ],
+ "type": "select",
+ "default": null
+ },
+ {
+ "key": "resolution",
+ "label": "Resolution",
+ "type": "text",
+ "default": null
+ },
+ {
+ "key": "boost_contrast",
+ "label": "Boost Player Contrast",
+ "type": "toggle",
+ "default": true
+ },
+ {
+ "key": "vsync",
+ "label": "Wait for Vertical Sync",
+ "type": "toggle",
+ "default": false
+ },
+ {
+ "key": "msaa",
+ "label": "Multisampling Anti-Aliasing Mode",
+ "options": [
+ "None",
+ "CMAA2",
+ "2X MSAA",
+ "4X MSAA",
+ "8X MSAA"
+ ],
+ "type": "select",
+ "default": null
+ },
+ {
+ "key": "shadow_quality",
+ "label": "Global Shadow Quality",
+ "options": [
+ "Low",
+ "Medium",
+ "High",
+ "Very High"
+ ],
+ "type": "select",
+ "default": null
+ },
+ {
+ "key": "fsr",
+ "label": "FidelityFX Super Resolution",
+ "options": [
+ "Disabled (Highest Quality)",
+ "Ultra Quality",
+ "Quality",
+ "Balanced",
+ "Performance"
+ ],
+ "type": "select",
+ "default": null
+ },
+ {
+ "key": "nvidia_reflex",
+ "label": "NVIDIA Reflex Low Latency",
+ "options": [
+ "Disabled",
+ "Enabled",
+ "Enabled + Boost"
+ ],
+ "type": "select",
+ "default": null
+ },
+ {
+ "key": "fps_max",
+ "label": "Max Frames Per Second (fps_max)",
+ "type": "slider",
+ "min": 0,
+ "max": 1000,
+ "default": null
+ }
+ ]
+ },
+ {
+ "id": "gameplay",
+ "settings": [
+ {
+ "key": "viewmodel_fov",
+ "label": "viewmodel_fov (console)",
+ "type": "slider",
+ "min": 54,
+ "max": 68,
+ "default": 60
+ },
+ {
+ "key": "crosshair_code",
+ "label": "Crosshair share code",
+ "type": "text",
+ "default": null
+ },
+ {
+ "key": "radar_rotate",
+ "label": "Radar rotate (cl_radar_rotate)",
+ "type": "toggle",
+ "default": true
+ },
+ {
+ "key": "radar_scale",
+ "label": "Radar map zoom (cl_radar_scale)",
+ "type": "slider",
+ "min": 0.25,
+ "max": 1,
+ "default": 0.7
+ }
+ ]
+ }
+ ],
+ "keybinds": [
+ {
+ "id": "move_forward",
+ "action": "Move Forward",
+ "default": "W"
+ },
+ {
+ "id": "move_back",
+ "action": "Move Back",
+ "default": "S"
+ },
+ {
+ "id": "move_left",
+ "action": "Move Left",
+ "default": "A"
+ },
+ {
+ "id": "move_right",
+ "action": "Move Right",
+ "default": "D"
+ },
+ {
+ "id": "jump",
+ "action": "Jump",
+ "default": "Space"
+ },
+ {
+ "id": "crouch",
+ "action": "Crouch",
+ "default": "Left Ctrl"
+ },
+ {
+ "id": "walk",
+ "action": "Walk",
+ "default": "Left Shift"
+ },
+ {
+ "id": "reload",
+ "action": "Reload",
+ "default": "R"
+ },
+ {
+ "id": "use",
+ "action": "Use",
+ "default": "E"
+ },
+ {
+ "id": "primary_weapon",
+ "action": "Primary Weapon",
+ "default": "1"
+ },
+ {
+ "id": "secondary_weapon",
+ "action": "Secondary Weapon",
+ "default": "2"
+ },
+ {
+ "id": "knife",
+ "action": "Knife",
+ "default": "3"
+ },
+ {
+ "id": "cycle_grenades",
+ "action": "Cycle Grenades",
+ "default": "4"
+ },
+ {
+ "id": "bomb_equipment",
+ "action": "Bomb / Equipment",
+ "default": "5"
+ },
+ {
+ "id": "inspect_weapon",
+ "action": "Inspect Weapon",
+ "default": "F"
+ },
+ {
+ "id": "drop_weapon",
+ "action": "Drop Weapon",
+ "default": "G"
+ },
+ {
+ "id": "buy_menu",
+ "action": "Buy Menu",
+ "default": "B"
+ },
+ {
+ "id": "scoreboard",
+ "action": "Scoreboard",
+ "default": "Tab"
+ },
+ {
+ "id": "use_radio_voice_push_to_talk",
+ "action": "Use Radio / Voice (Push to Talk)",
+ "default": "K"
+ },
+ {
+ "id": "player_ping",
+ "action": "Player Ping",
+ "default": "Mouse 3",
+ "note": "verify"
+ },
+ {
+ "id": "last_weapon_used",
+ "action": "Last Weapon Used",
+ "default": "Q"
+ }
+ ]
+ },
+ {
+ "id": "apex",
+ "name": "Apex Legends",
+ "publisher": "Electronic Arts / Respawn",
+ "yaw": 0.022,
+ "yaw_note": "Source-engine style: 0.022 degrees per count per 1.0 of 'Mouse Sensitivity' (same as CS2).",
+ "sens_key": "mouse_sens",
+ "config_file": "%USERPROFILE%\\Saved Games\\Respawn\\Apex\\local\\settings.cfg (convar text, mouse_sensitivity etc.) + videoconfig.txt; profile\\profile.cfg for binds.",
+ "sources": [
+ "https://csdb.gg/sensitivity-converter/",
+ "https://senslab.pro/sensitivity"
+ ],
+ "sections": [
+ {
+ "id": "mouse",
+ "settings": [
+ {
+ "key": "mouse_sens",
+ "label": "Mouse Sensitivity",
+ "type": "slider",
+ "min": 0.2,
+ "max": 20,
+ "step": 0.1,
+ "default": null,
+ "note": "settings.cfg: mouse_sensitivity"
+ },
+ {
+ "key": "ads_mult",
+ "label": "ADS Mouse Sensitivity Multiplier",
+ "type": "slider",
+ "min": 0.2,
+ "max": 10,
+ "step": 0.1,
+ "default": 1.0,
+ "note": "Used when Per Optic is Off"
+ },
+ {
+ "key": "per_optic",
+ "label": "Per Optic ADS Sensitivity",
+ "type": "toggle",
+ "default": false,
+ "note": "Toggle; unlocks 1x-10x optic multipliers"
+ },
+ {
+ "key": "mouse_accel",
+ "label": "Mouse Acceleration",
+ "type": "toggle",
+ "default": false
+ }
+ ]
+ },
+ {
+ "id": "audio",
+ "settings": [
+ {
+ "key": "master_volume",
+ "label": "Master Volume",
+ "type": "slider",
+ "min": 0,
+ "max": 100,
+ "default": null
+ },
+ {
+ "key": "sfx_volume",
+ "label": "Sound Effects Volume",
+ "type": "slider",
+ "min": 0,
+ "max": 100,
+ "default": null
+ },
+ {
+ "key": "dialogue_volume",
+ "label": "Dialogue Volume",
+ "type": "slider",
+ "min": 0,
+ "max": 100,
+ "default": null
+ },
+ {
+ "key": "music_volume",
+ "label": "Music Volume",
+ "type": "slider",
+ "min": 0,
+ "max": 100,
+ "default": null
+ },
+ {
+ "key": "lobby_music_volume",
+ "label": "Lobby Music Volume",
+ "type": "slider",
+ "min": 0,
+ "max": 100,
+ "default": null
+ },
+ {
+ "key": "voice_chat_volume",
+ "label": "Incoming Voice Chat Volume",
+ "type": "slider",
+ "min": 0,
+ "max": 100,
+ "default": null
+ }
+ ]
+ },
+ {
+ "id": "video",
+ "settings": [
+ {
+ "key": "display_mode",
+ "label": "Display Mode",
+ "options": [
+ "Full Screen",
+ "Windowed",
+ "Borderless Window"
+ ],
+ "type": "select",
+ "default": null
+ },
+ {
+ "key": "resolution",
+ "label": "Resolution",
+ "type": "text",
+ "default": null
+ },
+ {
+ "key": "fov",
+ "label": "Field of View",
+ "type": "slider",
+ "min": 70,
+ "max": 110,
+ "default": 90
+ },
+ {
+ "key": "fov_ability_scaling",
+ "label": "FOV Ability Scaling",
+ "type": "toggle",
+ "default": true
+ },
+ {
+ "key": "vsync",
+ "label": "V-Sync",
+ "options": [
+ "Disabled",
+ "Double Buffered",
+ "Triple Buffered",
+ "Adaptive"
+ ],
+ "type": "select",
+ "default": null
+ },
+ {
+ "key": "nvidia_reflex",
+ "label": "NVIDIA Reflex",
+ "options": [
+ "Disabled",
+ "Enabled",
+ "Enabled + Boost"
+ ],
+ "type": "select",
+ "default": null
+ },
+ {
+ "key": "adaptive_res",
+ "label": "Adaptive Resolution FPS Target",
+ "type": "number",
+ "min": 0,
+ "default": 0
+ },
+ {
+ "key": "anti_aliasing",
+ "label": "Anti-aliasing",
+ "options": [
+ "None",
+ "TSAA"
+ ],
+ "type": "select",
+ "default": null
+ },
+ {
+ "key": "texture_budget",
+ "label": "Texture Streaming Budget",
+ "options": [
+ "None",
+ "Very Low",
+ "Low",
+ "Medium",
+ "High",
+ "Very High",
+ "Insane"
+ ],
+ "type": "select",
+ "default": null
+ },
+ {
+ "key": "fps_max",
+ "label": "+fps_max (launch option)",
+ "type": "slider",
+ "min": 0,
+ "max": 300,
+ "default": null
+ }
+ ]
+ },
+ {
+ "id": "gameplay",
+ "settings": [
+ {
+ "key": "sprint_view_shake",
+ "label": "Sprint View Shake",
+ "options": [
+ "Normal",
+ "Minimal"
+ ],
+ "type": "select",
+ "default": "Normal"
+ },
+ {
+ "key": "aim_mode",
+ "label": "ADS (Toggle/Hold)",
+ "options": [
+ "Toggle",
+ "Hold"
+ ],
+ "type": "select",
+ "default": null
+ },
+ {
+ "key": "auto_sprint",
+ "label": "Auto-Sprint",
+ "type": "toggle",
+ "default": false
+ },
+ {
+ "key": "crosshair_color",
+ "label": "Crosshair Color",
+ "type": "text",
+ "default": null
+ }
+ ]
+ }
+ ],
+ "keybinds": [
+ {
+ "id": "move_forward",
+ "action": "Move Forward",
+ "default": "W"
+ },
+ {
+ "id": "move_back",
+ "action": "Move Back",
+ "default": "S"
+ },
+ {
+ "id": "move_left",
+ "action": "Move Left",
+ "default": "A"
+ },
+ {
+ "id": "move_right",
+ "action": "Move Right",
+ "default": "D"
+ },
+ {
+ "id": "jump",
+ "action": "Jump",
+ "default": "Space"
+ },
+ {
+ "id": "crouch_hold",
+ "action": "Crouch (Hold)",
+ "default": "Left Ctrl"
+ },
+ {
+ "id": "crouch_toggle",
+ "action": "Crouch (Toggle)",
+ "default": "C"
+ },
+ {
+ "id": "sprint",
+ "action": "Sprint",
+ "default": "Left Shift"
+ },
+ {
+ "id": "reload",
+ "action": "Reload",
+ "default": "R"
+ },
+ {
+ "id": "interact_pickup",
+ "action": "Interact / Pickup",
+ "default": "E"
+ },
+ {
+ "id": "tactical_ability",
+ "action": "Tactical Ability",
+ "default": "Q"
+ },
+ {
+ "id": "ultimate_ability",
+ "action": "Ultimate Ability",
+ "default": "Z"
+ },
+ {
+ "id": "equip_weapon_1",
+ "action": "Equip Weapon 1",
+ "default": "1"
+ },
+ {
+ "id": "equip_weapon_2",
+ "action": "Equip Weapon 2",
+ "default": "2"
+ },
+ {
+ "id": "holster_weapons",
+ "action": "Holster Weapons",
+ "default": "3"
+ },
+ {
+ "id": "equip_grenade",
+ "action": "Equip Grenade",
+ "default": "G"
+ },
+ {
+ "id": "melee",
+ "action": "Melee",
+ "default": "V"
+ },
+ {
+ "id": "fire_select",
+ "action": "Fire Select",
+ "default": "B"
+ },
+ {
+ "id": "inspect_weapon",
+ "action": "Inspect Weapon",
+ "default": "N"
+ },
+ {
+ "id": "ping",
+ "action": "Ping",
+ "default": "Middle Mouse"
+ },
+ {
+ "id": "inventory",
+ "action": "Inventory",
+ "default": "Tab"
+ },
+ {
+ "id": "map",
+ "action": "Map",
+ "default": "M"
+ },
+ {
+ "id": "use_health_item",
+ "action": "Use Health Item",
+ "default": "4",
+ "note": "verify (heal keys changed over seasons)"
+ }
+ ]
+ },
+ {
+ "id": "overwatch2",
+ "name": "Overwatch 2",
+ "publisher": "Blizzard Entertainment",
+ "yaw": 0.0066,
+ "yaw_note": "Degrees per count per 1 of 'Sensitivity'. Zoom sens (Widowmaker/Ana/Ashe) is a % of hip-fire ('Relative Aim Sensitivity While Zoomed').",
+ "sens_key": "sensitivity",
+ "config_file": "Documents\\Overwatch\\Settings\\Settings_v0.ini (graphics/audio INI); sensitivity and keybinds are synced to the Battle.net account.",
+ "sources": [
+ "https://senslab.pro/sensitivity",
+ "https://csdb.gg/sensitivity-converter/"
+ ],
+ "sections": [
+ {
+ "id": "mouse",
+ "settings": [
+ {
+ "key": "sensitivity",
+ "label": "Sensitivity",
+ "type": "slider",
+ "min": 0.01,
+ "max": 100,
+ "step": 0.01,
+ "default": 15,
+ "note": "Global, can be overridden per hero"
+ },
+ {
+ "key": "zoomed_rel",
+ "label": "Relative Aim Sensitivity While Zoomed",
+ "type": "slider",
+ "min": 0,
+ "max": 100,
+ "step": 0.01,
+ "default": 38,
+ "note": "Per scoped hero; 38 ~ focal-length match"
+ },
+ {
+ "key": "invert_look",
+ "label": "Invert Vertical Look",
+ "type": "toggle",
+ "default": false
+ }
+ ]
+ },
+ {
+ "id": "audio",
+ "settings": [
+ {
+ "key": "sfx_volume",
+ "label": "Sound Effects Volume",
+ "type": "slider",
+ "min": 0,
+ "max": 100,
+ "default": null
+ },
+ {
+ "key": "music_volume",
+ "label": "Music Volume",
+ "type": "slider",
+ "min": 0,
+ "max": 100,
+ "default": null
+ },
+ {
+ "key": "voice_volume",
+ "label": "Voice Volume",
+ "type": "slider",
+ "min": 0,
+ "max": 100,
+ "default": null
+ },
+ {
+ "key": "voice_chat_volume",
+ "label": "Voice Chat Volume",
+ "type": "slider",
+ "min": 0,
+ "max": 100,
+ "default": null
+ },
+ {
+ "key": "dolby_atmos",
+ "label": "Dolby Atmos for Headphones",
+ "type": "toggle",
+ "default": false
+ }
+ ]
+ },
+ {
+ "id": "video",
+ "settings": [
+ {
+ "key": "display_mode",
+ "label": "Display Mode",
+ "options": [
+ "Fullscreen",
+ "Windowed",
+ "Borderless Windowed"
+ ],
+ "type": "select",
+ "default": null
+ },
+ {
+ "key": "resolution",
+ "label": "Resolution",
+ "type": "text",
+ "default": null
+ },
+ {
+ "key": "fov",
+ "label": "Field of View",
+ "type": "slider",
+ "min": 80,
+ "max": 103,
+ "default": null,
+ "note": "Horizontal FOV"
+ },
+ {
+ "key": "frame_rate",
+ "label": "Frame Rate",
+ "options": [
+ "Display-Based",
+ "Custom"
+ ],
+ "type": "select",
+ "default": null
+ },
+ {
+ "key": "frame_rate_cap",
+ "label": "Frame Rate Cap",
+ "type": "slider",
+ "min": 30,
+ "max": 600,
+ "default": null
+ },
+ {
+ "key": "nvidia_reflex",
+ "label": "NVIDIA Reflex Low Latency",
+ "options": [
+ "Off",
+ "Enabled",
+ "Enabled + Boost"
+ ],
+ "type": "select",
+ "default": null
+ },
+ {
+ "key": "render_scale",
+ "label": "Render Scale",
+ "type": "slider",
+ "min": 50,
+ "max": 200,
+ "default": 100
+ },
+ {
+ "key": "upsampling",
+ "label": "High Quality Upsampling",
+ "options": [
+ "Default",
+ "AMD FSR 1.0",
+ "AMD FSR 2.2",
+ "NVIDIA DLSS",
+ "Intel XeSS"
+ ],
+ "type": "select",
+ "default": null
+ },
+ {
+ "key": "graphics_quality",
+ "label": "Graphics Quality",
+ "options": [
+ "Low",
+ "Medium",
+ "High",
+ "Ultra",
+ "Epic"
+ ],
+ "type": "select",
+ "default": null
+ },
+ {
+ "key": "vsync",
+ "label": "V-Sync",
+ "type": "toggle",
+ "default": false
+ },
+ {
+ "key": "reduce_buffering",
+ "label": "Reduce Buffering",
+ "type": "toggle",
+ "default": null
+ }
+ ]
+ },
+ {
+ "id": "gameplay",
+ "settings": [
+ {
+ "key": "kill_cam",
+ "label": "Kill Cam",
+ "type": "toggle",
+ "default": true
+ },
+ {
+ "key": "reticle",
+ "label": "Reticle Type",
+ "options": [
+ "Default",
+ "Circle",
+ "Crosshairs",
+ "Circle and Crosshairs",
+ "Dot"
+ ],
+ "type": "select",
+ "default": "Default"
+ },
+ {
+ "key": "high_precision_mouse",
+ "label": "Enable High Precision Mouse Input",
+ "type": "toggle",
+ "default": null
+ },
+ {
+ "key": "waypoint_opacity",
+ "label": "Waypoint Opacity",
+ "type": "number",
+ "default": null
+ }
+ ]
+ }
+ ],
+ "keybinds": [
+ {
+ "id": "move_forward",
+ "action": "Move Forward",
+ "default": "W"
+ },
+ {
+ "id": "move_back",
+ "action": "Move Back",
+ "default": "S"
+ },
+ {
+ "id": "move_left",
+ "action": "Move Left",
+ "default": "A"
+ },
+ {
+ "id": "move_right",
+ "action": "Move Right",
+ "default": "D"
+ },
+ {
+ "id": "primary_fire",
+ "action": "Primary Fire",
+ "default": "Left Mouse"
+ },
+ {
+ "id": "secondary_fire",
+ "action": "Secondary Fire",
+ "default": "Right Mouse"
+ },
+ {
+ "id": "ability_1",
+ "action": "Ability 1",
+ "default": "Left Shift"
+ },
+ {
+ "id": "ability_2",
+ "action": "Ability 2",
+ "default": "E"
+ },
+ {
+ "id": "ultimate_ability",
+ "action": "Ultimate Ability",
+ "default": "Q"
+ },
+ {
+ "id": "jump",
+ "action": "Jump",
+ "default": "Space"
+ },
+ {
+ "id": "crouch",
+ "action": "Crouch",
+ "default": "Left Ctrl"
+ },
+ {
+ "id": "reload",
+ "action": "Reload",
+ "default": "R"
+ },
+ {
+ "id": "quick_melee",
+ "action": "Quick Melee",
+ "default": "V"
+ },
+ {
+ "id": "interact",
+ "action": "Interact",
+ "default": "F"
+ },
+ {
+ "id": "weapon_1",
+ "action": "Weapon 1",
+ "default": "1"
+ },
+ {
+ "id": "weapon_2",
+ "action": "Weapon 2",
+ "default": "2"
+ },
+ {
+ "id": "next_previous_weapon",
+ "action": "Next / Previous Weapon",
+ "default": "Mouse Wheel"
+ },
+ {
+ "id": "communication_menu",
+ "action": "Communication Menu",
+ "default": "C",
+ "note": "verify"
+ },
+ {
+ "id": "ping",
+ "action": "Ping",
+ "default": "Middle Mouse",
+ "note": "verify"
+ },
+ {
+ "id": "hero_select",
+ "action": "Hero Select",
+ "default": "H"
+ },
+ {
+ "id": "scoreboard",
+ "action": "Scoreboard",
+ "default": "Tab"
+ }
+ ]
+ },
+ {
+ "id": "battlefield6",
+ "name": "Battlefield 6",
+ "publisher": "Electronic Arts / Battlefield Studios",
+ "yaw": null,
+ "yaw_note": "Non-linear: SensLab models hip-fire as 0.00173623 * sens + 0.00231498 deg/count; another converter stores slider / 1333.33 in the profile. Use a non-linear converter or measure; ADS also depends on Zoom Sensitivity Coefficient and Uniform Infantry Aiming.",
+ "sens_key": null,
+ "config_file": "Documents\\Battlefield 6\\settings\\<steam|epic|ea>\\PROFSAVE_profile (plain key-value text, e.g. GstInput.MouseSensitivity)",
+ "sources": [
+ "https://senslab.pro/sensitivity",
+ "https://github.com/swiiftex/Source2AllSensitivityConverter/pull/5",
+ "https://www.shacknews.com/article/145381/battlefield-6-keybindings-and-controls",
+ "https://help.ea.com/en/articles/battlefield/battlefield-6/pc-and-controller-settings-guide/",
+ "https://www.dexerto.com/wikis/battlefield-6/best-mouse-and-keyboard-settings",
+ "https://steamcommunity.com/app/2807960/discussions/0/681860127366828822/"
+ ],
+ "sections": [
+ {
+ "id": "mouse",
+ "settings": [
+ {
+ "key": "infantry_mouse_sens",
+ "label": "Infantry Mouse Aim Sensitivity",
+ "type": "slider",
+ "min": 0,
+ "max": 100,
+ "step": 1,
+ "default": null,
+ "note": "PROFSAVE: GstInput.MouseSensitivity; slider moves in whole numbers"
+ },
+ {
+ "key": "uniform_infantry_aiming",
+ "label": "Uniform Infantry Aiming",
+ "type": "toggle",
+ "default": true,
+ "note": "Toggle; scales ADS by FOV"
+ },
+ {
+ "key": "zoom_coeff",
+ "label": "Zoom Sensitivity Coefficient",
+ "type": "slider",
+ "min": 0,
+ "max": 200,
+ "step": 1,
+ "default": 178,
+ "note": "Per guides 178 is default; range unverified"
+ },
+ {
+ "key": "zoom_aim_sens",
+ "label": "Zoom Aim Sensitivity (per scope)",
+ "type": "slider",
+ "min": 0,
+ "max": 200,
+ "step": 1,
+ "default": 100,
+ "note": "Per-magnification multipliers"
+ },
+ {
+ "key": "vehicle_mouse_sens",
+ "label": "Vehicle Mouse Aim Sensitivity",
+ "type": "slider",
+ "min": 0,
+ "max": 100,
+ "step": 1,
+ "default": null
+ },
+ {
+ "key": "raw_input",
+ "label": "Mouse Raw Input",
+ "type": "toggle",
+ "default": null,
+ "note": "Toggle"
+ }
+ ]
+ },
+ {
+ "id": "audio",
+ "settings": [
+ {
+ "key": "master_volume",
+ "label": "Master Volume",
+ "type": "slider",
+ "min": 0,
+ "max": 100,
+ "default": null
+ },
+ {
+ "key": "music_volume",
+ "label": "Music Volume",
+ "type": "slider",
+ "min": 0,
+ "max": 100,
+ "default": null
+ },
+ {
+ "key": "sfx_volume",
+ "label": "Sound Effects Volume",
+ "type": "slider",
+ "min": 0,
+ "max": 100,
+ "default": null
+ },
+ {
+ "key": "voice_chat_volume",
+ "label": "Voice Chat Volume",
+ "type": "slider",
+ "min": 0,
+ "max": 100,
+ "default": null
+ },
+ {
+ "key": "audio_mix",
+ "label": "Audio Mix",
+ "type": "number",
+ "default": null,
+ "note": "Mix presets exist; labels unverified"
+ }
+ ]
+ },
+ {
+ "id": "video",
+ "settings": [
+ {
+ "key": "display_mode",
+ "label": "Display Mode",
+ "options": [
+ "Fullscreen",
+ "Borderless",
+ "Windowed"
+ ],
+ "type": "select",
+ "default": null
+ },
+ {
+ "key": "resolution",
+ "label": "Resolution",
+ "type": "text",
+ "default": null
+ },
+ {
+ "key": "fov",
+ "label": "Field of View",
+ "type": "number",
+ "default": null,
+ "note": "Players typically use 100-110; range unverified"
+ },
+ {
+ "key": "ads_fov",
+ "label": "ADS Field of View",
+ "type": "toggle",
+ "default": null
+ },
+ {
+ "key": "frame_rate_limit",
+ "label": "Frame Rate Limit",
+ "type": "number",
+ "min": 30,
+ "default": null
+ },
+ {
+ "key": "nvidia_reflex",
+ "label": "NVIDIA Reflex Low Latency",
+ "options": [
+ "Off",
+ "On",
+ "On + Boost"
+ ],
+ "type": "select",
+ "default": null
+ },
+ {
+ "key": "upscaling",
+ "label": "Upscaling Technique",
+ "options": [
+ "Off",
+ "NVIDIA DLSS",
+ "AMD FSR",
+ "Intel XeSS"
+ ],
+ "type": "select",
+ "default": null
+ },
+ {
+ "key": "frame_generation",
+ "label": "Frame Generation",
+ "type": "toggle",
+ "default": false
+ },
+ {
+ "key": "vsync",
+ "label": "VSync",
+ "type": "toggle",
+ "default": false
+ },
+ {
+ "key": "graphics_preset",
+ "label": "Graphics Quality Preset",
+ "options": [
+ "Low",
+ "Medium",
+ "High",
+ "Ultra",
+ "Custom"
+ ],
+ "type": "select",
+ "default": null
+ }
+ ]
+ },
+ {
+ "id": "gameplay",
+ "settings": [
+ {
+ "key": "zoom_mode",
+ "label": "Infantry Weapon Zoom",
+ "options": [
+ "Hold",
+ "Toggle"
+ ],
+ "type": "select",
+ "default": "Hold"
+ },
+ {
+ "key": "steady_scope",
+ "label": "Steady Scope",
+ "options": [
+ "Hold",
+ "Toggle"
+ ],
+ "type": "select",
+ "default": "Hold"
+ },
+ {
+ "key": "flick_look",
+ "label": "Soldier Flick Look Mode",
+ "options": [
+ "Off",
+ "Always"
+ ],
+ "type": "select",
+ "default": null
+ },
+ {
+ "key": "auto_sprint",
+ "label": "Auto Sprint",
+ "type": "toggle",
+ "default": null
+ }
+ ]
+ }
+ ],
+ "keybinds": [
+ {
+ "id": "move_forward",
+ "action": "Move Forward",
+ "default": "W"
+ },
+ {
+ "id": "move_back",
+ "action": "Move Back",
+ "default": "S"
+ },
+ {
+ "id": "move_left",
+ "action": "Move Left",
+ "default": "A"
+ },
+ {
+ "id": "move_right",
+ "action": "Move Right",
+ "default": "D"
+ },
+ {
+ "id": "jump_vault",
+ "action": "Jump / Vault",
+ "default": "Space"
+ },
+ {
+ "id": "sprint",
+ "action": "Sprint",
+ "default": "Left Shift"
+ },
+ {
+ "id": "crouch_hold",
+ "action": "Crouch (Hold)",
+ "default": "Left Ctrl"
+ },
+ {
+ "id": "crouch_toggle",
+ "action": "Crouch (Toggle)",
+ "default": "C"
+ },
+ {
+ "id": "prone",
+ "action": "Prone",
+ "default": "Z"
+ },
+ {
+ "id": "reload",
+ "action": "Reload",
+ "default": "R"
+ },
+ {
+ "id": "interact",
+ "action": "Interact",
+ "default": "E"
+ },
+ {
+ "id": "melee",
+ "action": "Melee",
+ "default": "F"
+ },
+ {
+ "id": "primary_weapon",
+ "action": "Primary Weapon",
+ "default": "1"
+ },
+ {
+ "id": "secondary_weapon",
+ "action": "Secondary Weapon",
+ "default": "2"
+ },
+ {
+ "id": "gadget_one",
+ "action": "Gadget One",
+ "default": "3"
+ },
+ {
+ "id": "gadget_two",
+ "action": "Gadget Two",
+ "default": "4"
+ },
+ {
+ "id": "class_ability_call_in",
+ "action": "Class Ability / Call-in",
+ "default": "6"
+ },
+ {
+ "id": "grenade",
+ "action": "Grenade",
+ "default": "G"
+ },
+ {
+ "id": "ping",
+ "action": "Ping",
+ "default": "Q"
+ },
+ {
+ "id": "commo_rose",
+ "action": "Commo Rose",
+ "default": "Middle Mouse"
+ },
+ {
+ "id": "toggle_laser_flashlight",
+ "action": "Toggle Laser / Flashlight",
+ "default": "T"
+ },
+ {
+ "id": "steady_scope",
+ "action": "Steady Scope",
+ "default": "Left Shift"
+ },
+ {
+ "id": "big_map",
+ "action": "Big Map",
+ "default": "M"
+ },
+ {
+ "id": "scoreboard_inventory",
+ "action": "Scoreboard / Inventory",
+ "default": "Tab"
+ },
+ {
+ "id": "lean_peek",
+ "action": "Lean / Peek",
+ "default": ""
+ }
+ ]
+ },
+ {
+ "id": "pubg",
+ "name": "PUBG: Battlegrounds",
+ "publisher": "Krafton",
+ "yaw": null,
+ "yaw_note": "Menu slider (1-100) is exponential; the game applies the linear LastConvertedSensitivity from GameUserSettings.ini (0.02 at slider 50). Linear yaw only valid on LastConvertedSensitivity; csdb lists 0.002222 but scale is ambiguous, so null.",
+ "sens_key": null,
+ "config_file": "%LOCALAPPDATA%\\TslGame\\Saved\\Config\\WindowsNoEditor\\GameUserSettings.ini (UE INI; sens entries hold Sensitivity + LastConvertedSensitivity per mode)",
+ "sources": [
+ "https://csdb.gg/sensitivity-converter/",
+ "https://mouse-sensitivity.com/forums/topic/607-pubg-battlegrounds-playerunknowns-battlegrounds/page/28",
+ "https://github.com/swiiftex/Source2AllSensitivityConverter/pull/5"
+ ],
+ "sections": [
+ {
+ "id": "mouse",
+ "settings": [
+ {
+ "key": "general_sens",
+ "label": "General Sensitivity",
+ "type": "slider",
+ "min": 1,
+ "max": 100,
+ "step": 1,
+ "default": 50,
+ "note": "Hip-fire (TPP/FPP); exponential"
+ },
+ {
+ "key": "vertical_mult",
+ "label": "Vertical Sensitivity Multiplier",
+ "type": "slider",
+ "min": 0.5,
+ "max": 2.0,
+ "step": 0.01,
+ "default": 1.0
+ },
+ {
+ "key": "targeting_sens",
+ "label": "Targeting Sensitivity",
+ "type": "slider",
+ "min": 1,
+ "max": 100,
+ "step": 1,
+ "default": 50,
+ "note": "ADS (iron sights/red dot)"
+ },
+ {
+ "key": "scoping_sens",
+ "label": "Scoping Sensitivity",
+ "type": "slider",
+ "min": 1,
+ "max": 100,
+ "step": 1,
+ "default": 50,
+ "note": "Per scope: 2x, 3x, 4x, 6x, 8x, 15x each 1-100"
+ },
+ {
+ "key": "vehicle_sens",
+ "label": "Vehicle Driver Sensitivity",
+ "type": "slider",
+ "min": 1,
+ "max": 100,
+ "step": 1,
+ "default": 50
+ }
+ ]
+ },
+ {
+ "id": "audio",
+ "settings": [
+ {
+ "key": "master_volume",
+ "label": "Master Volume",
+ "type": "slider",
+ "min": 0,
+ "max": 100,
+ "default": null
+ },
+ {
+ "key": "effects_volume",
+ "label": "Effects",
+ "type": "slider",
+ "min": 0,
+ "max": 100,
+ "default": null
+ },
+ {
+ "key": "ui_volume",
+ "label": "UI",
+ "type": "slider",
+ "min": 0,
+ "max": 100,
+ "default": null
+ },
+ {
+ "key": "lobby_music_volume",
+ "label": "Lobby Music",
+ "type": "slider",
+ "min": 0,
+ "max": 100,
+ "default": null
+ },
+ {
+ "key": "voice_volume",
+ "label": "Voice Chat Volume",
+ "type": "slider",
+ "min": 0,
+ "max": 100,
+ "default": null
+ }
+ ]
+ },
+ {
+ "id": "video",
+ "settings": [
+ {
+ "key": "display_mode",
+ "label": "Display Mode",
+ "options": [
+ "Fullscreen",
+ "Fullscreen (Windowed)",
+ "Windowed"
+ ],
+ "type": "select",
+ "default": null
+ },
+ {
+ "key": "resolution",
+ "label": "Resolution",
+ "type": "text",
+ "default": null
+ },
+ {
+ "key": "fpp_fov",
+ "label": "FPP Camera FOV",
+ "type": "slider",
+ "min": 80,
+ "max": 103,
+ "default": null
+ },
+ {
+ "key": "fps_cap",
+ "label": "FPS Cap",
+ "options": [
+ "Unlimited",
+ "Monitor Refresh Rate",
+ "Custom"
+ ],
+ "type": "select",
+ "default": null
+ },
+ {
+ "key": "render_scale",
+ "label": "Screen Scale",
+ "type": "slider",
+ "min": 70,
+ "max": 120,
+ "default": 100
+ },
+ {
+ "key": "anti_aliasing",
+ "label": "Anti-Aliasing",
+ "options": [
+ "Very Low",
+ "Low",
+ "Medium",
+ "High",
+ "Ultra"
+ ],
+ "type": "select",
+ "default": null
+ },
+ {
+ "key": "post_processing",
+ "label": "Post-Processing",
+ "options": [
+ "Very Low",
+ "Low",
+ "Medium",
+ "High",
+ "Ultra"
+ ],
+ "type": "select",
+ "default": null
+ },
+ {
+ "key": "textures",
+ "label": "Textures",
+ "options": [
+ "Very Low",
+ "Low",
+ "Medium",
+ "High",
+ "Ultra"
+ ],
+ "type": "select",
+ "default": null
+ },
+ {
+ "key": "view_distance",
+ "label": "View Distance",
+ "options": [
+ "Very Low",
+ "Low",
+ "Medium",
+ "High",
+ "Ultra"
+ ],
+ "type": "select",
+ "default": null
+ },
+ {
+ "key": "vsync",
+ "label": "V-Sync",
+ "type": "toggle",
+ "default": false
+ }
+ ]
+ },
+ {
+ "id": "gameplay",
+ "settings": [
+ {
+ "key": "aim_mode",
+ "label": "Aim / ADS behavior",
+ "options": [
+ "Hold",
+ "Toggle",
+ "Hold & Toggle"
+ ],
+ "type": "select",
+ "default": null
+ },
+ {
+ "key": "auto_reload",
+ "label": "Auto Reload",
+ "type": "toggle",
+ "default": null
+ },
+ {
+ "key": "auto_equip_attachments",
+ "label": "Auto Equip Attachments",
+ "type": "toggle",
+ "default": null
+ },
+ {
+ "key": "first_person_perspective",
+ "label": "Default perspective",
+ "options": [
+ "TPP",
+ "FPP"
+ ],
+ "type": "select",
+ "default": null
+ }
+ ]
+ }
+ ],
+ "keybinds": [
+ {
+ "id": "move_forward",
+ "action": "Move Forward",
+ "default": "W"
+ },
+ {
+ "id": "move_back",
+ "action": "Move Back",
+ "default": "S"
+ },
+ {
+ "id": "move_left",
+ "action": "Move Left",
+ "default": "A"
+ },
+ {
+ "id": "move_right",
+ "action": "Move Right",
+ "default": "D"
+ },
+ {
+ "id": "jump_vault",
+ "action": "Jump / Vault",
+ "default": "Space"
+ },
+ {
+ "id": "crouch",
+ "action": "Crouch",
+ "default": "C"
+ },
+ {
+ "id": "prone",
+ "action": "Prone",
+ "default": "Z"
+ },
+ {
+ "id": "sprint",
+ "action": "Sprint",
+ "default": "Left Shift"
+ },
+ {
+ "id": "walk",
+ "action": "Walk",
+ "default": "Left Ctrl"
+ },
+ {
+ "id": "reload",
+ "action": "Reload",
+ "default": "R"
+ },
+ {
+ "id": "interact",
+ "action": "Interact",
+ "default": "F"
+ },
+ {
+ "id": "peek_left",
+ "action": "Peek Left",
+ "default": "Q"
+ },
+ {
+ "id": "peek_right",
+ "action": "Peek Right",
+ "default": "E"
+ },
+ {
+ "id": "free_look",
+ "action": "Free Look",
+ "default": "Left Alt"
+ },
+ {
+ "id": "primary_weapon_1",
+ "action": "Primary Weapon 1",
+ "default": "1"
+ },
+ {
+ "id": "primary_weapon_2",
+ "action": "Primary Weapon 2",
+ "default": "2"
+ },
+ {
+ "id": "sidearm",
+ "action": "Sidearm",
+ "default": "3"
+ },
+ {
+ "id": "melee_weapon",
+ "action": "Melee Weapon",
+ "default": "4"
+ },
+ {
+ "id": "throwables",
+ "action": "Throwables",
+ "default": "5"
+ },
+ {
+ "id": "change_fire_mode",
+ "action": "Change Fire Mode",
+ "default": "B"
+ },
+ {
+ "id": "toggle_fpp_tpp",
+ "action": "Toggle FPP/TPP",
+ "default": "V"
+ },
+ {
+ "id": "inventory",
+ "action": "Inventory",
+ "default": "Tab"
+ },
+ {
+ "id": "map",
+ "action": "Map",
+ "default": "M"
+ },
+ {
+ "id": "zeroing_up",
+ "action": "Zeroing Up",
+ "default": "Page Up"
+ },
+ {
+ "id": "zeroing_down",
+ "action": "Zeroing Down",
+ "default": "Page Down"
+ }
+ ]
+ },
+ {
+ "id": "marvel_rivals",
+ "name": "Marvel Rivals",
+ "publisher": "NetEase Games",
+ "yaw": 0.0175,
+ "yaw_note": "Degrees per count per 1.0 of 'Mouse Horizontal Sensitivity' (CS2 x 1.257; Overwatch x 0.375 ~ 0.0066/0.0176). Third-person camera; per-hero overrides exist. One converter (csdb) lists 0.022, judged wrong.",
+ "sens_key": "mouse_h_sens",
+ "config_file": "%LOCALAPPDATA%\\Marvel\\Saved\\Config\\Windows\\GameUserSettings.ini (UE INI; may be read-only)",
+ "sources": [
+ "https://senslab.pro/sensitivity",
+ "https://github.com/swiiftex/Source2AllSensitivityConverter/pull/5",
+ "https://esports.gg/guides/marvel-rivals/how-to-convert-your-overwatch-sensitivity-to-marvel-rivals",
+ "https://prosettings.net/guides/marvel-rivals-options/",
+ "https://steamcommunity.com/app/2767030/discussions/0/591759268792825779"
+ ],
+ "sections": [
+ {
+ "id": "mouse",
+ "settings": [
+ {
+ "key": "mouse_h_sens",
+ "label": "Mouse Horizontal Sensitivity",
+ "type": "number",
+ "step": 0.01,
+ "default": null,
+ "note": "Keyboard > Combat; typical 2-4"
+ },
+ {
+ "key": "mouse_v_sens",
+ "label": "Mouse Vertical Sensitivity",
+ "type": "number",
+ "step": 0.01,
+ "default": null
+ },
+ {
+ "key": "hero_override",
+ "label": "Hero-specific sensitivity (All Heroes > hero)",
+ "type": "number",
+ "default": null,
+ "note": "Per-hero scope/zoom multipliers on some heroes"
+ },
+ {
+ "key": "invert_v",
+ "label": "Invert Vertical Look",
+ "type": "toggle",
+ "default": false
+ }
+ ]
+ },
+ {
+ "id": "audio",
+ "settings": [
+ {
+ "key": "master_volume",
+ "label": "Master Volume",
+ "type": "slider",
+ "min": 0,
+ "max": 100,
+ "default": null
+ },
+ {
+ "key": "music_volume",
+ "label": "Music Volume",
+ "type": "slider",
+ "min": 0,
+ "max": 100,
+ "default": null
+ },
+ {
+ "key": "sfx_volume",
+ "label": "Sound Effects Volume",
+ "type": "slider",
+ "min": 0,
+ "max": 100,
+ "default": null
+ },
+ {
+ "key": "voice_volume",
+ "label": "Voice Volume",
+ "type": "slider",
+ "min": 0,
+ "max": 100,
+ "default": null
+ },
+ {
+ "key": "voice_chat_volume",
+ "label": "Voice Chat Volume",
+ "type": "slider",
+ "min": 0,
+ "max": 100,
+ "default": null
+ }
+ ]
+ },
+ {
+ "id": "video",
+ "settings": [
+ {
+ "key": "display_mode",
+ "label": "Display Mode",
+ "options": [
+ "Fullscreen",
+ "Borderless",
+ "Windowed"
+ ],
+ "type": "select",
+ "default": null
+ },
+ {
+ "key": "resolution",
+ "label": "Aspect Ratio/Resolution",
+ "type": "text",
+ "default": null
+ },
+ {
+ "key": "upscaler",
+ "label": "Anti-Aliasing and Super Resolution Type",
+ "options": [
+ "Off",
+ "TAAU",
+ "NVIDIA DLSS",
+ "AMD FSR",
+ "Intel XeSS"
+ ],
+ "type": "select",
+ "default": null
+ },
+ {
+ "key": "super_res_mode",
+ "label": "Super Resolution Mode",
+ "options": [
+ "Ultra Performance",
+ "Performance",
+ "Balanced",
+ "Quality",
+ "Ultra Quality"
+ ],
+ "type": "select",
+ "default": null
+ },
+ {
+ "key": "frame_gen",
+ "label": "Frame Generation",
+ "type": "toggle",
+ "default": false
+ },
+ {
+ "key": "low_latency",
+ "label": "Low Latency Mode",
+ "options": [
+ "Off",
+ "On",
+ "On + Boost"
+ ],
+ "type": "select",
+ "default": null,
+ "note": "NVIDIA Reflex; AMD Anti-Lag 2 on AMD"
+ },
+ {
+ "key": "vsync",
+ "label": "V-Sync",
+ "type": "toggle",
+ "default": false
+ },
+ {
+ "key": "limit_fps",
+ "label": "Limit FPS",
+ "type": "toggle",
+ "default": null
+ },
+ {
+ "key": "fps_cap",
+ "label": "FPS Cap",
+ "type": "number",
+ "min": 30,
+ "default": null
+ },
+ {
+ "key": "graphics_quality",
+ "label": "Graphics Quality",
+ "options": [
+ "Low",
+ "Medium",
+ "High",
+ "Ultra",
+ "Custom"
+ ],
+ "type": "select",
+ "default": null
+ }
+ ]
+ },
+ {
+ "id": "gameplay",
+ "settings": [
+ {
+ "key": "reticle_type",
+ "label": "Reticle Type",
+ "type": "text",
+ "default": null
+ },
+ {
+ "key": "allied_health_bars",
+ "label": "Allied Health Bars",
+ "type": "text",
+ "default": null
+ },
+ {
+ "key": "hud_widget_size",
+ "label": "HUD Widget Size",
+ "type": "number",
+ "default": null
+ }
+ ]
+ }
+ ],
+ "keybinds": [
+ {
+ "id": "move_forward",
+ "action": "Move Forward",
+ "default": "W"
+ },
+ {
+ "id": "move_back",
+ "action": "Move Back",
+ "default": "S"
+ },
+ {
+ "id": "move_left",
+ "action": "Move Left",
+ "default": "A"
+ },
+ {
+ "id": "move_right",
+ "action": "Move Right",
+ "default": "D"
+ },
+ {
+ "id": "normal_attack",
+ "action": "Normal Attack",
+ "default": "Left Mouse"
+ },
+ {
+ "id": "secondary_attack_ability",
+ "action": "Secondary Attack / Ability",
+ "default": "Right Mouse"
+ },
+ {
+ "id": "ability_shift",
+ "action": "Ability (Shift)",
+ "default": "Left Shift",
+ "note": "verify"
+ },
+ {
+ "id": "ability_e",
+ "action": "Ability (E)",
+ "default": "E",
+ "note": "verify"
+ },
+ {
+ "id": "ability_f",
+ "action": "Ability (F)",
+ "default": "F",
+ "note": "verify"
+ },
+ {
+ "id": "ultimate",
+ "action": "Ultimate",
+ "default": "Q",
+ "note": "verify"
+ },
+ {
+ "id": "melee",
+ "action": "Melee",
+ "default": "V",
+ "note": "verify"
+ },
+ {
+ "id": "jump",
+ "action": "Jump",
+ "default": "Space"
+ },
+ {
+ "id": "reload",
+ "action": "Reload",
+ "default": "R"
+ },
+ {
+ "id": "team_up_ability",
+ "action": "Team-Up Ability",
+ "default": ""
+ },
+ {
+ "id": "scoreboard",
+ "action": "Scoreboard",
+ "default": "Tab"
+ }
+ ]
+ },
+ {
+ "id": "the_finals",
+ "name": "The Finals",
+ "publisher": "Embark Studios",
+ "yaw": 0.001,
+ "yaw_note": "Degrees per count per 1 of the menu sensitivity (CS2 sens x 22; OW2 sens x 6.6). Source: SensLab; one older SensLab page still shows 0.0066 (outdated).",
+ "sens_key": "mouse_sens",
+ "config_file": "%LOCALAPPDATA%\\Discovery\\Saved\\Config\\WindowsClient\\GameUserSettings.ini (UE INI; 'Discovery' = internal project name; unverified by official source)",
+ "sources": [
+ "https://senslab.pro/guides/the-finals-sensitivity",
+ "https://senslab.pro/sensitivity",
+ "https://prosettings.net/guides/the-finals-options/",
+ "https://www.shacknews.com/article/138166/the-finals-keybindings-controls",
+ "https://immortalboost.com/blog/the-finals/boost-game-fps/"
+ ],
+ "sections": [
+ {
+ "id": "mouse",
+ "settings": [
+ {
+ "key": "mouse_sens",
+ "label": "Mouse Look Sensitivity",
+ "type": "number",
+ "default": null,
+ "note": "Typical 20-45"
+ },
+ {
+ "key": "zoom_mult",
+ "label": "Zoom Sensitivity Multiplier",
+ "type": "number",
+ "max": 100,
+ "step": 1,
+ "default": 100,
+ "note": "% of hip-fire when aiming"
+ },
+ {
+ "key": "focal_scaling",
+ "label": "Mouse Focal Length Sensitivity Scaling",
+ "type": "toggle",
+ "default": true,
+ "note": "Toggle; scales ADS by zoom"
+ }
+ ]
+ },
+ {
+ "id": "audio",
+ "settings": [
+ {
+ "key": "master_volume",
+ "label": "Master Volume",
+ "type": "slider",
+ "min": 0,
+ "max": 100,
+ "default": null
+ },
+ {
+ "key": "music_volume",
+ "label": "Music Volume",
+ "type": "slider",
+ "min": 0,
+ "max": 100,
+ "default": null
+ },
+ {
+ "key": "sfx_volume",
+ "label": "SFX Volume",
+ "type": "slider",
+ "min": 0,
+ "max": 100,
+ "default": null
+ },
+ {
+ "key": "dialogue_volume",
+ "label": "Dialogue Volume",
+ "type": "slider",
+ "min": 0,
+ "max": 100,
+ "default": null
+ },
+ {
+ "key": "output_mode",
+ "label": "Output Mode",
+ "type": "number",
+ "default": null,
+ "note": "Stereo/Headphones or system default"
+ },
+ {
+ "key": "night_mode",
+ "label": "Night Mode",
+ "type": "toggle",
+ "default": false
+ }
+ ]
+ },
+ {
+ "id": "video",
+ "settings": [
+ {
+ "key": "window_mode",
+ "label": "Window Mode",
+ "options": [
+ "Fullscreen",
+ "Windowed Fullscreen",
+ "Windowed"
+ ],
+ "type": "select",
+ "default": null
+ },
+ {
+ "key": "resolution",
+ "label": "Resolution",
+ "type": "text",
+ "default": null
+ },
+ {
+ "key": "fov",
+ "label": "Field of View",
+ "type": "number",
+ "default": null,
+ "note": "Pros ~71-100+; range unverified"
+ },
+ {
+ "key": "nvidia_reflex",
+ "label": "NVIDIA Reflex Low Latency",
+ "options": [
+ "Off",
+ "On",
+ "On + Boost"
+ ],
+ "type": "select",
+ "default": null
+ },
+ {
+ "key": "scaling_method",
+ "label": "Resolution Scaling Method",
+ "options": [
+ "TAAU",
+ "TSR",
+ "NVIDIA DLSS",
+ "AMD FSR",
+ "Intel XeSS"
+ ],
+ "type": "select",
+ "default": null
+ },
+ {
+ "key": "resolution_scaling",
+ "label": "Resolution Scaling",
+ "type": "number",
+ "max": 100,
+ "default": 100
+ },
+ {
+ "key": "vsync",
+ "label": "V-Sync",
+ "type": "toggle",
+ "default": false
+ },
+ {
+ "key": "motion_blur",
+ "label": "Motion Blur",
+ "type": "toggle",
+ "default": null
+ },
+ {
+ "key": "rtxgi",
+ "label": "NVIDIA RTX Global Illumination",
+ "options": [
+ "Static",
+ "Dynamic"
+ ],
+ "type": "select",
+ "default": null
+ },
+ {
+ "key": "view_distance",
+ "label": "View Distance",
+ "options": [
+ "Low",
+ "Medium",
+ "High",
+ "Epic"
+ ],
+ "type": "select",
+ "default": null
+ }
+ ]
+ },
+ {
+ "id": "gameplay",
+ "settings": [
+ {
+ "key": "lens_distortion",
+ "label": "Lens Distortion",
+ "type": "toggle",
+ "default": null
+ },
+ {
+ "key": "crosshair",
+ "label": "Crosshair",
+ "type": "text",
+ "default": null
+ },
+ {
+ "key": "colorblind",
+ "label": "Colorblind Mode",
+ "type": "text",
+ "default": null
+ }
+ ]
+ }
+ ],
+ "keybinds": [
+ {
+ "id": "move_forward",
+ "action": "Move Forward",
+ "default": "W"
+ },
+ {
+ "id": "move_back",
+ "action": "Move Back",
+ "default": "S"
+ },
+ {
+ "id": "move_left",
+ "action": "Move Left",
+ "default": "A"
+ },
+ {
+ "id": "move_right",
+ "action": "Move Right",
+ "default": "D"
+ },
+ {
+ "id": "jump",
+ "action": "Jump",
+ "default": "Space"
+ },
+ {
+ "id": "crouch",
+ "action": "Crouch",
+ "default": "Left Ctrl"
+ },
+ {
+ "id": "sprint",
+ "action": "Sprint",
+ "default": "Left Shift"
+ },
+ {
+ "id": "reload",
+ "action": "Reload",
+ "default": "R"
+ },
+ {
+ "id": "interact",
+ "action": "Interact",
+ "default": "E"
+ },
+ {
+ "id": "specialization",
+ "action": "Specialization",
+ "default": "Q"
+ },
+ {
+ "id": "quick_melee",
+ "action": "Quick Melee",
+ "default": "V"
+ },
+ {
+ "id": "weapon",
+ "action": "Weapon",
+ "default": "1"
+ },
+ {
+ "id": "gadget_1",
+ "action": "Gadget 1",
+ "default": "2"
+ },
+ {
+ "id": "gadget_2",
+ "action": "Gadget 2",
+ "default": "3"
+ },
+ {
+ "id": "gadget_3",
+ "action": "Gadget 3",
+ "default": "4"
+ },
+ {
+ "id": "fire",
+ "action": "Fire",
+ "default": "Left Mouse"
+ },
+ {
+ "id": "aim",
+ "action": "Aim",
+ "default": "Right Mouse"
+ },
+ {
+ "id": "ping",
+ "action": "Ping",
+ "default": "Middle Mouse",
+ "note": "verify"
+ },
+ {
+ "id": "scoreboard",
+ "action": "Scoreboard",
+ "default": "Tab"
+ }
+ ]
+ },
+ {
+ "id": "tarkov",
+ "name": "Escape from Tarkov",
+ "publisher": "Battlestate Games",
+ "yaw": 0.125,
+ "yaw_note": "Degrees per count per 1.0 of 'Mouse sensitivity' (CS2 x 0.176). Third-party value; turn speed is further reduced in-game by gear weight/ergonomics.",
+ "sens_key": "mouse_sens",
+ "config_file": "%APPDATA%\\Battlestate Games\\Escape from Tarkov\\Settings\\ (Control.ini, Game.ini, Graphics.ini, Sound.ini; JSON content despite .ini extension; older installs in Documents\\Escape from Tarkov)",
+ "sources": [
+ "https://csdb.gg/sensitivity-converter/",
+ "https://community.skin.club/pro/tools/mouse-sensitivity-converter/cs2-to-escape-from-tarkov",
+ "https://www.mouse-sensitivity.com/forums/topic/7875-escape-from-tarkov-settings-file-location-update/",
+ "https://www.gamespot.com/articles/escape-from-tarkov-guide-for-controls-and-hotkeys/1100-6472601/"
+ ],
+ "sections": [
+ {
+ "id": "mouse",
+ "settings": [
+ {
+ "key": "mouse_sens",
+ "label": "Mouse sensitivity",
+ "type": "number",
+ "min": 0.1,
+ "step": 0.01,
+ "default": null,
+ "note": "Hip-fire"
+ },
+ {
+ "key": "aiming_sens",
+ "label": "Mouse aiming sensitivity",
+ "type": "number",
+ "min": 0.1,
+ "step": 0.01,
+ "default": null,
+ "note": "ADS"
+ },
+ {
+ "key": "mouse_accel",
+ "label": "Mouse acceleration",
+ "type": "toggle",
+ "default": false
+ }
+ ]
+ },
+ {
+ "id": "audio",
+ "settings": [
+ {
+ "key": "overall_volume",
+ "label": "Overall volume",
+ "type": "slider",
+ "min": 0,
+ "max": 100,
+ "default": null
+ },
+ {
+ "key": "interface_volume",
+ "label": "Interface volume",
+ "type": "slider",
+ "min": 0,
+ "max": 100,
+ "default": null
+ },
+ {
+ "key": "chat_volume",
+ "label": "Chat volume",
+ "type": "slider",
+ "min": 0,
+ "max": 100,
+ "default": null
+ },
+ {
+ "key": "music_volume",
+ "label": "Music volume",
+ "type": "slider",
+ "min": 0,
+ "max": 100,
+ "default": null
+ }
+ ]
+ },
+ {
+ "id": "video",
+ "settings": [
+ {
+ "key": "screen_mode",
+ "label": "Screen mode",
+ "options": [
+ "Fullscreen",
+ "Borderless",
+ "Windowed"
+ ],
+ "type": "select",
+ "default": null
+ },
+ {
+ "key": "resolution",
+ "label": "Screen resolution",
+ "type": "text",
+ "default": null
+ },
+ {
+ "key": "fov",
+ "label": "FOV",
+ "type": "slider",
+ "min": 50,
+ "max": 75,
+ "default": null
+ },
+ {
+ "key": "game_fps_limit",
+ "label": "Game max FPS",
+ "type": "number",
+ "min": 60,
+ "default": null
+ },
+ {
+ "key": "overall_quality",
+ "label": "Overall graphics quality",
+ "options": [
+ "Low",
+ "Medium",
+ "High",
+ "Ultra",
+ "Custom"
+ ],
+ "type": "select",
+ "default": null
+ },
+ {
+ "key": "texture_quality",
+ "label": "Texture quality",
+ "options": [
+ "Low",
+ "Medium",
+ "High"
+ ],
+ "type": "select",
+ "default": null
+ },
+ {
+ "key": "anti_aliasing",
+ "label": "Anti-aliasing",
+ "options": [
+ "Off",
+ "FXAA",
+ "TAA",
+ "TAA High"
+ ],
+ "type": "select",
+ "default": null
+ },
+ {
+ "key": "upscaling",
+ "label": "NVIDIA DLSS / AMD FSR",
+ "options": [
+ "Off",
+ "DLSS",
+ "FSR"
+ ],
+ "type": "select",
+ "default": null
+ },
+ {
+ "key": "nvidia_reflex",
+ "label": "NVIDIA Reflex Low Latency",
+ "options": [
+ "Off",
+ "On",
+ "On + Boost"
+ ],
+ "type": "select",
+ "default": null
+ },
+ {
+ "key": "vsync",
+ "label": "VSync",
+ "type": "toggle",
+ "default": false
+ }
+ ]
+ },
+ {
+ "id": "gameplay",
+ "settings": [
+ {
+ "key": "auto_empty_mags",
+ "label": "Auto-empty mags in raid",
+ "type": "toggle",
+ "default": null
+ },
+ {
+ "key": "head_bobbing",
+ "label": "Head bobbing",
+ "type": "number",
+ "default": null
+ },
+ {
+ "key": "quick_slot_use",
+ "label": "Quick slot usage behavior",
+ "type": "text",
+ "default": null
+ }
+ ]
+ }
+ ],
+ "keybinds": [
+ {
+ "id": "move_forward",
+ "action": "Move Forward",
+ "default": "W"
+ },
+ {
+ "id": "move_back",
+ "action": "Move Back",
+ "default": "S"
+ },
+ {
+ "id": "move_left",
+ "action": "Move Left",
+ "default": "A"
+ },
+ {
+ "id": "move_right",
+ "action": "Move Right",
+ "default": "D"
+ },
+ {
+ "id": "jump",
+ "action": "Jump",
+ "default": "Space"
+ },
+ {
+ "id": "crouch",
+ "action": "Crouch",
+ "default": "C"
+ },
+ {
+ "id": "prone",
+ "action": "Prone",
+ "default": "X"
+ },
+ {
+ "id": "sprint",
+ "action": "Sprint",
+ "default": "Left Shift"
+ },
+ {
+ "id": "lean_left",
+ "action": "Lean Left",
+ "default": "Q"
+ },
+ {
+ "id": "lean_right",
+ "action": "Lean Right",
+ "default": "E"
+ },
+ {
+ "id": "reload",
+ "action": "Reload",
+ "default": "R"
+ },
+ {
+ "id": "interact",
+ "action": "Interact",
+ "default": "F"
+ },
+ {
+ "id": "inventory",
+ "action": "Inventory",
+ "default": "Tab"
+ },
+ {
+ "id": "check_ammo",
+ "action": "Check Ammo",
+ "default": "Left Alt + T"
+ },
+ {
+ "id": "inspect_weapon",
+ "action": "Inspect Weapon",
+ "default": "L"
+ },
+ {
+ "id": "fire_mode",
+ "action": "Fire Mode",
+ "default": "B"
+ },
+ {
+ "id": "tactical_device",
+ "action": "Tactical Device",
+ "default": "T"
+ },
+ {
+ "id": "night_vision",
+ "action": "Night Vision",
+ "default": "N"
+ },
+ {
+ "id": "grenade",
+ "action": "Grenade",
+ "default": "G"
+ },
+ {
+ "id": "check_extracts",
+ "action": "Check Extracts",
+ "default": "O (double tap)"
+ },
+ {
+ "id": "quick_slots",
+ "action": "Quick Slots",
+ "default": "4-9, 0"
+ }
+ ]
+ },
+ {
+ "id": "destiny2",
+ "name": "Destiny 2",
+ "publisher": "Bungie",
+ "yaw": 0.0066,
+ "yaw_note": "Degrees per count per 1 of 'Look Sensitivity' (same as OW2/CoD per SensLab and csdb). ADS uses 'ADS Sensitivity Modifier' plus per-weapon zoom.",
+ "sens_key": "look_sens",
+ "config_file": "%APPDATA%\\Bungie\\DestinyPC\\prefs\\cvars.xml (XML; graphics, binds and sensitivity)",
+ "sources": [
+ "https://senslab.pro/sensitivity",
+ "https://csdb.gg/sensitivity-converter/",
+ "https://www.shacknews.com/article/101153/destiny-2-key-bindings-and-key-mapping",
+ "https://mouse-sensitivity.com/topic/777-destiny-2"
+ ],
+ "sections": [
+ {
+ "id": "mouse",
+ "settings": [
+ {
+ "key": "look_sens",
+ "label": "Look Sensitivity",
+ "type": "slider",
+ "min": 1,
+ "max": 20,
+ "step": 1,
+ "default": null,
+ "note": "Integer slider"
+ },
+ {
+ "key": "ads_modifier",
+ "label": "ADS Sensitivity Modifier",
+ "type": "slider",
+ "min": 0.1,
+ "max": 3.0,
+ "step": 0.1,
+ "default": 1.0
+ },
+ {
+ "key": "mouse_smoothing",
+ "label": "Mouse Smoothing",
+ "type": "toggle",
+ "default": false
+ },
+ {
+ "key": "invert",
+ "label": "Invert Look",
+ "type": "toggle",
+ "default": false
+ }
+ ]
+ },
+ {
+ "id": "audio",
+ "settings": [
+ {
+ "key": "master_volume",
+ "label": "Master Volume",
+ "type": "slider",
+ "min": 0,
+ "max": 100,
+ "default": null
+ },
+ {
+ "key": "sfx_volume",
+ "label": "Sound Effects Volume",
+ "type": "slider",
+ "min": 0,
+ "max": 100,
+ "default": null
+ },
+ {
+ "key": "music_volume",
+ "label": "Music Volume",
+ "type": "slider",
+ "min": 0,
+ "max": 100,
+ "default": null
+ },
+ {
+ "key": "dialogue_volume",
+ "label": "Dialogue Volume",
+ "type": "slider",
+ "min": 0,
+ "max": 100,
+ "default": null
+ },
+ {
+ "key": "voice_chat_volume",
+ "label": "Voice Chat Volume",
+ "type": "slider",
+ "min": 0,
+ "max": 100,
+ "default": null
+ }
+ ]
+ },
+ {
+ "id": "video",
+ "settings": [
+ {
+ "key": "window_mode",
+ "label": "Window Mode",
+ "options": [
+ "Fullscreen",
+ "Windowed",
+ "Windowed Fullscreen"
+ ],
+ "type": "select",
+ "default": null
+ },
+ {
+ "key": "resolution",
+ "label": "Resolution",
+ "type": "text",
+ "default": null
+ },
+ {
+ "key": "fov",
+ "label": "Field of View",
+ "type": "slider",
+ "min": 55,
+ "max": 105,
+ "default": null,
+ "note": "Range from memory; unverified"
+ },
+ {
+ "key": "vsync",
+ "label": "Vsync",
+ "type": "toggle",
+ "default": false
+ },
+ {
+ "key": "framerate_cap_enabled",
+ "label": "Framerate Cap Enabled",
+ "type": "toggle",
+ "default": null
+ },
+ {
+ "key": "framerate_cap",
+ "label": "Framerate Cap",
+ "type": "number",
+ "min": 30,
+ "default": null
+ },
+ {
+ "key": "render_resolution",
+ "label": "Render Resolution",
+ "type": "slider",
+ "min": 25,
+ "max": 200,
+ "default": 100
+ },
+ {
+ "key": "anti_aliasing",
+ "label": "Anti-Aliasing",
+ "options": [
+ "Off",
+ "FXAA",
+ "SMAA"
+ ],
+ "type": "select",
+ "default": null
+ },
+ {
+ "key": "motion_blur",
+ "label": "Motion Blur",
+ "type": "toggle",
+ "default": null
+ }
+ ]
+ },
+ {
+ "id": "gameplay",
+ "settings": [
+ {
+ "key": "sprint_mode",
+ "label": "Toggle Sprint",
+ "type": "toggle",
+ "default": null
+ },
+ {
+ "key": "crouch_mode",
+ "label": "Toggle Crouch",
+ "type": "toggle",
+ "default": null
+ },
+ {
+ "key": "aim_mode",
+ "label": "Toggle Zoom",
+ "type": "toggle",
+ "default": null
+ },
+ {
+ "key": "chromatic_aberration",
+ "label": "Chromatic Aberration",
+ "type": "toggle",
+ "default": null
+ }
+ ]
+ }
+ ],
+ "keybinds": [
+ {
+ "id": "move_forward",
+ "action": "Move Forward",
+ "default": "W"
+ },
+ {
+ "id": "move_back",
+ "action": "Move Back",
+ "default": "S"
+ },
+ {
+ "id": "move_left",
+ "action": "Move Left",
+ "default": "A"
+ },
+ {
+ "id": "move_right",
+ "action": "Move Right",
+ "default": "D"
+ },
+ {
+ "id": "jump",
+ "action": "Jump",
+ "default": "Space"
+ },
+ {
+ "id": "crouch",
+ "action": "Crouch",
+ "default": "Left Ctrl"
+ },
+ {
+ "id": "sprint",
+ "action": "Sprint",
+ "default": "Left Shift"
+ },
+ {
+ "id": "reload",
+ "action": "Reload",
+ "default": "R"
+ },
+ {
+ "id": "interact",
+ "action": "Interact",
+ "default": "E"
+ },
+ {
+ "id": "grenade",
+ "action": "Grenade",
+ "default": "Q"
+ },
+ {
+ "id": "melee",
+ "action": "Melee",
+ "default": "C"
+ },
+ {
+ "id": "super",
+ "action": "Super",
+ "default": "F"
+ },
+ {
+ "id": "class_ability",
+ "action": "Class Ability",
+ "default": "V"
+ },
+ {
+ "id": "kinetic_weapon",
+ "action": "Kinetic Weapon",
+ "default": "1"
+ },
+ {
+ "id": "energy_weapon",
+ "action": "Energy Weapon",
+ "default": "2"
+ },
+ {
+ "id": "power_weapon",
+ "action": "Power Weapon",
+ "default": "3"
+ },
+ {
+ "id": "deploy_ghost",
+ "action": "Deploy Ghost",
+ "default": "Tab"
+ },
+ {
+ "id": "director",
+ "action": "Director",
+ "default": "M"
+ },
+ {
+ "id": "fire",
+ "action": "Fire",
+ "default": "Left Mouse"
+ },
+ {
+ "id": "aim_down_sights",
+ "action": "Aim Down Sights",
+ "default": "Right Mouse"
+ }
+ ]
+ },
+ {
+ "id": "arc_raiders",
+ "name": "ARC Raiders",
+ "publisher": "Embark Studios (Nexon)",
+ "yaw": null,
+ "yaw_note": "Released (UE5). No verified public yaw constant (mouse-sensitivity.com supports it behind premium; no free source states the value). Sensitivity is a 0-100 slider, linearity unconfirmed.",
+ "sens_key": null,
+ "config_file": "%LOCALAPPDATA%\\PioneerGame\\Saved\\Config\\WindowsClient\\GameUserSettings.ini (UE INI)",
+ "sources": [
+ "https://arcraiders.wiki/wiki/Settings",
+ "https://mp1st.com/news/arc-raiders-config-settings-unfair-advantages",
+ "https://www.mouse-sensitivity.com/n/cs2-to-arc-raiders/"
+ ],
+ "sections": [
+ {
+ "id": "mouse",
+ "settings": [
+ {
+ "key": "h_sens",
+ "label": "Horizontal Sensitivity",
+ "type": "slider",
+ "min": 0,
+ "max": 100,
+ "step": 1,
+ "default": 50,
+ "note": "Mouse and Keyboard tab"
+ },
+ {
+ "key": "v_sens",
+ "label": "Vertical Sensitivity",
+ "type": "slider",
+ "min": 0,
+ "max": 100,
+ "step": 1,
+ "default": 50
+ },
+ {
+ "key": "zoom_mult",
+ "label": "Zoom Sensitivity Multiplier",
+ "type": "slider",
+ "min": 0,
+ "max": 100,
+ "step": 1,
+ "default": 100,
+ "note": "ADS"
+ },
+ {
+ "key": "scoped_zoom_mult",
+ "label": "Scoped Zoom Sensitivity Multiplier",
+ "type": "slider",
+ "min": 1,
+ "max": 200,
+ "step": 1,
+ "default": 100,
+ "note": "Scopes"
+ },
+ {
+ "key": "invert_v",
+ "label": "Invert Vertical Look Input",
+ "type": "toggle",
+ "default": false
+ },
+ {
+ "key": "ctrl_h_sens",
+ "label": "Horizontal Sensitivity (Controller)",
+ "type": "slider",
+ "min": 10,
+ "max": 400,
+ "step": 1,
+ "default": 80,
+ "note": "Controller tab; vertical default 60"
+ }
+ ]
+ },
+ {
+ "id": "audio",
+ "settings": [
+ {
+ "key": "master_volume",
+ "label": "Master Volume",
+ "type": "slider",
+ "min": 0,
+ "max": 100,
+ "default": 75
+ },
+ {
+ "key": "effects_volume",
+ "label": "Effects Volume",
+ "type": "slider",
+ "min": 0,
+ "max": 100,
+ "default": 100
+ },
+ {
+ "key": "music_volume",
+ "label": "Music Volume",
+ "type": "slider",
+ "min": 0,
+ "max": 100,
+ "default": 100
+ },
+ {
+ "key": "dialogue_volume",
+ "label": "Dialogue Volume",
+ "type": "slider",
+ "min": 0,
+ "max": 100,
+ "default": 100
+ },
+ {
+ "key": "party_voice_volume",
+ "label": "Party Voice Chat Volume",
+ "type": "slider",
+ "min": 0,
+ "max": 200,
+ "default": 100
+ },
+ {
+ "key": "proximity_voice_volume",
+ "label": "Proximity Voice Chat Volume",
+ "type": "slider",
+ "min": 0,
+ "max": 200,
+ "default": 140
+ },
+ {
+ "key": "night_mode",
+ "label": "Night Mode",
+ "type": "toggle",
+ "default": false
+ }
+ ]
+ },
+ {
+ "id": "video",
+ "settings": [
+ {
+ "key": "window_mode",
+ "label": "Window Mode",
+ "options": [
+ "Borderless Fullscreen",
+ "Windowed",
+ "Exclusive Fullscreen"
+ ],
+ "type": "select",
+ "default": "Borderless Fullscreen"
+ },
+ {
+ "key": "resolution",
+ "label": "Display Resolution",
+ "type": "text",
+ "default": null
+ },
+ {
+ "key": "fov",
+ "label": "Field of View",
+ "type": "slider",
+ "min": 60,
+ "max": 80,
+ "default": 70
+ },
+ {
+ "key": "frame_rate_limit",
+ "label": "Frame Rate Limit",
+ "type": "number",
+ "min": 30,
+ "default": 60
+ },
+ {
+ "key": "nvidia_reflex",
+ "label": "NVIDIA Reflex Low Latency",
+ "options": [
+ "On",
+ "On + Boost"
+ ],
+ "type": "select",
+ "default": "On"
+ },
+ {
+ "key": "scaling_method",
+ "label": "Resolution Scaling Method",
+ "options": [
+ "No AA",
+ "TAAU",
+ "TSR",
+ "NVIDIA DLSS",
+ "AMD FSR 3",
+ "Intel XeSS"
+ ],
+ "type": "select",
+ "default": "NVIDIA DLSS"
+ },
+ {
+ "key": "frame_generation",
+ "label": "Frame Generation",
+ "options": [
+ "Off",
+ "FSR 3",
+ "DLSS"
+ ],
+ "type": "select",
+ "default": "Off"
+ },
+ {
+ "key": "vsync",
+ "label": "VSync",
+ "type": "toggle",
+ "default": false
+ },
+ {
+ "key": "motion_blur",
+ "label": "Motion Blur",
+ "type": "toggle",
+ "default": true
+ },
+ {
+ "key": "overall_quality",
+ "label": "Overall Quality Level",
+ "options": [
+ "Low",
+ "Medium",
+ "High",
+ "Epic",
+ "Cinematic"
+ ],
+ "type": "select",
+ "default": null
+ },
+ {
+ "key": "rtxgi",
+ "label": "NVIDIA RTX Global Illumination",
+ "options": [
+ "Static",
+ "Dynamic - Low",
+ "Dynamic - Medium",
+ "Dynamic - High",
+ "Dynamic - Epic"
+ ],
+ "type": "select",
+ "default": "Dynamic - Medium"
+ }
+ ]
+ },
+ {
+ "id": "gameplay",
+ "settings": [
+ {
+ "key": "show_reload_progress",
+ "label": "Show Reload Progress",
+ "type": "toggle",
+ "default": true
+ },
+ {
+ "key": "show_damage_direction",
+ "label": "Show Damage Direction",
+ "type": "toggle",
+ "default": true
+ },
+ {
+ "key": "crossplay",
+ "label": "Crossplay",
+ "type": "toggle",
+ "default": true
+ },
+ {
+ "key": "hud_position",
+ "label": "HUD Position",
+ "options": [
+ "Stretched",
+ "Fixed"
+ ],
+ "type": "select",
+ "default": "Stretched"
+ },
+ {
+ "key": "blocked_lof",
+ "label": "Move Crosshair When Line of Fire is Blocked",
+ "type": "toggle",
+ "default": true
+ }
+ ]
+ }
+ ],
+ "keybinds": [
+ {
+ "id": "move_forward",
+ "action": "Move Forward",
+ "default": "W"
+ },
+ {
+ "id": "move_backward",
+ "action": "Move Backward",
+ "default": "S"
+ },
+ {
+ "id": "move_left",
+ "action": "Move Left",
+ "default": "A"
+ },
+ {
+ "id": "move_right",
+ "action": "Move Right",
+ "default": "D"
+ },
+ {
+ "id": "fire_throw_deploy",
+ "action": "Fire / Throw / Deploy",
+ "default": "Left Mouse"
+ },
+ {
+ "id": "aim_hold",
+ "action": "Aim (Hold)",
+ "default": "Right Mouse"
+ },
+ {
+ "id": "jump",
+ "action": "Jump",
+ "default": "Space"
+ },
+ {
+ "id": "sprint_hold",
+ "action": "Sprint (Hold)",
+ "default": "Left Shift"
+ },
+ {
+ "id": "crouch_hold",
+ "action": "Crouch (Hold)",
+ "default": "Left Ctrl"
+ },
+ {
+ "id": "crouch_toggle",
+ "action": "Crouch (Toggle)",
+ "default": "C"
+ },
+ {
+ "id": "dodge_roll",
+ "action": "Dodge Roll",
+ "default": "Left Alt"
+ },
+ {
+ "id": "walk_toggle",
+ "action": "Walk (Toggle)",
+ "default": "V"
+ },
+ {
+ "id": "interact",
+ "action": "Interact",
+ "default": "E"
+ },
+ {
+ "id": "reload",
+ "action": "Reload",
+ "default": "R"
+ },
+ {
+ "id": "shoulder_swap",
+ "action": "Shoulder Swap",
+ "default": "X"
+ },
+ {
+ "id": "weapon_1",
+ "action": "Weapon 1",
+ "default": "1"
+ },
+ {
+ "id": "weapon_2",
+ "action": "Weapon 2",
+ "default": "2"
+ },
+ {
+ "id": "weapon_melee",
+ "action": "Weapon Melee",
+ "default": "3"
+ },
+ {
+ "id": "unarmed",
+ "action": "Unarmed",
+ "default": "H"
+ },
+ {
+ "id": "items",
+ "action": "Items",
+ "default": "Q"
+ },
+ {
+ "id": "flashlight",
+ "action": "Flashlight",
+ "default": "F"
+ },
+ {
+ "id": "inventory",
+ "action": "Inventory",
+ "default": "Tab"
+ },
+ {
+ "id": "map",
+ "action": "Map",
+ "default": "M"
+ },
+ {
+ "id": "ping",
+ "action": "Ping",
+ "default": "Middle Mouse"
+ },
+ {
+ "id": "push_to_talk",
+ "action": "Push to Talk",
+ "default": "Z"
+ },
+ {
+ "id": "push_to_proximity",
+ "action": "Push to Proximity",
+ "default": "B"
+ }
+ ]
+ },
+ {
+ "id": "rocket_league",
+ "name": "Rocket League",
+ "publisher": "Psyonix / Epic Games",
+ "yaw": null,
+ "yaw_note": "Car game with a chase camera; no meaningful cm/360 conversion. Store camera + controller values instead.",
+ "sens_key": null,
+ "config_file": "Documents\\My Games\\Rocket League\\TAGame\\Config\\TASystemSettings.ini (graphics) + TAInput.ini; camera/controls in binary SaveData (.save) files.",
+ "sources": [
+ "https://www.epicgames.com/help/en-US/rocket-league-c5719357623323/basics-c7261959845275/what-are-camera-settings-in-rocket-league-a5720054403995"
+ ],
+ "sections": [
+ {
+ "id": "mouse",
+ "settings": [
+ {
+ "key": "steering_sens",
+ "label": "Steering Sensitivity",
+ "type": "slider",
+ "min": 0.1,
+ "max": 10,
+ "step": 0.01,
+ "default": 1.0,
+ "note": "Controller"
+ },
+ {
+ "key": "aerial_sens",
+ "label": "Aerial Sensitivity",
+ "type": "slider",
+ "min": 0.1,
+ "max": 10,
+ "step": 0.01,
+ "default": 1.0,
+ "note": "Controller"
+ },
+ {
+ "key": "deadzone",
+ "label": "Controller Deadzone",
+ "type": "slider",
+ "min": 0,
+ "max": 1,
+ "step": 0.01,
+ "default": 0.5
+ },
+ {
+ "key": "dodge_deadzone",
+ "label": "Dodge Deadzone",
+ "type": "slider",
+ "min": 0,
+ "max": 1,
+ "step": 0.01,
+ "default": 0.5
+ }
+ ]
+ },
+ {
+ "id": "audio",
+ "settings": [
+ {
+ "key": "master_volume",
+ "label": "Master Volume",
+ "type": "slider",
+ "min": 0,
+ "max": 100,
+ "default": null
+ },
+ {
+ "key": "gameplay_volume",
+ "label": "Gameplay Volume",
+ "type": "slider",
+ "min": 0,
+ "max": 100,
+ "default": null
+ },
+ {
+ "key": "ambient_volume",
+ "label": "Ambient Volume",
+ "type": "slider",
+ "min": 0,
+ "max": 100,
+ "default": null
+ },
+ {
+ "key": "menu_music_volume",
+ "label": "Menu Music Volume",
+ "type": "slider",
+ "min": 0,
+ "max": 100,
+ "default": null
+ },
+ {
+ "key": "ingame_music_volume",
+ "label": "In-Game Music Volume",
+ "type": "slider",
+ "min": 0,
+ "max": 100,
+ "default": null
+ }
+ ]
+ },
+ {
+ "id": "video",
+ "settings": [
+ {
+ "key": "window_mode",
+ "label": "Display Mode",
+ "options": [
+ "Fullscreen",
+ "Windowed",
+ "Borderless"
+ ],
+ "type": "select",
+ "default": null
+ },
+ {
+ "key": "resolution",
+ "label": "Resolution",
+ "type": "text",
+ "default": null
+ },
+ {
+ "key": "vsync",
+ "label": "Vertical Sync",
+ "type": "toggle",
+ "default": false
+ },
+ {
+ "key": "max_fps",
+ "label": "Frame Rate",
+ "options": [
+ "30",
+ "60",
+ "120",
+ "144",
+ "240",
+ "250",
+ "Uncapped"
+ ],
+ "type": "select",
+ "default": null
+ },
+ {
+ "key": "anti_aliasing",
+ "label": "Anti-Aliasing",
+ "options": [
+ "Off",
+ "FXAA Low",
+ "FXAA Medium",
+ "FXAA High",
+ "MLAA"
+ ],
+ "type": "select",
+ "default": null
+ },
+ {
+ "key": "render_quality",
+ "label": "Render Quality",
+ "options": [
+ "High Performance",
+ "Performance",
+ "Quality",
+ "High Quality"
+ ],
+ "type": "select",
+ "default": null
+ },
+ {
+ "key": "render_detail",
+ "label": "Render Detail",
+ "options": [
+ "Performance",
+ "Quality",
+ "High Quality",
+ "Custom"
+ ],
+ "type": "select",
+ "default": null
+ }
+ ]
+ },
+ {
+ "id": "gameplay",
+ "settings": [
+ {
+ "key": "cam_fov",
+ "label": "Field of View",
+ "type": "slider",
+ "min": 60,
+ "max": 110,
+ "default": 90
+ },
+ {
+ "key": "cam_distance",
+ "label": "Distance",
+ "type": "slider",
+ "min": 100,
+ "max": 400,
+ "default": 270
+ },
+ {
+ "key": "cam_height",
+ "label": "Height",
+ "type": "slider",
+ "min": 40,
+ "max": 200,
+ "default": 100
+ },
+ {
+ "key": "cam_angle",
+ "label": "Angle",
+ "type": "slider",
+ "min": -15,
+ "max": 0,
+ "default": -3
+ },
+ {
+ "key": "cam_stiffness",
+ "label": "Stiffness",
+ "type": "slider",
+ "min": 0,
+ "max": 1,
+ "default": 0.45
+ },
+ {
+ "key": "cam_swivel",
+ "label": "Swivel Speed",
+ "type": "slider",
+ "min": 1,
+ "max": 10,
+ "default": 2.5
+ },
+ {
+ "key": "cam_transition",
+ "label": "Transition Speed",
+ "type": "slider",
+ "min": 1,
+ "max": 2,
+ "default": 1.2
+ },
+ {
+ "key": "camera_shake",
+ "label": "Camera Shake",
+ "type": "toggle",
+ "default": true
+ }
+ ]
+ }
+ ],
+ "keybinds": [
+ {
+ "id": "throttle_forward",
+ "action": "Throttle Forward",
+ "default": "W"
+ },
+ {
+ "id": "throttle_reverse",
+ "action": "Throttle Reverse",
+ "default": "S"
+ },
+ {
+ "id": "steer_left",
+ "action": "Steer Left",
+ "default": "A"
+ },
+ {
+ "id": "steer_right",
+ "action": "Steer Right",
+ "default": "D"
+ },
+ {
+ "id": "jump",
+ "action": "Jump",
+ "default": "Right Mouse"
+ },
+ {
+ "id": "boost",
+ "action": "Boost",
+ "default": "Left Mouse"
+ },
+ {
+ "id": "powerslide",
+ "action": "Powerslide",
+ "default": "Left Shift"
+ },
+ {
+ "id": "air_roll",
+ "action": "Air Roll",
+ "default": "Left Shift"
+ },
+ {
+ "id": "air_roll_left",
+ "action": "Air Roll Left",
+ "default": "Q"
+ },
+ {
+ "id": "air_roll_right",
+ "action": "Air Roll Right",
+ "default": "E"
+ },
+ {
+ "id": "ball_cam",
+ "action": "Ball Cam",
+ "default": "Space"
+ },
+ {
+ "id": "rear_view",
+ "action": "Rear View",
+ "default": "Middle Mouse",
+ "note": "verify"
+ },
+ {
+ "id": "scoreboard",
+ "action": "Scoreboard",
+ "default": "Tab"
+ },
+ {
+ "id": "quick_chat",
+ "action": "Quick Chat",
+ "default": "1 / 2 / 3 / 4"
+ }
+ ]
+ }
+ ]
+}
diff --git a/dodaios/games/catalog.py b/dodaios/games/catalog.py
new file mode 100644
index 0000000000..42f6fa1d6f
--- /dev/null
+++ b/dodaios/games/catalog.py
@@ -0,0 +1,44 @@
+"""The shipped game catalog: which settings each game has, and their ranges.
+
+``catalog.json`` holds one entry per game: its sections (mouse, audio, video,
+gameplay) of typed settings, its default PC keybinds, the mouse "yaw" used
+for sensitivity conversion (``None`` when the game's sensitivity is not
+linear) and where the game keeps its own config file. Defaults are ``None``
+where they could not be verified; the UI then shows the field empty.
+"""
+
+from __future__ import annotations
+
+import json
+from functools import lru_cache
+from pathlib import Path
+from typing import Any
+
+CATALOG_PATH = Path(__file__).with_name("catalog.json")
+
+SECTION_IDS = ("mouse", "audio", "video", "gameplay")
+SETTING_TYPES = ("slider", "number", "select", "toggle", "text")
+
+
+@lru_cache(maxsize=1)
+def load_catalog() -> dict[str, Any]:
+ """The whole catalog, parsed once per process."""
+ with CATALOG_PATH.open(encoding="utf-8") as fh:
+ return json.load(fh)
+
+
+def list_games() -> list[dict[str, Any]]:
+ return list(load_catalog()["games"])
+
+
+def get_game(game_id: str) -> dict[str, Any] | None:
+ return next((g for g in load_catalog()["games"] if g["id"] == game_id), None)
+
+
+def settings_by_key(game: dict[str, Any]) -> dict[str, dict[str, Any]]:
+ """Every setting of a game, keyed by its ``key``, across all sections."""
+ return {s["key"]: s for section in game["sections"] for s in section["settings"]}
+
+
+def keybind_ids(game: dict[str, Any]) -> set[str]:
+ return {k["id"] for k in game["keybinds"]}
diff --git a/dodaios/games/sensitivity.py b/dodaios/games/sensitivity.py
new file mode 100644
index 0000000000..737a74d321
--- /dev/null
+++ b/dodaios/games/sensitivity.py
@@ -0,0 +1,52 @@
+"""Mouse sensitivity maths: cm/360, eDPI and converting between games.
+
+A game turns the camera by ``yaw * sens`` degrees for every mouse count, and
+a mouse sends ``dpi`` counts per inch. So one full turn takes
+``360 / (yaw * sens * dpi)`` inches, times 2.54 for centimetres. Two settings
+feel the same when that distance is equal, which gives the conversion
+``sens_b = sens_a * yaw_a * dpi_a / (yaw_b * dpi_b)``.
+
+Only hip-fire is converted: scoped and ADS multipliers depend on each game's
+field of view and are left to the player.
+"""
+
+from __future__ import annotations
+
+import math
+
+CM_PER_INCH = 2.54
+
+
+def _check(name: str, value: float) -> float:
+ if not math.isfinite(value) or value <= 0:
+ raise ValueError(f"{name} must be a positive number")
+ return float(value)
+
+
+def cm_per_360(yaw: float, sens: float, dpi: float) -> float:
+ """Centimetres of mouse travel for one full 360° turn."""
+ yaw, sens, dpi = _check("yaw", yaw), _check("sens", sens), _check("dpi", dpi)
+ return 360.0 / (yaw * sens * dpi) * CM_PER_INCH
+
+
+def edpi(sens: float, dpi: float) -> float:
+ """Effective DPI: sensitivity times DPI (only comparable within one game)."""
+ return _check("sens", sens) * _check("dpi", dpi)
+
+
+def convert(
+ sens: float,
+ from_yaw: float,
+ to_yaw: float,
+ from_dpi: float,
+ to_dpi: float | None = None,
+) -> float:
+ """The sensitivity in the target game that gives the same cm/360."""
+ to_dpi = from_dpi if to_dpi is None else to_dpi
+ counts = _check("sens", sens) * _check("from_yaw", from_yaw) * _check("from_dpi", from_dpi)
+ return counts / (_check("to_yaw", to_yaw) * _check("to_dpi", to_dpi))
+
+
+def sens_for_cm(cm: float, yaw: float, dpi: float) -> float:
+ """The sensitivity that gives ``cm`` centimetres per 360° turn."""
+ return 360.0 * CM_PER_INCH / (_check("cm", cm) * _check("yaw", yaw) * _check("dpi", dpi))
diff --git a/dodaios/games/store.py b/dodaios/games/store.py
new file mode 100644
index 0000000000..566e1bd382
--- /dev/null
+++ b/dodaios/games/store.py
@@ -0,0 +1,219 @@
+"""The user's own game settings, one profile per game, in one JSON file.
+
+Lives at ``<DATA_DIR>/games/profiles.json``::
+
+ {"version": 1, "dpi": 800,
+ "games": {"fortnite": {"values": {"mouse_sens_x": 6.4},
+ "keybinds": {"jump": "Space"},
+ "dpi": null, "notes": "", "updated_at": "..."}}}
+
+``dpi`` at the top is the mouse DPI every game uses unless its profile sets
+its own. Values are checked against the catalog before they are written, and
+the file is replaced atomically so a crash never leaves half a file.
+"""
+
+from __future__ import annotations
+
+import json
+import logging
+import math
+import os
+import threading
+from datetime import UTC, datetime
+from pathlib import Path
+from typing import Any
+
+from dodaios.games.catalog import get_game, keybind_ids, settings_by_key
+
+log = logging.getLogger(__name__)
+
+DEFAULT_DPI = 800
+MIN_DPI, MAX_DPI = 50, 64000
+MAX_KEY_LEN = 40
+MAX_TEXT_LEN = 200
+MAX_NOTES_LEN = 4000
+
+_LOCK = threading.Lock()
+
+
+class UnknownGameError(LookupError):
+ """The game id is not in the catalog."""
+
+
+def store_path(data_dir: Path | None = None) -> Path:
+ if data_dir is None:
+ from dodaios.core import config
+
+ data_dir = config.DATA_DIR
+ return Path(data_dir) / "games" / "profiles.json"
+
+
+def _empty() -> dict[str, Any]:
+ return {"version": 1, "dpi": DEFAULT_DPI, "games": {}}
+
+
+def _read(path: Path) -> dict[str, Any]:
+ try:
+ raw = json.loads(path.read_text(encoding="utf-8"))
+ except FileNotFoundError: # no profile saved yet: a fresh install starts empty
+ return _empty()
+ except (OSError, ValueError) as exc:
+ log.warning("game profiles unreadable, starting empty: %s", exc)
+ return _empty()
+ if not isinstance(raw, dict) or not isinstance(raw.get("games"), dict):
+ return _empty()
+ raw.setdefault("version", 1)
+ if not isinstance(raw.get("dpi"), int):
+ raw["dpi"] = DEFAULT_DPI
+ return raw
+
+
+def _write(path: Path, data: dict[str, Any]) -> None:
+ path.parent.mkdir(parents=True, exist_ok=True)
+ tmp = path.with_suffix(".json.tmp")
+ tmp.write_text(json.dumps(data, indent=1, ensure_ascii=False), encoding="utf-8")
+ os.replace(tmp, path)
+
+
+def check_dpi(value: Any) -> int:
+ if isinstance(value, bool) or not isinstance(value, (int, float)):
+ raise ValueError("DPI must be a number")
+ dpi = int(round(value))
+ if not MIN_DPI <= dpi <= MAX_DPI:
+ raise ValueError(f"DPI must be between {MIN_DPI} and {MAX_DPI}")
+ return dpi
+
+
+def check_value(setting: dict[str, Any], value: Any) -> Any:
+ """``value`` normalized for ``setting``, or ``ValueError`` when it does not fit."""
+ if value is None:
+ return None
+ kind = setting["type"]
+ label = setting["label"]
+ if kind == "toggle":
+ if not isinstance(value, bool):
+ raise ValueError(f"{label}: expected on or off")
+ return value
+ if kind == "select":
+ if value not in setting.get("options", []):
+ raise ValueError(f"{label}: not one of the game's options")
+ return value
+ if kind == "text":
+ if not isinstance(value, str) or len(value) > MAX_TEXT_LEN:
+ raise ValueError(f"{label}: text up to {MAX_TEXT_LEN} characters")
+ return value.strip()
+ # slider / number
+ if isinstance(value, bool) or not isinstance(value, (int, float)) or not math.isfinite(value):
+ raise ValueError(f"{label}: expected a number")
+ low, high = setting.get("min"), setting.get("max")
+ if low is not None and value < low:
+ raise ValueError(f"{label}: at least {low}")
+ if high is not None and value > high:
+ raise ValueError(f"{label}: at most {high}")
+ return value
+
+
+def check_key(value: Any) -> str:
+ if not isinstance(value, str) or len(value) > MAX_KEY_LEN:
+ raise ValueError(f"A key name is text up to {MAX_KEY_LEN} characters")
+ return value.strip()
+
+
+def _game_or_raise(game_id: str) -> dict[str, Any]:
+ game = get_game(game_id)
+ if game is None:
+ raise UnknownGameError(game_id)
+ return game
+
+
+def _blank_profile() -> dict[str, Any]:
+ return {"values": {}, "keybinds": {}, "dpi": None, "notes": "", "updated_at": None}
+
+
+class GameProfileStore:
+ """Read and change the profiles file. Every method is safe across threads."""
+
+ def __init__(self, path: Path | None = None) -> None:
+ self.path = path or store_path()
+
+ def snapshot(self) -> dict[str, Any]:
+ with _LOCK:
+ return _read(self.path)
+
+ def profile(self, game_id: str) -> dict[str, Any]:
+ _game_or_raise(game_id)
+ data = self.snapshot()
+ return {**_blank_profile(), **data["games"].get(game_id, {})}
+
+ def set_default_dpi(self, dpi: Any) -> int:
+ value = check_dpi(dpi)
+ with _LOCK:
+ data = _read(self.path)
+ data["dpi"] = value
+ _write(self.path, data)
+ return value
+
+ def update(
+ self,
+ game_id: str,
+ *,
+ values: dict[str, Any] | None = None,
+ keybinds: dict[str, Any] | None = None,
+ dpi: Any = ...,
+ notes: str | None = None,
+ ) -> dict[str, Any]:
+ """Merge a change into one game's profile and return the whole profile.
+
+ A value or keybind of ``None`` removes it (back to the game default).
+ ``dpi=None`` makes the game follow the default DPI again; leaving it
+ out keeps what is saved. Everything is checked before anything is
+ written, so one bad field leaves the file untouched.
+ """
+ game = _game_or_raise(game_id)
+ settings = settings_by_key(game)
+ binds = keybind_ids(game)
+ clean_values: dict[str, Any] = {}
+ for key, value in (values or {}).items():
+ if key not in settings:
+ raise ValueError(f"Unknown setting: {key}")
+ clean_values[key] = check_value(settings[key], value)
+ clean_binds: dict[str, str | None] = {}
+ for key, value in (keybinds or {}).items():
+ if key not in binds:
+ raise ValueError(f"Unknown keybind: {key}")
+ clean_binds[key] = None if value is None else check_key(value)
+ clean_dpi = None if dpi is None or dpi is ... else check_dpi(dpi)
+ if notes is not None and (not isinstance(notes, str) or len(notes) > MAX_NOTES_LEN):
+ raise ValueError(f"Notes are text up to {MAX_NOTES_LEN} characters")
+
+ with _LOCK:
+ data = _read(self.path)
+ profile = {**_blank_profile(), **data["games"].get(game_id, {})}
+ for key, value in clean_values.items():
+ if value is None:
+ profile["values"].pop(key, None)
+ else:
+ profile["values"][key] = value
+ for key, value in clean_binds.items():
+ if value is None:
+ profile["keybinds"].pop(key, None)
+ else:
+ profile["keybinds"][key] = value
+ if dpi is not ...:
+ profile["dpi"] = clean_dpi
+ if notes is not None:
+ profile["notes"] = notes
+ profile["updated_at"] = datetime.now(UTC).isoformat(timespec="seconds")
+ data["games"][game_id] = profile
+ _write(self.path, data)
+ return profile
+
+ def reset(self, game_id: str) -> bool:
+ """Forget one game's profile. Returns whether there was one."""
+ _game_or_raise(game_id)
+ with _LOCK:
+ data = _read(self.path)
+ existed = data["games"].pop(game_id, None) is not None
+ if existed:
+ _write(self.path, data)
+ return existed
diff --git a/dodaios/plugins/tool/navigate.py b/dodaios/plugins/tool/navigate.py
index e062bce2bd..debef6f66a 100644
--- a/dodaios/plugins/tool/navigate.py
+++ b/dodaios/plugins/tool/navigate.py
@@ -71,6 +71,8 @@ KNOWN: frozenset[str] = frozenset(
"marketplace",
# My Pets: the desktop pet, its look, and the pets the user created.
"pets",
+ # Game settings: per-game sensitivity, keybinds, audio and video.
+ "games",
# Keyboard shortcuts: every shortcut in one place, with a key tester.
"shortcuts",
# Built for you: what the self-building loop made, with keep and undo.
@@ -277,6 +279,14 @@ _ALIASES: dict[str, str] = {
# is already the section id, and anything broader ("animals") would pull
# ordinary questions about animals onto a settings page.
"my pets": "pets",
+ "game settings": "games",
+ "gaming settings": "games",
+ "games": "games",
+ "sensitivity converter": "games",
+ "spiele": "games", # i18n-allow: input vocab
+ "spieleinstellungen": "games", # i18n-allow: input vocab
+ "spiel einstellungen": "games", # i18n-allow: input vocab
+ "ajustes de juegos": "games", # i18n-allow: input vocab
"my pet": "pets",
"desktop pet": "pets",
"desktop pets": "pets",
diff --git a/dodaios/ui/section_windows.py b/dodaios/ui/section_windows.py
index 74528d1237..355253e8fd 100644
--- a/dodaios/ui/section_windows.py
+++ b/dodaios/ui/section_windows.py
@@ -5,7 +5,7 @@ WINDOW_GROUPS: dict[str, tuple[str, ...]] = {
"settings": (
"settings", "taskbar", "languages", "profile", "agent-instructions",
"socials", "apikeys", "telephony", "telephony-setup", "computers",
- "appshots", "shortcuts", "pets", "costs", "feedback",
+ "appshots", "shortcuts", "pets", "games", "costs", "feedback",
),
"plugins": ("plugins", "mcps", "skills"),
"clis": ("clis", "cli-test-hub"),
diff --git a/dodaios/ui/web/frontend/src/components/games/GameControls.tsx b/dodaios/ui/web/frontend/src/components/games/GameControls.tsx
new file mode 100644
index 0000000000..31fb28fc64
--- /dev/null
+++ b/dodaios/ui/web/frontend/src/components/games/GameControls.tsx
@@ -0,0 +1,343 @@
+/**
+ * The building blocks of Settings → Game settings: one row per game setting
+ * (slider, number, choice, switch or text) and the keybind capture button.
+ *
+ * Rows keep a local draft while the user drags or types and hand the value
+ * up only when it is settled (pointer up, blur, Enter), so a slider drag is
+ * one save, not fifty.
+ */
+import { useEffect, useRef, useState, type ReactNode } from "react";
+import { RotateCcw } from "lucide-react";
+import { Input } from "@/components/ui/input";
+import { BrandedSelect } from "@/components/ui/select";
+import { Switch } from "@/components/ui/switch";
+import { useT } from "@/i18n";
+import { keyNameFromCode, mouseButtonName, wheelName } from "@/lib/gameKeys";
+import type { GameSetting, GameSettingValue } from "@/lib/gamesApi";
+import { cn } from "@/lib/utils";
+
+function formatDefault(setting: GameSetting, t: (key: string) => string): string | null {
+ const value = setting.default;
+ if (value === null || value === undefined || value === "") return null;
+ if (typeof value === "boolean") return value ? t("games.on") : t("games.off");
+ return String(value);
+}
+
+function SettingShell({
+ setting,
+ saved,
+ onReset,
+ children,
+}: {
+ setting: GameSetting;
+ saved: boolean;
+ onReset: () => void;
+ children: ReactNode;
+}) {
+ const t = useT();
+ const fallback = formatDefault(setting, t);
+ return (
+ <div
+ data-testid={`game-setting-${setting.key}`}
+ className="flex flex-col gap-2 border-b border-border/60 py-3 last:border-b-0 sm:flex-row sm:items-center sm:gap-6"
+ >
+ <div className="min-w-0 sm:w-[42%]">
+ <div className="flex items-center gap-2">
+ <span className="text-sm font-medium text-foreground">{setting.label}</span>
+ {saved && (
+ <span aria-hidden className="h-1.5 w-1.5 shrink-0 rounded-full bg-primary" />
+ )}
+ </div>
+ {(setting.note || fallback) && (
+ <p className="mt-0.5 text-xs text-muted-foreground">
+ {fallback && t("games.default_value").replace("{0}", fallback)}
+ {fallback && setting.note && " · "}
+ {setting.note}
+ </p>
+ )}
+ </div>
+ <div className="flex min-w-0 flex-1 items-center gap-2">
+ <div className="min-w-0 flex-1">{children}</div>
+ <button
+ type="button"
+ onClick={onReset}
+ disabled={!saved}
+ title={t("games.reset_field")}
+ aria-label={`${t("games.reset_field")}: ${setting.label}`}
+ className={cn(
+ "flex h-8 w-8 shrink-0 items-center justify-center rounded-md text-muted-foreground transition-colors hover:bg-secondary hover:text-foreground",
+ !saved && "invisible",
+ )}
+ >
+ <RotateCcw className="h-3.5 w-3.5" aria-hidden />
+ </button>
+ </div>
+ </div>
+ );
+}
+
+function toNumber(raw: string): number | null {
+ if (raw.trim() === "") return null;
+ const value = Number(raw.replace(",", "."));
+ return Number.isFinite(value) ? value : null;
+}
+
+function NumberField({
+ value,
+ setting,
+ onCommit,
+ className,
+}: {
+ value: number | null;
+ setting: GameSetting;
+ onCommit: (value: number | null) => void;
+ className?: string;
+}) {
+ const [draft, setDraft] = useState(value === null ? "" : String(value));
+ useEffect(() => setDraft(value === null ? "" : String(value)), [value]);
+ const commit = () => {
+ const next = toNumber(draft);
+ if (next === value) return;
+ if (draft.trim() !== "" && next === null) {
+ setDraft(value === null ? "" : String(value));
+ return;
+ }
+ onCommit(next);
+ };
+ return (
+ <Input
+ inputMode="decimal"
+ value={draft}
+ placeholder={setting.default !== null ? String(setting.default) : "—"}
+ aria-label={setting.label}
+ onChange={(event) => setDraft(event.currentTarget.value)}
+ onBlur={commit}
+ onKeyDown={(event) => {
+ if (event.key === "Enter") (event.currentTarget as HTMLInputElement).blur();
+ }}
+ className={cn("h-8 font-mono tabular-nums", className)}
+ />
+ );
+}
+
+export function GameSettingRow({
+ setting,
+ value,
+ onChange,
+}: {
+ setting: GameSetting;
+ /** The saved value, or undefined when the game default applies. */
+ value: GameSettingValue | undefined;
+ onChange: (value: GameSettingValue | null) => void;
+}) {
+ const t = useT();
+ const saved = value !== undefined;
+ const effective = saved ? value : setting.default;
+ const reset = () => onChange(null);
+
+ if (setting.type === "toggle") {
+ return (
+ <SettingShell setting={setting} saved={saved} onReset={reset}>
+ <Switch
+ checked={effective === true}
+ aria-label={setting.label}
+ onCheckedChange={(next) => onChange(next)}
+ />
+ </SettingShell>
+ );
+ }
+
+ if (setting.type === "select") {
+ return (
+ <SettingShell setting={setting} saved={saved} onReset={reset}>
+ <BrandedSelect
+ value={typeof effective === "string" ? effective : ""}
+ options={(setting.options ?? []).map((option) => ({ value: option, label: option }))}
+ onValueChange={(next) => onChange(next)}
+ ariaLabel={setting.label}
+ placeholder={t("games.unset")}
+ className="h-8 w-full max-w-xs"
+ />
+ </SettingShell>
+ );
+ }
+
+ if (setting.type === "text") {
+ return (
+ <SettingShell setting={setting} saved={saved} onReset={reset}>
+ <TextField
+ value={typeof value === "string" ? value : ""}
+ label={setting.label}
+ onCommit={(next) => onChange(next === "" ? null : next)}
+ />
+ </SettingShell>
+ );
+ }
+
+ const numeric = typeof effective === "number" ? effective : null;
+ return (
+ <SettingShell setting={setting} saved={saved} onReset={reset}>
+ {setting.type === "slider" ? (
+ <SliderField setting={setting} value={numeric} saved={saved} onCommit={onChange} />
+ ) : (
+ <NumberField setting={setting} value={saved ? numeric : null} onCommit={onChange} className="max-w-[10rem]" />
+ )}
+ </SettingShell>
+ );
+}
+
+function SliderField({
+ setting,
+ value,
+ saved,
+ onCommit,
+}: {
+ setting: GameSetting;
+ value: number | null;
+ saved: boolean;
+ onCommit: (value: number | null) => void;
+}) {
+ const min = setting.min ?? 0;
+ const max = setting.max ?? 100;
+ const [draft, setDraft] = useState<number>(value ?? min);
+ const dirty = useRef(false);
+ useEffect(() => setDraft(value ?? min), [value, min]);
+ const commit = () => {
+ if (!dirty.current) return;
+ dirty.current = false;
+ onCommit(draft);
+ };
+ return (
+ <div className="flex items-center gap-3">
+ <input
+ type="range"
+ min={min}
+ max={max}
+ step={setting.step ?? "any"}
+ value={draft}
+ aria-label={setting.label}
+ onChange={(event) => {
+ dirty.current = true;
+ setDraft(Number(event.currentTarget.value));
+ }}
+ onPointerUp={commit}
+ onKeyUp={commit}
+ onBlur={commit}
+ className={cn("h-1 min-w-0 flex-1 cursor-pointer accent-primary", !saved && value === null && "opacity-50")}
+ />
+ <NumberField
+ setting={setting}
+ value={saved ? value : null}
+ onCommit={onCommit}
+ className="w-24 shrink-0"
+ />
+ </div>
+ );
+}
+
+function TextField({
+ value,
+ label,
+ onCommit,
+}: {
+ value: string;
+ label: string;
+ onCommit: (value: string) => void;
+}) {
+ const [draft, setDraft] = useState(value);
+ useEffect(() => setDraft(value), [value]);
+ return (
+ <Input
+ value={draft}
+ aria-label={label}
+ maxLength={200}
+ onChange={(event) => setDraft(event.currentTarget.value)}
+ onBlur={() => draft.trim() !== value && onCommit(draft.trim())}
+ onKeyDown={(event) => {
+ if (event.key === "Enter") (event.currentTarget as HTMLInputElement).blur();
+ }}
+ className="h-8 font-mono"
+ />
+ );
+}
+
+/**
+ * A button that shows the bound key; click it, then press a key, click a
+ * mouse button or turn the wheel to bind. Escape cancels. While listening,
+ * the press is swallowed so app shortcuts do not fire.
+ */
+export function KeyCaptureButton({
+ value,
+ label,
+ onCapture,
+}: {
+ value: string;
+ label: string;
+ onCapture: (key: string) => void;
+}) {
+ const t = useT();
+ const [listening, setListening] = useState(false);
+ const buttonRef = useRef<HTMLButtonElement>(null);
+
+ useEffect(() => {
+ if (!listening) return;
+ const finish = (key: string | null) => {
+ setListening(false);
+ if (key) onCapture(key);
+ };
+ const onKey = (event: KeyboardEvent) => {
+ event.preventDefault();
+ event.stopPropagation();
+ if (event.code === "Escape") return finish(null);
+ finish(keyNameFromCode(event.code));
+ };
+ const onMouse = (event: MouseEvent) => {
+ event.preventDefault();
+ event.stopPropagation();
+ finish(mouseButtonName(event.button));
+ };
+ const onWheel = (event: WheelEvent) => {
+ event.preventDefault();
+ event.stopPropagation();
+ if (event.deltaY !== 0) finish(wheelName(event.deltaY));
+ };
+ const block = (event: Event) => {
+ event.preventDefault();
+ event.stopPropagation();
+ };
+ // Registered on the next tick so the click that started listening is not
+ // itself taken as the binding.
+ const timer = window.setTimeout(() => {
+ window.addEventListener("keydown", onKey, true);
+ window.addEventListener("mousedown", onMouse, true);
+ window.addEventListener("wheel", onWheel, { capture: true, passive: false });
+ window.addEventListener("contextmenu", block, true);
+ }, 0);
+ return () => {
+ window.clearTimeout(timer);
+ window.removeEventListener("keydown", onKey, true);
+ window.removeEventListener("mousedown", onMouse, true);
+ window.removeEventListener("wheel", onWheel, true);
+ window.removeEventListener("contextmenu", block, true);
+ };
+ }, [listening, onCapture]);
+
+ return (
+ <button
+ ref={buttonRef}
+ type="button"
+ aria-label={`${label}: ${value || t("games.keybind_unbound")}`}
+ aria-pressed={listening}
+ onClick={() => setListening(true)}
+ className={cn(
+ "flex h-8 min-w-[7.5rem] items-center justify-center rounded-md border px-3 font-mono text-xs transition-colors",
+ listening
+ ? "border-primary bg-primary/10 text-foreground"
+ : "border-border bg-muted text-foreground hover:border-border-strong",
+ !value && !listening && "text-muted-foreground",
+ )}
+ >
+ {listening ? t("games.keybind_press") : value || t("games.keybind_unbound")}
+ </button>
+ );
+}
diff --git a/dodaios/ui/web/frontend/src/components/layout/navGroups.ts b/dodaios/ui/web/frontend/src/components/layout/navGroups.ts
index e90b40cc99..fbc1dbad81 100644
--- a/dodaios/ui/web/frontend/src/components/layout/navGroups.ts
+++ b/dodaios/ui/web/frontend/src/components/layout/navGroups.ts
@@ -9,7 +9,7 @@
* A second hand-written list anywhere would be the classic drift trap (AP-4):
* a section added here would silently never appear on the deck.
*/
-import { KeyRound, type LucideIcon } from "lucide-react";
+import { Gamepad2, KeyRound, type LucideIcon } from "lucide-react";
import {
AgentsIcon,
ArtifactsIcon,
@@ -264,6 +264,7 @@ export const SETTINGS_HUB_ONLY_ITEMS: NavItem[] = [
},
{ id: "appshots", labelKey: "nav.appshots", icon: CaptureIcon, fallbackLabel: "Appshots" },
{ id: "pets", labelKey: "nav.pets", icon: PetsIcon, fallbackLabel: "My Pets" },
+ { id: "games", labelKey: "nav.games", icon: Gamepad2, fallbackLabel: "Game settings" },
];
/**
@@ -290,6 +291,7 @@ export const SETTINGS_HUB_IDS: readonly SectionId[] = [
"appshots",
"shortcuts",
"pets",
+ "games",
"costs",
"feedback",
];
diff --git a/dodaios/ui/web/frontend/src/hooks/useGames.ts b/dodaios/ui/web/frontend/src/hooks/useGames.ts
new file mode 100644
index 0000000000..ac21770a4e
--- /dev/null
+++ b/dodaios/ui/web/frontend/src/hooks/useGames.ts
@@ -0,0 +1,61 @@
+/**
+ * React Query hooks for Settings → Game settings. Every write invalidates
+ * the index and the game it touched; nothing polls (AP-33).
+ */
+import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
+import {
+ fetchGame,
+ fetchGames,
+ resetGameProfile,
+ saveDefaultDpi,
+ saveGameProfile,
+ type ProfilePatch,
+} from "@/lib/gamesApi";
+
+export const gameKeys = {
+ all: ["games"] as const,
+ detail: (id: string) => ["games", "detail", id] as const,
+};
+
+export function useGamesIndex() {
+ return useQuery({ queryKey: gameKeys.all, queryFn: fetchGames });
+}
+
+export function useGameDetail(gameId: string | null) {
+ return useQuery({
+ queryKey: gameKeys.detail(gameId ?? ""),
+ queryFn: () => fetchGame(gameId as string),
+ enabled: Boolean(gameId),
+ });
+}
+
+export function useSaveGameProfile() {
+ const client = useQueryClient();
+ return useMutation({
+ mutationFn: ({ gameId, patch }: { gameId: string; patch: ProfilePatch }) =>
+ saveGameProfile(gameId, patch),
+ onSuccess: (_data, { gameId }) => {
+ void client.invalidateQueries({ queryKey: gameKeys.detail(gameId) });
+ void client.invalidateQueries({ queryKey: gameKeys.all, exact: true });
+ },
+ });
+}
+
+export function useResetGameProfile() {
+ const client = useQueryClient();
+ return useMutation({
+ mutationFn: (gameId: string) => resetGameProfile(gameId),
+ onSuccess: (_data, gameId) => {
+ void client.invalidateQueries({ queryKey: gameKeys.detail(gameId) });
+ void client.invalidateQueries({ queryKey: gameKeys.all, exact: true });
+ },
+ });
+}
+
+export function useSaveDefaultDpi() {
+ const client = useQueryClient();
+ return useMutation({
+ mutationFn: (dpi: number) => saveDefaultDpi(dpi),
+ onSuccess: () => void client.invalidateQueries({ queryKey: gameKeys.all }),
+ });
+}
diff --git a/dodaios/ui/web/frontend/src/i18n/locales/de.json b/dodaios/ui/web/frontend/src/i18n/locales/de.json
index cb5e39daac..3a2213e5ad 100644
--- a/dodaios/ui/web/frontend/src/i18n/locales/de.json
+++ b/dodaios/ui/web/frontend/src/i18n/locales/de.json
@@ -334,7 +334,8 @@
"voice_api_keys": "API-Keys",
"shortcuts": "Tastenkürzel",
"pets": "Meine Pets",
- "self_build": "Für dich gebaut"
+ "self_build": "Für dich gebaut",
+ "games": "Spieleinstellungen"
},
"assistant_view": {
"header_named": "Dein Assistent in {0}, geweckt mit „{1}“.",
@@ -7754,7 +7755,7 @@
"write_other": "Dateien erstellt",
"image_one": "ein Bild angesehen",
"image_other": "Bilder angesehen",
- "used": "{what} verwendet" ,
+ "used": "{what} verwendet",
"lookup_one": "Werkzeuge nachgeschlagen",
"lookup_other": "Werkzeuge nachgeschlagen",
"asked_one": "dich gefragt",
@@ -7766,7 +7767,7 @@
"search": "Nach {pattern} gesucht",
"search_in": "In {path} nach {pattern} gesucht",
"edit": "{target} bearbeitet",
- "write": "{target} erstellt" ,
+ "write": "{target} erstellt",
"lookup": "Werkzeuge nachgeschlagen",
"asked": "Dich gefragt"
},
@@ -10803,5 +10804,57 @@
"reach_tool_plain": "Das ganze Werkzeug",
"cancel": "Abbrechen"
}
+ },
+ "games": {
+ "title": "Spieleinstellungen",
+ "subtitle": "Sensitivity, Keybinds, Audio und Grafik für jedes Spiel an einem Ort, dazu ein Umrechner, der dein Aim von einem Spiel ins nächste mitnimmt.",
+ "default_dpi": "Maus-DPI",
+ "search": "Spiele suchen",
+ "saved_badge": "Gespeichert",
+ "load_error": "Die Spieleinstellungen konnten nicht geladen werden: {0}",
+ "save_error": "Das wurde nicht gespeichert: {0}",
+ "section_empty": "Für dieses Spiel gibt es hier noch keine Einstellungen.",
+ "game_dpi": "DPI für dieses Spiel",
+ "follow_default": "Nutzt den Standard von {0} DPI.",
+ "cm360": "cm/360",
+ "cm360_hint": "Mausweg für eine volle Drehung.",
+ "edpi": "eDPI",
+ "not_convertible": "Die Sensitivity dieses Spiels ist nicht linear und lässt sich daher nicht umrechnen.",
+ "keybind_hint": "Klicke auf eine Taste und drücke dann eine Taste, eine Maustaste oder dreh am Mausrad. Esc bricht ab.",
+ "keybind_press": "Taste drücken…",
+ "keybind_unbound": "Nicht belegt",
+ "keybind_clear": "Leeren",
+ "keybind_reset": "Standard",
+ "keybind_conflict": "Auch belegt von: {0}",
+ "default_value": "Standard: {0}",
+ "unset": "Nicht gesetzt",
+ "reset_field": "Zurück zum Spielstandard",
+ "on": "An",
+ "off": "Aus",
+ "converter_hint": "Gleiches Gefühl in jedem Spiel: gleiche cm/360 bei deiner DPI. Nur Hipfire; Scope- und ADS-Multiplikatoren hängen vom jeweiligen Spiel ab.",
+ "converter_from": "Deine {0}-Sensitivity",
+ "converter_target_dpi": "Ziel-DPI (optional)",
+ "converter_game": "Spiel",
+ "converter_sens": "Sensitivity",
+ "converter_apply": "Speichern",
+ "converter_applied": "{0} für {1} gespeichert.",
+ "converter_unavailable": "{0} hat keine lineare Sensitivity und lässt sich daher nicht umrechnen.",
+ "notes": "Notizen",
+ "notes_placeholder": "Crosshair, Routinen, alles, was du dir merken willst.",
+ "config_file": "Wo das Spiel seine Einstellungen speichert",
+ "copy": "Kopieren",
+ "copied": "In die Zwischenablage kopiert.",
+ "copy_failed": "Kopieren fehlgeschlagen.",
+ "reset_profile": "Zurücksetzen",
+ "reset_confirm": "Zum Zurücksetzen erneut klicken",
+ "reset_done": "{0} ist wieder auf Standard.",
+ "tabs": {
+ "mouse": "Maus",
+ "keybinds": "Keybinds",
+ "audio": "Audio",
+ "video": "Grafik",
+ "gameplay": "Gameplay",
+ "converter": "Umrechner"
+ }
}
}
diff --git a/dodaios/ui/web/frontend/src/i18n/locales/en.json b/dodaios/ui/web/frontend/src/i18n/locales/en.json
index 4423c7d16b..03f348a984 100644
--- a/dodaios/ui/web/frontend/src/i18n/locales/en.json
+++ b/dodaios/ui/web/frontend/src/i18n/locales/en.json
@@ -334,7 +334,8 @@
"voice_api_keys": "API Keys",
"shortcuts": "Keyboard shortcuts",
"pets": "My Pets",
- "self_build": "Built for you"
+ "self_build": "Built for you",
+ "games": "Game settings"
},
"assistant_view": {
"header_named": "Your assistant in {0}, woken by “{1}”.",
@@ -7754,7 +7755,7 @@
"write_other": "created files",
"image_one": "viewed an image",
"image_other": "viewed images",
- "used": "used {what}" ,
+ "used": "used {what}",
"lookup_one": "looked up tools",
"lookup_other": "looked up tools",
"asked_one": "asked you",
@@ -7766,7 +7767,7 @@
"search": "Searched for {pattern}",
"search_in": "Searched for {pattern} in {path}",
"edit": "Edited {target}",
- "write": "Created {target}" ,
+ "write": "Created {target}",
"lookup": "Looked up tools",
"asked": "Asked you"
},
@@ -10803,5 +10804,57 @@
"reach_tool_plain": "This whole tool",
"cancel": "Cancel"
}
+ },
+ "games": {
+ "title": "Game settings",
+ "subtitle": "Your sensitivity, keybinds, audio and video for every game in one place, and a converter that carries your aim from one game to another.",
+ "default_dpi": "Mouse DPI",
+ "search": "Search games",
+ "saved_badge": "Saved",
+ "load_error": "Game settings could not be loaded: {0}",
+ "save_error": "That did not save: {0}",
+ "section_empty": "This game has no settings here yet.",
+ "game_dpi": "DPI for this game",
+ "follow_default": "Uses the default of {0} DPI.",
+ "cm360": "cm/360",
+ "cm360_hint": "Mouse travel for one full turn.",
+ "edpi": "eDPI",
+ "not_convertible": "This game's sensitivity is not linear, so it cannot be converted.",
+ "keybind_hint": "Click a key, then press a key, a mouse button or turn the wheel. Esc cancels.",
+ "keybind_press": "Press a key…",
+ "keybind_unbound": "Unbound",
+ "keybind_clear": "Clear",
+ "keybind_reset": "Default",
+ "keybind_conflict": "Also used by: {0}",
+ "default_value": "Default: {0}",
+ "unset": "Not set",
+ "reset_field": "Back to the game default",
+ "on": "On",
+ "off": "Off",
+ "converter_hint": "Same feel in every game: the same cm/360 at your DPI. Hip-fire only; scoped and ADS multipliers depend on each game.",
+ "converter_from": "Your {0} sensitivity",
+ "converter_target_dpi": "Target DPI (optional)",
+ "converter_game": "Game",
+ "converter_sens": "Sensitivity",
+ "converter_apply": "Save",
+ "converter_applied": "{0} saved for {1}.",
+ "converter_unavailable": "{0} has no linear sensitivity, so it cannot be converted.",
+ "notes": "Notes",
+ "notes_placeholder": "Crosshair, routines, anything you want to remember.",
+ "config_file": "Where the game keeps its settings",
+ "copy": "Copy",
+ "copied": "Copied to the clipboard.",
+ "copy_failed": "Could not copy.",
+ "reset_profile": "Reset",
+ "reset_confirm": "Click again to reset",
+ "reset_done": "{0} is back to defaults.",
+ "tabs": {
+ "mouse": "Mouse",
+ "keybinds": "Keybinds",
+ "audio": "Audio",
+ "video": "Video",
+ "gameplay": "Gameplay",
+ "converter": "Converter"
+ }
}
}
diff --git a/dodaios/ui/web/frontend/src/i18n/locales/es.json b/dodaios/ui/web/frontend/src/i18n/locales/es.json
index 9a0cbea8e6..6de3d232be 100644
--- a/dodaios/ui/web/frontend/src/i18n/locales/es.json
+++ b/dodaios/ui/web/frontend/src/i18n/locales/es.json
@@ -334,7 +334,8 @@
"voice_api_keys": "Claves API",
"shortcuts": "Atajos de teclado",
"pets": "Mis mascotas",
- "self_build": "Hecho para ti"
+ "self_build": "Hecho para ti",
+ "games": "Ajustes de juegos"
},
"assistant_view": {
"header_named": "Tu asistente en {0}, se despierta con «{1}».",
@@ -7754,7 +7755,7 @@
"write_other": "creó archivos",
"image_one": "vio una imagen",
"image_other": "vio imágenes",
- "used": "usó {what}" ,
+ "used": "usó {what}",
"lookup_one": "consultó herramientas",
"lookup_other": "consultó herramientas",
"asked_one": "te preguntó",
@@ -7766,7 +7767,7 @@
"search": "Buscó {pattern}",
"search_in": "Buscó {pattern} en {path}",
"edit": "Editó {target}",
- "write": "Creó {target}" ,
+ "write": "Creó {target}",
"lookup": "Consultó herramientas",
"asked": "Te preguntó"
},
@@ -10803,5 +10804,57 @@
"reach_tool_plain": "Toda la herramienta",
"cancel": "Cancelar"
}
+ },
+ "games": {
+ "title": "Ajustes de juegos",
+ "subtitle": "Tu sensibilidad, controles, audio y vídeo de cada juego en un solo lugar, y un conversor que lleva tu puntería de un juego a otro.",
+ "default_dpi": "DPI del ratón",
+ "search": "Buscar juegos",
+ "saved_badge": "Guardado",
+ "load_error": "No se pudieron cargar los ajustes de juegos: {0}",
+ "save_error": "No se guardó: {0}",
+ "section_empty": "Este juego aún no tiene ajustes aquí.",
+ "game_dpi": "DPI para este juego",
+ "follow_default": "Usa el valor por defecto de {0} DPI.",
+ "cm360": "cm/360",
+ "cm360_hint": "Recorrido del ratón para un giro completo.",
+ "edpi": "eDPI",
+ "not_convertible": "La sensibilidad de este juego no es lineal, así que no se puede convertir.",
+ "keybind_hint": "Haz clic en una tecla y luego pulsa una tecla, un botón del ratón o gira la rueda. Esc cancela.",
+ "keybind_press": "Pulsa una tecla…",
+ "keybind_unbound": "Sin asignar",
+ "keybind_clear": "Quitar",
+ "keybind_reset": "Por defecto",
+ "keybind_conflict": "También la usa: {0}",
+ "default_value": "Por defecto: {0}",
+ "unset": "Sin definir",
+ "reset_field": "Volver al valor del juego",
+ "on": "Sí",
+ "off": "No",
+ "converter_hint": "La misma sensación en cada juego: los mismos cm/360 con tu DPI. Solo disparo desde la cadera; los multiplicadores de mira dependen de cada juego.",
+ "converter_from": "Tu sensibilidad en {0}",
+ "converter_target_dpi": "DPI de destino (opcional)",
+ "converter_game": "Juego",
+ "converter_sens": "Sensibilidad",
+ "converter_apply": "Guardar",
+ "converter_applied": "{0} guardado para {1}.",
+ "converter_unavailable": "{0} no tiene sensibilidad lineal, así que no se puede convertir.",
+ "notes": "Notas",
+ "notes_placeholder": "Mira, rutinas, todo lo que quieras recordar.",
+ "config_file": "Dónde guarda el juego sus ajustes",
+ "copy": "Copiar",
+ "copied": "Copiado al portapapeles.",
+ "copy_failed": "No se pudo copiar.",
+ "reset_profile": "Restablecer",
+ "reset_confirm": "Haz clic otra vez para restablecer",
+ "reset_done": "{0} vuelve a los valores por defecto.",
+ "tabs": {
+ "mouse": "Ratón",
+ "keybinds": "Controles",
+ "audio": "Audio",
+ "video": "Vídeo",
+ "gameplay": "Jugabilidad",
+ "converter": "Conversor"
+ }
}
}
diff --git a/dodaios/ui/web/frontend/src/i18n/locales/pt.json b/dodaios/ui/web/frontend/src/i18n/locales/pt.json
index 47527b78c9..0d82a98e4c 100644
--- a/dodaios/ui/web/frontend/src/i18n/locales/pt.json
+++ b/dodaios/ui/web/frontend/src/i18n/locales/pt.json
@@ -334,7 +334,8 @@
"voice_api_keys": "Chaves de API",
"shortcuts": "Atalhos de teclado",
"pets": "Os meus Pets",
- "self_build": "Feito para si"
+ "self_build": "Feito para si",
+ "games": "Configurações de jogos"
},
"assistant_view": {
"header_named": "O teu assistente em {0}, despertado por “{1}”.",
@@ -7754,7 +7755,7 @@
"write_other": "criou ficheiros",
"image_one": "viu uma imagem",
"image_other": "viu imagens",
- "used": "usou {what}" ,
+ "used": "usou {what}",
"lookup_one": "consultou ferramentas",
"lookup_other": "consultou ferramentas",
"asked_one": "perguntou a você",
@@ -7766,7 +7767,7 @@
"search": "Pesquisou {pattern}",
"search_in": "Pesquisou {pattern} em {path}",
"edit": "Editou {target}",
- "write": "Criou {target}" ,
+ "write": "Criou {target}",
"lookup": "Consultou ferramentas",
"asked": "Perguntou a você"
},
@@ -10803,5 +10804,57 @@
"reach_tool_plain": "A ferramenta toda",
"cancel": "Cancelar"
}
+ },
+ "games": {
+ "title": "Configurações de jogos",
+ "subtitle": "Sua sensibilidade, atalhos, áudio e vídeo de cada jogo em um só lugar, e um conversor que leva sua mira de um jogo para outro.",
+ "default_dpi": "DPI do mouse",
+ "search": "Buscar jogos",
+ "saved_badge": "Salvo",
+ "load_error": "Não foi possível carregar as configurações de jogos: {0}",
+ "save_error": "Não foi salvo: {0}",
+ "section_empty": "Este jogo ainda não tem configurações aqui.",
+ "game_dpi": "DPI para este jogo",
+ "follow_default": "Usa o padrão de {0} DPI.",
+ "cm360": "cm/360",
+ "cm360_hint": "Distância do mouse para uma volta completa.",
+ "edpi": "eDPI",
+ "not_convertible": "A sensibilidade deste jogo não é linear, então não pode ser convertida.",
+ "keybind_hint": "Clique em uma tecla e depois pressione uma tecla, um botão do mouse ou gire a roda. Esc cancela.",
+ "keybind_press": "Pressione uma tecla…",
+ "keybind_unbound": "Sem atalho",
+ "keybind_clear": "Limpar",
+ "keybind_reset": "Padrão",
+ "keybind_conflict": "Também usada por: {0}",
+ "default_value": "Padrão: {0}",
+ "unset": "Não definido",
+ "reset_field": "Voltar ao padrão do jogo",
+ "on": "Ligado",
+ "off": "Desligado",
+ "converter_hint": "A mesma sensação em cada jogo: os mesmos cm/360 no seu DPI. Só tiro sem mira; multiplicadores de mira dependem de cada jogo.",
+ "converter_from": "Sua sensibilidade em {0}",
+ "converter_target_dpi": "DPI de destino (opcional)",
+ "converter_game": "Jogo",
+ "converter_sens": "Sensibilidade",
+ "converter_apply": "Salvar",
+ "converter_applied": "{0} salvo para {1}.",
+ "converter_unavailable": "{0} não tem sensibilidade linear, então não pode ser convertido.",
+ "notes": "Notas",
+ "notes_placeholder": "Mira, rotinas, tudo o que quiser lembrar.",
+ "config_file": "Onde o jogo guarda as configurações",
+ "copy": "Copiar",
+ "copied": "Copiado para a área de transferência.",
+ "copy_failed": "Não foi possível copiar.",
+ "reset_profile": "Redefinir",
+ "reset_confirm": "Clique de novo para redefinir",
+ "reset_done": "{0} voltou ao padrão.",
+ "tabs": {
+ "mouse": "Mouse",
+ "keybinds": "Atalhos",
+ "audio": "Áudio",
+ "video": "Vídeo",
+ "gameplay": "Jogabilidade",
+ "converter": "Conversor"
+ }
}
}
diff --git a/dodaios/ui/web/frontend/src/i18n/locales/zh.json b/dodaios/ui/web/frontend/src/i18n/locales/zh.json
index 65b06a0d21..5e6172158a 100644
--- a/dodaios/ui/web/frontend/src/i18n/locales/zh.json
+++ b/dodaios/ui/web/frontend/src/i18n/locales/zh.json
@@ -334,7 +334,8 @@
"voice_api_keys": "API 密钥",
"shortcuts": "键盘快捷键",
"pets": "我的宠物",
- "self_build": "为你构建"
+ "self_build": "为你构建",
+ "games": "游戏设置"
},
"assistant_view": {
"header_named": "你在 {0} 中的助手,用“{1}”唤醒。",
@@ -7754,7 +7755,7 @@
"write_other": "创建了多个文件",
"image_one": "查看了一张图片",
"image_other": "查看了多张图片",
- "used": "使用了 {what}" ,
+ "used": "使用了 {what}",
"lookup_one": "查找了工具",
"lookup_other": "查找了工具",
"asked_one": "向你提问",
@@ -7766,7 +7767,7 @@
"search": "搜索了 {pattern}",
"search_in": "在 {path} 中搜索了 {pattern}",
"edit": "编辑了 {target}",
- "write": "创建了 {target}" ,
+ "write": "创建了 {target}",
"lookup": "查找了工具",
"asked": "向你提问"
},
@@ -10803,5 +10804,57 @@
"reach_tool_plain": "整个工具",
"cancel": "取消"
}
+ },
+ "games": {
+ "title": "游戏设置",
+ "subtitle": "每款游戏的灵敏度、按键、音频和画面集中在一处,还有一个换算器,把你的手感从一款游戏带到另一款。",
+ "default_dpi": "鼠标 DPI",
+ "search": "搜索游戏",
+ "saved_badge": "已保存",
+ "load_error": "无法加载游戏设置:{0}",
+ "save_error": "未能保存:{0}",
+ "section_empty": "这款游戏在这里还没有设置。",
+ "game_dpi": "此游戏的 DPI",
+ "follow_default": "使用默认的 {0} DPI。",
+ "cm360": "cm/360",
+ "cm360_hint": "转一整圈所需的鼠标移动距离。",
+ "edpi": "eDPI",
+ "not_convertible": "这款游戏的灵敏度不是线性的,无法换算。",
+ "keybind_hint": "点击一个按键,然后按下键盘按键、鼠标按键或滚动滚轮。按 Esc 取消。",
+ "keybind_press": "请按键…",
+ "keybind_unbound": "未绑定",
+ "keybind_clear": "清除",
+ "keybind_reset": "默认",
+ "keybind_conflict": "同时被使用:{0}",
+ "default_value": "默认:{0}",
+ "unset": "未设置",
+ "reset_field": "恢复游戏默认值",
+ "on": "开",
+ "off": "关",
+ "converter_hint": "每款游戏手感一致:在你的 DPI 下保持相同的 cm/360。仅限腰射;开镜倍率取决于各游戏。",
+ "converter_from": "你的 {0} 灵敏度",
+ "converter_target_dpi": "目标 DPI(可选)",
+ "converter_game": "游戏",
+ "converter_sens": "灵敏度",
+ "converter_apply": "保存",
+ "converter_applied": "已为 {1} 保存 {0}。",
+ "converter_unavailable": "{0} 的灵敏度不是线性的,无法换算。",
+ "notes": "备注",
+ "notes_placeholder": "准星、习惯,任何你想记住的东西。",
+ "config_file": "游戏保存设置的位置",
+ "copy": "复制",
+ "copied": "已复制到剪贴板。",
+ "copy_failed": "无法复制。",
+ "reset_profile": "重置",
+ "reset_confirm": "再次点击以重置",
+ "reset_done": "{0} 已恢复默认。",
+ "tabs": {
+ "mouse": "鼠标",
+ "keybinds": "按键",
+ "audio": "音频",
+ "video": "画面",
+ "gameplay": "玩法",
+ "converter": "换算器"
+ }
}
}
diff --git a/dodaios/ui/web/frontend/src/lib/gameKeys.test.ts b/dodaios/ui/web/frontend/src/lib/gameKeys.test.ts
new file mode 100644
index 0000000000..55a06893d6
--- /dev/null
+++ b/dodaios/ui/web/frontend/src/lib/gameKeys.test.ts
@@ -0,0 +1,40 @@
+import { describe, expect, it } from "vitest";
+
+import { keyConflicts, keyNameFromCode, mouseButtonName, wheelName } from "@/lib/gameKeys";
+
+describe("game key names", () => {
+ it("names keys the way game menus print them", () => {
+ expect(keyNameFromCode("KeyW")).toBe("W");
+ expect(keyNameFromCode("Digit4")).toBe("4");
+ expect(keyNameFromCode("ShiftLeft")).toBe("Left Shift");
+ expect(keyNameFromCode("ControlLeft")).toBe("Left Ctrl");
+ expect(keyNameFromCode("Space")).toBe("Space");
+ expect(keyNameFromCode("F12")).toBe("F12");
+ expect(keyNameFromCode("Numpad5")).toBe("Numpad 5");
+ expect(keyNameFromCode("Unidentified")).toBeNull();
+ });
+
+ it("names mouse buttons and the wheel", () => {
+ expect(mouseButtonName(0)).toBe("Left Mouse");
+ expect(mouseButtonName(3)).toBe("Mouse 4");
+ expect(mouseButtonName(9)).toBeNull();
+ expect(wheelName(-1)).toBe("Mouse Wheel Up");
+ expect(wheelName(1)).toBe("Mouse Wheel Down");
+ });
+});
+
+describe("keyConflicts", () => {
+ it("flags actions sharing a key, case-insensitively, and ignores unbound ones", () => {
+ const conflicts = keyConflicts([
+ { id: "jump", action: "Jump", key: "Space" },
+ { id: "vault", action: "Vault", key: "space" },
+ { id: "crouch", action: "Crouch", key: "C" },
+ { id: "a", action: "A", key: "" },
+ { id: "b", action: "B", key: "" },
+ ]);
+ expect(conflicts.get("jump")).toEqual(["Vault"]);
+ expect(conflicts.get("vault")).toEqual(["Jump"]);
+ expect(conflicts.has("crouch")).toBe(false);
+ expect(conflicts.has("a")).toBe(false);
+ });
+});
diff --git a/dodaios/ui/web/frontend/src/lib/gameKeys.ts b/dodaios/ui/web/frontend/src/lib/gameKeys.ts
new file mode 100644
index 0000000000..8076816570
--- /dev/null
+++ b/dodaios/ui/web/frontend/src/lib/gameKeys.ts
@@ -0,0 +1,96 @@
+/**
+ * Key names for game keybinds, in the words games print in their menus
+ * ("Left Shift", "Mouse 4", "Space") rather than browser codes.
+ */
+
+const CODE_NAMES: Record<string, string> = {
+ Space: "Space",
+ ShiftLeft: "Left Shift",
+ ShiftRight: "Right Shift",
+ ControlLeft: "Left Ctrl",
+ ControlRight: "Right Ctrl",
+ AltLeft: "Left Alt",
+ AltRight: "Right Alt",
+ MetaLeft: "Left Win",
+ MetaRight: "Right Win",
+ CapsLock: "Caps Lock",
+ Tab: "Tab",
+ Enter: "Enter",
+ Backspace: "Backspace",
+ Delete: "Delete",
+ Insert: "Insert",
+ Home: "Home",
+ End: "End",
+ PageUp: "Page Up",
+ PageDown: "Page Down",
+ ArrowUp: "Up Arrow",
+ ArrowDown: "Down Arrow",
+ ArrowLeft: "Left Arrow",
+ ArrowRight: "Right Arrow",
+ Backquote: "`",
+ Minus: "-",
+ Equal: "=",
+ BracketLeft: "[",
+ BracketRight: "]",
+ Backslash: "\\",
+ Semicolon: ";",
+ Quote: "'",
+ Comma: ",",
+ Period: ".",
+ Slash: "/",
+ IntlBackslash: "<",
+ NumpadAdd: "Numpad +",
+ NumpadSubtract: "Numpad -",
+ NumpadMultiply: "Numpad *",
+ NumpadDivide: "Numpad /",
+ NumpadDecimal: "Numpad .",
+ NumpadEnter: "Numpad Enter",
+};
+
+/** The game-style name of a pressed key, or null for keys we cannot name. */
+export function keyNameFromCode(code: string): string | null {
+ if (CODE_NAMES[code]) return CODE_NAMES[code];
+ let m = /^Key([A-Z])$/.exec(code);
+ if (m) return m[1];
+ m = /^Digit([0-9])$/.exec(code);
+ if (m) return m[1];
+ m = /^Numpad([0-9])$/.exec(code);
+ if (m) return `Numpad ${m[1]}`;
+ m = /^F([0-9]{1,2})$/.exec(code);
+ if (m) return `F${m[1]}`;
+ return null;
+}
+
+const MOUSE_NAMES = ["Left Mouse", "Middle Mouse", "Right Mouse", "Mouse 4", "Mouse 5"];
+
+/** `MouseEvent.button` → game-style name. */
+export function mouseButtonName(button: number): string | null {
+ return MOUSE_NAMES[button] ?? null;
+}
+
+export function wheelName(deltaY: number): string {
+ return deltaY < 0 ? "Mouse Wheel Up" : "Mouse Wheel Down";
+}
+
+/**
+ * Which actions share a key with another action: action id → the other
+ * actions' labels. Unbound actions never conflict.
+ */
+export function keyConflicts(
+ binds: readonly { id: string; action: string; key: string }[],
+): Map<string, string[]> {
+ const byKey = new Map<string, { id: string; action: string }[]>();
+ for (const bind of binds) {
+ const key = bind.key.trim().toLowerCase();
+ if (!key) continue;
+ byKey.set(key, [...(byKey.get(key) ?? []), bind]);
+ }
+ const out = new Map<string, string[]>();
+ for (const group of byKey.values()) {
+ if (group.length < 2) continue;
+ for (const bind of group) {
+ out.set(bind.id, group.filter((other) => other.id !== bind.id).map((other) => other.action));
+ }
+ }
+ return out;
+}
diff --git a/dodaios/ui/web/frontend/src/lib/gamesApi.ts b/dodaios/ui/web/frontend/src/lib/gamesApi.ts
new file mode 100644
index 0000000000..705a5e8b9e
--- /dev/null
+++ b/dodaios/ui/web/frontend/src/lib/gamesApi.ts
@@ -0,0 +1,156 @@
+/**
+ * Client for `/api/games` — Settings → Game settings (docs/game-settings.md).
+ *
+ * The catalog (which settings each game has) comes from the backend, so a
+ * new game is one entry in `dodaios/games/catalog.json`, not a frontend change.
+ */
+
+export type GameSettingType = "slider" | "number" | "select" | "toggle" | "text";
+export type GameSettingValue = number | string | boolean;
+export type GameSectionId = "mouse" | "audio" | "video" | "gameplay";
+
+export interface GameSetting {
+ key: string;
+ label: string;
+ type: GameSettingType;
+ min?: number;
+ max?: number;
+ step?: number;
+ options?: string[];
+ default: GameSettingValue | null;
+ note?: string;
+}
+
+export interface GameKeybind {
+ id: string;
+ action: string;
+ default: string;
+ note?: string;
+}
+
+export interface GameDefinition {
+ id: string;
+ name: string;
+ publisher: string;
+ /** Degrees per mouse count at sensitivity 1; null when not linear. */
+ yaw: number | null;
+ yaw_note: string;
+ /** The hip-fire setting the converter reads and writes. */
+ sens_key: string | null;
+ config_file: string;
+ sources: string[];
+ sections: { id: GameSectionId; settings: GameSetting[] }[];
+ keybinds: GameKeybind[];
+}
+
+export interface GameProfile {
+ values: Record<string, GameSettingValue>;
+ keybinds: Record<string, string>;
+ dpi: number | null;
+ notes: string;
+ updated_at: string | null;
+}
+
+export interface GameSummary {
+ id: string;
+ name: string;
+ publisher: string;
+ convertible: boolean;
+ has_profile: boolean;
+ updated_at: string | null;
+}
+
+export interface GamesIndex {
+ dpi: number;
+ games: GameSummary[];
+}
+
+export interface GameDetail {
+ game: GameDefinition;
+ profile: GameProfile;
+ default_dpi: number;
+}
+
+export interface ProfilePatch {
+ values?: Record<string, GameSettingValue | null>;
+ keybinds?: Record<string, string | null>;
+ dpi?: number;
+ reset_dpi?: boolean;
+ notes?: string;
+}
+
+export interface ConvertResult {
+ game_id: string;
+ sens: number;
+ dpi: number;
+ to_dpi: number;
+ cm_per_360: number;
+ edpi: number;
+ results: { id: string; name: string; sens_key: string; sens: number; edpi: number }[];
+}
+
+export class GamesRequestError extends Error {
+ readonly status: number;
+
+ constructor(message: string, status: number) {
+ super(message);
+ this.name = "GamesRequestError";
+ this.status = status;
+ }
+}
+
+async function request<T>(url: string, init?: RequestInit): Promise<T> {
+ const response = await fetch(url, init);
+ const body = (await response.json().catch(() => null)) as T | { detail?: unknown } | null;
+ if (!response.ok) {
+ const detail =
+ body && typeof body === "object" && "detail" in body && typeof body.detail === "string"
+ ? body.detail
+ : "";
+ throw new GamesRequestError(detail || `Request failed (${response.status}).`, response.status);
+ }
+ return body as T;
+}
+
+function sendJson<T>(url: string, method: string, payload: unknown): Promise<T> {
+ return request<T>(url, {
+ method,
+ headers: { "content-type": "application/json" },
+ body: JSON.stringify(payload),
+ });
+}
+
+export function fetchGames(): Promise<GamesIndex> {
+ return request<GamesIndex>("/api/games");
+}
+
+export function fetchGame(gameId: string): Promise<GameDetail> {
+ return request<GameDetail>(`/api/games/${encodeURIComponent(gameId)}`);
+}
+
+export function saveGameProfile(gameId: string, patch: ProfilePatch): Promise<{ profile: GameProfile }> {
+ return sendJson(`/api/games/${encodeURIComponent(gameId)}/profile`, "PUT", patch);
+}
+
+export function resetGameProfile(gameId: string): Promise<{ removed: boolean }> {
+ return request(`/api/games/${encodeURIComponent(gameId)}/profile`, { method: "DELETE" });
+}
+
+export function saveDefaultDpi(dpi: number): Promise<{ dpi: number }> {
+ return sendJson("/api/games/dpi", "PUT", { dpi });
+}
+
+export function convertSensitivity(input: {
+ game_id: string;
+ sens: number;
+ dpi?: number;
+ to_dpi?: number;
+}): Promise<ConvertResult> {
+ return sendJson("/api/games/convert", "POST", input);
+}
+
+/** cm of mouse travel for a 360° turn (same formula as dodaios/games/sensitivity.py). */
+export function cmPer360(yaw: number, sens: number, dpi: number): number | null {
+ if (!(yaw > 0 && sens > 0 && dpi > 0)) return null;
+ return (360 / (yaw * sens * dpi)) * 2.54;
+}
diff --git a/dodaios/ui/web/frontend/src/lib/quickSwitch.ts b/dodaios/ui/web/frontend/src/lib/quickSwitch.ts
index 836823eeb2..8221944314 100644
--- a/dodaios/ui/web/frontend/src/lib/quickSwitch.ts
+++ b/dodaios/ui/web/frontend/src/lib/quickSwitch.ts
@@ -305,20 +305,27 @@ export function rankQuickSwitch(
): RankedEntry[] {
const needle = normalizeQuery(query);
if (!needle) return [];
- const rows: RankedEntry[] = [];
+ const rows: (RankedEntry & { score: number })[] = [];
for (const item of entries) {
const label = labelFor(item);
const prefix = labelStartsWith(label, needle);
- const matches =
- prefix ||
- (needle.length > SHORT_QUERY &&
- entryTerms(item, label).some((term) => scoreTerm(term, needle) > 0));
- if (matches) rows.push({ entry: item, label, prefix });
+ const score =
+ needle.length > SHORT_QUERY
+ ? Math.max(0, ...entryTerms(item, label).map((term) => scoreTerm(term, needle)))
+ : 0;
+ if (prefix || score > 0) rows.push({ entry: item, label, prefix, score });
}
- return rows.sort(
- (a, b) =>
- compareMatches(a, b) || Number(Boolean(a.entry.parentLabelKey)) - Number(Boolean(b.entry.parentLabelKey)),
- );
+ // Rows reached through another name (a German query for Settings) rank by how
+ // well that name matched before the alphabet: an exact other-language name
+ // beats one that merely contains the query (the German Game settings label).
+ return rows
+ .sort(
+ (a, b) =>
+ (a.prefix === b.prefix && !a.prefix ? b.score - a.score : 0) ||
+ compareMatches(a, b) ||
+ Number(Boolean(a.entry.parentLabelKey)) - Number(Boolean(b.entry.parentLabelKey)),
+ )
+ .map(({ score: _score, ...row }) => row);
}
/**
diff --git a/dodaios/ui/web/frontend/src/store/events.ts b/dodaios/ui/web/frontend/src/store/events.ts
index deeaef120c..5fb3f084dc 100644
--- a/dodaios/ui/web/frontend/src/store/events.ts
+++ b/dodaios/ui/web/frontend/src/store/events.ts
@@ -89,6 +89,9 @@ export type SectionId =
// My Pets: the desktop pet — which one, its size, its bubble, and custom
// pets from a sprite sheet (docs/pets.md). A Settings-hub page.
| "pets"
+ // Game settings: per-game sensitivity, keybinds, audio, video and
+ // gameplay, plus a sensitivity converter between games. A Settings-hub page.
+ | "games"
| "dictionary"
| "dictation"
// The three tabs added by the merged voice section. "dictation" (default
@@ -145,6 +148,7 @@ export const SECTION_IDS = [
"appshots",
"shortcuts",
"pets",
+ "games",
"dictionary",
"dictation",
// `satisfies` only catches array entries that are missing from the union,
@@ -242,6 +246,7 @@ export const SECTION_LABELS: Record<SectionId, string> = {
appshots: "Appshots",
shortcuts: "Keyboard shortcuts",
pets: "My Pets",
+ games: "Game settings",
dictionary: "Dictionary",
dictation: "Dictation",
// Plain English, deliberately NOT the "{name} Voice" brand: these labels are
@@ -289,6 +294,7 @@ export const SECTION_LABEL_KEYS: Record<SectionId, string> = {
appshots: "nav.appshots",
shortcuts: "nav.shortcuts",
pets: "nav.pets",
+ games: "nav.games",
dictionary: "nav.dictionary",
dictation: "nav.dictation",
"voice-shortcuts": "shell_sections.voice_shortcuts",
diff --git a/dodaios/ui/web/frontend/src/views/GamesView.test.tsx b/dodaios/ui/web/frontend/src/views/GamesView.test.tsx
new file mode 100644
index 0000000000..55a25bfe04
--- /dev/null
+++ b/dodaios/ui/web/frontend/src/views/GamesView.test.tsx
@@ -0,0 +1,178 @@
+import { QueryClient, QueryClientProvider } from "@tanstack/react-query";
+import { act, cleanup, fireEvent, render, screen, waitFor, within } from "@testing-library/react";
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+
+import { GamesView, profileSummary } from "@/views/GamesView";
+import type { GameDefinition, GameProfile } from "@/lib/gamesApi";
+
+const CS2: GameDefinition = {
+ id: "cs2",
+ name: "Counter-Strike 2",
+ publisher: "Valve",
+ yaw: 0.022,
+ yaw_note: "",
+ sens_key: "sensitivity",
+ config_file: "Steam\\userdata\\cfg",
+ sources: [],
+ sections: [
+ {
+ id: "mouse",
+ settings: [
+ { key: "sensitivity", label: "Mouse Sensitivity", type: "slider", min: 0.01, max: 8, step: 0.01, default: 1.25 },
+ ],
+ },
+ {
+ id: "audio",
+ settings: [{ key: "master", label: "Master Volume", type: "slider", min: 0, max: 100, step: 1, default: null }],
+ },
+ {
+ id: "video",
+ settings: [
+ { key: "mode", label: "Display Mode", type: "select", options: ["Fullscreen", "Windowed"], default: "Fullscreen" },
+ ],
+ },
+ { id: "gameplay", settings: [{ key: "hud", label: "Show HUD", type: "toggle", default: true }] },
+ ],
+ keybinds: [
+ { id: "jump", action: "Jump", default: "Space" },
+ { id: "crouch", action: "Crouch", default: "Left Ctrl" },
+ ],
+};
+
+interface Call {
+ method: string;
+ url: string;
+ body: unknown;
+}
+
+function stubServer() {
+ const profile: GameProfile = { values: {}, keybinds: {}, dpi: null, notes: "", updated_at: null };
+ const calls: Call[] = [];
+ const json = (body: unknown, status = 200) => ({ ok: status < 400, status, json: async () => body });
+ vi.stubGlobal(
+ "fetch",
+ vi.fn(async (input: unknown, init?: { method?: string; body?: string }) => {
+ const url = String(input);
+ const method = (init?.method ?? "GET").toUpperCase();
+ const body = init?.body ? JSON.parse(init.body) : undefined;
+ calls.push({ method, url, body });
+ if (url === "/api/games") {
+ return json({
+ dpi: 800,
+ games: [
+ { id: "cs2", name: "Counter-Strike 2", publisher: "Valve", convertible: true, has_profile: false, updated_at: null },
+ ],
+ });
+ }
+ if (url === "/api/games/cs2" && method === "GET") {
+ return json({ game: CS2, profile, default_dpi: 800 });
+ }
+ if (url === "/api/games/cs2/profile" && method === "PUT") {
+ Object.assign(profile.values, body.values ?? {});
+ Object.assign(profile.keybinds, body.keybinds ?? {});
+ profile.updated_at = "2026-10-27T00:00:00+00:00";
+ return json({ profile });
+ }
+ if (url === "/api/games/convert") {
+ return json({
+ game_id: "cs2",
+ sens: body.sens,
+ dpi: 800,
+ to_dpi: 800,
+ cm_per_360: 25.97,
+ edpi: body.sens * 800,
+ results: [{ id: "valorant", name: "Valorant", sens_key: "aim_sens", sens: 0.3143, edpi: 251.4 }],
+ });
+ }
+ return json({ detail: "unexpected" }, 404);
+ }),
+ );
+ return calls;
+}
+
+function renderView() {
+ const client = new QueryClient({ defaultOptions: { queries: { retry: false } } });
+ return render(
+ <QueryClientProvider client={client}>
+ <GamesView />
+ </QueryClientProvider>,
+ );
+}
+
+describe("GamesView", () => {
+ let calls: Call[];
+ beforeEach(() => {
+ calls = stubServer();
+ });
+ afterEach(() => {
+ cleanup();
+ vi.unstubAllGlobals();
+ window.localStorage.clear();
+ });
+
+ it("opens the first game with its mouse settings and the cm/360 of its default", async () => {
+ renderView();
+ expect(await screen.findByTestId("game-panel-cs2")).toBeTruthy();
+ expect(screen.getByTestId("game-setting-sensitivity")).toBeTruthy();
+ // 1.25 default @ 800 DPI with yaw 0.022 → 41.6 cm.
+ expect(within(screen.getByTestId("games-mouse-summary")).getByText(/41[.,]6 cm/)).toBeTruthy();
+ });
+
+ it("saves a typed sensitivity when the field loses focus", async () => {
+ renderView();
+ const setting = await screen.findByTestId("game-setting-sensitivity");
+ const input = within(setting).getByRole("textbox", { name: "Mouse Sensitivity" });
+ fireEvent.change(input, { target: { value: "2" } });
+ fireEvent.blur(input);
+ await waitFor(() =>
+ expect(calls.some((c) => c.method === "PUT" && JSON.stringify(c.body) === '{"values":{"sensitivity":2}}')).toBe(true),
+ );
+ });
+
+ it("binds a key by pressing it and swallows the press", async () => {
+ renderView();
+ await screen.findByTestId("game-panel-cs2");
+ fireEvent.click(screen.getByRole("button", { name: /^Keybinds/ }));
+ const row = await screen.findByTestId("game-keybind-jump");
+ fireEvent.click(within(row).getByRole("button", { name: /Jump/ }));
+ await act(async () => {
+ await new Promise((resolve) => setTimeout(resolve, 5));
+ });
+ const event = new KeyboardEvent("keydown", { code: "KeyF", bubbles: true, cancelable: true });
+ act(() => {
+ window.dispatchEvent(event);
+ });
+ expect(event.defaultPrevented).toBe(true);
+ await waitFor(() =>
+ expect(calls.some((c) => c.method === "PUT" && JSON.stringify(c.body) === '{"keybinds":{"jump":"F"}}')).toBe(true),
+ );
+ });
+
+ it("converts the sensitivity to other games and applies one", async () => {
+ renderView();
+ await screen.findByTestId("game-panel-cs2");
+ fireEvent.click(screen.getByRole("button", { name: /^Converter$/ }));
+ fireEvent.change(await screen.findByTestId("games-converter-sens"), { target: { value: "1" } });
+ const table = await screen.findByTestId("games-converter-results");
+ expect(within(table).getByText("Valorant")).toBeTruthy();
+ fireEvent.click(within(table).getByRole("button"));
+ await waitFor(() =>
+ expect(
+ calls.some((c) => c.url === "/api/games/valorant/profile" && JSON.stringify(c.body) === '{"values":{"aim_sens":0.314}}'),
+ ).toBe(true),
+ );
+ });
+});
+
+describe("profileSummary", () => {
+ it("lists only what the player set", () => {
+ const text = profileSummary(
+ CS2,
+ { values: { sensitivity: 1.1, hud: false }, keybinds: { jump: "Mouse Wheel Down" }, dpi: 400, notes: "", updated_at: null },
+ 400,
+ );
+ expect(text).toBe(
+ ["Counter-Strike 2 — DPI 400", "", "[mouse]", "Mouse Sensitivity: 1.1", "", "[gameplay]", "Show HUD: Off", "", "[keybinds]", "Jump: Mouse Wheel Down"].join("\n"),
+ );
+ });
+});
diff --git a/dodaios/ui/web/frontend/src/views/GamesView.tsx b/dodaios/ui/web/frontend/src/views/GamesView.tsx
new file mode 100644
index 0000000000..68acf5502c
--- /dev/null
+++ b/dodaios/ui/web/frontend/src/views/GamesView.tsx
@@ -0,0 +1,677 @@
+/**
+ * Settings → Game settings: the player's own settings for each game —
+ * sensitivity, keybinds, audio, video, gameplay — in one place, plus a
+ * converter that carries a hip-fire sensitivity from one game to the others
+ * at the same cm/360 (docs/game-settings.md).
+ *
+ * Which settings a game has comes from the backend catalog
+ * (`dodaios/games/catalog.json`), so adding a game never touches this view.
+ */
+import { useCallback, useEffect, useState } from "react";
+import { useQuery } from "@tanstack/react-query";
+import { Check, Copy, FileCog, Gamepad2, Loader2, Search, Trash2 } from "lucide-react";
+import { GameSettingRow, KeyCaptureButton } from "@/components/games/GameControls";
+import { PageHeader } from "@/components/layout/PageHeader";
+import { TabBar } from "@/components/layout/SectionTabBar";
+import { Button } from "@/components/ui/button";
+import { Input } from "@/components/ui/input";
+import { Textarea } from "@/components/ui/textarea";
+import {
+ useGameDetail,
+ useGamesIndex,
+ useResetGameProfile,
+ useSaveDefaultDpi,
+ useSaveGameProfile,
+} from "@/hooks/useGames";
+import { useT } from "@/i18n";
+import { robustCopy } from "@/lib/clipboard";
+import { keyConflicts } from "@/lib/gameKeys";
+import {
+ cmPer360,
+ convertSensitivity,
+ type GameDefinition,
+ type GameProfile,
+ type GameSettingValue,
+ type ProfilePatch,
+} from "@/lib/gamesApi";
+import { cn } from "@/lib/utils";
+import { useEventStore } from "@/store/events";
+
+type TabId = "mouse" | "keybinds" | "audio" | "video" | "gameplay" | "converter";
+const TABS: readonly TabId[] = ["mouse", "keybinds", "audio", "video", "gameplay", "converter"];
+const LAST_GAME_KEY = "dodaios.games.last";
+
+function readLastGame(): string | null {
+ try {
+ return window.localStorage.getItem(LAST_GAME_KEY);
+ } catch {
+ return null;
+ }
+}
+
+function writeLastGame(id: string) {
+ try {
+ window.localStorage.setItem(LAST_GAME_KEY, id);
+ } catch {
+ // Remembering the last game is a convenience only.
+ }
+}
+
+function formatNumber(value: number, digits = 2): string {
+ return value.toLocaleString(undefined, { maximumFractionDigits: digits });
+}
+
+export function GamesView() {
+ const t = useT();
+ const pushToast = useEventStore((s) => s.pushToast);
+ const index = useGamesIndex();
+ const saveDpi = useSaveDefaultDpi();
+ const [query, setQuery] = useState("");
+ const [selected, setSelected] = useState<string | null>(() => readLastGame());
+ const [tab, setTab] = useState<TabId>("mouse");
+
+ const games = index.data?.games ?? [];
+ useEffect(() => {
+ if (games.length === 0) return;
+ if (!selected || !games.some((game) => game.id === selected)) setSelected(games[0].id);
+ }, [games, selected]);
+
+ const needle = query.trim().toLowerCase();
+ const visible = games.filter(
+ (game) =>
+ needle === "" ||
+ game.name.toLowerCase().includes(needle) ||
+ game.publisher.toLowerCase().includes(needle),
+ );
+
+ const choose = (id: string) => {
+ setSelected(id);
+ writeLastGame(id);
+ };
+
+ return (
+ <div
+ data-testid="games-view"
+ className="flex h-full flex-col overflow-y-auto bg-background px-4 pb-10 scrollbar-jarvis sm:px-8"
+ >
+ <div className="w-full max-w-[1400px]">
+ <PageHeader
+ icon={<Gamepad2 />}
+ title={t("games.title")}
+ description={t("games.subtitle")}
+ actions={
+ index.data && (
+ <DpiField
+ label={t("games.default_dpi")}
+ value={index.data.dpi}
+ onCommit={(dpi) =>
+ dpi !== null &&
+ saveDpi.mutate(dpi, {
+ onError: (error) =>
+ pushToast("error", t("games.save_error").replace("{0}", (error as Error).message)),
+ })
+ }
+ />
+ )
+ }
+ />
+
+ {index.isError && (
+ <p role="alert" className="text-sm text-destructive">
+ {t("games.load_error").replace("{0}", (index.error as Error).message)}
+ </p>
+ )}
+ {index.isLoading && <Loader2 className="h-5 w-5 animate-spin text-muted-foreground" aria-hidden />}
+
+ {index.data && (
+ <div className="flex flex-col gap-6 lg:flex-row">
+ <aside className="lg:w-64 lg:shrink-0">
+ <div className="relative mb-3">
+ <Search
+ className="pointer-events-none absolute left-2.5 top-1/2 h-3.5 w-3.5 -translate-y-1/2 text-muted-foreground"
+ aria-hidden
+ />
+ <Input
+ value={query}
+ onChange={(event) => setQuery(event.currentTarget.value)}
+ placeholder={t("games.search")}
+ aria-label={t("games.search")}
+ className="h-8 pl-8"
+ />
+ </div>
+ <ul className="flex gap-1 overflow-x-auto pb-1 lg:flex-col lg:overflow-visible lg:pb-0" data-testid="games-list">
+ {visible.map((game) => (
+ <li key={game.id} className="shrink-0">
+ <button
+ type="button"
+ data-testid={`games-pick-${game.id}`}
+ aria-current={game.id === selected ? "true" : undefined}
+ onClick={() => choose(game.id)}
+ className={cn(
+ "flex w-full items-center gap-2 rounded-md px-3 py-2 text-left transition-colors",
+ game.id === selected
+ ? "bg-secondary text-foreground-strong"
+ : "text-foreground hover:bg-secondary/60",
+ )}
+ >
+ <span className="min-w-0 flex-1">
+ <span className="block truncate text-sm font-medium">{game.name}</span>
+ <span className="block truncate text-xs text-muted-foreground">{game.publisher}</span>
+ </span>
+ {game.has_profile && (
+ <span
+ className="h-1.5 w-1.5 shrink-0 rounded-full bg-primary"
+ title={t("games.saved_badge")}
+ aria-label={t("games.saved_badge")}
+ />
+ )}
+ </button>
+ </li>
+ ))}
+ </ul>
+ </aside>
+
+ <section className="min-w-0 flex-1">
+ {selected && (
+ <GamePanel
+ key={selected}
+ gameId={selected}
+ defaultDpi={index.data.dpi}
+ tab={tab}
+ onTab={setTab}
+ />
+ )}
+ </section>
+ </div>
+ )}
+ </div>
+ </div>
+ );
+}
+
+function DpiField({
+ label,
+ value,
+ placeholder,
+ allowEmpty = false,
+ onCommit,
+}: {
+ label: string;
+ value: number | null;
+ placeholder?: string;
+ /** A blank field means "follow the default"; otherwise blank just reverts. */
+ allowEmpty?: boolean;
+ onCommit: (dpi: number | null) => void;
+}) {
+ const [draft, setDraft] = useState(value === null ? "" : String(value));
+ useEffect(() => setDraft(value === null ? "" : String(value)), [value]);
+ const commit = () => {
+ const trimmed = draft.trim();
+ if (trimmed === "") {
+ if (!allowEmpty) setDraft(value === null ? "" : String(value));
+ else if (value !== null) onCommit(null);
+ return;
+ }
+ const next = Math.round(Number(trimmed));
+ if (!Number.isFinite(next) || next < 50 || next > 64000) {
+ setDraft(value === null ? "" : String(value));
+ return;
+ }
+ if (next !== value) onCommit(next);
+ };
+ return (
+ <label className="flex items-center gap-2.5 rounded-lg border border-border bg-card px-3 py-1.5">
+ <span className="text-sm font-medium text-foreground">{label}</span>
+ <Input
+ inputMode="numeric"
+ value={draft}
+ placeholder={placeholder}
+ onChange={(event) => setDraft(event.currentTarget.value)}
+ onBlur={commit}
+ onKeyDown={(event) => {
+ if (event.key === "Enter") (event.currentTarget as HTMLInputElement).blur();
+ }}
+ className="h-7 w-20 font-mono tabular-nums"
+ />
+ </label>
+ );
+}
+
+function GamePanel({
+ gameId,
+ defaultDpi,
+ tab,
+ onTab,
+}: {
+ gameId: string;
+ defaultDpi: number;
+ tab: TabId;
+ onTab: (tab: TabId) => void;
+}) {
+ const t = useT();
+ const pushToast = useEventStore((s) => s.pushToast);
+ const detail = useGameDetail(gameId);
+ const save = useSaveGameProfile();
+ const reset = useResetGameProfile();
+ const [confirmReset, setConfirmReset] = useState(false);
+
+ const patch = useCallback(
+ (change: ProfilePatch) =>
+ save.mutate(
+ { gameId, patch: change },
+ {
+ onError: (error) =>
+ pushToast("error", t("games.save_error").replace("{0}", (error as Error).message)),
+ },
+ ),
+ [gameId, save, pushToast, t],
+ );
+
+ if (detail.isLoading || !detail.data) {
+ return detail.isError ? (
+ <p role="alert" className="text-sm text-destructive">
+ {t("games.load_error").replace("{0}", (detail.error as Error).message)}
+ </p>
+ ) : (
+ <Loader2 className="h-5 w-5 animate-spin text-muted-foreground" aria-hidden />
+ );
+ }
+
+ const { game, profile } = detail.data;
+ const dpi = profile.dpi ?? defaultDpi;
+ const section = game.sections.find((s) => s.id === tab);
+ const hasProfile = profile.updated_at !== null;
+
+ const copySummary = async () => {
+ const ok = await robustCopy(profileSummary(game, profile, dpi));
+ pushToast(ok ? "success" : "error", ok ? t("games.copied") : t("games.copy_failed"));
+ };
+
+ return (
+ <div data-testid={`game-panel-${game.id}`}>
+ <div className="flex flex-wrap items-start justify-between gap-3">
+ <div>
+ <h2 className="text-lg font-semibold text-foreground-strong">{game.name}</h2>
+ <p className="text-xs text-muted-foreground">{game.publisher}</p>
+ </div>
+ <div className="flex items-center gap-2">
+ <Button type="button" variant="outline" size="sm" onClick={() => void copySummary()}>
+ <Copy aria-hidden />
+ {t("games.copy")}
+ </Button>
+ <Button
+ type="button"
+ variant={confirmReset ? "destructive" : "outline"}
+ size="sm"
+ disabled={!hasProfile || reset.isPending}
+ onBlur={() => setConfirmReset(false)}
+ onClick={() => {
+ if (!confirmReset) return setConfirmReset(true);
+ setConfirmReset(false);
+ reset.mutate(game.id, {
+ onSuccess: () => pushToast("success", t("games.reset_done").replace("{0}", game.name)),
+ onError: (error) =>
+ pushToast("error", t("games.save_error").replace("{0}", (error as Error).message)),
+ });
+ }}
+ >
+ <Trash2 aria-hidden />
+ {confirmReset ? t("games.reset_confirm") : t("games.reset_profile")}
+ </Button>
+ </div>
+ </div>
+
+ <TabBar
+ className="mt-4"
+ tabs={TABS.map((id) => ({
+ id,
+ label: t(`games.tabs.${id}`),
+ count: id === "keybinds" ? game.keybinds.length : undefined,
+ }))}
+ active={tab}
+ onChange={(id) => onTab(id as TabId)}
+ />
+
+ <div className="mt-4 rounded-lg border border-border bg-card px-4">
+ {tab === "mouse" && (
+ <MouseSummary game={game} profile={profile} defaultDpi={defaultDpi} onPatch={patch} />
+ )}
+ {section &&
+ (section.settings.length === 0 ? (
+ <p className="py-6 text-sm text-muted-foreground">{t("games.section_empty")}</p>
+ ) : (
+ section.settings.map((setting) => (
+ <GameSettingRow
+ key={setting.key}
+ setting={setting}
+ value={profile.values[setting.key]}
+ onChange={(value) => patch({ values: { [setting.key]: value } })}
+ />
+ ))
+ ))}
+ {tab === "keybinds" && <KeybindList game={game} profile={profile} onPatch={patch} />}
+ {tab === "converter" && <Converter game={game} profile={profile} dpi={dpi} />}
+ </div>
+
+ <div className="mt-6 grid gap-4 md:grid-cols-2">
+ <NotesField value={profile.notes} onCommit={(notes) => patch({ notes })} />
+ <div className="rounded-lg border border-border bg-card p-4">
+ <div className="flex items-center gap-2 text-sm font-medium text-foreground">
+ <FileCog className="h-4 w-4 text-muted-foreground" aria-hidden />
+ {t("games.config_file")}
+ </div>
+ <p className="mt-2 break-words font-mono text-xs text-muted-foreground">{game.config_file}</p>
+ </div>
+ </div>
+ </div>
+ );
+}
+
+function MouseSummary({
+ game,
+ profile,
+ defaultDpi,
+ onPatch,
+}: {
+ game: GameDefinition;
+ profile: GameProfile;
+ defaultDpi: number;
+ onPatch: (patch: ProfilePatch) => void;
+}) {
+ const t = useT();
+ const dpi = profile.dpi ?? defaultDpi;
+ const sensSetting = game.sens_key
+ ? game.sections.flatMap((s) => s.settings).find((s) => s.key === game.sens_key)
+ : undefined;
+ const raw = game.sens_key ? (profile.values[game.sens_key] ?? sensSetting?.default) : undefined;
+ const sens = typeof raw === "number" ? raw : null;
+ const cm = game.yaw && sens ? cmPer360(game.yaw, sens, dpi) : null;
+
+ return (
+ <div className="grid gap-3 border-b border-border/60 py-4 sm:grid-cols-3" data-testid="games-mouse-summary">
+ <div>
+ <p className="text-xs text-muted-foreground">{t("games.game_dpi")}</p>
+ <div className="mt-1">
+ <DpiField
+ label="DPI"
+ value={profile.dpi}
+ placeholder={String(defaultDpi)}
+ allowEmpty
+ onCommit={(next) => onPatch(next === null ? { reset_dpi: true } : { dpi: next })}
+ />
+ </div>
+ {profile.dpi === null && (
+ <p className="mt-1 text-xs text-muted-foreground">
+ {t("games.follow_default").replace("{0}", String(defaultDpi))}
+ </p>
+ )}
+ </div>
+ <Stat label={t("games.cm360")} value={cm ? `${formatNumber(cm, 1)} cm` : "—"} hint={t("games.cm360_hint")} />
+ <Stat
+ label={t("games.edpi")}
+ value={sens ? formatNumber(sens * dpi, 0) : "—"}
+ hint={game.yaw ? undefined : t("games.not_convertible")}
+ />
+ </div>
+ );
+}
+
+function Stat({ label, value, hint }: { label: string; value: string; hint?: string }) {
+ return (
+ <div>
+ <p className="text-xs text-muted-foreground">{label}</p>
+ <p className="mt-1 font-mono text-xl tabular-nums text-foreground-strong">{value}</p>
+ {hint && <p className="mt-0.5 text-xs text-muted-foreground">{hint}</p>}
+ </div>
+ );
+}
+
+function KeybindList({
+ game,
+ profile,
+ onPatch,
+}: {
+ game: GameDefinition;
+ profile: GameProfile;
+ onPatch: (patch: ProfilePatch) => void;
+}) {
+ const t = useT();
+ const rows = game.keybinds.map((bind) => ({
+ ...bind,
+ key: profile.keybinds[bind.id] ?? bind.default,
+ saved: bind.id in profile.keybinds,
+ }));
+ const conflicts = keyConflicts(rows);
+
+ return (
+ <div data-testid="games-keybinds">
+ <p className="border-b border-border/60 py-3 text-xs text-muted-foreground">{t("games.keybind_hint")}</p>
+ {rows.map((row) => {
+ const clash = conflicts.get(row.id);
+ return (
+ <div
+ key={row.id}
+ data-testid={`game-keybind-${row.id}`}
+ className="flex flex-wrap items-center gap-3 border-b border-border/60 py-2 last:border-b-0"
+ >
+ <div className="min-w-0 flex-1">
+ <div className="flex items-center gap-2">
+ <span className="text-sm text-foreground">{row.action}</span>
+ {row.saved && <span aria-hidden className="h-1.5 w-1.5 rounded-full bg-primary" />}
+ </div>
+ {clash && (
+ <p className="text-xs text-amber-500">
+ {t("games.keybind_conflict").replace("{0}", clash.join(", "))}
+ </p>
+ )}
+ {!clash && row.note && <p className="text-xs text-muted-foreground">{row.note}</p>}
+ </div>
+ <KeyCaptureButton
+ value={row.key}
+ label={row.action}
+ onCapture={(key) => onPatch({ keybinds: { [row.id]: key } })}
+ />
+ <Button
+ type="button"
+ variant="ghost"
+ size="sm"
+ className="text-xs"
+ onClick={() => onPatch({ keybinds: { [row.id]: "" } })}
+ disabled={row.key === ""}
+ >
+ {t("games.keybind_clear")}
+ </Button>
+ <Button
+ type="button"
+ variant="ghost"
+ size="sm"
+ className={cn("text-xs", !row.saved && "invisible")}
+ onClick={() => onPatch({ keybinds: { [row.id]: null } })}
+ title={row.default ? t("games.default_value").replace("{0}", row.default) : undefined}
+ >
+ {t("games.keybind_reset")}
+ </Button>
+ </div>
+ );
+ })}
+ </div>
+ );
+}
+
+function Converter({ game, profile, dpi }: { game: GameDefinition; profile: GameProfile; dpi: number }) {
+ const t = useT();
+ const pushToast = useEventStore((s) => s.pushToast);
+ const save = useSaveGameProfile();
+ const sensKey = game.sens_key;
+ const saved = sensKey ? profile.values[sensKey] : undefined;
+ const [sensDraft, setSensDraft] = useState(typeof saved === "number" ? String(saved) : "");
+ const [toDpiDraft, setToDpiDraft] = useState("");
+ const [applied, setApplied] = useState<string | null>(null);
+ const sens = Number(sensDraft.replace(",", "."));
+ const toDpi = Number(toDpiDraft);
+ const validSens = Number.isFinite(sens) && sens > 0;
+ const validToDpi = toDpiDraft.trim() === "" || (Number.isFinite(toDpi) && toDpi >= 50 && toDpi <= 64000);
+
+ const result = useQuery({
+ queryKey: ["games", "convert", game.id, sens, dpi, toDpiDraft],
+ queryFn: () =>
+ convertSensitivity({
+ game_id: game.id,
+ sens,
+ dpi,
+ to_dpi: toDpiDraft.trim() === "" ? undefined : Math.round(toDpi),
+ }),
+ enabled: Boolean(game.yaw && sensKey && validSens && validToDpi),
+ staleTime: Infinity,
+ });
+
+ if (!game.yaw || !sensKey) {
+ return (
+ <p className="py-6 text-sm text-muted-foreground" data-testid="games-converter-unavailable">
+ {t("games.converter_unavailable").replace("{0}", game.name)}
+ </p>
+ );
+ }
+
+ const apply = (targetId: string, targetName: string, targetKey: string, value: number) => {
+ const rounded = Math.round(value * 1000) / 1000;
+ save.mutate(
+ { gameId: targetId, patch: { values: { [targetKey]: rounded } } },
+ {
+ onSuccess: () => {
+ setApplied(targetId);
+ pushToast("success", t("games.converter_applied").replace("{0}", String(rounded)).replace("{1}", targetName));
+ },
+ onError: (error) =>
+ pushToast("error", t("games.save_error").replace("{0}", (error as Error).message)),
+ },
+ );
+ };
+
+ return (
+ <div className="py-4" data-testid="games-converter">
+ <p className="text-xs text-muted-foreground">{t("games.converter_hint")}</p>
+ <div className="mt-3 flex flex-wrap items-end gap-4">
+ <label className="flex flex-col gap-1">
+ <span className="text-xs text-muted-foreground">
+ {t("games.converter_from").replace("{0}", game.name)}
+ </span>
+ <Input
+ inputMode="decimal"
+ value={sensDraft}
+ onChange={(event) => setSensDraft(event.currentTarget.value)}
+ className="h-8 w-32 font-mono tabular-nums"
+ data-testid="games-converter-sens"
+ />
+ </label>
+ <div className="flex flex-col gap-1">
+ <span className="text-xs text-muted-foreground">DPI</span>
+ <span className="flex h-8 items-center font-mono text-sm tabular-nums">{dpi}</span>
+ </div>
+ <label className="flex flex-col gap-1">
+ <span className="text-xs text-muted-foreground">{t("games.converter_target_dpi")}</span>
+ <Input
+ inputMode="numeric"
+ value={toDpiDraft}
+ placeholder={String(dpi)}
+ onChange={(event) => setToDpiDraft(event.currentTarget.value)}
+ className="h-8 w-28 font-mono tabular-nums"
+ />
+ </label>
+ {result.data && (
+ <div className="ml-auto text-right">
+ <p className="text-xs text-muted-foreground">{t("games.cm360")}</p>
+ <p className="font-mono text-xl tabular-nums text-foreground-strong" data-testid="games-converter-cm">
+ {formatNumber(result.data.cm_per_360, 1)} cm
+ </p>
+ </div>
+ )}
+ </div>
+
+ {result.isError && (
+ <p role="alert" className="mt-3 text-sm text-destructive">
+ {(result.error as Error).message}
+ </p>
+ )}
+
+ {result.data && (
+ <table className="mt-4 w-full text-sm" data-testid="games-converter-results">
+ <thead>
+ <tr className="text-left text-xs text-muted-foreground">
+ <th className="py-2 font-normal">{t("games.converter_game")}</th>
+ <th className="py-2 text-right font-normal">{t("games.converter_sens")}</th>
+ <th className="hidden py-2 text-right font-normal sm:table-cell">{t("games.edpi")}</th>
+ <th className="py-2" />
+ </tr>
+ </thead>
+ <tbody>
+ {result.data.results.map((row) => (
+ <tr key={row.id} className="border-t border-border/60">
+ <td className="py-2 text-foreground">{row.name}</td>
+ <td className="py-2 text-right font-mono tabular-nums text-foreground-strong">
+ {formatNumber(row.sens, 3)}
+ </td>
+ <td className="hidden py-2 text-right font-mono tabular-nums text-muted-foreground sm:table-cell">
+ {formatNumber(row.edpi, 0)}
+ </td>
+ <td className="py-2 pl-3 text-right">
+ <Button
+ type="button"
+ variant="ghost"
+ size="sm"
+ className="text-xs"
+ disabled={save.isPending}
+ onClick={() => apply(row.id, row.name, row.sens_key, row.sens)}
+ >
+ {applied === row.id && <Check aria-hidden />}
+ {t("games.converter_apply")}
+ </Button>
+ </td>
+ </tr>
+ ))}
+ </tbody>
+ </table>
+ )}
+ </div>
+ );
+}
+
+function NotesField({ value, onCommit }: { value: string; onCommit: (notes: string) => void }) {
+ const t = useT();
+ const [draft, setDraft] = useState(value);
+ useEffect(() => setDraft(value), [value]);
+ return (
+ <label className="flex flex-col gap-2 rounded-lg border border-border bg-card p-4">
+ <span className="text-sm font-medium text-foreground">{t("games.notes")}</span>
+ <Textarea
+ value={draft}
+ maxLength={4000}
+ placeholder={t("games.notes_placeholder")}
+ onChange={(event) => setDraft(event.currentTarget.value)}
+ onBlur={() => draft !== value && onCommit(draft)}
+ className="min-h-[5rem] text-sm"
+ />
+ </label>
+ );
+}
+
+/** Plain-text summary of a profile, for pasting into chat or a note. */
+export function profileSummary(game: GameDefinition, profile: GameProfile, dpi: number): string {
+ const lines = [`${game.name} — DPI ${dpi}`];
+ for (const section of game.sections) {
+ const set = section.settings.filter((s) => profile.values[s.key] !== undefined);
+ if (set.length === 0) continue;
+ lines.push("", `[${section.id}]`);
+ for (const s of set) {
+ const value: GameSettingValue = profile.values[s.key];
+ lines.push(`${s.label}: ${typeof value === "boolean" ? (value ? "On" : "Off") : value}`);
+ }
+ }
+ const binds = game.keybinds.filter((b) => b.id in profile.keybinds);
+ if (binds.length > 0) {
+ lines.push("", "[keybinds]");
+ for (const b of binds) lines.push(`${b.action}: ${profile.keybinds[b.id] || "—"}`);
+ }
+ if (profile.notes.trim()) lines.push("", profile.notes.trim());
+ return lines.join("\n");
+}
diff --git a/dodaios/ui/web/frontend/src/views/SettingsHubView.tsx b/dodaios/ui/web/frontend/src/views/SettingsHubView.tsx
index 4d2d4758d3..6d2cc84eda 100644
--- a/dodaios/ui/web/frontend/src/views/SettingsHubView.tsx
+++ b/dodaios/ui/web/frontend/src/views/SettingsHubView.tsx
@@ -23,7 +23,7 @@ import { cn } from "@/lib/utils";
* page over the user's current section, with a searchable left navigation
* (General · System · Activity) and the selected section on the right:
*
- * General: General, Keyboard shortcuts, Appshots, My Pets, Profile,
+ * General: General, Keyboard shortcuts, Appshots, My Pets, Game settings, Profile,
* {name} (the assistant), Socials
* System: Computers, API Keys
* Activity: Spend, Feedback
@@ -78,6 +78,9 @@ const ShortcutsTab = lazy(() =>
const PetsTab = lazy(() =>
import("@/views/PetsView").then((m) => ({ default: m.PetsView })),
);
+const GamesTab = lazy(() =>
+ import("@/views/GamesView").then((m) => ({ default: m.GamesView })),
+);
const CostsTab = lazy(() =>
import("@/views/CostsView").then((m) => ({ default: m.CostsView })),
);
@@ -93,6 +96,7 @@ type HubNavId =
| "shortcuts"
| "appshots"
| "pets"
+ | "games"
| "profile"
| "agent-instructions"
| "socials"
@@ -109,6 +113,7 @@ const HUB_NAV_GROUPS: readonly { labelKey: string; ids: readonly HubNavId[] }[]
"shortcuts",
"appshots",
"pets",
+ "games",
"profile",
"agent-instructions",
"socials",
@@ -135,6 +140,7 @@ const TAB_CONTENT: Record<HubNavId | "telephony-setup", LazyExoticComponent<Comp
appshots: AppshotsTab,
shortcuts: ShortcutsTab,
pets: PetsTab,
+ games: GamesTab,
costs: CostsTab,
feedback: FeedbackTab,
};
@@ -165,6 +171,8 @@ function resolveHubTab(active: string): { content: HubNavId | "telephony-setup";
return { content: "shortcuts", highlight: "shortcuts" };
case "pets":
return { content: "pets", highlight: "pets" };
+ case "games":
+ return { content: "games", highlight: "games" };
case "costs":
return { content: "costs", highlight: "costs" };
case "feedback":
diff --git a/dodaios/ui/web/frontend/src/views/settings/settingsSearch.ts b/dodaios/ui/web/frontend/src/views/settings/settingsSearch.ts
index c43c0c787b..177f747297 100644
--- a/dodaios/ui/web/frontend/src/views/settings/settingsSearch.ts
+++ b/dodaios/ui/web/frontend/src/views/settings/settingsSearch.ts
@@ -33,6 +33,7 @@ const SEARCH_PAGES = [
{ id: "appshots", keys: ["appshots"] },
{ id: "shortcuts", keys: ["shortcuts_view", "settings_view.keybinds", "settings_view.quick_switch"] },
{ id: "pets", keys: ["pets"] },
+ { id: "games", keys: ["games"] },
{ id: "costs", keys: ["costs_view"] },
{ id: "feedback", keys: ["feedback"] },
] as const;
diff --git a/dodaios/ui/web/games_routes.py b/dodaios/ui/web/games_routes.py
new file mode 100644
index 0000000000..a48534bda1
--- /dev/null
+++ b/dodaios/ui/web/games_routes.py
@@ -0,0 +1,161 @@
+"""REST API for Game settings — per-game profiles and the sensitivity converter.
+
+Endpoints (mounted by the WebServer in ``_build_app()``):
+
+ GET /api/games → every game in the catalog (summary),
+ which ones have a saved profile, and
+ the default mouse DPI.
+ GET /api/games/{id} → one game's full definition + profile.
+ PUT /api/games/{id}/profile → merge values / keybinds / dpi / notes.
+ DELETE /api/games/{id}/profile → forget the profile (back to defaults).
+ PUT /api/games/dpi → the default mouse DPI.
+ POST /api/games/convert → a hip-fire sensitivity in every other
+ game with the same cm/360.
+
+No brain, no config file: the profiles live in ``<DATA_DIR>/games`` (see
+``dodaios.games.store``), so this works headless too.
+"""
+
+from __future__ import annotations
+
+from typing import Any
+
+from fastapi import APIRouter, HTTPException
+from pydantic import BaseModel
+
+from dodaios.games import sensitivity
+from dodaios.games.catalog import get_game, list_games
+from dodaios.games.store import GameProfileStore, UnknownGameError
+
+router = APIRouter(prefix="/api/games", tags=["games"])
+
+
+def _store() -> GameProfileStore:
+ # Built per request so DATA_DIR is read at call time (tests patch it).
+ return GameProfileStore()
+
+
+def _summary(game: dict[str, Any], profiles: dict[str, Any]) -> dict[str, Any]:
+ profile = profiles.get(game["id"])
+ return {
+ "id": game["id"],
+ "name": game["name"],
+ "publisher": game["publisher"],
+ "convertible": bool(game.get("yaw") and game.get("sens_key")),
+ "has_profile": profile is not None,
+ "updated_at": profile.get("updated_at") if profile else None,
+ }
+
+
+def games_index() -> dict[str, Any]:
+ data = _store().snapshot()
+ return {
+ "dpi": data["dpi"],
+ "games": [_summary(g, data["games"]) for g in list_games()],
+ }
+
+
+class DpiBody(BaseModel):
+ dpi: int
+
+
+def set_dpi(body: DpiBody) -> dict[str, Any]:
+ try:
+ return {"dpi": _store().set_default_dpi(body.dpi)}
+ except ValueError as exc:
+ raise HTTPException(status_code=400, detail=str(exc)) from exc
+
+
+class ConvertBody(BaseModel):
+ game_id: str
+ sens: float
+ dpi: int | None = None
+ to_dpi: int | None = None
+
+
[email protected]("/convert")
+def convert(body: ConvertBody) -> dict[str, Any]:
+ source = get_game(body.game_id)
+ if source is None:
+ raise HTTPException(status_code=404, detail="Unknown game")
+ if not source.get("yaw"):
+ raise HTTPException(
+ status_code=400,
+ detail=f"{source['name']} has no linear sensitivity, so it cannot be converted.",
+ )
+ default_dpi = _store().snapshot()["dpi"]
+ dpi = body.dpi or default_dpi
+ to_dpi = body.to_dpi or dpi
+ try:
+ cm = sensitivity.cm_per_360(source["yaw"], body.sens, dpi)
+ results = []
+ for game in list_games():
+ if game["id"] == source["id"] or not game.get("yaw") or not game.get("sens_key"):
+ continue
+ value = sensitivity.convert(body.sens, source["yaw"], game["yaw"], dpi, to_dpi)
+ results.append(
+ {
+ "id": game["id"],
+ "name": game["name"],
+ "sens_key": game["sens_key"],
+ "sens": round(value, 4),
+ "edpi": round(value * to_dpi, 1),
+ }
+ )
+ except ValueError as exc:
+ raise HTTPException(status_code=400, detail=str(exc)) from exc
+ return {
+ "game_id": source["id"],
+ "sens": body.sens,
+ "dpi": dpi,
+ "to_dpi": to_dpi,
+ "cm_per_360": round(cm, 2),
+ "edpi": round(body.sens * dpi, 1),
+ "results": results,
+ }
+
+
[email protected]("/{game_id}")
+def game_detail(game_id: str) -> dict[str, Any]:
+ game = get_game(game_id)
+ if game is None:
+ raise HTTPException(status_code=404, detail="Unknown game")
+ store = _store()
+ return {"game": game, "profile": store.profile(game_id), "default_dpi": store.snapshot()["dpi"]}
+
+
+class ProfileBody(BaseModel):
+ values: dict[str, Any] | None = None
+ keybinds: dict[str, str | None] | None = None
+ dpi: int | None = None
+ # Distinguishes "dpi": null (follow the default) from leaving dpi out.
+ reset_dpi: bool = False
+ notes: str | None = None
+
+
[email protected]("/{game_id}/profile")
+def save_profile(game_id: str, body: ProfileBody) -> dict[str, Any]:
+ dpi: Any = ...
+ if body.reset_dpi:
+ dpi = None
+ elif body.dpi is not None:
+ dpi = body.dpi
+ try:
+ profile = _store().update(
+ game_id, values=body.values, keybinds=body.keybinds, dpi=dpi, notes=body.notes
+ )
+ except UnknownGameError as exc:
+ raise HTTPException(status_code=404, detail="Unknown game") from exc
+ except ValueError as exc:
+ raise HTTPException(status_code=400, detail=str(exc)) from exc
+ return {"profile": profile}
+
+
[email protected]("/{game_id}/profile")
+def reset_profile(game_id: str) -> dict[str, Any]:
+ try:
+ return {"removed": _store().reset(game_id)}
+ except UnknownGameError as exc:
+ raise HTTPException(status_code=404, detail="Unknown game") from exc
diff --git a/dodaios/ui/web/server.py b/dodaios/ui/web/server.py
index 7b41a0d358..0e40ec88ba 100644
--- a/dodaios/ui/web/server.py
+++ b/dodaios/ui/web/server.py
@@ -568,6 +568,7 @@ class WebServer:
from .onboarding_routes import router as onboarding_router
from .outputs_routes import router as outputs_router
from .permissions_routes import router as permissions_router
+ from .games_routes import router as games_router
from .pets_routes import router as pets_router
from .preview_routes import router as preview_router
from .profile_routes import router as profile_router
@@ -753,6 +754,7 @@ class WebServer:
app.include_router(computers_router)
# Desktop pets — the `pet` overlay style's pets, look and visibility.
app.include_router(pets_router)
+ app.include_router(games_router)
app.include_router(dictionary_router)
# Dictation mode — hold to speak, text lands in the focused field.
# Mounted so every action is also `jarvis api dictation <op>`, which is
diff --git a/pyproject.toml b/pyproject.toml
index 144c8f22b8..3b15af3698 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -922,6 +922,9 @@ dodaios = [
"agent_runtimes/runtime-versions.json",
# Translated system phrases, one file per language (dodaios/i18n/catalog.py).
"i18n/locales/*.json",
+ # The researched settings of every game in Settings -> Game settings
+ # (dodaios/games/catalog.py reads it via Path(__file__)).
+ "games/catalog.json",
# Seed catalogs (CLI tools / skills / marketplace plugins) — named
# explicitly rather than a repo-wide "**/*.json" glob, which would also
# sweep in dodaios/ui/web/frontend's SOURCE config (package.json,
diff --git a/tests/unit/games/__init__.py b/tests/unit/games/__init__.py
new file mode 100644
index 0000000000..e69de29bb2
diff --git a/tests/unit/games/test_games.py b/tests/unit/games/test_games.py
new file mode 100644
index 0000000000..b8c41c8b7f
--- /dev/null
+++ b/tests/unit/games/test_games.py
@@ -0,0 +1,242 @@
+"""Game settings: the catalog, the sensitivity maths, the profile store, the API."""
+
+from __future__ import annotations
+
+import json
+
+import pytest
+from fastapi import FastAPI
+from fastapi.testclient import TestClient
+
+from dodaios.games import sensitivity
+from dodaios.games.catalog import SECTION_IDS, SETTING_TYPES, get_game, list_games
+from dodaios.games.store import GameProfileStore, UnknownGameError
+
+# --------------------------------------------------------------------------- catalog
+
+
+def test_catalog_covers_the_big_shooters() -> None:
+ ids = {g["id"] for g in list_games()}
+ assert {"fortnite", "cod_bo6", "r6_siege_x", "valorant", "cs2", "apex"} <= ids
+
+
[email protected]("game", list_games(), ids=lambda g: g["id"])
+def test_every_game_is_well_formed(game: dict) -> None:
+ assert [s["id"] for s in game["sections"]] == list(SECTION_IDS)
+ keys = [s["key"] for section in game["sections"] for s in section["settings"]]
+ assert len(keys) == len(set(keys)), "setting keys must be unique per game"
+ for section in game["sections"]:
+ for setting in section["settings"]:
+ assert setting["type"] in SETTING_TYPES
+ if setting["type"] == "select":
+ assert len(setting["options"]) >= 2
+ assert setting["default"] in (None, *setting["options"])
+ if setting["type"] == "slider":
+ assert setting["min"] < setting["max"]
+ bind_ids = [k["id"] for k in game["keybinds"]]
+ assert len(bind_ids) == len(set(bind_ids))
+ assert len(bind_ids) >= 10
+ if game["yaw"]:
+ assert game["sens_key"] in keys
+ else:
+ assert game["sens_key"] is None
+
+
+# --------------------------------------------------------------------------- maths
+
+
+def test_cm_per_360_matches_known_values() -> None:
+ # CS2 at 2.0 / 400 DPI is the classic 51.95 cm/360.
+ assert sensitivity.cm_per_360(0.022, 2.0, 400) == pytest.approx(51.95, abs=0.01)
+
+
+def test_convert_cs2_to_valorant_is_the_well_known_ratio() -> None:
+ # Valorant = CS / 3.1818...
+ assert sensitivity.convert(1.0, 0.022, 0.07, 800) == pytest.approx(0.3143, abs=1e-4)
+
+
+def test_convert_keeps_cm_per_360_across_dpi() -> None:
+ target = sensitivity.convert(6.4, 0.005555, 0.0066, 800, 1600)
+ assert sensitivity.cm_per_360(0.005555, 6.4, 800) == pytest.approx(
+ sensitivity.cm_per_360(0.0066, target, 1600)
+ )
+
+
+def test_sens_for_cm_inverts_cm_per_360() -> None:
+ sens = sensitivity.sens_for_cm(30, 0.07, 800)
+ assert sensitivity.cm_per_360(0.07, sens, 800) == pytest.approx(30)
+
+
[email protected]("bad", [0, -1, float("nan"), float("inf")])
+def test_maths_refuses_non_positive_input(bad: float) -> None:
+ with pytest.raises(ValueError):
+ sensitivity.cm_per_360(0.022, bad, 800)
+
+
+# --------------------------------------------------------------------------- store
+
+
+def store(tmp_path) -> GameProfileStore:
+ return GameProfileStore(tmp_path / "games" / "profiles.json")
+
+
+def test_update_merges_and_persists(store: GameProfileStore) -> None:
+ store.update("valorant", values={"aim_sens": 0.35}, keybinds={"jump": "Mouse Wheel Down"})
+ store.update("valorant", values={"scoped_mult": 1.0}, dpi=1600, notes="0.35 @ 1600")
+ profile = store.profile("valorant")
+ assert profile["values"] == {"aim_sens": 0.35, "scoped_mult": 1.0}
+ assert profile["keybinds"] == {"jump": "Mouse Wheel Down"}
+ assert profile["dpi"] == 1600
+ assert profile["notes"] == "0.35 @ 1600"
+ on_disk = json.loads(store.path.read_text(encoding="utf-8"))
+ assert on_disk["games"]["valorant"]["values"]["aim_sens"] == 0.35
+
+
+def test_none_removes_a_value_and_dpi_none_follows_default(store: GameProfileStore) -> None:
+ store.update("cs2", values={"sensitivity": 1.1}, dpi=400)
+ store.update("cs2", values={"sensitivity": None}, dpi=None)
+ profile = store.profile("cs2")
+ assert profile["values"] == {}
+ assert profile["dpi"] is None
+
+
+def test_leaving_dpi_out_keeps_it(store: GameProfileStore) -> None:
+ store.update("cs2", dpi=400)
+ store.update("cs2", values={"sensitivity": 1.0})
+ assert store.profile("cs2")["dpi"] == 400
+
+
+ ("values", "message"),
+ [
+ ({"nope": 1}, "Unknown setting"),
+ ({"aim_sens": 999}, "at most"),
+ ({"aim_sens": "fast"}, "expected a number"),
+ ({"aim_sens": True}, "expected a number"),
+ ({"raw_input_buffer": 1}, "on or off"),
+ ],
+)
+def test_bad_values_are_refused_and_nothing_is_written(
+ store: GameProfileStore, values: dict, message: str
+) -> None:
+ with pytest.raises(ValueError, match=message):
+ store.update("valorant", values=values)
+ assert not store.path.exists()
+
+
+def test_select_values_must_be_an_option(store: GameProfileStore) -> None:
+ game = get_game("r6_siege_x")
+ select = next(s for sec in game["sections"] for s in sec["settings"] if s["type"] == "select")
+ store.update("r6_siege_x", values={select["key"]: select["options"][0]})
+ with pytest.raises(ValueError, match="options"):
+ store.update("r6_siege_x", values={select["key"]: "Ultra Mega"})
+
+
+def test_unknown_game_and_keybind(store: GameProfileStore) -> None:
+ with pytest.raises(UnknownGameError):
+ store.update("tetris", values={})
+ with pytest.raises(ValueError, match="Unknown keybind"):
+ store.update("cs2", keybinds={"fly": "F"})
+
+
+def test_reset_forgets_the_profile(store: GameProfileStore) -> None:
+ store.update("apex", values={"mouse_sens": 1.5})
+ assert store.reset("apex") is True
+ assert store.reset("apex") is False
+ assert store.profile("apex")["values"] == {}
+
+
+def test_corrupt_file_reads_as_empty(store: GameProfileStore) -> None:
+ store.path.parent.mkdir(parents=True)
+ store.path.write_text("{not json", encoding="utf-8")
+ assert store.snapshot()["games"] == {}
+
+
+def test_default_dpi_bounds(store: GameProfileStore) -> None:
+ assert store.set_default_dpi(1600) == 1600
+ assert store.snapshot()["dpi"] == 1600
+ with pytest.raises(ValueError):
+ store.set_default_dpi(10)
+
+
+# --------------------------------------------------------------------------- API
+
+
+def client(tmp_path, monkeypatch) -> TestClient:
+ from dodaios.core import config
+ from dodaios.ui.web.games_routes import router
+
+ monkeypatch.setattr(config, "DATA_DIR", tmp_path)
+ app = FastAPI()
+ app.include_router(router)
+ return TestClient(app)
+
+
+def test_index_lists_games_and_default_dpi(client: TestClient) -> None:
+ body = client.get("/api/games").json()
+ assert body["dpi"] == 800
+ fortnite = next(g for g in body["games"] if g["id"] == "fortnite")
+ assert fortnite == {
+ "id": "fortnite",
+ "name": "Fortnite",
+ "publisher": "Epic Games",
+ "convertible": True,
+ "has_profile": False,
+ "updated_at": None,
+ }
+
+
+def test_profile_round_trip(client: TestClient) -> None:
+ response = client.put(
+ "/api/games/fortnite/profile",
+ json={"values": {"mouse_sens_x": 6.4}, "keybinds": {"jump": "Space"}, "dpi": 1600},
+ )
+ assert response.status_code == 200
+ detail = client.get("/api/games/fortnite").json()
+ assert detail["profile"]["values"] == {"mouse_sens_x": 6.4}
+ assert detail["profile"]["dpi"] == 1600
+ assert detail["game"]["name"] == "Fortnite"
+ assert next(g for g in client.get("/api/games").json()["games"] if g["id"] == "fortnite")[
+ "has_profile"
+ ]
+ reset = client.put("/api/games/fortnite/profile", json={"reset_dpi": True})
+ assert reset.json()["profile"]["dpi"] is None
+ assert client.delete("/api/games/fortnite/profile").json() == {"removed": True}
+
+
+def test_profile_errors(client: TestClient) -> None:
+ assert client.get("/api/games/tetris").status_code == 404
+ assert client.put("/api/games/tetris/profile", json={}).status_code == 404
+ bad = client.put("/api/games/cs2/profile", json={"values": {"sensitivity": 50}})
+ assert bad.status_code == 400
+ assert "at most" in bad.json()["detail"]
+
+
+def test_convert_lists_every_other_linear_game(client: TestClient) -> None:
+ payload = {"game_id": "cs2", "sens": 1.0, "dpi": 800}
+ body = client.post("/api/games/convert", json=payload).json()
+ assert body["cm_per_360"] == pytest.approx(51.95, abs=0.01)
+ assert body["edpi"] == 800
+ by_id = {row["id"]: row for row in body["results"]}
+ assert "cs2" not in by_id
+ assert "battlefield6" not in by_id # not linear
+ assert by_id["valorant"]["sens"] == pytest.approx(0.3143, abs=1e-4)
+ assert by_id["apex"]["sens"] == pytest.approx(1.0)
+ assert by_id["valorant"]["sens_key"] == "aim_sens"
+
+
+def test_convert_uses_the_saved_default_dpi(client: TestClient) -> None:
+ client.put("/api/games/dpi", json={"dpi": 400})
+ body = client.post("/api/games/convert", json={"game_id": "cs2", "sens": 2.0}).json()
+ assert body["dpi"] == 400
+ assert body["cm_per_360"] == pytest.approx(51.95, abs=0.01)
+
+
+def test_convert_refuses_non_linear_games_and_bad_input(client: TestClient) -> None:
+ pubg = client.post("/api/games/convert", json={"game_id": "pubg", "sens": 50})
+ assert pubg.status_code == 400
+ assert client.post("/api/games/convert", json={"game_id": "cs2", "sens": 0}).status_code == 400
+ assert client.post("/api/games/convert", json={"game_id": "x", "sens": 1}).status_code == 404
+ assert client.put("/api/games/dpi", json={"dpi": 1}).status_code == 400