docs(website): refresh system requirements and AMD status #1054
No reviewers
Labels
No labels
area/accessibility
area/audio
area/input
area/install
area/menu
area/renderer
area/saves
area/tooling
area/upscaling
beanstalk: approved
beanstalk: failed
beanstalk: needs approval
beanstalk: running
beanstalk: tested
ci: approved
good first issue
gpu/amd
gpu/igpu
gpu/intel
gpu/nvidia
help wanted
kind
bug
kind
chore
kind
docs
kind
feature
kind
performance
kind
question
needs measurements
platform/linux
platform/macos
platform/steam-deck
platform/windows
preview
priority
critical
priority
high
priority
low
regression
risk
high
risk
low
risk
medium
status
blocked
status
confirmed
status
duplicate
status
invalid
status
needs-info
status
wontfix
ci: approved
No milestone
No project
No assignees
2 participants
Notifications
Due date
No due date set.
Dependencies
No dependencies set
Reference
MagicBeanDev/Longshot!1054
Loading…
Reference in a new issue
No description provided.
Delete branch "bibiburl/Longshot:docs/requirements-audit"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
Type: docs · Risk: low · Tested on: Linux, Chromium 153 (website only) · Needs: none
Why
The AMD project-status row is too technical for a quick compatibility check, omits the Linux fallback default, and links to old Hookshot reports that are no longer accessible.
The recommended hardware should allow more headroom while keeping the existing simple requirements table. These are estimates, not hardware qualification or a 60 fps guarantee.
The requirements page still says the Linux AppImage requires AVX2, despite #574 removing that restriction. It also promises steady 60 fps for specific CPUs without enough evidence, and suggests a 6 GB quality preset for a 4 GB card.
What changed
Keep the existing Minimum/Recommended table and surrounding wording, raise the recommended hardware, and make the README and Getting Started agree with the website.
Only three documentation files differ from main: README (requirements and AMD project status), the requirements page, and the short memory recommendation in Getting Started. No layout, runtime, tests or new audit document.
Evidence and developer guidance
AMD status was checked against the Windows device rule in
gpu/vk/mesh_mode.h, the Linux default ingpu/vk/vk_main.cpp, merged #219, and current reports #933 and #1040. #975 is merged but still lists RX 6600 gameplay verification as pending, so the row does not claim the slowdown is fixed. The detailed fallback rules already remain indocs/development.md; no new technical section is added.The tested configurations catalogue records runs using the named CPUs and GPUs. This establishes that these configurations have been exercised, not that they are equivalent or guarantee a frame rate. The 7800X3D results are specific stationary scenes; RTX 4070 and RX 7800 XT records include correctness tests rather than a matched performance comparison. The 13600K test report is likewise build-, scene- and settings-specific.
The 32 GB recommendation leaves room for the recorded roughly 13–19 GiB game-memory use and the operating system. The 12 GB VRAM recommendation gives more headroom than the old 8 GB recommendation. These remain editorial estimates; no new benchmark qualification is claimed.
The developer hardware support tiers still include lower-end hardware. Those are support priorities, not recommended performance tiers. This PR does not remove that support. The runtime's “16GB RAM or more recommended” warning remains compatible with recommending 32 GB for headroom, and the direct Getting Started recommendation is updated to match. The project-status link remains available for known hardware issues; removing Arc from the examples does not change runtime compatibility.
Measurements
Verdict: documentation only; no gameplay measurements. Existing presentation retained and the two requirements copies checked for matching content.
Flags and settings
None.
Testing
Tested: main
bbe421f5against73dd846d, with the final requirements wording rebuilt and visually checked at1ee97b9a:graphics-settings.test.ts,HDR Native condition accepts current prose but remains required.2c48449a: rebuilt the website and rechecked local links/tests; rendered README screenshots below. The same existing HDR test failure remains. No additional game-free suite or gameplay run for this prose-only follow-up.Not tested: game performance, new hardware or Windows execution; this PR makes no new benchmark claim.
Must be tested: None for these documentation corrections.
Existing game-free failures on both sides
tests/test_bug_report_defaults.pytests/test_crt_options.pytests/test_guest_imported.pytests/test_linux_preflight.pytests/test_linux_update.pytests/test_make_game_cache.pytests/test_missing_nup.pytests/test_mods_size_table.pytests/test_pending_guest_import.pytests/test_run_all_changed.pytests/test_vk_occlusion_queries.pytests/test_walk_key.pyRisks
What could break: wording could become outdated as builds change.
Turning it off: revert the change.
Compatibility: Nothing changes in the game, saves, settings or dependencies. The normal website workflow publishes the text after merge.
Issues
See #574 for the AVX2 change and #104 for the original requirements table. The revised hardware estimates remain estimates; this PR does not qualify a new performance tier.
Checklist
Everyone
type(scope): description) of the status line's type.main.python -I -B tests/run_all.pypasses (any failure that also fails onmainis named).third_party/untouched (a new folder with aPROVENANCE.mdinstead).When it applies
Assisted-by:/Co-Authored-By:trailers.Screenshots
Current requirements page, with Intel Arc removed from every row.
Current: desktop, light
After: this PR @
1ee97b9a— desktop, lightCurrent: desktop, dark
After: this PR @
1ee97b9a— desktop, darkCurrent: phone, light
After: this PR @
1ee97b9a— phone, lightCurrent: phone, dark
After: this PR @
1ee97b9a— phone, darkHistorical comparison only — old main before this PR (superseded specs)
Before: main @
bbe421f5— desktop, lightBefore: main @
bbe421f5— desktop, darkBefore: main @
bbe421f5— phone, lightBefore: main @
bbe421f5— phone, darkAMD status comparison
Local Markdown renderings of the README row, using the same presentation for before and after. These show the source wording, not a screenshot of the Forgejo interface. Requirements-page screenshots above are unchanged.
AMD row: desktop, light — current and previous
AMD row: desktop, dark — current and previous
AMD row: phone, light — current and previous
AMD row: phone, dark — current and previous
Requirements audit complete: source/history and RC ancestry checked, outdated claims corrected, and before/after light/dark desktop and phone screenshots added to the main post. The 19-page website build and link checks pass; the new parity test passes after reproducing the AVX2 mismatch on main. Website and game-free suites have only the same failures as main, listed in the description. No gameplay performance or hardware-qualification claim.
WIP: docs(website): validate system requirements against current evidenceto docs(website): validate system requirements against current evidencedocs(website): validate system requirements against current evidenceto docs(website): correct CPU and VRAM guidanceReduced to the requested spec-only update: original Minimum/Recommended layout and surrounding text restored. Only the CPU and VRAM rows change in the website and matching README: current builds no longer need AVX2, the unsupported steady-60-fps CPU sentence is removed, and a 4 GB card uses Minimum (4GB). The other documentation changes, added test and audit document are removed. Main-post screenshots now show this version. Build and link checks pass; website and game-free failures are unchanged from main.
docs(website): correct CPU and VRAM guidanceto docs(website): raise recommended hardware and correct requirementsRaised the recommended CPU/GPU and memory specifications in
73dd846d, keeping the original table and minimum hardware. README, website and Getting Started now agree. The description records the test evidence and its limits: these are headroom estimates, not a 60 fps guarantee. Fresh full-page desktop/phone screenshots in both themes replace the previous after captures. Website build and link checks pass; website and game-free test failures match main.Updated
83152052to the requested recommended specs: Ryzen 7 7800X3D or Core i5-13600K; RTX 4070 or RX 7800 XT; 12 GB+ VRAM and 32 GB+ RAM. Removed Arc B580 from the recommendation in both copies. Refreshed screenshots; website build and link checks pass, with the same existing HDR test failure. Layout and minimum hardware are unchanged.Put current screenshots first and collapsed the clearly labelled previous versions. The recommended GPU row shows RTX 4070 or RX 7800 XT. Intel Arc references remain in minimum hardware and mesh-shader support, which were unchanged.
Removed Intel Arc from the requirements table entirely in
1ee97b9a: no Arc A380 minimum example and no Arc mention in the mesh-shader row. Updated the matching README section and all four current screenshots. Confirmed rendered requirements contain no Intel Arc text. Website build and link checks pass; the same existing HDR test failure remains.docs(website): raise recommended hardware and correct requirementsto docs(website): refresh system requirements and AMD statusAdded the AMD project-status refresh in
2c48449a. The row is shorter, mentions automatic Windows/Linux rendering workarounds, links current RX 6600 and Radeon 860M reports, and points to existing technical details. It does not claim the remaining issues are fixed. Website build and all 1,067 local link/asset checks pass; website tests retain the same existing HDR failure (101 pass / 1 fail). Added labelled local README before/after renders; the requirements screenshots remain unchanged.