aboutsummaryrefslogtreecommitdiffhomepage
path: root/docs/custom_mod_messages.md
blob: b6072fcc62fc08bd1f333200f5fa85ab44716617 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
# Custom Mod Messages

The website offers support for a variety of variables that can be used in your custom mod messages.
Variables can be used with the `${VAR}` syntax. Anyone who has programmed/scripted in a language
such as Shell Script should be familiar with this syntax.

The following variables are supported:
	- `H` (Hours)

	- `M` (Minutes)

	- `S` (Seconds)

	- `MS` (Milliseconds)

	- `PM` (Padded Minutes)
		- `5` becomes `05`, `18` remains `18`

	- `PS` (Padded Minutes)
		- `5` becomes `05`, `18` remains `18`

	- `1MS` (1 Place Precision Milliseconds)
		- `.466` becomes `.5`, `.421` becomes `.4`

	- `2MS` (2 Place Precision Milliseconds)
		- `.466` becomes `.47`, `.4` becomes `.40`

	- `3MS` (3 Place Precision Milliseconds)
		- `.4` becomes `.400`

	- `TS` (Total Seconds)

	- `ST` (Start Time)
		- Represented in seconds

	- `ET` (End Time)
		- Represented in seconds

	- `TT` (Total Time)
		- In the format `H:MM:SS.xxx`
		- If the run is less than an hour then hours are not shown
		- Milliseconds use 3 place precision
		- If the run is less than a minute, `0` is shown for the minutes

	- `SF` (Start Frame)

	- `EF` (End Frame)

	- `TF` (Total Frames)

## Example Usage

Custom mod message:

```
Mod Note: Retimed to ${H}h ${M}m ${S}s ${3MS}ms
```

Output:

```
Mod Note: Retimed to 0h 6m 18s 000ms
```

Custom mod message:

```
Retimed! ${M}'${PS}"${3MS}
```

Output:

```
Retimed! 5'09"167
```

## BUGS

	- Multiline mod notes currently are not supported.