pulse

1# Pulse Configuration Reference
2 
3Configuration is managed through the ModMenu GUI (`config/pulse.json` is auto-generated on first launch).
4 
5## General Settings
6 
7| Option | Type | Default | Description |
8|---|---|---|---|
9| `targetFps` | int | `60` | Target framerate. Higher = Pulse reacts earlier to drops. |
10| `pressureSensitivity` | float | `1.0` | Multiplier on the pressure score. >1.0 escalates faster, <1.0 is slower. |
11| `recoverySpeed` | float | `1.0` | Multiplier on recovery tick count. >1.0 recovers faster. |
12| `maxOptimizationStage` | enum | `EMERGENCY` | Capped stage. `NORMAL` effectively disables optimizations. |
13| `debugMode` | boolean | `false` | Shows the on-screen debug overlay (FPS, pressure, stage, modules). |
14 
15## Module Toggles
16 
17Every module type has an `enabled` toggle (default: `true`). Modules with a public API hook will apply game-state changes when enabled. Modules without one track internal parameters only (ready for future mixin targets).
18 
19| Module | Game Hook | Effect |
20|---|---|---|
21| `ENTITIES` | `options.entityDistanceScaling()` | Reduces entity render distance under pressure |
22| `CLOUDS` | `options.cloudStatus()` | Disables clouds at Moderate+ |
23| `WEATHER` | `level.setRainLevel()/setThunderLevel()` | Damps rain/thunder intensity |
24| `PARTICLES` | None (26.2 Mojmap has no `ParticleStatus` enum) | Internal params only |
25| `ANIMATIONS` | None | Internal params only |
26| `TRANSPARENCY` | None | Internal params only |
27| `UI` | None | Internal params only |
28| `CHUNKS` | None | Internal params only |
29| `SHADOWS` | Iris/OptiFine reflection | Adjusts shadow distance/resolution if shaders active |
30 
31## JSON Format (`config/pulse.json`)
32 
33```json
34{
35  "targetFps": 60,
36  "pressureSensitivity": 1.0,
37  "recoverySpeed": 1.0,
38  "maxOptimizationStage": "EMERGENCY",
39  "moduleEnabled": {
40    "PARTICLES": true,
41    "ENTITIES": true,
42    "CHUNKS": true,
43    "CLOUDS": true,
44    "SHADOWS": true,
45    "TRANSPARENCY": true,
46    "WEATHER": true,
47    "ANIMATIONS": true,
48    "UI": true,
49    "RENDER_DISTANCE": true
50  },
51  "debugMode": false
52}
53```
54