Timelines
Triggevent borrows the base timeline files from Cactbot. However, you can add your own entries, as well as make edits to the builtin ones. It also has the ability to add icons for abilities to the timeline.
Since we don't have accurate in/out-of-combat yet, the timeline may get out of sync for dungeons, alliance raids, etc.
The settings are accessible under Plugin Settings -> Timelines.
Overlay configuration is done on the "Overlays" tab.
Here are what the settings mean.
- Enable Overlay: Enable/Disable the timeline overlay
- Debug Mode: Only useful for writing timelines. Causes the last sync to always be displayed, even if it is out of your time window. Also shows sync-only entries as 'null'. See the timeline guide. A "*" on a timeline entry indicates the current sync.
- Show Pre-Pull: Show the overlay prior to the pull beginning.
- Reset on Map Change: Reset the timeline on a "Map Change". Note that some raids have map changes, and the timeline may not expect to be reset. Recommend leaving this disabled unless you are primarily using it in dungeons/alliance raids/DRS/etc.
- Max in Overlay: Max number of timeline entries to display at a time.
- Seconds in Future: Max time in the future to display timeline entries (e.g. 60 will display timeline entries a minute out).
- Seconds in Past: max time in the past to display timeline entries. Should be 0 unless trying to debug timeline issues.
On the left, you can pick a zone to display the timeline file from that zone. If you are currently in the zone (or replaying a log in that zone), you can also click the "Select Current" button to select it automatically.
Once you have selected a timeline to edit, you can start typing in any cell to edit. To add a new entry, select an entry whose time most closely matches the entry you want to create, then click "Add New Timeline Entry" at the bottom. Or, right click an existing entry, and "Clone".
The columns are:
- Type: 'B' for builtin, 'C' for fully custom, 'O' for a custom override of a builtin (i.e. you edited a builtin entry)
- Time: Same as Cactbot - represents when on the timeline this entry takes place (in seconds).
- Icon: A URL to an Icon to use. At some point, I will make a picker for ability icons since that is the intended use.
- Text/Name: The text to be displayed. Same as Cactbot. Leave empty if you do not want it to be displayed, but still want to use it as a sync.
- Pattern: The sync pattern. This is a regex for parsed log lines. Same as Cactbot.
- Duration: Optional, provides an "active time". Same as Cactbot.
- Window Start/End/Effective: Same as Cactbot. This tells it how far before/after it should allow a sync to this line. Both the start and end default to 2.5. You must edit the start/end values, the "Win Effective" is just a preview of the end result. Typically, 2.5 is fine, but for phase pushes and loops without fixed durations, this can be useful to resync the timeline.
- Jump: Same as Cactbot. When this line is synced to, the timeline will jump to the given time rather than the normal time of the sync. Useful for loops.