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
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
|
# Features Format
Many features are complex. Here we lay out the format used when writing a feature.
The overall structure of a feature is a dictionary as follows:
* "name": NAME
* "text": TEXT
* "subfeatures": SUBFEATURES
In addition to the hardcoded data provided in the feature, certain variables may be given at runtime.
## Variables
Many features are very similar between creatures except for certain variables. When instantiated programatically, the feature is given the following:
* NAME: The name of the creature with this feature
* V0, V1, ... VN: Zero-indexed list of integer variables
Certain portions of features accept these as parameters, either inline as in TEXT, or in the place of hardcoded variables for conditions or effects.
In addition to these, certain attributes of the creature having this feature may be probed such as STR, DEX, CON, INT, WIS, CHA, or PROF.
Finally, simple math can be provided in postfix notation surounded by parentheses. For example, to set a save DC equal to 8+int+prof: (8,INT,PROF,+,+).
## TEXT
This is explanatory text. It accepts embedded variables in the form {VARNAME}. For example, the text "The {NAME}'s weapon attacks are magical. When the {NAME} hits with any weapon, the weapon deals an extra {V0}d{V1} radiant damage.", when applied to a "deva" with runtime variables (4, 8), we get:
"The deva's weapon attacks are magical. When the deva hits with any weapon, the weapon deals an extra 4d8 radiant damage."
## Subfeatures
Each feature consists of a list of "subfeatures", which are treated as independent features in the game, but are grouped together for clear organization.
Each subfeature is a dictionary with the following elements:
* "trigger": TRIGGER
* "conditions": CONDITIONS
* "effects": EFFECTS
* "recharge": RECHARGE
Several of the elements accept various nouns.
## NOUNS
Nouns embedded into subfeature elements may be any of:
* "self"
* "creature"
* "object"
* "structure"
* "target"
* "point in space"
* NAME
Where NAME is interpreted by the game as a specific creature or object with a matching name.
### TRIGGER
TRIGGER is a list containing any of the following followed by nouns corresponding to instances of N:
* "on init"
* "action"
* "bonus action"
* "free action"
* "N start of turn"
* "N end of turn"
* "N takes damage" (pushes damage amount to variables list)
* "N moves"
* "N makes check against N"
* "N forces N to save"
* "N rolls a d20"
* "N targets N by a spell"
* "N attacks N"
* "N hits N"
* "N touches N"
### CONDITIONS
CONDITIONS is a list of lists, all of which must evaluate True for effects to be applied. Each condition list is formatted [ CONDITION, variables ] where CONDITION is any of the following, prepend "not " to invert:
* "N has property PROPERTY"
* "N is hostile to N"
* "N is allied to N"
* "N wishes it to be so"
* "N succeeds dc X ABILITY save by at least X"
* "N fails dc X ABILITY save by at least X"
* "N is within radius X of N"
* "N can see N"
* "N has completed >= X turns"
* "N is at full hp"
* "N has >= X hp"
* "Damage received >= X"
* "Damage received was a critical hit"
* "Damage received was type TYPE"
* "N has condition CONDITION"
* "N has condition CONDITION given by N"
* "N and N are on same plane of existence"
* "N is on plane PLANE"
* "N moved X distance straight toward N"
* "N has X movement remaining"
* "N made attack ATTACK"
* "N has underside exposed"
* "First time N uses feature on N during turn"
* "N is flying"
* "N is under effects of spell SPELL"
* "N has spell from school SCHOOL cast on it"
* "N is on terrain TERRAIN"
* "N is inside an object"
* "N is in lighting LIGHTING (sunlight, dim light, darkness, magical darkness)"
* "N can understand >= X languages"
* "N and N share a language"
* "N has >= X heads"
* "N has X spell slots remaining"
* "N had advantage on most recent die roll"
* "N had disadvantage on most recent die roll"
* "N used a weapon on most recent attack"
* "N is surprised"
* "N is bound by N"
* "N is aware of N"
* "N and N are in the same web"
### EFFECTS
EFFECTS is a list of dictionaries containing the following:
* "target": NOUN
* "effect": [EFFECT, variables]
* "duration": DURATION
Where EFFECT is any of the following (UNDER CONSTRUCTION DENOTED BY x):
* Terrain in X ft radius is difficult
* Set movement speed to X
x * Increase movement speed by X
x * Increase jump distance by X
x * Increase jump height by X
* Acquire condition CONDITION
x * End condition CONDITION
x * Acquire/override property PROPERTY
x * Death
x * Surprised
x * Pushed X feet in DIRECTION direction
x * Immune to feature FEATURE
x * Immune to spells with trait SPELL\_TRAIT
x * Disadvantage on rolls ROLL\_CLASS
x * Advantage on rolls ROLL\_CLASS
x * Automatic fail on rolls ROLL\_CLASS
x * Automatic succeed on rolls ROLL\_CLASS
x * Automatic critical hit
x * Move X distance
x * Deal X damage
x * Disable other feature
x * Know distance/direction to creature/object within X distance
x * Reduce incoming damage by X
* Regain X hp
x * Weapon/armor corrodes
x * Ignite flammable objects
x * Expend spell slot
x * Special movement
x * Plane shift
x * Grant spell effect
x * Transparency (perpetual hidenness?)
x * Prescribed actions (randomized), any of:
x - Nothing
x - Moves in random direction
x - Attacks random creature within reach
x * Telepathic command
x * Learns creature's desires
x * Spell storing
x * Creates X diameter tunnel
The duration of an effect may be omitted for instantaneous effects and is any of the following:
* "End of turn"
* "Start of next turn"
* "End of next turn"
* Until action is taken to end
x * TIME???
x * Repeated saves???
x * Repeated saves at advantage/disadvantage with condition???
x * Until certain spell is cast???
x * Until other effect expires???
### RECHARGE
The recharge of a feature may be omitted to indicate that it is unlimited. Otherwise, it is a list of the following two items:
* Integer indicating number of times the feature can be used
* Any of "turn", "long rest", "short rest" indicating when spent uses are restored
|
