MagicBeanDev/LongshotLauncher
MagicBeanDev/LongshotLauncher
Watch
8
3
Fork
You've already forked LongshotLauncher
 11
Code Issues 1 Pull requests 8 Projects Releases 8 Packages Wiki Activity Actions 11

feat: check system requirements above the tools download #25

Merged
HumanBean merged 1 commit from HumanBean/LongshotLauncher:feat/system-requirements into main 2026-11-13 10:26:49 +00:00
Conversation 0 Commits 1 Files changed 10 +246
HumanBean commented 2026-11-13 10:10:34 +00:00
Owner

Players should see whether their PC meets the published requirements while the builder downloads, before spending time building the game. Add a status card above the download progress. The status caption and System requirements link share the first line; a visible second line shows detected RAM, Vulkan support, VRAM and mesh-shader availability, along with any limitations or unknown checks. Details wrap across the card as needed and remain available as accessibility help text.

  • Gray means unknown checks, including unavailable GPU information or mesh-shader support.
  • Yellow means known limitations, such as 4 GB RAM, under 8 GB VRAM, missing mesh shaders, or less than 60 GB free for building. A known limitation takes precedence over an unknown result.
  • Green means the checked OS, RAM (16 GB), VRAM (8 GB), Vulkan 1.3, mesh shaders and storage requirements are met.
  • Red identifies detected incompatibility: unsupported OS, missing Linux AVX2, or no Vulkan 1.3 hardware GPU. Results are advisory and never block downloading or building.

The native Vulkan probe reads API support, device-local memory and the meshShader feature directly from the installed loader. It evaluates one GPU at a time, without combining different cards' capabilities. CPU-model performance and physical core count are not verified; the linked requirements page covers them. GPU shared memory can be reported differently, storage uses the initial build destination, and RAM reflects the runtime's available-memory limit. No frame-rate guarantee is implied.

Validation: .NET 10 build with warnings as errors; 597 core checks passed, including 22 requirements cases for thresholds, unknown results, mesh shaders, precedence, multiple GPUs and accurate descriptions of detected hardware; all 28 release tests passed. Native Vulkan/mesh-shader probe exercised on Linux. Actual Avalonia screens rendered headlessly at 960×600 and visually reviewed with authored status fixtures. No game files or saves used. Windows native probing remains untested on Windows.

Green
Yellow
Gray
Red

Players should see whether their PC meets the published requirements while the builder downloads, before spending time building the game. Add a status card above the download progress. The status caption and System requirements link share the first line; a visible second line shows detected RAM, Vulkan support, VRAM and mesh-shader availability, along with any limitations or unknown checks. Details wrap across the card as needed and remain available as accessibility help text. - Gray means unknown checks, including unavailable GPU information or mesh-shader support. - Yellow means known limitations, such as 4 GB RAM, under 8 GB VRAM, missing mesh shaders, or less than 60 GB free for building. A known limitation takes precedence over an unknown result. - Green means the checked OS, RAM (16 GB), VRAM (8 GB), Vulkan 1.3, mesh shaders and storage requirements are met. - Red identifies detected incompatibility: unsupported OS, missing Linux AVX2, or no Vulkan 1.3 hardware GPU. Results are advisory and never block downloading or building. The native Vulkan probe reads API support, device-local memory and the meshShader feature directly from the installed loader. It evaluates one GPU at a time, without combining different cards' capabilities. CPU-model performance and physical core count are not verified; the linked requirements page covers them. GPU shared memory can be reported differently, storage uses the initial build destination, and RAM reflects the runtime's available-memory limit. No frame-rate guarantee is implied. Validation: .NET 10 build with warnings as errors; 597 core checks passed, including 22 requirements cases for thresholds, unknown results, mesh shaders, precedence, multiple GPUs and accurate descriptions of detected hardware; all 28 release tests passed. Native Vulkan/mesh-shader probe exercised on Linux. Actual Avalonia screens rendered headlessly at 960×600 and visually reviewed with authored status fixtures. No game files or saves used. Windows native probing remains untested on Windows. ![Green](https://git.magicbean.dev/HumanBean/LongshotLauncher/raw/branch/feat/system-requirements/docs/screenshots/requirements-green.png?v=a04a3e81) ![Yellow](https://git.magicbean.dev/HumanBean/LongshotLauncher/raw/branch/feat/system-requirements/docs/screenshots/requirements-yellow.png?v=a04a3e81) ![Gray](https://git.magicbean.dev/HumanBean/LongshotLauncher/raw/branch/feat/system-requirements/docs/screenshots/requirements-gray.png?v=a04a3e81) ![Red](https://git.magicbean.dev/HumanBean/LongshotLauncher/raw/branch/feat/system-requirements/docs/screenshots/requirements-red.png?v=a04a3e81)
HumanBean force-pushed feat/system-requirements from 2b6c2e3f4b
All checks were successful
CI / Compile and test (pull_request) Has been skipped
Details
CI / Conventional Commit title (pull_request) Successful in 2s
Details
to 61a453e393
All checks were successful
CI / Compile and test (pull_request) Has been skipped
Details
CI / Conventional Commit title (pull_request) Successful in 3s
Details
2026-11-13 10:22:48 +00:00 Compare
HumanBean force-pushed feat/system-requirements from 61a453e393
All checks were successful
CI / Compile and test (pull_request) Has been skipped
Details
CI / Conventional Commit title (pull_request) Successful in 3s
Details
to a04a3e81ea
All checks were successful
CI / Compile and test (pull_request) Has been skipped
Details
CI / Conventional Commit title (pull_request) Successful in 6s
Details
2026-11-13 10:25:46 +00:00 Compare
HumanBean deleted branch feat/system-requirements 2026-11-13 10:26:50 +00:00
Sign in to join this conversation.
Reviewers
No reviewers
Labels
Clear labels   
area/build
Building Longshot from your game

  
area/install
Installing Longshot

  
area/saves
Moving and backing up saves

  
area/ui
The launcher's windows and screens

  
area/updates
Finding and applying updates

  
good first issue
A good start for a new contributor

  
gpu/amd
AMD GPUs

  
gpu/intel
Intel GPUs

  
gpu/nvidia
NVIDIA GPUs

  
help wanted
Extra hands or knowledge wanted

  
kind
bug
 Something doesn't work as it should

  
kind
chore
 Build, CI, dependencies, tidying

  
kind
docs
 Documentation

  
kind
feature
 A new feature or an improvement

  
kind
performance
 Frame rate, frame time, loading, memory

  
kind
question
 A question rather than a change

  
platform/linux
Linux only

  
platform/steam-deck
Steam Deck

  
platform/windows
Windows only

  
priority
critical
 Crashes, data loss, or blocks most players

  
priority
high
 Important: next in line

  
priority
low
 Nice to have

  
status
blocked
 Waits on something else first

  
status
confirmed
 Reproduced or agreed on

  
status
duplicate
 Already reported or proposed

  
status
invalid
 Not a problem in this project

  
status
needs-info
 Waiting for more information from the reporter

  
status
wontfix
 Will not be worked on

No labels
area/build
area/install
area/saves
area/ui
area/updates
good first issue
gpu/amd
gpu/intel
gpu/nvidia
help wanted
kind
bug
kind
chore
kind
docs
kind
feature
kind
performance
kind
question
platform/linux
platform/steam-deck
platform/windows
priority
critical
priority
high
priority
low
status
blocked
status
confirmed
status
duplicate
status
invalid
status
needs-info
status
wontfix
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
MagicBeanDev/LongshotLauncher!25
No description provided.