Skip to content

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.


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.