| … | |
… | |
| 96 | |
96 | |
| 97 | =item $flag - A hashref that stores flags associated with the player and |
97 | =item $flag - A hashref that stores flags associated with the player and |
| 98 | can be seen by all NPCs (so better name your flags uniquely). This is |
98 | can be seen by all NPCs (so better name your flags uniquely). This is |
| 99 | useful for storing e.g. quest information. See C<@setflag> and C<@ifflag>. |
99 | useful for storing e.g. quest information. See C<@setflag> and C<@ifflag>. |
| 100 | |
100 | |
|
|
101 | =item @find - see @find, below. |
|
|
102 | |
| 101 | =back |
103 | =back |
| 102 | |
104 | |
| 103 | The environment is that standard "map scripting environment", which is |
105 | The environment is that standard "map scripting environment", which is |
| 104 | limited in the type of constructs allowed (no loops, for example). |
106 | limited in the type of constructs allowed (no loops, for example). |
| 105 | |
107 | |
| … | |
… | |
| 138 | Like C<@cond>, but proceed regardless of the outcome. |
140 | Like C<@cond>, but proceed regardless of the outcome. |
| 139 | |
141 | |
| 140 | =item @msg perl |
142 | =item @msg perl |
| 141 | |
143 | |
| 142 | Like C<@cond>, but the return value will be stringified and prepended to |
144 | Like C<@cond>, but the return value will be stringified and prepended to |
| 143 | the message. |
145 | the reply message. |
|
|
146 | |
|
|
147 | =item @check match expression |
|
|
148 | |
|
|
149 | Executes a match expression (see |
|
|
150 | http://pod.tst.eu/http://cvs.schmorp.de/deliantra/server/lib/cf/match.pm) |
|
|
151 | to see if it matches. |
|
|
152 | |
|
|
153 | C<self> is the npc object, C<object>, C<source> and C<originator> are the |
|
|
154 | player communicating with the NPC. |
|
|
155 | |
|
|
156 | If the check fails, the match is skipped. |
|
|
157 | |
|
|
158 | =item @find match expression |
|
|
159 | |
|
|
160 | Like C<@check> in that it executes a match expression, but instead of |
|
|
161 | failing, it gathers all objects matched into the C<@find> array variable. |
|
|
162 | |
|
|
163 | When you want to skip the match when no objects have been found, combine |
|
|
164 | C<@find> with C<@cond>: |
|
|
165 | |
|
|
166 | @match see my spellbook |
|
|
167 | @find type=SPELLBOOK in inv |
|
|
168 | @cond @find |
|
|
169 | It looks dirty. |
|
|
170 | @match see my spellbook |
|
|
171 | I can't see any, where do you have it? |
| 144 | |
172 | |
| 145 | =item @setstate state value |
173 | =item @setstate state value |
| 146 | |
174 | |
| 147 | Sets the named state C<state> to the given C<value>. State values are |
175 | Sets the named state C<state> to the given C<value>. State values are |
| 148 | associated with a specific player-NPC pair, so each NPC has its own state |
176 | associated with a specific player-NPC pair, so each NPC has its own state |
| … | |
… | |
| 245 | my @replies; |
273 | my @replies; |
| 246 | my @match; # @match/@parse command results |
274 | my @match; # @match/@parse command results |
| 247 | |
275 | |
| 248 | my $state = $self->{npc}{$self->{ob}->name}{dialog_state} ||= {}; |
276 | my $state = $self->{npc}{$self->{ob}->name}{dialog_state} ||= {}; |
| 249 | my $flag = $self->{ob}{dialog_flag} ||= {}; |
277 | my $flag = $self->{ob}{dialog_flag} ||= {}; |
|
|
278 | |
|
|
279 | my @find; |
| 250 | |
280 | |
| 251 | my %vars = ( |
281 | my %vars = ( |
| 252 | who => $self->{ob}, |
282 | who => $self->{ob}, |
| 253 | npc => $self->{npc}, |
283 | npc => $self->{npc}, |
| 254 | state => $state, |
284 | state => $state, |
| … | |
… | |
| 282 | or next topic; |
312 | or next topic; |
| 283 | |
313 | |
| 284 | } elsif ($cmd eq "eval") { |
314 | } elsif ($cmd eq "eval") { |
| 285 | cf::safe_eval $args, %vars; |
315 | cf::safe_eval $args, %vars; |
| 286 | warn "\@eval evaluation error: $@\n" if $@; |
316 | warn "\@eval evaluation error: $@\n" if $@; |
|
|
317 | |
|
|
318 | } elsif ($cmd eq "check") { |
|
|
319 | eval { |
|
|
320 | cf::match::match $args, $self->{ob}, $self->{npc}, $self->{ob} |
|
|
321 | or next topic; |
|
|
322 | }; |
|
|
323 | warn "\@check evaluation error: $@\n" if $@; |
|
|
324 | |
|
|
325 | } elsif ($cmd eq "find") { |
|
|
326 | @find = eval { |
|
|
327 | cf::match::match $args, $self->{ob}, $self->{npc}, $self->{ob} |
|
|
328 | }; |
|
|
329 | warn "\@find evaluation error: $@\n" if $@; |
| 287 | |
330 | |
| 288 | } elsif ($cmd eq "msg") { |
331 | } elsif ($cmd eq "msg") { |
| 289 | push @replies, [$self->{npc}, (scalar cf::safe_eval $args, %vars)]; |
332 | push @replies, [$self->{npc}, (scalar cf::safe_eval $args, %vars)]; |
| 290 | |
333 | |
| 291 | } elsif ($cmd eq "setflag") { |
334 | } elsif ($cmd eq "setflag") { |
