DPR: Quality Presets and Recommended Preset

[ariesninjadev]

(New PR for #1158 due to it being on my personal fork)

---

Task

Allow users to have access to graphics presets that will speed up their ability to tune their visuals to match their desired output/device's computing demands

AARD-1781 and AARD-1919

Symptom

"What!? There isn't a 'Fancy' graphics setting? I'm quitting this game 😡"

Solution

This PR adds quality presets to the graphics settings modal, and allows Synthesis to automatically select the low (or "fast") graphics preset based on certain parameters including whether the device is a mobile device, or the specs are low. Check the Recommended Settings section for help on testing the recommended settings functionality.

---

Presets

Fast Graphics (Low)

Balanced Graphics (Medium)

Fancy Graphics (High)

If any options are changed, the preset is automatically set to "Custom":

---

Recommended Settings

The recommended settings are only applied to a device once. We then save whether or not this optimization has been applied in localstorage. To tell the browser that we haven't run the optimization yet, run the following in dev tools:

let p=JSON.parse(localStorage.getItem("Preferences"));p.GraphicsOptimizationApplied=!1;localStorage.setItem("Preferences",JSON.stringify(p));

Then, you can emulate mobile device headers by using device mode in dev tools:

Finally, reload the page.

Verification

• Unit tests pass
• Changes work as intended
• Existing bugs have plans

---

Before merging, ensure the following criteria are met:

• All acceptance criteria outlined in the ticket are met.
• Necessary test cases have been added and updated.
• A feature toggle or safe disable path has been added (if applicable).
• User-facing polish:
  • Ask: "Is this ready-looking?"
• Cross-linking between Jira and GitHub:
  • PR links to the relevant Jira issue.
  • Jira ticket has a comment referencing this PR.

[azaleacolburn]

Why don't the settings with sliders appear when you use the fast graphics preset? Is this intentional? Also, could we conform this PR's description to the project's standard?

[ariesninjadev]

Why don't the settings with sliders appear when you use the fast graphics preset? Is this intentional?

It's because fancy shadows is disabled on fast. The bubble is still filled because of an existing bug with bubbles and being unable to update them, which I will patch as soon as UI Refactor drops (UI Refactor before GTA 6?)

Also, could we conform this PR's description to the project's standard?

...fine

[AlexD717]

If I enable fancy shadows on "fast" it switches to custom mode, but then if I switch back to "fast" it still shows fancy shadows enabled.

Screen.Recording.2025-07-22.at.10.14.38.AM.mov

[ariesninjadev]

If I enable fancy shadows on "fast" it switches to custom mode, but then if I switch back to "fast" it still shows fancy shadows enabled.

Please see this comment, this comment, and this comment.

[AlexD717]

If I enable fancy shadows on "fast" it switches to custom mode, but then if I switch back to "fast" it still shows fancy shadows enabled.

Please see this comment, this comment, and this comment.

My bad, I didn't notice that. I think pr #1229 should solve your issue.

On another note, would it be possible for you to add a button that the user can press that reruns the optimization? Not really required but I do think that it would add some nice polish.

[AlexD717]

This is fine for setting graphics quality but it isn't very accurate. Currently we just get the memory and cores which doesn't give an accurate estimate of device performance as cpu core performance can vary wildly. In my opinion it would be best to run a simple performance test, but I am fine approving this if we don't want to bother with that.

[ariesninjadev]

This is fine for setting graphics quality but it isn't very accurate. Currently we just get the memory and cores which doesn't give an accurate estimate of device performance as cpu core performance can vary wildly. In my opinion it would be best to run a simple performance test, but I am fine approving this if we don't want to bother with that.

In my experience with web game development with doing performance tests, they aren't too reliable. There are too many factors that could sway the results of the test (surviv.io did an auto graphics adjustment, and the performance test was 4000 lines of mess).

Of course it's still totally an option, but would probably be a whole other 8 point ticket, and grabbing the specs/ram is usually enough to make a guess (and yes, 4gb and 2c are tested values)

[AlexD717]

@ariesninjadev now that pr #1229 was merged into dev, are you able to make it so that the checkboxes work properly?

[BrandonPacewic]

Getting an issue where if I:

1. Graphics Settings -> Fast -> Accept
2. Graphics Settings -> Fast -> Cancel

Then some lighting setting updates and everything goes dark.

I'm also getting toasts about settings being updated and saved everytime I open the panel. Not sure if this is also the behaviour on dev but it feels not quite right.

[BrandonPacewic]

This looks good and I was unable to break the state from what I tried. Unfortunately this is where we are going to draw the line for UI changes for #1241 (AARD-1903). This will need to be updated for the introduced conflicts and then we can merge.