Skip to content

HamesInFlames/Pc-optimization

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🎯 FragForge

Competitive Gaming Windows Optimizer

A hardware-aware PowerShell + WPF wrapper around Chris Titus Tech WinUtil that applies a curated optimization profile for competitive FPS gaming — R6 Siege, Hunt: Showdown, Marvel Rivals, CS2, Valorant, and friends.

PowerShell Windows License: MIT Wraps WinUtil


Why

WinUtil is excellent but you still have to manually pick the right tweaks every time, and the defaults are aimed at general use, not competitive shooters. FragForge:

  1. Detects your hardware — CPU vendor, GPU vendor, RAM, OS build.
  2. Builds a competitive-gaming-tuned config — adapts to AMD vs Intel CPU, skips tweaks that hurt FPS or visibility.
  3. Creates a System Restore Point before changing anything, so you can always roll back.
  4. Hands the config to WinUtil and runs it.

One command. One reboot. Done.


What it actually changes

The profile disables what hurts competitive FPS or steals input cycles, while keeping anything that helps (Game Mode stays on, HAGS stays on).

Category Tweaks
Privacy / telemetry Activity History, Telemetry, Location, WiFi Sense, Suggested Apps, Recall (Win11 24H2)
Gaming-relevant Game DVR off (Game Mode stays on), Service optimization, Teredo off, Faster Explorer, End Task on right-click
System hygiene HomeGroup off, Hibernation off, Temp files cleaned
Bloatware Copilot removed, default Microsoft bloatware removed
Intel-specific LMS1 (Intel ME services) disabled — only applied if Intel CPU is detected

What FragForge deliberately does not change:

  • ❌ Game Mode (helps competitive)
  • ❌ HAGS / Hardware-Accelerated GPU Scheduling (required for DLSS Frame Gen, no measurable harm)
  • ❌ Windows Defender (effectively zero gaming overhead on Win11 in 2025)
  • ❌ Windows Update servicing
  • ❌ Page file (UE5 needs it)
  • ❌ SysMain / Superfetch (the "disable for SSD" advice is outdated)

What FragForge does not touch (do these manually):

  • BIOS settings (PBO, Curve Optimizer, EXPO)
  • NVIDIA Control Panel (Reflex, Low Latency Mode Ultra, etc.)
  • GPU undervolt (MSI Afterburner)
  • Per-game settings (motion blur, CA, render scale)
  • VBS / Memory Integrity — strongly recommended to disable manually for ~8% FPS gain. See docs/MANUAL-TWEAKS.md.

Quick start

💡 Open PowerShell as Administrator first.

irm https://raw.githubusercontent.com/HamesInFlames/Pc-optimization/main/fragforge.ps1 | iex

Replace HamesInFlames with your GitHub username after forking/publishing.

Local run

git clone https://github.com/HamesInFlames/Pc-optimization.git
cd Pc-optimization
.\fragforge.ps1

Headless / scripted

.\fragforge.ps1 -NoUI

Skip restore point (not recommended)

.\fragforge.ps1 -SkipRestorePoint

Rollback

If you don't like the results:

rstrui.exe

Pick the restore point named "FragForge - Before Competitive Optimization" and roll back. Reboot.


What it looks like

The UI shows your detected hardware, the profile description, and the full list of tweaks that will be applied. Nothing happens until you click Create Restore Point + Apply.

┌──────────────────────────────────────────┐
│  FragForge                               │
│  v0.1.0 · Competitive Gaming Optimizer   │
├──────────────────────────────────────────┤
│  Detected Hardware                       │
│  CPU   AMD Ryzen 7 9800X3D · 8c/16t      │
│  GPU   NVIDIA GeForce RTX 3080           │
│  RAM   32 GB                             │
│  OS    Windows 11 Pro · build 26100      │
├──────────────────────────────────────────┤
│  Profile: Competitive FPS                │
│  Curated for R6 Siege, Hunt: Showdown,   │
│  Marvel Rivals, CS2, Valorant...         │
├──────────────────────────────────────────┤
│  •  WPFTweaksAH                          │
│  •  WPFTweaksTele                        │
│  •  WPFTweaksDVR                         │
│  ...                                     │
├──────────────────────────────────────────┤
│  Ready. Restore point first.             │
│        [Open Logs] [Cancel] [Apply]      │
└──────────────────────────────────────────┘

Logs

Everything FragForge does is logged to:

%LOCALAPPDATA%\FragForge\fragforge-YYYYMMDD-HHmmss.log

The exact WinUtil config that was applied is written to:

%LOCALAPPDATA%\FragForge\winutil-config.json

You can inspect, modify, or reuse this config independently with WinUtil:

& ([scriptblock]::Create((irm https://christitus.com/win))) -Config "$env:LOCALAPPDATA\FragForge\winutil-config.json" -Run

Hardware detection

FragForge inspects:

  • CPU vendor (Win32_Processor.Manufacturer) → AMD / Intel
  • CPU model → flags Zen 5 X3D (9800X3D / 9950X3D) for future profile expansion
  • GPU vendor → NVIDIA / AMD / Intel Arc
  • GPU model → flags Ampere / Ada / Blackwell for future profile expansion
  • RAM in GB
  • OS build number

Currently only the CPU vendor changes the profile output. The other detections are exposed for future profile branches and shown in the UI for transparency.


Roadmap

  • Per-vendor GPU branches — different NVCP defaults via API
  • Profile presets — Competitive FPS / Streaming / Productivity
  • VBS one-click toggle — currently manual; biggest single perf win
  • Validation pass — post-run check that tweaks actually applied
  • Companion module — NVIDIA Control Panel automation via nvidia-smi + nvapi wrappers
  • Generate before/after benchmark with CapFrameX integration

Contributing

PRs welcome, especially:

  • New competitive game presets
  • AMD GPU profile branches (Radeon Anti-Lag toggle, etc.)
  • Localization
  • Screenshots / demo GIFs

Run PSScriptAnalyzer before submitting:

Install-Module -Name PSScriptAnalyzer -Force
Invoke-ScriptAnalyzer -Path .\fragforge.ps1

CI runs the same check on every PR.


Credits


License

MIT — same license as WinUtil. Use, fork, modify, ship.


Disclaimer

FragForge invokes a third-party tool (WinUtil) that modifies Windows. A System Restore Point is created before any changes, but you assume all risk. Don't run this on a work machine without permission. Don't run this if you don't understand what it does — the tweak list is right there in the UI before you click Apply.

About

Hardware-aware Windows optimizer for competitive FPS gaming. Wraps Chris Titus Tech WinUtil with a curated profile. PowerShell + WPF, single file, irm|iex runnable.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors