FR - Frame Reflex | Plugin 1.3

What is Frame Reflex?

Frame Reflex is a single-script autoload plugin for Godot 4.3+ that continuously measures your game's real runtime performance and adjusts the rendering pipeline on the fly — render scale, shadow quality, FSR, LOD budget, SSAO, SSIL, SDFGI, and more.

No manual per-device config. No build variants. Drop it in and forget about it.

---

How It Works ?

FrameReflex is a Godot 4 plugin that automatically adjusts rendering quality (resolution scale, shadows, LOD, FSR) in real-time to maintain a stable 60+ FPS target. It takes 2–10 seconds on startup to detect your device's performance, then keeps things running smoothly with three manual presets (Performance / Balanced / Quality / Custom) controllable from the editor.

---

Quality Profiles

Four built-in profiles, each defining a render scale band (not a fixed value). The scale drifts continuously within that band in 2.5% steps, with a 3-second recovery cooldown and 5 FPS hysteresis buffer to prevent oscillation.

Profile	Render Scale	LOD Threshold	SSAO / SSIL	Texture Filter
Performance	50 – 70%	15 px	Off	Off
Balanced	60 – 75%	10 px	Off	Low
Quality	70 – 80%	5px	On	Low
Custom	Custom	Custom	Custom	Custom

---

NEW UPDATE = IMPROVED !

Adaptive Systems 

NEW  CUSTOM MODE

Customize your own mode and export it ! 

Stutter Detection

Uses frame-time standard deviation, not just average FPS. Detects hitching even when average FPS looks healthy. Triggers an immediate scale-down when variance exceeds the threshold.

Thermal Throttle Detection

Tracks a rolling 60-second FPS baseline. If your device's performance drifts 20% below that baseline (a sign of thermal throttling), it automatically steps the quality profile down — Performance → Balanced → Quality in reverse.

Dynamic FSR

Enables FSR 1  automatically when there's FPS headroom. Falls back to FXAA when FPS is lower. 

Dynamic Shadows

Shadow atlas size and directional shadow filter quality (PCF disabled / PCF5 / PCF13) scale with FPS in three tiers — all without touching your scene or lights.

Background Mode

Caps FPS at 30 when the window loses focus. Re-runs the warmup window when refocused so quality recalibrates cleanly.

Smart Benchmark

Call FRManager.RunBenchmark() on first launch to test all three profiles for 2 seconds each. Frame Reflex picks the highest-quality profile that sustains your FPS target and saves the result — so the best profile auto-loads on every future session.

---

Setup — 2 Steps

1. Go to Project → Plugins → FR - Frame Reflex and set it to ON
2. Go to Project → AutoLoad and add FrManager.gd

---

Compatible with Godot 4.3 and above. Works on Windows, macOS, Linux, and Android.

ـــــــــــــــــــــــــــــــــــــــــــــــــــــــــــــــــــــــــــــــــــــــــــــــــــــــــــــــــــــــــــــــــــ

Having more FPS without effecting the quality ..!