Options
Open Tools → DivinityCodes → Hot Patch → Options to configure Hot Patch behavior.
Settings are stored in EditorPrefs and persist across Unity sessions.
License
You must accept the End User License Agreement before Hot Patch can run. The full text is in LICENSE.txt inside the package folder.
Performance
Play Mode warmup
Preloads Roslyn and assembly metadata when Play Mode starts so the first IDE save patches faster. Runs silently in the background.
Default: On
Index project scripts during warmup
Builds a type lookup cache in the background after warmup. Speeds up patch target resolution.
Disable on very large projects if Play Mode entry feels heavy.
Default: On
IDE save detection
File save debounce (seconds)
Waits this long after a file change before applying a patch. Increase if your IDE saves in multiple steps or triggers duplicate writes.
Default: 0.4s - Range: 0.1–2.0s
Background poll interval (seconds)
How often Hot Patch scans script timestamps while Unity is open during Play Mode. Lower values detect saves sooner; higher values use less CPU.
Default: 0.35s - Range: 0.1–2.0s
Detect saves when Unity regains focus
Checks for IDE file changes immediately when you alt-tab back to Unity. Recommended when using an external editor.
Default: On
Play Mode exit
Recompile when exiting Play Mode
After editing scripts during Play Mode, request a Unity script recompile on exit so the Editor matches disk.
Turn off if you prefer to press Recompile manually.
Default: On
Activity log
| Option | Default | Description |
|---|---|---|
| Clear log when entering Play Mode | On | Empties the Home tab log each Play Mode start |
| Clear log on script recompile | Off | Empties log on domain reload |
| Log file save events | On | Logs when a changed script file is detected |
| Log successful patch results | On | Logs patch success summaries (errors always logged) |
| Log Play Mode ready message | On | Logs when auto-refresh is blocked and Hot Patch is ready |
Callbacks
Invoke [InvokeOnHotPatch] methods
Calls methods marked with [InvokeOnHotPatch] after patches are applied during Play Mode.
Default: On.
Exclusions
Excluded assemblies
Assembly name prefixes to skip. Matching scripts are not patched.
Built-in exclusions include: Unity, UnityEngine, UnityEditor, System, HotPatch, and others.
Add your own prefixes to skip third-party or generated assemblies, e.g. MyPackage.Editor.
Excluded namespaces
Namespace prefixes to skip. Types under these namespaces are ignored when scanning for patch targets.
Reset to defaults
Restores all options to factory defaults. Does not reset the license acceptance or Start/Stop state.