> For the complete documentation index, see [llms.txt](https://docs.devlevy.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.devlevy.com/ue-code-plugin/bptracker/plugin-settings.md).
# Plugin Settings
## **BPTracker - Plugin Settings Reference**
> **You don't need to configure all of this.** \
> BPTracker works out of the box with sensible defaults — this page is a *reference* for when you want to fine-tune something, not a setup checklist. \
> *Most users only ever touch two things: the **Asset Types** checkboxes and their **Author Name**.*
>
> Location: **Project Settings > Plugins > BP Tracker**. Stored in `Config/DefaultBPTracker.ini` (project-shared), except where noted.
### Asset Types
Master toggles enable tracking for an asset family; indented sub-options add per-save detail and are disabled while their master is off. Turning any toggle off stops **new** recording only — existing history stays browsable.
#### Blueprint group
| Setting | Default | What it does |
| --------------------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| Track Blueprint | On | Records Blueprint saves: variables, graphs, parent class, interfaces, node counts |
| Track BP Components | On | Component list changes — add/remove, class swap, reparenting |
| Track BP Node Details | On | Individual nodes, pins, and comments (enables node-level diffs and jump). Applies to **every** Blueprint kind, including Widget and Anim Blueprints |
| Track BP Macros | On | Macro graph changes. Also applies to all Blueprint kinds |
#### Widget Blueprint group
| Setting | Default | What it does |
| ----------------------- | ------- | ------------------------------------------------ |
| Track Widget Blueprint | On | Records Widget Blueprint saves (widget tree) |
| Track Widget Properties | On | Per-widget property values |
| Track Widget Slot | On | Slot/layout changes (position, anchors, padding) |
| Track Widget Animations | On | Widget animation additions/changes |
| Track Widget Bindings | On | Property binding changes |
#### Animation group
| Setting | Default | What it does |
| ------------------------- | ------- | -------------------------------------------------------------------- |
| Track Anim Blueprint | Off | AnimGraph state machines, states, transition graphs |
| Track Anim Montage | On | Slot segments, RateScale, sync groups |
| Track Anim Sequence | On | RateScale, interpolation, curves, sync markers, raw-key signature |
| Track Anim Notify Details | On | Notify instances and their properties (shared by Montage & Sequence) |
#### Material group
| Setting | Default | What it does |
| -------------------------- | ------- | ----------------------------------------------------------------------------- |
| Track Material | On | Records Material saves |
| Track Material Properties | On | Blend mode, shading model, two-sided, and other material properties |
| Track Material Inputs | On | Main input pin connections (BaseColor, Roughness, …) |
| Track Material Expressions | On | Expression nodes, node-to-node rewiring, comments (enables node jump) |
| Track Material Instance | On | Parent, overrides, scalar/vector/texture/RVT/font parameters, static switches |
| Track Material Function | On | Function description/exposure, expressions, function instances |
#### AI group
| Setting | Default | What it does |
| --------------------- | ------- | --------------------------------------------------------------- |
| Track Behavior Tree | On | Behavior Tree node structure (+ Blackboard keys) |
| Track BT Node Details | On | Per-node property values, root decorators, Blackboard key types |
#### Data group
| Setting | Default | What it does |
| ------------------------- | ------- | ------------------------------------------------------------- |
| Track Data Asset | On | All editable properties of Data Assets (incl. nested structs) |
| Track Data Table | Off | Row-level changes — add/remove/modify rows and cell values |
| Track Curve | On | Curve asset key data |
| Track Curve Table | Off | Curve table rows |
| Track String Table | On | String table entries |
| Track User Defined Enum | Off | Enumerators and display names |
| Track User Defined Struct | Off | Members, types, defaults |
#### Niagara group
| Setting | Default | What it does |
| ------------------------------ | ------- | ------------------------------------------------------------- |
| Track Niagara System | On | System/emitter-level changes (also standalone Emitter assets) |
| Track Niagara Module Values | On | Stack module input values per stage |
| Track Niagara Renderer Details | On | Renderer property values |
#### Sequencer group
| Setting | Default | What it does |
| ------------------------------- | ------- | -------------------------------------------------- |
| Track Level Sequence | On | Playback range, bindings, tracks |
| Track Sequencer Section Details | On | Section properties and keyframe channel signatures |
**Note on defaults:** a few types default to Off (Anim Blueprint, Data Table, Curve Table, User Defined Enum/Struct) because they can be save-heavy in some pipelines. Flip them on if you use them.**One-time effect:** switching a *detail* option off makes the next save compare once against the previous richer snapshot — you may see a single bulk "removed" entry, then it goes quiet.
### Recording
| Setting | Default | What it does |
| ------------------- | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Enabled | On | Master switch for all recording. Off = nothing records (existing history kept, viewers still work) |
| Author Name | *(empty)* | The name written into each record's author field. Empty = your machine account name. **Per-user**: stored in your personal editor ini, never in the shared project config — so one teammate's name can't stamp everyone's records |
| Min Save Interval | 2.0 s | Debounce: repeat saves of the same asset within this window are recorded once |
| Ignore Auto Save | On | Editor auto-saves are not recorded |
| Track Save All | Off | Whether a "Save All" burst (3+ assets saving within \~0.5 s) is recorded at all |
| Max Save All Assets | 10 | Cap on how many assets one Save All burst may record (when Track Save All is on) |
### Local History
| Setting | Default | What it does |
| -------------------- | ------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| Enable Local History | On | Writes per-asset logs to `/AssetChangeLogs/` — survives editor restarts, deliberately outside the volatile `Saved/` folder |
| Local History Path | *(empty = default)* | Custom log location. ⚠ Applied at next editor start |
### Content History
| Setting | Default | What it does |
| ---------------------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Enable Content History | Off | Additionally writes logs under `Content/` next to assets, so history can be committed and shared through source control (team timeline, author names included). On startup, shared logs sync into local history |
### Performance
| Setting | Default | What it does |
| ------------------- | ------- | ----------------------------------------------------------------------------------------------------------------------------- |
| Async Write | On | Log writing goes through a serialized background queue — saves never wait on disk; flushed on rename and editor shutdown |
| Baseline Cache Size | 50 | How many asset snapshots stay in memory (LRU). Evicted entries reload from disk transparently. ⚠ Applied at next editor start |
### Display
| Setting | Default | What it does |
| ----------------------------- | ---------- | ---------------------------------------------------------------------------------------------------------- |
| Page Size | 20 | History entries per page |
| Default Filter Days | 7 | Initial time window of the History view |
| History Window Default Size | 1440 × 900 | Floating History window size (manual resizes are remembered separately) |
| Dashboard Window Default Size | 1200 × 780 | Floating Dashboard window size |
| *Reset Window Sizes* (button) | — | Restores factory sizes and clears remembered manual resizes; applies to an open History window immediately |
### Archive
| Setting | Default | What it does |
| ----------------------------------------- | ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Enable Archive | Off | Automatic housekeeping: moves old entries out of live logs into the archive folder. Archived entries leave the live History view but still count in the Dashboard; files stay on disk |
| Archive Entries Older Than (Months) | 6 | Age cutoff |
| Archive After Days (Test) | 0 (off) | Testing override in days; when > 0 the smaller of days/months wins |
| Force Archive When File Size Exceeds (MB) | 10 | Oversized live logs get their oldest entries archived regardless of age |
| Archive Path | *(empty = default)* | Default `/AssetChangeLogs/_archive`. ⚠ Applied at next editor start |
| *Run Archive Now* (button) | — | One-shot archive pass |
### Actions
| Button | What it does |
| ------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Initialize All Baselines | Pre-captures snapshots for every tracked asset (normally taken when an asset is first opened). Shows a progress dialog — `Baseline 137/2450 (5%): AssetName` — with **Cancel** (keeps what's done so far). Assets of disabled types are skipped without loading. Requires *Enabled* |
| Clear All Baselines | Deletes all baselines, in-memory history, local logs, **and archives** (custom archive path included) after a confirmation that lists everything. **Irreversible** |
### Console command equivalents
`BPTracker.InitAll` · `BPTracker.RunArchive` · `BPTracker.ClearAll` · `BPTracker.History` (opens the History window)
### Settings that require an editor restart
**Local History Path · Archive Path · Baseline Cache Size** — applied at editor startup; the editor shows a notice when you change them. Everything else applies immediately.
> If a setting doesn't behave the way this page says, or you're unsure which option fits your project, just email **** or visit [**Discord Channel**](https://discord.gg/jCJy4At9p)— include your engine version and the asset type involved, and we'll get back to you. \
> During beta, bug reports are fixed with priority.
BPTracker · UE 5.0–5.8 · Editor-only · Support: · © 2026 Dev Levy. All Rights Reserved.