| … | |
… | |
| 48 | made. The copy automatically has all attachments the original object |
48 | made. The copy automatically has all attachments the original object |
| 49 | had. The perl variables get copied in a shallow way (references are shared |
49 | had. The perl variables get copied in a shallow way (references are shared |
| 50 | between instances). If this is not the behaviour you need, you have to |
50 | between instances). If this is not the behaviour you need, you have to |
| 51 | adjust the B<destination> object as you see fit. |
51 | adjust the B<destination> object as you see fit. |
| 52 | |
52 | |
|
|
53 | =head3 add_bonus (item creator difficulty max_magic flags) |
|
|
54 | |
|
|
55 | A basic item has been created (e.g. for shops, monsters drops etc.) |
|
|
56 | that needs bonus values applied. The B<creator> object is a template |
|
|
57 | object that can be used to inherit stuff (and can be NULL). Flags is a |
|
|
58 | combination of GT_ENVIRONMENT (???) or GT_STARTEQUIP (set FLAG_STARTEQUIP |
|
|
59 | on item or set its value to 0) or GT_MINIMAL (???) |
|
|
60 | |
|
|
61 | When overriden, built-in bonus generation is skipped, otherwise |
|
|
62 | treasure generation continues as it would without this hook. |
|
|
63 | |
|
|
64 | In general, if flags != 0 or creator != 0 you should just return and leave |
|
|
65 | item generation to the standard code. |
|
|
66 | |
| 53 | =head3 destroy (object) |
67 | =head3 destroy (object) |
| 54 | |
68 | |
| 55 | Invoked when the crossfire object gets destroyed, and only when the object |
69 | Invoked when the crossfire object gets destroyed, and only when the object |
| 56 | has a handler for this event. This event can occur many times, as its |
70 | has a handler for this event. This event can occur many times, as its |
| 57 | called when the in-memory object is destroyed, not when the object itself |
71 | called when the in-memory object is destroyed, not when the object itself |
| … | |
… | |
| 235 | |
249 | |
| 236 | =head3 death (player) |
250 | =head3 death (player) |
| 237 | |
251 | |
| 238 | Invoked whenever a player dies, before the death actually gets processed. |
252 | Invoked whenever a player dies, before the death actually gets processed. |
| 239 | |
253 | |
| 240 | =head3 map_change (player oldmap newmap) |
254 | =head3 map_change (player newmap x y -- ) |
| 241 | |
255 | |
| 242 | Invoked whenever a player moves from one map to another. |
256 | Invoked before a player moves from one map to another, can override the movement. |
| 243 | |
257 | |
| 244 | =head3 extcmd (player string) |
258 | =head3 extcmd (player string) |
| 245 | |
259 | |
| 246 | Invoked whenever a client issues the C<extcmd> protocol command. It's |
260 | Invoked whenever a client issues the C<extcmd> protocol command. It's |
| 247 | argument is passed without any changes. |
261 | argument is passed without any changes. |
| … | |
… | |
| 304 | |
318 | |
| 305 | =head3 clean (map) |
319 | =head3 clean (map) |
| 306 | |
320 | |
| 307 | Invoked when a temporary B<map> gets deleted on-disk. |
321 | Invoked when a temporary B<map> gets deleted on-disk. |
| 308 | |
322 | |
| 309 | =head3 enter (map player) |
323 | =head3 enter (map player x y -- ) |
| 310 | |
324 | |
| 311 | Invoked whenever a player enters the B<map>. This event is likely unreliable. |
325 | Invoked whenever a player tries to enter the B<map>, while he/she is still |
|
|
326 | on the old map. Overriding means the player won't be able to enter, and, |
|
|
327 | if newmap/x/y are given, will be redirected to that map instead. |
| 312 | |
328 | |
| 313 | =head3 leave (map player) |
329 | =head3 leave (map player -- ) |
| 314 | |
330 | |
| 315 | Invoked whenever a player leaves the B<map>. This event is likely unreliable. |
331 | Invoked whenever a player tries to leave the B<map>. Overriding means the |
| 316 | |
332 | player won't be able to leave. |
| 317 | =head3 upgrade (map) |
|
|
| 318 | |
|
|
| 319 | (TEMPORARY EVENT) gets invoked whenever a old-style map has been upgraded. |
|
|
| 320 | |
333 | |
| 321 | =head3 trigger (map connection state) |
334 | =head3 trigger (map connection state) |
| 322 | |
335 | |
| 323 | Invoked whenever something activates a B<connection> on the B<map>. If B<state> |
336 | Invoked whenever something activates a B<connection> on the B<map>. If B<state> |
| 324 | is true the connection was 'state' and if false it is 'released'. |
337 | is true the connection was 'state' and if false it is 'released'. |
|
|
338 | |
