Interface
Open Hot Patch from Tools > DivinityCodes > Hot Patch. The window is your control center for Play Mode patching.
Window layout
The window is divided into five areas, top to bottom: +--------------------------------------------------+ | Header: PlayMode indicator | Logo | Version | +--------------------------------------------------+ | Control bar: [Menu] [Start/Stop] [Recompile] | +--------------------------------------------------+ | Tabs: Console | Options | About | +--------------------------------------------------+ | | | Tab content (log, settings, or about panel) | | | +--------------------------------------------------+ | Footer: copyright | +--------------------------------------------------+
The control bar is visible on every tab, so you can Start, Stop, or Recompile without switching back to Console.
Header
| Element | Description |
|---|---|
| PlayMode indicator | Green light when Unity is in Play Mode, red when in Edit Mode. Patching only applies during Play Mode. |
| Logo | Hot Patch branding, centered. |
| Version | Installed Hot Patch version (top-right). |
Control bar
Three icon buttons sit below the header.
Center: Start / Stop
| State | Button | Action |
|---|---|---|
| Stopped | Start | Enables Hot Patch. Begins watching for IDE saves once you enter Play Mode. |
| Running | Stop | Disables Hot Patch and releases the auto-refresh guard. |
The Start button is disabled until you accept the license in the Options tab.
When started, the log writes Hot Patch started. When stopped, it writes Hot Patch stopped.
Right: Recompile
Recompile all scripts from disk
| Mode | Behavior |
|---|---|
| Play Mode (Hot Patch running) | Re-applies every user script from disk without exiting Play Mode. Use when patches were skipped or you want a full sync. |
| Edit Mode | Triggers a normal Unity script compilation (AssetDatabase.Refresh + RequestScriptCompilation). |
Left: More actions (dropdown menu)
Opens a menu with patch utilities and links:
| Item | When available | What it does |
|---|---|---|
| Revert Last Patch | Play Mode, Hot Patch running, a patch was applied | Undoes the most recent per-file patch batch. |
| Clear Patches | Play Mode, active patches exist | Removes all runtime Harmony hooks. |
| Apply/Sync | Play Mode, Hot Patch running | Scans all scripts for disk changes and applies immediately. |
| Jump to Script (last patched) | A script was patched this session | Pings and opens the last patched .cs file in Unity. |
| Check for Updates | Always | Checks for a newer Hot Patch version. |
| Documentation | Always | Opens the online docs. |
| Report Issue | Always | Opens the GitHub issue tracker. |
| More Tools | Always | Opens the DivinityCodes product page. |
Revert, Clear, and Apply/Sync are grayed out when Hot Patch is stopped or Unity is not in Play Mode.
Tabs
Console
The main activity view. Shows a live log of everything Hot Patch does: file saves, patch results, warnings, and errors.
Before the license is accepted, a hint appears: "Accept the license in Options to enable Hot Patch."
When idle, the log shows: "Hot Patch activity will appear here."
See Activity log below.
Options
All Hot Patch settings: license, performance, IDE detection, Play Mode exit behavior, logging, callbacks, and exclusions. See Options.
About
A scrolling welcome panel with product information and links.
Activity log
The Console tab log is the first place to look when something does not work.
Log toolbar
| Control | Description |
|---|---|
| Clear | Empties the log immediately. |
| Clear dropdown | Toggle Clear on Play and Clear on Recompile without opening Options. |
| Auto Scroll | When enabled, the log scrolls to the newest entry automatically. |
| Active patches: N | Count of live runtime patches currently applied (right side). |
Log entry colors
| Color | Meaning |
|---|---|
| Light gray | Normal messages (file saves, patch success, status) |
| Yellow / amber | Warnings (skipped files, unsupported edits, partial success) |
| Red | Errors (compile failures, patch exceptions) |
Timestamps
Each log line shows a timestamp on the left and the message on the right. Continuation lines (wrapped text) are indented.
Context menu
Right-click inside the log area:
| Action | Description |
|---|---|
| Clear Log | Same as the toolbar Clear button. |
| Copy | Copies the full log text to the clipboard. |
| Export | Saves the log to a .txt file and reveals it in Finder/Explorer. |
Typical log messages
| Message | Meaning |
|---|---|
Hot Patch is ready - IDE saves will patch at runtime without recompiling. |
Auto-refresh is blocked. You can save scripts in your IDE. |
Hot Patch started. / Hot Patch stopped. |
Start/Stop toggled. |
Patched MyClass |
A type was patched successfully. |
Skipped Assets/... |
File was excluded (Editor folder, excluded assembly, etc.). |
No patchable members |
File was read but contained nothing Hot Patch could patch. |
Recompile started - applying all scripts from disk. |
Full re-apply triggered during Play Mode. |
Play Mode ended - N patch(es) cleared and Unity recompile requested. |
Normal exit after editing scripts during Play Mode. |
Update overlay
When a new version is available, an update overlay may appear on top of the window. Hot Patch pauses itself while the overlay is shown and restores your previous Start/Stop state when you dismiss it.
You can also check manually from More actions > Check for Updates.