… | |
… | |
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 |
… | |
… | |
171 | associated with a specific player and can be seen by all NPCs. with |
199 | associated with a specific player and can be seen by all NPCs. with |
172 | respect to a particular player, which makes them suitable to store quest |
200 | respect to a particular player, which makes them suitable to store quest |
173 | markers and other information (e.g. reputation/alignment). Flags are |
201 | markers and other information (e.g. reputation/alignment). Flags are |
174 | persistent over the lifetime of a player, so be careful :) |
202 | persistent over the lifetime of a player, so be careful :) |
175 | |
203 | |
|
|
204 | Perversely enough, using C<@setfflag> without a C<value> clears the flag |
|
|
205 | as if it was never set, so always provide a flag value (e.g. C<1>) when |
|
|
206 | you want to set the flag. |
|
|
207 | |
176 | See C<@ifflag> for an example. |
208 | See C<@ifflag> for an example. |
177 | |
209 | |
178 | =item @ifflag flag value |
210 | =item @ifflag flag value |
179 | |
211 | |
180 | Requires that the named C<flag> has the given C<value>, otherwise this |
212 | Requires that the named C<flag> has the given C<value>, otherwise this |
181 | topic is skipped. For more complex comparisons, see C<@cond> with |
213 | topic is skipped. For more complex comparisons, see C<@cond> with |
182 | C<$flag>. Example: |
214 | C<$flag>. |
|
|
215 | |
|
|
216 | If no C<value> is given, then the ifflag succeeds when the flag is true. |
|
|
217 | |
|
|
218 | Example: |
183 | |
219 | |
184 | @match I want to do the quest! |
220 | @match I want to do the quest! |
185 | @setflag kings_quest 1 |
221 | @setflag kings_quest 1 |
186 | Then seek out Bumblebee in Navar, he will tell you... |
222 | Then seek out Bumblebee in Navar, he will tell you... |
187 | @match I did the quest |
223 | @match I did the quest |
… | |
… | |
201 | When the state argument is omitted the trigger is stateful and retains an |
237 | When the state argument is omitted the trigger is stateful and retains an |
202 | internal state per connected-id. There is a limitation to the use of this: The |
238 | internal state per connected-id. There is a limitation to the use of this: The |
203 | state won't be changed when the connection is triggered by other triggers. So |
239 | state won't be changed when the connection is triggered by other triggers. So |
204 | be careful when triggering the connection from other objects. |
240 | be careful when triggering the connection from other objects. |
205 | |
241 | |
206 | When a state argument is given it should be either 0 or 1. 1 will 'push' the connection |
242 | When a state argument is given it should be a positive integer. Any value |
207 | and 0 will 'release' the connection. This is useful for example when you want to |
243 | C<!= 0> will 'push' the connection (in general, you should specify C<1> |
208 | let a npc control a door. |
244 | for this) and C<0> will 'release' the connection. This is useful for |
|
|
245 | example when you want to let an NPC control a door. |
209 | |
246 | |
210 | Trigger all objects with the given connected-id by 'releasing' the connection. |
247 | Trigger all objects with the given connected-id by 'releasing' the connection. |
211 | |
248 | |
212 | =item @playersound face-name |
249 | =item @playersound face-name |
213 | |
250 | |
… | |
… | |
244 | my @replies; |
281 | my @replies; |
245 | my @match; # @match/@parse command results |
282 | my @match; # @match/@parse command results |
246 | |
283 | |
247 | my $state = $self->{npc}{$self->{ob}->name}{dialog_state} ||= {}; |
284 | my $state = $self->{npc}{$self->{ob}->name}{dialog_state} ||= {}; |
248 | my $flag = $self->{ob}{dialog_flag} ||= {}; |
285 | my $flag = $self->{ob}{dialog_flag} ||= {}; |
|
|
286 | |
|
|
287 | my @find; |
249 | |
288 | |
250 | my %vars = ( |
289 | my %vars = ( |
251 | who => $self->{ob}, |
290 | who => $self->{ob}, |
252 | npc => $self->{npc}, |
291 | npc => $self->{npc}, |
253 | state => $state, |
292 | state => $state, |
… | |
… | |
282 | |
321 | |
283 | } elsif ($cmd eq "eval") { |
322 | } elsif ($cmd eq "eval") { |
284 | cf::safe_eval $args, %vars; |
323 | cf::safe_eval $args, %vars; |
285 | warn "\@eval evaluation error: $@\n" if $@; |
324 | warn "\@eval evaluation error: $@\n" if $@; |
286 | |
325 | |
|
|
326 | } elsif ($cmd eq "check") { |
|
|
327 | eval { |
|
|
328 | cf::match::match $args, $self->{ob}, $self->{npc}, $self->{ob} |
|
|
329 | or next topic; |
|
|
330 | }; |
|
|
331 | warn "\@check evaluation error: $@\n" if $@; |
|
|
332 | |
|
|
333 | } elsif ($cmd eq "find") { |
|
|
334 | @find = eval { |
|
|
335 | cf::match::match $args, $self->{ob}, $self->{npc}, $self->{ob} |
|
|
336 | }; |
|
|
337 | warn "\@find evaluation error: $@\n" if $@; |
|
|
338 | |
287 | } elsif ($cmd eq "msg") { |
339 | } elsif ($cmd eq "msg") { |
288 | push @replies, [$self->{npc}, (scalar cf::safe_eval $args, %vars)]; |
340 | push @replies, [$self->{npc}, (scalar cf::safe_eval $args, %vars)]; |
289 | |
341 | |
290 | } elsif ($cmd eq "setflag") { |
342 | } elsif ($cmd eq "setflag") { |
291 | my ($name, $value) = split /\s+/, $args, 2; |
343 | my ($name, $value) = split /\s+/, $args, 2; |
… | |
… | |
297 | $value ? $state->{$name} = $value |
349 | $value ? $state->{$name} = $value |
298 | : delete $state->{$name}; |
350 | : delete $state->{$name}; |
299 | |
351 | |
300 | } elsif ($cmd eq "ifflag") { |
352 | } elsif ($cmd eq "ifflag") { |
301 | my ($name, $value) = split /\s+/, $args, 2; |
353 | my ($name, $value) = split /\s+/, $args, 2; |
302 | $flag->{$name} eq $value |
354 | defined $value ? $flag->{$name} eq $value |
|
|
355 | : $flag->{$name} |
303 | or next topic; |
356 | or next topic; |
304 | |
357 | |
305 | } elsif ($cmd eq "ifstate") { |
358 | } elsif ($cmd eq "ifstate") { |
306 | my ($name, $value) = split /\s+/, $args, 2; |
359 | my ($name, $value) = split /\s+/, $args, 2; |
307 | $state->{$name} eq $value |
360 | $state->{$name} eq $value |
308 | or next topic; |
361 | or next topic; |
309 | |
362 | |
310 | } elsif ($cmd eq "trigger") { |
363 | } elsif ($cmd eq "trigger") { |
311 | my ($con, $state) = split /\s+/, $args, 2; |
364 | my ($con, $state) = split /\s+/, $args, 2; |
312 | $con = $con * 1; |
|
|
313 | |
365 | |
314 | if (defined $state) { |
366 | if (defined $state) { |
315 | $self->{npc}->map->trigger ($args, $state); |
367 | $self->{npc}->map->trigger ($con, $state, $self->{npc}, $self->{ob}); |
316 | } else { |
368 | } else { |
317 | my $rvalue = \$self->{npc}{dialog_trigger}{$con}; |
369 | my $rvalue = \$self->{npc}{dialog_trigger}{$con+0}; |
318 | $self->{npc}->map->trigger ($con, $$rvalue = !$$rvalue); |
370 | $self->{npc}->map->trigger ($con, $$rvalue = !$$rvalue, $self->{npc}, $self->{ob}); |
319 | } |
371 | } |
320 | |
372 | |
321 | } elsif ($cmd eq "addtopic") { |
373 | } elsif ($cmd eq "addtopic") { |
322 | push @kw, split /\|/, $args; |
374 | push @kw, split /\|/, $args; |
323 | $self->{add_topic}->(split /\s*\|\s*/, $args) if $self->{add_topic}; |
375 | $self->{add_topic}->(split /\s*\|\s*/, $args) if $self->{add_topic}; |
… | |
… | |
345 | last; |
397 | last; |
346 | } |
398 | } |
347 | } |
399 | } |
348 | } |
400 | } |
349 | |
401 | |
|
|
402 | $self->{npc}->use_trigger ($self->{ob}) |
|
|
403 | if $self->{npc}->type == cf::MAGIC_EAR; |
|
|
404 | |
350 | return wantarray ? ($reply, @kw) : $reply; |
405 | return wantarray ? ($reply, @kw) : $reply; |
351 | } |
406 | } |
352 | } |
407 | } |
353 | } |
408 | } |
354 | |
409 | |