Window Overview
Watch Window
This is the main window of the tool, where most of its features are accessible. You can find it under Window/LiveWatch.
Below are descriptions of the key components:
1. Search
Toggles the visibility of the Search Panel.
2. Live
Enables or disables data recording, including manual updates. Enabled by default.
3. Collapse
Hides columns with unchanged values, showing only columns with unique values. Enabled by default.
How to make variable values Collapsable?
Use SetAlwaysCollapsable()
method from WatchReference API.
4. Clear
Deletes all recorded data for the variables. The variables remain, but all data is lost. Be cautious when using this, as there is no confirmation prompt.
5. View
Submenu for adjusting data visualization settings.
6. Save
Saves the current data as a binary file to a selected path.
7. Load
Loads watch data from a previously saved binary file.
8. Preferences
Submenu with various useful commands.
9. Variable Name
Displays the name of the watched variable. If the variable has child members (i.e., it's not a base type), there will be a foldout button on the left of the label.
Info
Note that the column is resizable by dragging with the mouse.
10. Variable Values
Values are organized into cell segments, where identical values are merged into one long cell. Each cell contains a progress bar that compares the variable’s value to others visible on the screen.
Clicking anywhere in the value area will bring up a selection column showing all values from the same iteration. If the selected cell has unique values to the left or right, small guiding triangles appear, indicating whether the neighboring value is larger or smaller (top or bottom triangle).
11. Child Variables Preview
If a variable has child members, its values are displayed in a compressed view regardless of their count or depth. Each line in the preview cell represents a specific child’s value. A bright rectangle indicates a changed value in that column. Search results are also shown here.
Why does the preview take time to appear?
This calculation runs in the background on a separate thread to avoid slowing down the interface, but processing time may increase depending on the number and depth of the child variables.
12. Info Area
Depending on what is selected, this area will show either the full name or value of the specific variable, regardless of its length.
13. Extra Text
You can attach additional information to each pushed value. For example, in the screenshot, it shows the source of the gold change (more information in upcoming chapters).
Search Panel
The Search Panel functionality is more advanced than in a typical Console, allowing for the use of multiple queries linked by boolean operators. Additionally, similar to other areas, the Search Panel is resizable.
1. New Line
Adds a new query line.
2. Progress Bar
Displays the current search progress along with a counter.
3. Previous Result
Navigates to the previous search result
Why Collapse mode disables after click?
Jumping to a different search value will disable the Collapse feature to prevent skipping potentially collapsed values.
4. Next Result
Similar to the previous function, this navigates to the next result. The jump order is left to right for values, and then from top to bottom for variables, starting with variable labels if there are such queries.
5. Run
Triggers the search. Processed in a separate thread.
6. AutoRun
When enabled, the search restarts every time the queries are modified.
7. Query Connective Operator
Defines the boolean operator, either OR
or AND
.
8. Inverse
Inverts the affected query line (e.g., a query of <= 15
will become > 15
after inversion).
9. Target
Specifies the target for the query line, which can be either a variable Name or Value.
10. Target Type
For variable names, it’s always String. For values, it includes: String (string
and char
), Bool, Decimal (float
, double
), Integer (int
, short
, etc.), and Numeric (for both Decimal and Integer).
11. Query Line Operator
Determines the query operator based on target types. For String, the options are Equals and Contains. For numerical values, it includes Equals, Greater, GreaterOrEqual, Less, and LessOrEqual.
12. Query
Represents the query text itself.
13. Case
Toggles case sensitivity for String queries. For example, after enabling, the previously positive query ‘Health’ Equals ’health’
will become negative.
14. Delete
Removes the query line. Note that the first line cannot be deleted.
Cell View Submenu
This submenu allows you to customize the appearance of the cells.
1. Width
Slider for adjusting the width of the cells. If the width drops below a certain level, the window will switch to Graph
mode.
2. Height
Slider for adjusting the height of the cells.
3. Selection
Option for selecting the direction of the selection column: Right
or Left
.
4. Restore Defaults
Resets the above settings to their default values.
Preferences Submenu
This submenu provides access to various settings related to LiveWatch.
1. Preferences
Link to the Editor Preferences
Window, where you can adjust LiveWatch settings and parameters.
2. Regenerate All
Triggers the regeneration process on every Generator
scriptable object present in the project.
Next chapter: Window Shortcuts