summaryrefslogtreecommitdiff
path: root/src/map/magic-interpreter.h
blob: 26f6c5c0f5dce451fcaebae5f7648c1d9b1b351b (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
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
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
/* Magic interpreter */

#ifndef MAGIC_INTERPRETER_H
#define MAGIC_INTERPRETER_H

#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <math.h>

#include "magic.h"
#include "malloc.h"
#include "map.h"
#include "chrif.h"
#include "clif.h"
#include "intif.h"
#include "pc.h"
#include "npc.h"
#include "mob.h"
#include "pet.h"
#include "itemdb.h"
#include "script.h"
#include "battle.h"
#include "skill.h"
#include "party.h"
#include "guild.h"
#include "chat.h"
#include "trade.h"
#include "storage.h"
#include "vending.h"
#include "nullpo.h"

#include "../common/timer.h"

#define SPELLARG_NONE	0	/* No spell parameter */
#define SPELLARG_PC	1	/* Spell parameter describes pc (defaults to self) */
#define SPELLARG_STRING	2	/* Spell parameter describes pc (defaults to self) */



/* ------ */
/* Values */
/* ------ */

#define TY_UNDEF	0
#define TY_INT		1
#define TY_DIR		2
#define TY_STRING	3 
#define TY_ENTITY	5
#define TY_LOCATION	6
#define TY_AREA		7
#define TY_SPELL	8
#define TY_INVOCATION	9
#define TY_FAIL		127

#define DIR_S	0
#define DIR_SW	1
#define DIR_W	2
#define DIR_NW	3
#define DIR_N	4
#define DIR_NE	5
#define DIR_E	6
#define DIR_SE	7

struct expr;
struct val;
struct location;
struct area;
struct spell;
struct invocation;

typedef struct location {
    int m;
    int x, y;
} location_t;

#define AREA_LOCATION	0
#define AREA_UNION	1
#define AREA_RECT	2
#define AREA_BAR	3

typedef struct area {
    union a {
        location_t a_loc;
        struct { location_t loc; int width, depth, dir; } a_bar;
        struct { location_t loc; int width, height; } a_rect;
        struct area * a_union[2];
    } a;
    int size;
    unsigned char ty;
} area_t;

typedef struct val {
    union v {
        int v_int;
        char *v_string;
        entity_t *v_entity; /* Used ONLY during operation/function invocation; otherwise we use v_int */
        area_t *v_area;
        location_t v_location;
        struct invocation *v_invocation;  /* Used ONLY during operation/function invocation; otherwise we use v_int */
        struct spell *v_spell;
    } v;
    unsigned char ty;
} val_t;


/* ----------- */
/* Expressions */
/* ----------- */

#define MAX_ARGS 7	/* Max. # of args used in builtin primitive functions */

#define EXPR_VAL	0
#define EXPR_LOCATION	1
#define EXPR_AREA	2
#define EXPR_FUNAPP	3
#define EXPR_ID		4

typedef struct e_location {
    struct expr *m, *x, *y;
} e_location_t;

typedef struct e_area {
    union a0 {
        e_location_t a_loc;
        struct { e_location_t loc; struct expr *width, *depth, *dir; } a_bar;
        struct { e_location_t loc; struct expr *width, *height; } a_rect;
        struct e_area* a_union[2];
    } a;
    unsigned char ty;
} e_area_t;

typedef struct expr {
    union e {
        val_t e_val;
        e_location_t e_location;
        e_area_t e_area;
        struct { int id, line_nr, column; int args_nr; struct expr *args[MAX_ARGS]; } e_funapp;
        int e_id;
    } e;
    unsigned char ty;
} expr_t;


/* ------- */
/* Effects */
/* ------- */

#define EFFECT_SKIP	0
#define EFFECT_ABORT	1
#define EFFECT_ASSIGN	2
#define EFFECT_FOREACH	3
#define EFFECT_FOR	4
#define EFFECT_IF	5
#define EFFECT_SLEEP	6
#define EFFECT_SCRIPT	7
#define EFFECT_BREAK	8
#define EFFECT_OP	9
#define EFFECT_END	10
#define EFFECT_CALL	11

#define FOREACH_FILTER_MOB	1
#define FOREACH_FILTER_PC	2
#define FOREACH_FILTER_ENTITY	3
#define FOREACH_FILTER_TARGET	4
#define FOREACH_FILTER_SPELL	5

typedef struct effect {
    struct effect* next;
    union e0 {
        struct { int id; expr_t *expr; } e_assign;
        struct { int id;
                 expr_t *area;
                 struct effect* body;
                 unsigned char filter; } e_foreach;
        struct { int id;
                 expr_t *start, *stop;
                 struct effect *body; } e_for;
        struct { expr_t *cond; struct effect *true_branch, *false_branch; } e_if;
        expr_t *e_sleep; /* sleep time */
        unsigned char *e_script;
        struct { int id; int args_nr; int line_nr, column; expr_t *args[MAX_ARGS]; } e_op;
        struct { int args_nr, *formals; expr_t **actuals; struct effect *body; } e_call;
    } e;
    unsigned char ty;
} effect_t;


/* ---------- */
/* Components */ 
/* ---------- */

typedef struct component {
    struct component *next;
    int item_id;
    int count;
} component_t;


/* ----------- */
/* Spellguards */
/* ----------- */

#define SPELLGUARD_CONDITION	0
#define SPELLGUARD_COMPONENTS	1
#define SPELLGUARD_CATALYSTS	2
#define SPELLGUARD_CHOICE	3
#define SPELLGUARD_MANA		4
#define SPELLGUARD_CASTTIME	5
#define SPELLGUARD_EFFECT	6

typedef struct effect_set {
        effect_t *effect, *at_trigger, *at_end;
} effect_set_t;

typedef struct spellguard {
    struct spellguard *next;
    union s {
        expr_t *s_condition;
        expr_t *s_mana;
        expr_t *s_casttime;
        component_t *s_components;
        component_t *s_catalysts;
        struct spellguard *s_alt; /* either `next' or `s.s_alt' */
        effect_set_t s_effect;
    } s;
    unsigned char ty;
} spellguard_t;


/* ------ */
/* Spells */
/* ------ */

typedef struct letdef {
    int id;
    expr_t *expr;
} letdef_t;

#define SPELL_FLAG_LOCAL	(1 << 0) // spell associated not with caster but with place
#define SPELL_FLAG_SILENT	(1 << 1) // spell invocation never uttered
#define SPELL_FLAG_NONMAGIC	(1 << 2) // `magic word' only:  don't require spellcasting ability

typedef struct spell {
    char *name;
    char *invocation;
    int flags;
    int arg;
    int spellarg_ty;

    int letdefs_nr;
    letdef_t *letdefs;

    spellguard_t *spellguard;
} spell_t;

/* ------- */
/* Anchors */
/* ------- */

typedef struct teleport_anchor {
    char *name;
    char *invocation;
    expr_t *location;
} teleport_anchor_t;

/* ------------------- */
/* The big config blob */
/* ------------------- */

typedef struct {
    int vars_nr;
    char **var_name;
    val_t *vars; /* Initial assignments, if any, or NULL */

    int obscure_chance;
    int min_casttime;

    int spells_nr;
    spell_t **spells;

    int anchors_nr; /* NEGATIVE iff we have sorted the anchors */
    teleport_anchor_t **anchors;
} magic_conf_t;


/* Execution environment */

#define VAR_MIN_CASTTIME	0
#define VAR_OBSCURE_CHANCE	1
#define VAR_CASTER		2
#define VAR_SPELLPOWER		3
#define VAR_SPELL		4
#define VAR_INVOCATION		5
#define VAR_TARGET		6
#define VAR_SCRIPTTARGET	7
#define VAR_LOCATION		8

struct magic_config;

typedef struct env {
    magic_conf_t *base_env;
    val_t *vars;
} env_t;

#define MAX_STACK_SIZE 32

#define CONT_STACK_FOREACH	0
#define CONT_STACK_FOR		1
#define CONT_STACK_PROC		2

typedef struct cont_activation_record {
    effect_t *return_location;
    union c {
        struct { int id; effect_t *body; int entities_nr; int *entities; int index; } c_foreach;
        struct { int id; effect_t *body; int current; int stop; } c_for;
        struct { int args_nr, *formals; val_t *old_actuals; } c_proc;
    } c;
    unsigned char ty;
} cont_activation_record_t;

typedef struct status_change_ref {
    int sc_type;
    int bl_id;
} status_change_ref_t;

#define INVOCATION_FLAG_BOUND		(1 << 0)	/* Bound directly to the caster (i.e., ignore its location) */
#define INVOCATION_FLAG_ABORTED		(1 << 1)	/* Used `abort' to terminate */

typedef struct invocation {
    struct block_list bl;

    struct invocation *next_invocation; /* used for spells directly associated with a caster: they form a singly-linked list */
    int flags;

    env_t *env;
    spell_t *spell;
    int caster;  /* this is the person who originally invoked the spell */
    int subject; /* when this person dies, the spell dies with it */

    int timer; /* spell timer, if any */

    int stack_size;
    cont_activation_record_t stack[MAX_STACK_SIZE];

    int script_pos; /* Script position; if nonzero, resume the script we were running. */
    effect_t *current_effect;
    effect_t *trigger_effect; /* If non-NULL, this is used to spawn a cloned effect based on the same environment */
    effect_t *end_effect; /* If non-NULL, this is executed when the spell terminates naturally, e.g. when all status changes have run out or all delays are over. */

    /* Status change references:  for status change updates, keep track of whom we updated where */
    int status_change_refs_nr;
    status_change_ref_t *status_change_refs;

} invocation_t;


extern magic_conf_t magic_conf; /* Global magic conf */
extern env_t magic_default_env; /* Fake default environment */


/**
 * Adds a component selection to a component holder (which may initially be NULL)
 */
void
magic_add_component(component_t **component_holder, int id, int count);


teleport_anchor_t *
magic_find_anchor(char *name);

/**
 * The parameter `param' must have been dynamically allocated; ownership is transferred to the resultant env_t.
 */
env_t *
spell_create_env(magic_conf_t *conf, spell_t *spell, character_t *caster, int spellpower, char *param);

void
magic_free_env(env_t *env);

/**
 * near_miss is set to nonzero iff the spell only failed due to ephemereal issues (spell delay in effect, out of mana, out of components)
 */
effect_set_t *
spell_trigger(spell_t *spell, character_t *caster, env_t *env, int *near_miss);

invocation_t *
spell_instantiate(effect_set_t *effect, env_t *env);

/**
 * Bind a spell to a subject (this is a no-op for `local' spells).
 */
void
spell_bind(character_t *subject, invocation_t *invocation);

int // 1 on failure
spell_unbind(character_t *subject, invocation_t *invocation);


/**
 * Clones a spell to run the at_effect field
 */
invocation_t *
spell_clone_effect(invocation_t *source);

spell_t *
magic_find_spell(char *invocation);

/* The following is used only by the parser: */
typedef struct args_rec {
    int args_nr;
    expr_t **args;
} args_rec_t;

typedef struct {
        char *name;
        int args_nr;
        int *args;
        effect_t *body;
} proc_t;

#endif /* !defined (MAGIC_INTERPRETER_H) */