pulse

1# Pulse Performance
2 
3## Overhead
4 
5Pulse runs entirely in the client tick loop. Its overhead is minimal:
6 
7| Component | Typical |
8|---|---|
9| PerformanceEngine.update() | < 0.01 ms |
10| PressureEngine.update() | < 0.01 ms |
11| AdaptiveManager.update() | < 0.01 ms |
12| ModuleManager.update() | < 0.01 ms |
13| **Total per tick** | **< 0.04 ms** |
14 
15At 60 FPS (16.67 ms budget), Pulse consumes < 0.3% of frametime.
16 
17## Expected Savings
18 
19**No formal benchmarks exist yet.** Real-world savings depend on scene complexity.
20 
21| Optimization | Expected Gain | Status |
22|---|---|---|
23| Entity distance scaling | 5–15% in dense entity scenes | Mixin + Options API |
24| Cloud reduction | 2–5% | Options API |
25| Weather particle filtering | 1–3% | Internal param hooks |
26| Particle reduction | TBD | Mixin |
27| Animation culling | TBD | Mixin |
28| Chunk upload prioritization | TBD | Mixin |
29| Transparency sort reduction | TBD | Mixin |
30| UI update throttling | TBD | Mixin |
31| Shadow resolution (shader mods) | TBD | Iris reflection |
32 
33## Profiling
34 
35Run a JFR recording alongside Pulse:
36 
37```
38./gradlew runClient
39```
40 
41Then attach JDK Mission Control to the process.
42