## What this does

- Adds **Run** distance to Token Hud, including tooltips for Move value, plus Walk, Run and Swim mode distances. 
  - Only the base **Move** value is shown for vehicles. 
- Adds **Initiative** to Token Hud, including tooltip for Agility values.
  - Initiative and Agility are only displayed in active scenes.
- Adds **Fortune**, **Resolve**, **Corruption** and **Perception** to Token Hud, including tooltips for Fate, Resilience, Sin and Intuition values respectively.
  - These are only displayed for player character tokens.
- Adds **interactions** to support commonly used tests and characteristic changes (see [Interactions](#interactions) for full details).
- Updates **Condition** menu: 
  - repositions to avoid overlapping with the Initiative hud extension.
  - alters the styling to make condition icons more visible.

## Usage Patterns

- Right click a token to bring up the extended token hud info. 
  - Primary characteristic values are displayed (Run, Initiative, Fortune, Resolve, Corruption and Perception).
  - Hover over icons to see alternative characteristic values (Move and Walk, Agility, Fate, Resilience, Sin and Intuition respectively).
- Use mouse and key combinations to trigger interactions. Typical interaction patterns are:
  - Double-click to roll related tests and tables for primary characteristics.
  - `ALT` and double-click to roll related tests and tables for non-primary characteristics
  - Right-click to adjust characteristic values.

### Interactions

#### Movement

| Interaction                               | Effect                                                       |
| ----------------------------------------- | ------------------------------------------------------------ |
| `CTRL` + `Double-click`                   | Roll **Dodge** test                                          |
| `ALT` + `Double-click`                    | Roll **Athletics** for Running, Leaping, Falling and Pursuit tests. |
| `SHIFT` + `Double-click`                  | Roll **Stealth** test                                        |
| `CTRL` + `ALT` + `Double-click`           | Roll **Climb** test                                          |
| `CTRL` + `SHIFT` + `Double-click`         | Roll **Drive** test                                          |
| `ALT` + `SHIFT` + `Double-click`          | Roll **Ride** test                                           |
| `CTRL` + `ALT` + `SHIFT` + `Double-click` | Roll **Swim** test                                           |

#### Resolve

| Interaction              | Effect                                                       |
| ------------------------ | ------------------------------------------------------------ |
| `CTRL` + `Double-click`  | Roll **Cool** for psychology tests, including spiritual corrupting influences |
| `ALT` + `Double-click`   | Roll **Endurance** for disease and physical resistance tests, including corrupting influences |
| `SHIFT` + `Double-click` | Roll **Consume Alcohol** test                                |
| `CTRL` + `Right-Click`   | Reduce Resolve by 1                                          |
| `SHIFT` +  `Right-Click` | Increase Resolve by 1                                        |

#### Fortune

| Interaction                      | Effect                     |
| -------------------------------- | -------------------------- |
| `CTRL` + `Double-click`          | Roll **Gamble** test       |
| `SHIFT` + `Double-click`         | Roll **Charm** test        |
| `ALT` + `Double-click`           | Roll **Gossip** test       |
| `ALT` + `SHIFT` + `Double-click` | Roll **Charm Animal** test |
| `CTRL` + `Right-Click`           | Reduce Fortune by 1        |
| `SHIFT` + `Right-Click`          | Increase Fortune by 1      |

#### Corruption

| Interaction                       | Effect                           |
| --------------------------------- | -------------------------------- |
| `CTRL` +  `Double-click`          | Roll for Physical Mutation       |
| `SHIFT` + `Double-click`          | Roll for Mental Mutation         |
| `ALT` + `Double-click`            | Roll **Pray** Test               |
| `ALT` + `SHIFT` + `Double-click`  | Roll for Wrath of Gods           |
| `CTRL` + `ALT` +  `Double-click`  | Roll d100 for **Little Prayers** |
| `CTRL` + `Right-Click`            | Reduce Corruption by 1           |
| `SHIFT` +  `Right-Click`          | Increase Corruption by 1         |
| `CTRL` + `ALT` + `Right-Click`    | Reduce Sin by 1                  |
| `SHIFT` + `ALT` + `Right-Click`   | Increase Sin by 1                |

#### Perception

| Interaction             | Effect                                                       |
| ----------------------- | ------------------------------------------------------------ |
| `CTRL` + `Double-click` | Roll **Perception** test, including those granted for, eg, *Acute Sense*  (WFRP p132) and *Second Sight* (WFRP p144). |
| `ALT` + `Double-click`  | Roll **Intuition** test, including those granted for, eg, *Detect Artefact*  (WFRP p135), *Holy Visions* (WFRP p138), *Nose for Trouble* (WFRP p141), *Second Sight* (WFRP p144), and *Sixth Sense* (WFRP p145). |

#### Initiative

| Interaction                       | Effect                                                       |
| --------------------------------- | ------------------------------------------------------------ |
| `CTRL` + `Double-click`           | Roll **Initiative** characteristic test.                     |
| `CTRL` + `SHIFT` + `Double-click` | Roll **Track** test.                                         |
| `ALT` + `Double-click`            | Roll **Agility** characteristic test, including for breaking Initiative tie-breakers (WFRP p156). |

## TODO: Images

### NPCs and Creatures (Inactive Scenes)
![](uploads/token-hud-ext_npc-inactive_0-2.png)

### Player Characters 
#### Corruption and Sin
![](uploads/token-hud-ext_pc-corruption-inactive_0-2.png)

#### Fortune and Fate
![](uploads/token-hud-ext_pc-fate-inactive_0-2.png)

#### Resolve and Resilience
![](uploads/token-hud-ext_pc-resolve-inactive_0-2.png)

### Initiative and Agility (Active Scenes)
![](uploads/token-hud-ext_pc-initiative-active_0-2.png)

## Conflicts
- Visual conflict with the tooltip feature of **Virtual Tabletop Assets - Party Overview**: [workaround](conflicts#virtual-tabletop-assets---party-overview).
- Other modules that alter token hud or hover behaviour may also visually conflict (such as **Health Estimate**).

## Notes
- [Source](https://github.com/Jagusti/fvtt-wfrp4e-gmtoolkit/blob/master/scripts/token-hud-extension.js)

## History
- Version 0.7.0. Vehicle actors are handled separately to character, npc and creature actors.