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.
Python agent-orchestrationai-agentai-coding-assistantclaude-codecoding-agentcomputer-usedesktop-applocal-firstmcppersonal-jarvisvoice-assistantvoice-coding
claude/game settings (#950)
Ruben Lütke4b25d14d276d
diff --git a/docs/game-settings.md b/docs/game-settings.mdnew file mode 100644index 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__.pynew file mode 100644index 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.jsonnew file mode 100644index 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.pynew file mode 100644index 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.pynew file mode 100644index 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.pynew file mode 100644index 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 existeddiff --git a/dodaios/plugins/tool/navigate.py b/dodaios/plugins/tool/navigate.pyindex 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.pyindex 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.tsxnew file mode 100644index 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.tsindex 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.tsnew file mode 100644index 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.jsonindex 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.jsonindex 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.jsonindex 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.jsonindex 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.jsonindex 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.tsnew file mode 100644index 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.tsnew file mode 100644index 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.tsnew file mode 100644index 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.tsindex 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.tsindex 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.tsxnew file mode 100644index 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.tsxnew file mode 100644index 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.tsxindex 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<Compappshots: 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.tsindex 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.pynew file mode 100644index 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++[email protected]("/dpi")+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 excdiff --git a/dodaios/ui/web/server.py b/dodaios/ui/web/server.pyindex 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_routerfrom .outputs_routes import router as outputs_routerfrom .permissions_routes import router as permissions_router+ from .games_routes import router as games_routerfrom .pets_routes import router as pets_routerfrom .preview_routes import router as preview_routerfrom .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 isdiff --git a/pyproject.toml b/pyproject.tomlindex 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__.pynew file mode 100644index 0000000000..e69de29bb2diff --git a/tests/unit/games/test_games.py b/tests/unit/games/test_games.pynew file mode 100644index 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