Skip to content

Installation ​

Unity version ​

Event Monitor is tested on Unity 6 LTS (6000.3.7f1, 6000.4.2f1) and Unity 2022.3.62f3. The package relies on Unity’s IL Post-Processor pipeline.

Compatibility matrix (tested) ​

Unity versionStatus
6000.3.7f1Supported
6000.4.2f1Supported
2022.3.62f3Supported

Install via UPM (copy-paste) ​

Recommended path is Unity Package Manager.

Option A: Package Manager UI ​

  1. Open Window -> Package Manager
  2. Click +
  3. Choose Add package from git URL...
  4. Paste your Event Monitor repository URL

Option B: manifest.json ​

Add the package to Packages/manifest.json:

json
{
  "dependencies": {
    "com.pawelca.eventmonitor": "https://github.com/your-org/eventmonitor.git"
  }
}

Replace only the repository URL with your actual source.

When installed this way, Event Monitor can declare and restore its own dependencies automatically (including Mono.Cecil).

Package layout ​

After install, the package typically contains:

  • Runtime — EventBus, EventRecord, optional ReflectionScanner.
  • Editor — EventMonitor window, settings, demo scene tooling.
  • IL Post-Processors — assembly that rewrites user assemblies at compile time.

Exact folder names may vary by version; treat this documentation as product-level guidance.

Dependency: Mono.Cecil (automatic in UPM flow) ​

The IL post-processor depends on Mono.Cecil:

  • com.unity.nuget.mono-cecil (for example 1.11.6)

For UPM package installation, this dependency should be resolved automatically by package.json. If you use legacy asset export/import, see Import checklist.

Which assemblies get instrumented? ​

The post-processor does not rewrite every DLL in your project. Typical user script assemblies (for example Assembly-CSharp and many custom asmdef assemblies) are candidates. Unity engine, Editor, system, and Event Monitor’s own assemblies are skipped to avoid recursion and noise.

If your gameplay code lives in a custom asmdef, that assembly is usually still processed as long as it is allow-listed by the tool’s gate and recording is enabled. See ILPP diagnostics and settings and IL patterns and limitations.

Verify instrumentation ​

After installation:

  1. Open Window → Event Monitor and enable Record.
  2. Enter Play Mode and trigger a known event += / ?.Invoke() path.
  3. Confirm SUB / INVOKE rows appear.

If nothing appears, use Troubleshooting & FAQ and optional ILPP diagnostics.

Import Demo Scene sample (Package Manager) ​

To enable Tools/Event Monitor/Generate Demo Scene:

  1. Open Window -> Package Manager
  2. Select Event Monitor
  3. Open the Samples tab
  4. Click Import on Demo Scene Generator

Package Manager Samples import flow

Next step ​

Continue with Quick Start.

If you imported Event Monitor via asset export into another project, use Import checklist.

Event Monitor — Unity Editor documentation