ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/deliantra/server/lib/cf.pm
(Generate patch)

Comparing deliantra/server/lib/cf.pm (file contents):
Revision 1.45 by root, Sat Aug 26 23:36:32 2006 UTC vs.
Revision 1.226 by root, Wed Mar 14 04:12:29 2007 UTC

1package cf; 1package cf;
2
3use utf8;
4use strict;
2 5
3use Symbol; 6use Symbol;
4use List::Util; 7use List::Util;
5use Storable; 8use Storable;
9use Event;
6use Opcode; 10use Opcode;
7use Safe; 11use Safe;
8use Safe::Hole; 12use Safe::Hole;
9 13
14use Coro 3.52 ();
15use Coro::State;
16use Coro::Event;
17use Coro::Timer;
18use Coro::Signal;
19use Coro::Semaphore;
20use Coro::AIO;
21
22use BDB ();
23use Data::Dumper;
24use Digest::MD5;
25use Fcntl;
26use IO::AIO 2.32 ();
27use YAML::Syck ();
10use Time::HiRes; 28use Time::HiRes;
11use Event; 29use Compress::LZF;
30
31Coro::State::cctx_stacksize 256000; # 1-2MB stack, for deep recursions in maze generator
32Compress::LZF::sfreeze_cr { }; # prime Compress::LZF so it does not use require later
12$Event::Eval = 1; # no idea why this is required, but it is 33$Event::Eval = 1; # no idea why this is required, but it is
13 34
14use strict; 35sub WF_AUTOCANCEL () { 1 } # automatically cancel this watcher on reload
15 36
37# work around bug in YAML::Syck - bad news for perl6, will it be as broken wrt. unicode?
38$YAML::Syck::ImplicitUnicode = 1;
39
40$Coro::main->prio (Coro::PRIO_MAX); # run main coroutine ("the server") with very high priority
41
16our %COMMAND = (); 42our %COMMAND = ();
43our %COMMAND_TIME = ();
44
45our @EXTS = (); # list of extension package names
46our %EXTCMD = ();
47our %EXT_CORO = (); # coroutines bound to extensions
48our %EXT_MAP = (); # pluggable maps
49
50our $RELOAD; # number of reloads so far
17our @EVENT; 51our @EVENT;
18our %PROP_TYPE; 52our $LIBDIR = datadir . "/ext";
19our %PROP_IDX;
20our $LIBDIR = maps_directory "perl";
21 53
22our $TICK = MAX_TIME * 1e-6; 54our $TICK = MAX_TIME * 1e-6;
23our $TICK_WATCHER; 55our $TICK_WATCHER;
56our $AIO_POLL_WATCHER;
57our $NEXT_RUNTIME_WRITE; # when should the runtime file be written
24our $NEXT_TICK; 58our $NEXT_TICK;
59our $NOW;
60our $USE_FSYNC = 1; # use fsync to write maps - default off
61
62our $BDB_POLL_WATCHER;
63our $DB_ENV;
64
65our %CFG;
66
67our $UPTIME; $UPTIME ||= time;
68our $RUNTIME;
69
70our %PLAYER; # all users
71our %MAP; # all maps
72our $LINK_MAP; # the special {link} map, which is always available
73our $RANDOM_MAPS = cf::localdir . "/random";
74our $BDB_ENV_DIR = cf::localdir . "/db";
75
76our $WAIT_FOR_TICK; $WAIT_FOR_TICK ||= new Coro::Signal;
77our $WAIT_FOR_TICK_ONE; $WAIT_FOR_TICK_ONE ||= new Coro::Signal;
78
79# used to convert map paths into valid unix filenames by replacing / by ∕
80our $PATH_SEP = "∕"; # U+2215, chosen purely for visual reasons
81
82binmode STDOUT;
83binmode STDERR;
84
85# read virtual server time, if available
86unless ($RUNTIME || !-e cf::localdir . "/runtime") {
87 open my $fh, "<", cf::localdir . "/runtime"
88 or die "unable to read runtime file: $!";
89 $RUNTIME = <$fh> + 0.;
90}
91
92mkdir cf::localdir;
93mkdir cf::localdir . "/" . cf::playerdir;
94mkdir cf::localdir . "/" . cf::tmpdir;
95mkdir cf::localdir . "/" . cf::uniquedir;
96mkdir $RANDOM_MAPS;
97mkdir $BDB_ENV_DIR;
98
99our $EMERGENCY_POSITION;
100
101sub cf::map::normalise;
102
103#############################################################################
104
105=head2 GLOBAL VARIABLES
106
107=over 4
108
109=item $cf::UPTIME
110
111The timestamp of the server start (so not actually an uptime).
112
113=item $cf::RUNTIME
114
115The time this server has run, starts at 0 and is increased by $cf::TICK on
116every server tick.
117
118=item $cf::LIBDIR
119
120The perl library directory, where extensions and cf-specific modules can
121be found. It will be added to C<@INC> automatically.
122
123=item $cf::NOW
124
125The time of the last (current) server tick.
126
127=item $cf::TICK
128
129The interval between server ticks, in seconds.
130
131=item %cf::CFG
132
133Configuration for the server, loaded from C</etc/crossfire/config>, or
134from wherever your confdir points to.
135
136=item $cf::WAIT_FOR_TICK, $cf::WAIT_FOR_TICK_ONE
137
138These are Coro::Signal objects that are C<< ->broadcast >> (WAIT_FOR_TICK)
139or C<< ->send >> (WAIT_FOR_TICK_ONE) on after normal server tick
140processing has been done. Call C<< ->wait >> on them to maximise the
141window of cpu time available, or simply to synchronise to the server tick.
142
143=back
144
145=cut
25 146
26BEGIN { 147BEGIN {
27 *CORE::GLOBAL::warn = sub { 148 *CORE::GLOBAL::warn = sub {
28 my $msg = join "", @_; 149 my $msg = join "", @_;
150 utf8::encode $msg;
151
29 $msg .= "\n" 152 $msg .= "\n"
30 unless $msg =~ /\n$/; 153 unless $msg =~ /\n$/;
31 154
32 print STDERR "cfperl: $msg";
33 LOG llevError, "cfperl: $msg"; 155 LOG llevError, $msg;
34 }; 156 };
35} 157}
36 158
37my %ignore_set = (MAP_PROP_PATH => 1); # I hate the plug-in api. Deeply! 159@safe::cf::global::ISA = @cf::global::ISA = 'cf::attachable';
38 160@safe::cf::object::ISA = @cf::object::ISA = 'cf::attachable';
39# generate property mutators 161@safe::cf::player::ISA = @cf::player::ISA = 'cf::attachable';
40sub prop_gen { 162@safe::cf::client::ISA = @cf::client::ISA = 'cf::attachable';
41 my ($prefix, $class) = @_; 163@safe::cf::map::ISA = @cf::map::ISA = 'cf::attachable';
42
43 no strict 'refs';
44
45 for my $prop (keys %PROP_TYPE) {
46 $prop =~ /^\Q$prefix\E_(.*$)/ or next;
47 my $sub = lc $1;
48
49 my $type = $PROP_TYPE{$prop};
50 my $idx = $PROP_IDX {$prop};
51
52 *{"$class\::get_$sub"} = *{"$class\::$sub"} = sub {
53 $_[0]->get_property ($type, $idx)
54 };
55
56 *{"$class\::set_$sub"} = sub {
57 $_[0]->set_property ($type, $idx, $_[1]);
58 } unless $ignore_set{$prop};
59 }
60}
61
62# auto-generate most of the API
63
64prop_gen OBJECT_PROP => "cf::object";
65# CFAPI_OBJECT_ANIMATION?
66prop_gen PLAYER_PROP => "cf::object::player";
67
68prop_gen MAP_PROP => "cf::map";
69prop_gen ARCH_PROP => "cf::arch";
70
71@safe::cf::object::player::ISA = @cf::object::player::ISA = 'cf::object'; 164@safe::cf::object::player::ISA = @cf::object::player::ISA = 'cf::object';
72 165
73# we bless all objects into (empty) derived classes to force a method lookup 166# we bless all objects into (empty) derived classes to force a method lookup
74# within the Safe compartment. 167# within the Safe compartment.
75for my $pkg (qw(cf::object cf::object::player cf::player cf::map cf::party cf::region cf::arch)) { 168for my $pkg (qw(
169 cf::global cf::attachable
170 cf::object cf::object::player
171 cf::client cf::player
172 cf::arch cf::living
173 cf::map cf::party cf::region
174)) {
76 no strict 'refs'; 175 no strict 'refs';
77 @{"safe::$pkg\::wrap::ISA"} = @{"$pkg\::wrap::ISA"} = $pkg; 176 @{"safe::$pkg\::wrap::ISA"} = @{"$pkg\::wrap::ISA"} = $pkg;
78} 177}
79 178
80$Event::DIED = sub { 179$Event::DIED = sub {
81 warn "error in event callback: @_"; 180 warn "error in event callback: @_";
82}; 181};
83 182
84my %ext_pkg; 183=head2 UTILITY FUNCTIONS
85my @exts;
86my @hook;
87my %command;
88my %extcmd;
89 184
90############################################################################# 185=over 4
91# utility functions 186
187=item dumpval $ref
188
189=cut
190
191sub dumpval {
192 eval {
193 local $SIG{__DIE__};
194 my $d;
195 if (1) {
196 $d = new Data::Dumper([$_[0]], ["*var"]);
197 $d->Terse(1);
198 $d->Indent(2);
199 $d->Quotekeys(0);
200 $d->Useqq(1);
201 #$d->Bless(...);
202 $d->Seen($_[1]) if @_ > 1;
203 $d = $d->Dump();
204 }
205 $d =~ s/([\x00-\x07\x09\x0b\x0c\x0e-\x1f])/sprintf "\\x%02x", ord($1)/ge;
206 $d
207 } || "[unable to dump $_[0]: '$@']";
208}
92 209
93use JSON::Syck (); # TODO# replace by JSON::PC once working 210use JSON::Syck (); # TODO# replace by JSON::PC once working
211
212=item $ref = cf::from_json $json
213
214Converts a JSON string into the corresponding perl data structure.
215
216=cut
94 217
95sub from_json($) { 218sub from_json($) {
96 $JSON::Syck::ImplicitUnicode = 1; # work around JSON::Syck bugs 219 $JSON::Syck::ImplicitUnicode = 1; # work around JSON::Syck bugs
97 JSON::Syck::Load $_[0] 220 JSON::Syck::Load $_[0]
98} 221}
99 222
223=item $json = cf::to_json $ref
224
225Converts a perl data structure into its JSON representation.
226
227=cut
228
100sub to_json($) { 229sub to_json($) {
101 $JSON::Syck::ImplicitUnicode = 0; # work around JSON::Syck bugs 230 $JSON::Syck::ImplicitUnicode = 0; # work around JSON::Syck bugs
102 JSON::Syck::Dump $_[0] 231 JSON::Syck::Dump $_[0]
103} 232}
104 233
234=item cf::lock_wait $string
235
236Wait until the given lock is available. See cf::lock_acquire.
237
238=item my $lock = cf::lock_acquire $string
239
240Wait until the given lock is available and then acquires it and returns
241a Coro::guard object. If the guard object gets destroyed (goes out of scope,
242for example when the coroutine gets canceled), the lock is automatically
243returned.
244
245Lock names should begin with a unique identifier (for example, cf::map::find
246uses map_find and cf::map::load uses map_load).
247
248=cut
249
250our %LOCK;
251
252sub lock_wait($) {
253 my ($key) = @_;
254
255 # wait for lock, if any
256 while ($LOCK{$key}) {
257 push @{ $LOCK{$key} }, $Coro::current;
258 Coro::schedule;
259 }
260}
261
262sub lock_acquire($) {
263 my ($key) = @_;
264
265 # wait, to be sure we are not locked
266 lock_wait $key;
267
268 $LOCK{$key} = [];
269
270 Coro::guard {
271 # wake up all waiters, to be on the safe side
272 $_->ready for @{ delete $LOCK{$key} };
273 }
274}
275
276sub freeze_mainloop {
277 return unless $TICK_WATCHER->is_active;
278
279 my $guard = Coro::guard {
280 $TICK_WATCHER->start;
281 };
282 $TICK_WATCHER->stop;
283 $guard
284}
285
286=item cf::async { BLOCK }
287
288Currently the same as Coro::async_pool, meaning you cannot use
289C<on_destroy>, C<join> or other gimmicks on these coroutines. The only
290thing you are allowed to do is call C<prio> on it.
291
292=cut
293
294BEGIN { *async = \&Coro::async_pool }
295
296=item cf::sync_job { BLOCK }
297
298The design of crossfire+ requires that the main coro ($Coro::main) is
299always able to handle events or runnable, as crossfire+ is only partly
300reentrant. Thus "blocking" it by e.g. waiting for I/O is not acceptable.
301
302If it must be done, put the blocking parts into C<sync_job>. This will run
303the given BLOCK in another coroutine while waiting for the result. The
304server will be frozen during this time, so the block should either finish
305fast or be very important.
306
307=cut
308
309sub sync_job(&) {
310 my ($job) = @_;
311
312 if ($Coro::current == $Coro::main) {
313 # this is the main coro, too bad, we have to block
314 # till the operation succeeds, freezing the server :/
315
316 # TODO: use suspend/resume instead
317 # (but this is cancel-safe)
318 my $freeze_guard = freeze_mainloop;
319
320 my $busy = 1;
321 my @res;
322
323 (async {
324 @res = eval { $job->() };
325 warn $@ if $@;
326 undef $busy;
327 })->prio (Coro::PRIO_MAX);
328
329 while ($busy) {
330 Coro::cede or Event::one_event;
331 }
332
333 wantarray ? @res : $res[0]
334 } else {
335 # we are in another coroutine, how wonderful, everything just works
336
337 $job->()
338 }
339}
340
341=item $coro = cf::async_ext { BLOCK }
342
343Like async, but this coro is automatically being canceled when the
344extension calling this is being unloaded.
345
346=cut
347
348sub async_ext(&) {
349 my $cb = shift;
350
351 my $coro = &Coro::async ($cb);
352
353 $coro->on_destroy (sub {
354 delete $EXT_CORO{$coro+0};
355 });
356 $EXT_CORO{$coro+0} = $coro;
357
358 $coro
359}
360
361sub write_runtime {
362 my $guard = cf::lock_acquire "write_runtime";
363
364 my $runtime = cf::localdir . "/runtime";
365
366 my $fh = aio_open "$runtime~", O_WRONLY | O_CREAT, 0644
367 or return;
368
369 my $value = $cf::RUNTIME + 90 + 10;
370 # 10 is the runtime save interval, for a monotonic clock
371 # 60 allows for the watchdog to kill the server.
372
373 (aio_write $fh, 0, (length $value), $value, 0) <= 0
374 and return;
375
376 # always fsync - this file is important
377 aio_fsync $fh
378 and return;
379
380 close $fh
381 or return;
382
383 aio_rename "$runtime~", $runtime
384 and return;
385
386 1
387}
388
389=back
390
391=cut
392
105############################################################################# 393#############################################################################
106# "new" plug-in system
107 394
108=item cf::object::attach ... # NYI 395=head2 ATTACHABLE OBJECTS
109 396
110=item cf::attach_global ... 397Many objects in crossfire are so-called attachable objects. That means you can
398attach callbacks/event handlers (a collection of which is called an "attachment")
399to it. All such attachable objects support the following methods.
111 400
112=item cf::attach_to_type $object_type, ... 401In the following description, CLASS can be any of C<global>, C<object>
402C<player>, C<client> or C<map> (i.e. the attachable objects in
403crossfire+).
113 404
114=item cf::attach_to_objects ... 405=over 4
115 406
116=item cf::attach_to_players ... 407=item $attachable->attach ($attachment, key => $value...)
117 408
118=item cf::attach_to_maps ... 409=item $attachable->detach ($attachment)
119 410
411Attach/detach a pre-registered attachment to a specific object and give it
412the specified key/value pairs as arguments.
413
414Example, attach a minesweeper attachment to the given object, making it a
41510x10 minesweeper game:
416
417 $obj->attach (minesweeper => width => 10, height => 10);
418
419=item $bool = $attachable->attached ($name)
420
421Checks wether the named attachment is currently attached to the object.
422
423=item cf::CLASS->attach ...
424
425=item cf::CLASS->detach ...
426
427Define an anonymous attachment and attach it to all objects of the given
428CLASS. See the next function for an explanation of its arguments.
429
430You can attach to global events by using the C<cf::global> class.
431
432Example, log all player logins:
433
434 cf::player->attach (
435 on_login => sub {
436 my ($pl) = @_;
437 ...
438 },
439 );
440
441Example, attach to the jeweler skill:
442
443 cf::object->attach (
444 type => cf::SKILL,
445 subtype => cf::SK_JEWELER,
446 on_use_skill => sub {
447 my ($sk, $ob, $part, $dir, $msg) = @_;
448 ...
449 },
450 );
451
120=item cf:register_attachment $name, ... 452=item cf::CLASS::attachment $name, ...
121 453
122 prio => $number, # lower is earlier 454Register an attachment by C<$name> through which attachable objects of the
123 on_xxx => \&cb, 455given CLASS can refer to this attachment.
456
457Some classes such as crossfire maps and objects can specify attachments
458that are attached at load/instantiate time, thus the need for a name.
459
460These calls expect any number of the following handler/hook descriptions:
461
462=over 4
463
464=item prio => $number
465
466Set the priority for all following handlers/hooks (unless overwritten
467by another C<prio> setting). Lower priority handlers get executed
468earlier. The default priority is C<0>, and many built-in handlers are
469registered at priority C<-1000>, so lower priorities should not be used
470unless you know what you are doing.
471
472=item type => $type
473
474(Only for C<< cf::object->attach >> calls), limits the attachment to the
475given type of objects only (the additional parameter C<subtype> can be
476used to further limit to the given subtype).
477
478=item on_I<event> => \&cb
479
480Call the given code reference whenever the named event happens (event is
481something like C<instantiate>, C<apply>, C<use_skill> and so on, and which
482handlers are recognised generally depends on the type of object these
483handlers attach to).
484
485See F<include/eventinc.h> for the full list of events supported, and their
486class.
487
124 package => package::, 488=item package => package::
489
490Look for sub functions of the name C<< on_I<event> >> in the given
491package and register them. Only handlers for eevents supported by the
492object/class are recognised.
493
494=back
495
496Example, define an attachment called "sockpuppet" that calls the given
497event handler when a monster attacks:
498
499 cf::object::attachment sockpuppet =>
500 on_skill_attack => sub {
501 my ($self, $victim) = @_;
502 ...
503 }
504 }
505
506=item $attachable->valid
507
508Just because you have a perl object does not mean that the corresponding
509C-level object still exists. If you try to access an object that has no
510valid C counterpart anymore you get an exception at runtime. This method
511can be used to test for existence of the C object part without causing an
512exception.
125 513
126=cut 514=cut
127 515
128# the following variables are defined in .xs and must not be re-created 516# the following variables are defined in .xs and must not be re-created
129our @CB_GLOBAL = (); # registry for all global events 517our @CB_GLOBAL = (); # registry for all global events
518our @CB_ATTACHABLE = (); # registry for all attachables
130our @CB_OBJECT = (); # all objects (should not be used except in emergency) 519our @CB_OBJECT = (); # all objects (should not be used except in emergency)
131our @CB_PLAYER = (); 520our @CB_PLAYER = ();
521our @CB_CLIENT = ();
132our @CB_TYPE = (); # registry for type (cf-object class) based events 522our @CB_TYPE = (); # registry for type (cf-object class) based events
133our @CB_MAP = (); 523our @CB_MAP = ();
134 524
135my %attachment; 525my %attachment;
136 526
527sub cf::attachable::thawer_merge {
528 # simply override everything except _meta
529 local $_[0]{_meta};
530 %{$_[0]} = %{$_[1]};
531}
532
137sub _attach_cb($\%$$$) { 533sub _attach_cb($$$$) {
138 my ($registry, $undo, $event, $prio, $cb) = @_; 534 my ($registry, $event, $prio, $cb) = @_;
139 535
140 use sort 'stable'; 536 use sort 'stable';
141 537
142 $cb = [$prio, $cb]; 538 $cb = [$prio, $cb];
143 539
144 @{$registry->[$event]} = sort 540 @{$registry->[$event]} = sort
145 { $a->[0] cmp $b->[0] } 541 { $a->[0] cmp $b->[0] }
146 @{$registry->[$event] || []}, $cb; 542 @{$registry->[$event] || []}, $cb;
147
148 push @{$undo->{cb}}, [$event, $cb];
149} 543}
544
545# hack
546my %attachable_klass = map +($_ => 1), KLASS_OBJECT, KLASS_CLIENT, KLASS_PLAYER, KLASS_MAP;
150 547
151# attach handles attaching event callbacks 548# attach handles attaching event callbacks
152# the only thing the caller has to do is pass the correct 549# the only thing the caller has to do is pass the correct
153# registry (== where the callback attaches to). 550# registry (== where the callback attaches to).
154sub _attach(\@$@) { 551sub _attach {
155 my ($registry, $klass, @arg) = @_; 552 my ($registry, $klass, @arg) = @_;
156 553
554 my $object_type;
157 my $prio = 0; 555 my $prio = 0;
158
159 my %undo = (
160 registry => $registry,
161 cb => [],
162 );
163
164 my %cb_id = map +("on_" . lc $EVENT[$_][0], $_) , grep $EVENT[$_][1] == $klass, 0 .. $#EVENT; 556 my %cb_id = map +("on_" . lc $EVENT[$_][0], $_) , grep $EVENT[$_][1] == $klass, 0 .. $#EVENT;
557
558 #TODO: get rid of this hack
559 if ($attachable_klass{$klass}) {
560 %cb_id = (%cb_id, map +("on_" . lc $EVENT[$_][0], $_) , grep $EVENT[$_][1] == KLASS_ATTACHABLE, 0 .. $#EVENT);
561 }
165 562
166 while (@arg) { 563 while (@arg) {
167 my $type = shift @arg; 564 my $type = shift @arg;
168 565
169 if ($type eq "prio") { 566 if ($type eq "prio") {
170 $prio = shift @arg; 567 $prio = shift @arg;
171 568
569 } elsif ($type eq "type") {
570 $object_type = shift @arg;
571 $registry = $CB_TYPE[$object_type] ||= [];
572
573 } elsif ($type eq "subtype") {
574 defined $object_type or Carp::croak "subtype specified without type";
575 my $object_subtype = shift @arg;
576 $registry = $CB_TYPE[$object_type + $object_subtype * NUM_SUBTYPES] ||= [];
577
172 } elsif ($type eq "package") { 578 } elsif ($type eq "package") {
173 my $pkg = shift @arg; 579 my $pkg = shift @arg;
174 580
175 while (my ($name, $id) = each %cb_id) { 581 while (my ($name, $id) = each %cb_id) {
176 if (my $cb = $pkg->can ($name)) { 582 if (my $cb = $pkg->can ($name)) {
177 _attach_cb $registry, %undo, $id, $prio, $cb; 583 _attach_cb $registry, $id, $prio, $cb;
178 } 584 }
179 } 585 }
180 586
181 } elsif (exists $cb_id{$type}) { 587 } elsif (exists $cb_id{$type}) {
182 _attach_cb $registry, %undo, $cb_id{$type}, $prio, shift @arg; 588 _attach_cb $registry, $cb_id{$type}, $prio, shift @arg;
183 589
184 } elsif (ref $type) { 590 } elsif (ref $type) {
185 warn "attaching objects not supported, ignoring.\n"; 591 warn "attaching objects not supported, ignoring.\n";
186 592
187 } else { 593 } else {
188 shift @arg; 594 shift @arg;
189 warn "attach argument '$type' not supported, ignoring.\n"; 595 warn "attach argument '$type' not supported, ignoring.\n";
190 } 596 }
191 } 597 }
192
193 \%undo
194} 598}
195 599
196sub cf::object::attach { 600sub _object_attach {
197 die; 601 my ($obj, $name, %arg) = @_;
198}
199 602
200sub attach_global { 603 return if exists $obj->{_attachment}{$name};
201 _attach @CB_GLOBAL, KLASS_GLOBAL, @_
202}
203 604
204sub attach_to_type { 605 if (my $attach = $attachment{$name}) {
205 my $type = shift; 606 my $registry = $obj->registry;
206 607
207 _attach @{$CB_TYPE[$type]}, KLASS_OBJECT, @_ 608 for (@$attach) {
208} 609 my ($klass, @attach) = @$_;
610 _attach $registry, $klass, @attach;
611 }
209 612
210sub attach_to_objects { 613 $obj->{$name} = \%arg;
211 _attach @CB_OBJECT, KLASS_OBJECT, @_ 614 } else {
212} 615 warn "object uses attachment '$name' that is not available, postponing.\n";
616 }
213 617
214sub attach_to_players { 618 $obj->{_attachment}{$name} = undef;
215 _attach @CB_PLAYER, KLASS_PLAYER, @_
216} 619}
217 620
218sub attach_to_maps { 621sub cf::attachable::attach {
219 _attach @CB_MAP, KLASS_MAP, @_ 622 if (ref $_[0]) {
220} 623 _object_attach @_;
624 } else {
625 _attach shift->_attach_registry, @_;
626 }
627};
221 628
222sub register_attachment { 629# all those should be optimised
630sub cf::attachable::detach {
631 my ($obj, $name) = @_;
632
633 if (ref $obj) {
634 delete $obj->{_attachment}{$name};
635 reattach ($obj);
636 } else {
637 Carp::croak "cannot, currently, detach class attachments";
638 }
639};
640
641sub cf::attachable::attached {
642 my ($obj, $name) = @_;
643
644 exists $obj->{_attachment}{$name}
645}
646
647for my $klass (qw(ATTACHABLE GLOBAL OBJECT PLAYER CLIENT MAP)) {
648 eval "#line " . __LINE__ . " 'cf.pm'
649 sub cf::\L$klass\E::_attach_registry {
650 (\\\@CB_$klass, KLASS_$klass)
651 }
652
653 sub cf::\L$klass\E::attachment {
223 my $name = shift; 654 my \$name = shift;
224 655
225 $attachment{$name} = [@_]; 656 \$attachment{\$name} = [[KLASS_$klass, \@_]];
657 }
658 ";
659 die if $@;
226} 660}
227 661
228our $override; 662our $override;
229our @invoke_results = (); # referenced from .xs code. TODO: play tricks with reify and mortals? 663our @invoke_results = (); # referenced from .xs code. TODO: play tricks with reify and mortals?
230 664
244 for (@$callbacks) { 678 for (@$callbacks) {
245 eval { &{$_->[1]} }; 679 eval { &{$_->[1]} };
246 680
247 if ($@) { 681 if ($@) {
248 warn "$@"; 682 warn "$@";
249 warn "... while processing $EVENT[$event][0] event, skipping processing altogether.\n"; 683 warn "... while processing $EVENT[$event][0](@_) event, skipping processing altogether.\n";
250 override; 684 override;
251 } 685 }
252 686
253 return 1 if $override; 687 return 1 if $override;
254 } 688 }
255 689
256 0 690 0
257} 691}
692
693=item $bool = cf::global::invoke (EVENT_CLASS_XXX, ...)
694
695=item $bool = $attachable->invoke (EVENT_CLASS_XXX, ...)
696
697Generate an object-specific event with the given arguments.
698
699This API is preliminary (most likely, the EVENT_CLASS_xxx prefix will be
700removed in future versions), and there is no public API to access override
701results (if you must, access C<@cf::invoke_results> directly).
702
703=back
704
705=cut
258 706
259############################################################################# 707#############################################################################
260# object support 708# object support
261 709
262sub instantiate { 710sub reattach {
711 # basically do the same as instantiate, without calling instantiate
263 my ($obj, $data) = @_; 712 my ($obj) = @_;
713
714 bless $obj, ref $obj; # re-bless in case extensions have been reloaded
715
264 my $registry = $obj->registry; 716 my $registry = $obj->registry;
265 717
266 $data = from_json $data; 718 @$registry = ();
267 719
268 for (@$data) { 720 delete $obj->{_attachment} unless scalar keys %{ $obj->{_attachment} || {} };
269 my ($pri, $name, @args) = @$_;
270 721
722 for my $name (keys %{ $obj->{_attachment} || {} }) {
271 if (my $attach = $attachment{$name}) { 723 if (my $attach = $attachment{$name}) {
724 for (@$attach) {
725 my ($klass, @attach) = @$_;
272 _attach @$registry, KLASS_OBJECT, @$attach; 726 _attach $registry, $klass, @attach;
727 }
728 } else {
729 warn "object uses attachment '$name' that is not available, postponing.\n";
730 }
731 }
732}
273 733
274 if (my $cb = delete $registry->[EVENT_OBJECT_INSTANTIATE]) { 734cf::attachable->attach (
735 prio => -1000000,
736 on_instantiate => sub {
737 my ($obj, $data) = @_;
738
739 $data = from_json $data;
740
741 for (@$data) {
742 my ($name, $args) = @$_;
743
744 $obj->attach ($name, %{$args || {} });
745 }
746 },
747 on_reattach => \&reattach,
748 on_clone => sub {
749 my ($src, $dst) = @_;
750
751 @{$dst->registry} = @{$src->registry};
752
753 %$dst = %$src;
754
755 %{$dst->{_attachment}} = %{$src->{_attachment}}
756 if exists $src->{_attachment};
757 },
758);
759
760sub object_freezer_save {
761 my ($filename, $rdata, $objs) = @_;
762
763 sync_job {
764 if (length $$rdata) {
765 warn sprintf "saving %s (%d,%d)\n",
766 $filename, length $$rdata, scalar @$objs;
767
768 if (my $fh = aio_open "$filename~", O_WRONLY | O_CREAT, 0600) {
769 chmod SAVE_MODE, $fh;
770 aio_write $fh, 0, (length $$rdata), $$rdata, 0;
771 aio_fsync $fh if $cf::USE_FSYNC;
772 close $fh;
773
275 for (@$cb) { 774 if (@$objs) {
276 eval { $_->[1]->($obj, @args); }; 775 if (my $fh = aio_open "$filename.pst~", O_WRONLY | O_CREAT, 0600) {
277 if ($@) { 776 chmod SAVE_MODE, $fh;
278 warn "$@"; 777 my $data = Storable::nfreeze { version => 1, objs => $objs };
279 warn "... while processing '$name' instantiate with args <@args>\n"; 778 aio_write $fh, 0, (length $data), $data, 0;
779 aio_fsync $fh if $cf::USE_FSYNC;
780 close $fh;
781 aio_rename "$filename.pst~", "$filename.pst";
280 } 782 }
783 } else {
784 aio_unlink "$filename.pst";
785 }
786
787 aio_rename "$filename~", $filename;
788 } else {
789 warn "FATAL: $filename~: $!\n";
790 }
791 } else {
792 aio_unlink $filename;
793 aio_unlink "$filename.pst";
794 }
795 }
796}
797
798sub object_freezer_as_string {
799 my ($rdata, $objs) = @_;
800
801 use Data::Dumper;
802
803 $$rdata . Dumper $objs
804}
805
806sub object_thawer_load {
807 my ($filename) = @_;
808
809 my ($data, $av);
810
811 (aio_load $filename, $data) >= 0
812 or return;
813
814 unless (aio_stat "$filename.pst") {
815 (aio_load "$filename.pst", $av) >= 0
816 or return;
817 $av = eval { (Storable::thaw $av)->{objs} };
818 }
819
820 warn sprintf "loading %s (%d)\n",
821 $filename, length $data, scalar @{$av || []};#d#
822 return ($data, $av);
823}
824
825#############################################################################
826# command handling &c
827
828=item cf::register_command $name => \&callback($ob,$args);
829
830Register a callback for execution when the client sends the user command
831$name.
832
833=cut
834
835sub register_command {
836 my ($name, $cb) = @_;
837
838 my $caller = caller;
839 #warn "registering command '$name/$time' to '$caller'";
840
841 push @{ $COMMAND{$name} }, [$caller, $cb];
842}
843
844=item cf::register_extcmd $name => \&callback($pl,$packet);
845
846Register a callbackf ro execution when the client sends an extcmd packet.
847
848If the callback returns something, it is sent back as if reply was being
849called.
850
851=cut
852
853sub register_extcmd {
854 my ($name, $cb) = @_;
855
856 $EXTCMD{$name} = $cb;
857}
858
859cf::player->attach (
860 on_command => sub {
861 my ($pl, $name, $params) = @_;
862
863 my $cb = $COMMAND{$name}
864 or return;
865
866 for my $cmd (@$cb) {
867 $cmd->[1]->($pl->ob, $params);
868 }
869
870 cf::override;
871 },
872 on_extcmd => sub {
873 my ($pl, $buf) = @_;
874
875 my $msg = eval { from_json $buf };
876
877 if (ref $msg) {
878 if (my $cb = $EXTCMD{$msg->{msgtype}}) {
879 if (my %reply = $cb->($pl, $msg)) {
880 $pl->ext_reply ($msg->{msgid}, %reply);
281 } 881 }
282 } 882 }
283 } else { 883 } else {
284 warn "object uses attachment $name that is not available, postponing.\n"; 884 warn "player " . ($pl->ob->name) . " sent unparseable ext message: <$buf>\n";
285 } 885 }
286 886
287 push @{$obj->{_attachment}}, $name; 887 cf::override;
288 }
289}
290
291# basically do the same as instantiate, without calling instantiate
292sub reattach {
293 my ($obj) = @_;
294 my $registry = $obj->registry;
295
296 warn "reattach<@_, $_>\n";
297}
298
299attach_to_objects
300 prio => -1000000,
301 on_clone => sub {
302 my ($src, $dst) = @_;
303
304 @{$dst->registry} = @{$src->registry};
305 warn "registry clone ", join ":", @{$src->registry};#d#
306
307 %$dst = %$src;
308
309 $dst->{_attachment} = [@{ $src->{_attachment} }]
310 if exists $src->{_attachment};
311
312 warn "clone<@_>\n";#d#
313 }, 888 },
314; 889);
315
316#############################################################################
317# old plug-in events
318
319sub inject_event {
320 my $extension = shift;
321 my $event_code = shift;
322
323 my $cb = $hook[$event_code]{$extension}
324 or return;
325
326 &$cb
327}
328
329sub inject_global_event {
330 my $event = shift;
331
332 my $cb = $hook[$event]
333 or return;
334
335 List::Util::max map &$_, values %$cb
336}
337
338sub inject_command {
339 my ($name, $obj, $params) = @_;
340
341 for my $cmd (@{ $command{$name} }) {
342 $cmd->[1]->($obj, $params);
343 }
344
345 -1
346}
347
348sub register_command {
349 my ($name, $time, $cb) = @_;
350
351 my $caller = caller;
352 #warn "registering command '$name/$time' to '$caller'";
353
354 push @{ $command{$name} }, [$time, $cb, $caller];
355 $COMMAND{"$name\000"} = List::Util::max map $_->[0], @{ $command{$name} };
356}
357
358sub register_extcmd {
359 my ($name, $cb) = @_;
360
361 my $caller = caller;
362 #warn "registering extcmd '$name' to '$caller'";
363
364 $extcmd{$name} = [$cb, $caller];
365}
366
367sub register {
368 my ($base, $pkg) = @_;
369
370 #TODO
371}
372 890
373sub load_extension { 891sub load_extension {
374 my ($path) = @_; 892 my ($path) = @_;
375 893
376 $path =~ /([^\/\\]+)\.ext$/ or die "$path"; 894 $path =~ /([^\/\\]+)\.ext$/ or die "$path";
377 my $base = $1; 895 my $base = $1;
378 my $pkg = $1; 896 my $pkg = $1;
379 $pkg =~ s/[^[:word:]]/_/g; 897 $pkg =~ s/[^[:word:]]/_/g;
380 $pkg = "ext::$pkg"; 898 $pkg = "ext::$pkg";
381 899
382 warn "loading '$path' into '$pkg'\n"; 900 warn "... loading '$path' into '$pkg'\n";
383 901
384 open my $fh, "<:utf8", $path 902 open my $fh, "<:utf8", $path
385 or die "$path: $!"; 903 or die "$path: $!";
386 904
387 my $source = 905 my $source =
388 "package $pkg; use strict; use utf8;\n" 906 "package $pkg; use strict; use utf8;\n"
389 . "#line 1 \"$path\"\n{\n" 907 . "#line 1 \"$path\"\n{\n"
390 . (do { local $/; <$fh> }) 908 . (do { local $/; <$fh> })
391 . "\n};\n1"; 909 . "\n};\n1";
392 910
393 eval $source 911 unless (eval $source) {
394 or die "$path: $@"; 912 my $msg = $@ ? "$path: $@\n"
395 913 : "extension disabled.\n";
396 push @exts, $pkg; 914 if ($source =~ /^#!.*perl.*#.*MANDATORY/m) { # ugly match
397 $ext_pkg{$base} = $pkg; 915 warn $@;
398 916 warn "mandatory extension failed to load, exiting.\n";
399# no strict 'refs'; 917 exit 1;
400# @{"$pkg\::ISA"} = ext::; 918 }
401 919 die $@;
402 register $base, $pkg;
403}
404
405sub unload_extension {
406 my ($pkg) = @_;
407
408 warn "removing extension $pkg\n";
409
410 # remove hooks
411 #TODO
412# for my $idx (0 .. $#PLUGIN_EVENT) {
413# delete $hook[$idx]{$pkg};
414# } 920 }
415 921
416 # remove commands 922 push @EXTS, $pkg;
417 for my $name (keys %command) {
418 my @cb = grep $_->[2] ne $pkg, @{ $command{$name} };
419
420 if (@cb) {
421 $command{$name} = \@cb;
422 $COMMAND{"$name\000"} = List::Util::max map $_->[0], @cb;
423 } else {
424 delete $command{$name};
425 delete $COMMAND{"$name\000"};
426 }
427 }
428
429 # remove extcmds
430 for my $name (grep $extcmd{$_}[1] eq $pkg, keys %extcmd) {
431 delete $extcmd{$name};
432 }
433
434 if (my $cb = $pkg->can ("unload")) {
435 eval {
436 $cb->($pkg);
437 1
438 } or warn "$pkg unloaded, but with errors: $@";
439 }
440
441 Symbol::delete_package $pkg;
442} 923}
443 924
444sub load_extensions { 925sub load_extensions {
445 my $LIBDIR = maps_directory "perl";
446
447 for my $ext (<$LIBDIR/*.ext>) { 926 for my $ext (<$LIBDIR/*.ext>) {
448 next unless -r $ext; 927 next unless -r $ext;
449 eval { 928 eval {
450 load_extension $ext; 929 load_extension $ext;
451 1 930 1
452 } or warn "$ext not loaded: $@"; 931 } or warn "$ext not loaded: $@";
453 } 932 }
454} 933}
455 934
456sub _perl_reload(&) { 935#############################################################################
936
937=head2 CORE EXTENSIONS
938
939Functions and methods that extend core crossfire objects.
940
941=cut
942
943package cf::player;
944
945use Coro::AIO;
946
947=head3 cf::player
948
949=over 4
950
951=item cf::player::find $login
952
953Returns the given player object, loading it if necessary (might block).
954
955=cut
956
957sub playerdir($) {
958 cf::localdir
959 . "/"
960 . cf::playerdir
961 . "/"
962 . (ref $_[0] ? $_[0]->ob->name : $_[0])
963}
964
965sub path($) {
966 my $login = ref $_[0] ? $_[0]->ob->name : $_[0];
967
968 (playerdir $login) . "/$login.pl"
969}
970
971sub find_active($) {
972 $cf::PLAYER{$_[0]}
973 and $cf::PLAYER{$_[0]}->active
974 and $cf::PLAYER{$_[0]}
975}
976
977sub exists($) {
978 my ($login) = @_;
979
980 $cf::PLAYER{$login}
981 or cf::sync_job { !aio_stat path $login }
982}
983
984sub find($) {
985 return $cf::PLAYER{$_[0]} || do {
986 my $login = $_[0];
987
988 my $guard = cf::lock_acquire "user_find:$login";
989
990 $cf::PLAYER{$_[0]} || do {
991 my $pl = load_pl path $login
992 or return;
993 $cf::PLAYER{$login} = $pl
994 }
995 }
996}
997
998sub save($) {
999 my ($pl) = @_;
1000
1001 return if $pl->{deny_save};
1002
1003 my $path = path $pl;
1004 my $guard = cf::lock_acquire "user_save:$path";
1005
1006 return if $pl->{deny_save};
1007
1008 aio_mkdir playerdir $pl, 0770;
1009 $pl->{last_save} = $cf::RUNTIME;
1010
1011 $pl->save_pl ($path);
1012 Coro::cede;
1013}
1014
1015sub new($) {
1016 my ($login) = @_;
1017
1018 my $self = create;
1019
1020 $self->ob->name ($login);
1021 $self->{deny_save} = 1;
1022
1023 $cf::PLAYER{$login} = $self;
1024
1025 $self
1026}
1027
1028=item $pl->quit_character
1029
1030Nukes the player without looking back. If logged in, the connection will
1031be destroyed. May block for a long time.
1032
1033=cut
1034
1035sub quit_character {
1036 my ($pl) = @_;
1037
1038 my $name = $pl->ob->name;
1039
1040 $pl->{deny_save} = 1;
1041 $pl->password ("*"); # this should lock out the player until we nuked the dir
1042
1043 $pl->invoke (cf::EVENT_PLAYER_LOGOUT, 1) if $pl->active;
1044 $pl->deactivate;
1045 $pl->invoke (cf::EVENT_PLAYER_QUIT);
1046 $pl->ns->destroy if $pl->ns;
1047
1048 my $path = playerdir $pl;
1049 my $temp = "$path~$cf::RUNTIME~deleting~";
1050 aio_rename $path, $temp;
1051 delete $cf::PLAYER{$pl->ob->name};
1052 $pl->destroy;
1053
1054 my $prefix = qr<^~\Q$name\E/>;
1055
1056 # nuke player maps
1057 $cf::MAP{$_}->nuke for grep /$prefix/, keys %cf::MAP;
1058
1059 IO::AIO::aio_rmtree $temp;
1060}
1061
1062=item $pl->kick
1063
1064Kicks a player out of the game. This destroys the connection.
1065
1066=cut
1067
1068sub kick {
1069 my ($pl, $kicker) = @_;
1070
1071 $pl->invoke (cf::EVENT_PLAYER_KICK, $kicker);
1072 $pl->killer ("kicked");
1073 $pl->ns->destroy;
1074}
1075
1076=item cf::player::list_logins
1077
1078Returns am arrayref of all valid playernames in the system, can take a
1079while and may block, so not sync_job-capable, ever.
1080
1081=cut
1082
1083sub list_logins {
1084 my $dirs = aio_readdir cf::localdir . "/" . cf::playerdir
1085 or return [];
1086
1087 my @logins;
1088
1089 for my $login (@$dirs) {
1090 my $fh = aio_open path $login, Fcntl::O_RDONLY, 0 or next;
1091 aio_read $fh, 0, 512, my $buf, 0 or next;
1092 $buf !~ /^password -------------$/m or next; # official not-valid tag
1093
1094 utf8::decode $login;
1095 push @logins, $login;
1096 }
1097
1098 \@logins
1099}
1100
1101=item $player->maps
1102
1103Returns an arrayref of map paths that are private for this
1104player. May block.
1105
1106=cut
1107
1108sub maps($) {
1109 my ($pl) = @_;
1110
1111 $pl = ref $pl ? $pl->ob->name : $pl;
1112
1113 my $files = aio_readdir playerdir $pl
1114 or return;
1115
1116 my @paths;
1117
1118 for (@$files) {
1119 utf8::decode $_;
1120 next if /\.(?:pl|pst)$/;
1121 next unless /^$PATH_SEP/o;
1122
1123 push @paths, cf::map::normalise "~$pl/$_";
1124 }
1125
1126 \@paths
1127}
1128
1129=item $player->ext_reply ($msgid, $msgtype, %msg)
1130
1131Sends an ext reply to the player.
1132
1133=cut
1134
1135sub ext_reply($$$%) {
1136 my ($self, $id, %msg) = @_;
1137
1138 $msg{msgid} = $id;
1139
1140 $self->send ("ext " . cf::to_json \%msg);
1141}
1142
1143package cf;
1144
1145=back
1146
1147
1148=head3 cf::map
1149
1150=over 4
1151
1152=cut
1153
1154package cf::map;
1155
1156use Fcntl;
1157use Coro::AIO;
1158
1159use overload
1160 '""' => \&as_string,
1161 fallback => 1;
1162
1163our $MAX_RESET = 3600;
1164our $DEFAULT_RESET = 3000;
1165
1166sub generate_random_map {
1167 my ($self, $rmp) = @_;
1168 # mit "rum" bekleckern, nicht
1169 $self->_create_random_map (
1170 $rmp->{wallstyle}, $rmp->{wall_name}, $rmp->{floorstyle}, $rmp->{monsterstyle},
1171 $rmp->{treasurestyle}, $rmp->{layoutstyle}, $rmp->{doorstyle}, $rmp->{decorstyle},
1172 $rmp->{origin_map}, $rmp->{final_map}, $rmp->{exitstyle}, $rmp->{this_map},
1173 $rmp->{exit_on_final_map},
1174 $rmp->{xsize}, $rmp->{ysize},
1175 $rmp->{expand2x}, $rmp->{layoutoptions1}, $rmp->{layoutoptions2}, $rmp->{layoutoptions3},
1176 $rmp->{symmetry}, $rmp->{difficulty}, $rmp->{difficulty_given}, $rmp->{difficulty_increase},
1177 $rmp->{dungeon_level}, $rmp->{dungeon_depth}, $rmp->{decoroptions}, $rmp->{orientation},
1178 $rmp->{origin_y}, $rmp->{origin_x}, $rmp->{random_seed}, $rmp->{total_map_hp},
1179 $rmp->{map_layout_style}, $rmp->{treasureoptions}, $rmp->{symmetry_used},
1180 (cf::region::find $rmp->{region}), $rmp->{custom}
1181 )
1182}
1183
1184=item cf::map->register ($regex, $prio)
1185
1186Register a handler for the map path matching the given regex at the
1187givne priority (higher is better, built-in handlers have priority 0, the
1188default).
1189
1190=cut
1191
1192sub register {
1193 my (undef, $regex, $prio) = @_;
1194 my $pkg = caller;
1195
1196 no strict;
1197 push @{"$pkg\::ISA"}, __PACKAGE__;
1198
1199 $EXT_MAP{$pkg} = [$prio, qr<$regex>];
1200}
1201
1202# also paths starting with '/'
1203$EXT_MAP{"cf::map"} = [0, qr{^(?=/)}];
1204
1205sub thawer_merge {
1206 my ($self, $merge) = @_;
1207
1208 # we have to keep some variables in memory intact
1209 local $self->{path};
1210 local $self->{load_path};
1211 local $self->{deny_save};
1212 local $self->{deny_reset};
1213
1214 $self->SUPER::thawer_merge ($merge);
1215}
1216
1217sub normalise {
1218 my ($path, $base) = @_;
1219
1220 $path = "$path"; # make sure its a string
1221
1222 $path =~ s/\.map$//;
1223
1224 # map plan:
1225 #
1226 # /! non-realised random map exit (special hack!)
1227 # {... are special paths that are not being touched
1228 # ?xxx/... are special absolute paths
1229 # ?random/... random maps
1230 # /... normal maps
1231 # ~user/... per-player map of a specific user
1232
1233 $path =~ s/$PATH_SEP/\//go;
1234
1235 # treat it as relative path if it starts with
1236 # something that looks reasonable
1237 if ($path =~ m{^(?:\./|\.\./|\w)}) {
1238 $base or Carp::carp "normalise called with relative path and no base: '$path'";
1239
1240 $base =~ s{[^/]+/?$}{};
1241 $path = "$base/$path";
1242 }
1243
1244 for ($path) {
1245 redo if s{//}{/};
1246 redo if s{/\.?/}{/};
1247 redo if s{/[^/]+/\.\./}{/};
1248 }
1249
1250 $path
1251}
1252
1253sub new_from_path {
1254 my (undef, $path, $base) = @_;
1255
1256 return $path if UNIVERSAL::isa $path, "cf::map"; # already a map object
1257
1258 $path = normalise $path, $base;
1259
1260 for my $pkg (sort { $EXT_MAP{$b}[0] <=> $EXT_MAP{$a}[0] } keys %EXT_MAP) {
1261 if ($path =~ $EXT_MAP{$pkg}[1]) {
1262 my $self = bless cf::map::new, $pkg;
1263 $self->{path} = $path; $self->path ($path);
1264 $self->init; # pass $1 etc.
1265 return $self;
1266 }
1267 }
1268
1269 Carp::carp "unable to resolve path '$path' (base '$base').";
1270 ()
1271}
1272
1273sub init {
1274 my ($self) = @_;
1275
1276 $self
1277}
1278
1279sub as_string {
1280 my ($self) = @_;
1281
1282 "$self->{path}"
1283}
1284
1285# the displayed name, this is a one way mapping
1286sub visible_name {
1287 &as_string
1288}
1289
1290# the original (read-only) location
1291sub load_path {
1292 my ($self) = @_;
1293
1294 sprintf "%s/%s/%s.map", cf::datadir, cf::mapdir, $self->{path}
1295}
1296
1297# the temporary/swap location
1298sub save_path {
1299 my ($self) = @_;
1300
1301 (my $path = $_[0]{path}) =~ s/\//$PATH_SEP/g;
1302 sprintf "%s/%s/%s.map", cf::localdir, cf::tmpdir, $path
1303}
1304
1305# the unique path, undef == no special unique path
1306sub uniq_path {
1307 my ($self) = @_;
1308
1309 (my $path = $_[0]{path}) =~ s/\//$PATH_SEP/g;
1310 sprintf "%s/%s/%s", cf::localdir, cf::uniquedir, $path
1311}
1312
1313# and all this just because we cannot iterate over
1314# all maps in C++...
1315sub change_all_map_light {
1316 my ($change) = @_;
1317
1318 $_->change_map_light ($change)
1319 for grep $_->outdoor, values %cf::MAP;
1320}
1321
1322sub unlink_save {
1323 my ($self) = @_;
1324
1325 utf8::encode (my $save = $self->save_path);
1326 IO::AIO::aioreq_pri 4; Coro::AIO::aio_unlink $save;
1327 IO::AIO::aioreq_pri 4; Coro::AIO::aio_unlink "$save.pst";
1328}
1329
1330sub load_header_from($) {
1331 my ($self, $path) = @_;
1332
1333 utf8::encode $path;
1334 #aio_open $path, O_RDONLY, 0
1335 # or return;
1336
1337 $self->_load_header ($path)
1338 or return;
1339
1340 $self->{load_path} = $path;
1341
1342 1
1343}
1344
1345sub load_header_orig {
1346 my ($self) = @_;
1347
1348 $self->load_header_from ($self->load_path)
1349}
1350
1351sub load_header_temp {
1352 my ($self) = @_;
1353
1354 $self->load_header_from ($self->save_path)
1355}
1356
1357sub prepare_temp {
1358 my ($self) = @_;
1359
1360 $self->last_access ((delete $self->{last_access})
1361 || $cf::RUNTIME); #d#
1362 # safety
1363 $self->{instantiate_time} = $cf::RUNTIME
1364 if $self->{instantiate_time} > $cf::RUNTIME;
1365}
1366
1367sub prepare_orig {
1368 my ($self) = @_;
1369
1370 $self->{load_original} = 1;
1371 $self->{instantiate_time} = $cf::RUNTIME;
1372 $self->last_access ($cf::RUNTIME);
1373 $self->instantiate;
1374}
1375
1376sub load_header {
1377 my ($self) = @_;
1378
1379 if ($self->load_header_temp) {
1380 $self->prepare_temp;
1381 } else {
1382 $self->load_header_orig
1383 or return;
1384 $self->prepare_orig;
1385 }
1386
1387 1
1388}
1389
1390sub find;
1391sub find {
1392 my ($path, $origin) = @_;
1393
1394 $path = normalise $path, $origin && $origin->path;
1395
1396 cf::lock_wait "map_find:$path";
1397
1398 $cf::MAP{$path} || do {
1399 my $guard = cf::lock_acquire "map_find:$path";
1400 my $map = new_from_path cf::map $path
1401 or return;
1402
1403 $map->{last_save} = $cf::RUNTIME;
1404
1405 $map->load_header
1406 or return;
1407
1408 if ($map->should_reset && 0) {#d#TODO# disabled, crashy (locking issue?)
1409 # doing this can freeze the server in a sync job, obviously
1410 #$cf::WAIT_FOR_TICK->wait;
1411 $map->reset;
1412 undef $guard;
1413 return find $path;
1414 }
1415
1416 $cf::MAP{$path} = $map
1417 }
1418}
1419
1420sub pre_load { }
1421sub post_load { }
1422
1423sub load {
1424 my ($self) = @_;
1425
1426 local $self->{deny_reset} = 1; # loading can take a long time
1427
1428 my $path = $self->{path};
1429 my $guard = cf::lock_acquire "map_load:$path";
1430
1431 return if $self->in_memory != cf::MAP_SWAPPED;
1432
1433 $self->in_memory (cf::MAP_LOADING);
1434
1435 $self->alloc;
1436
1437 $self->pre_load;
1438
1439 $self->_load_objects ($self->{load_path}, 1)
1440 or return;
1441
1442 $self->set_object_flag (cf::FLAG_OBJ_ORIGINAL, 1)
1443 if delete $self->{load_original};
1444
1445 if (my $uniq = $self->uniq_path) {
1446 utf8::encode $uniq;
1447 if (aio_open $uniq, O_RDONLY, 0) {
1448 $self->clear_unique_items;
1449 $self->_load_objects ($uniq, 0);
1450 }
1451 }
1452
1453 Coro::cede;
1454
1455 # now do the right thing for maps
1456 $self->link_multipart_objects;
1457
1458 unless ($self->{deny_activate}) {
1459 $self->decay_objects;
1460 $self->fix_auto_apply;
1461 $self->update_buttons;
1462 Coro::cede;
1463 $self->set_darkness_map;
1464 $self->difficulty ($self->estimate_difficulty)
1465 unless $self->difficulty;
1466 Coro::cede;
1467 $self->activate;
1468 }
1469
1470 $self->post_load;
1471
1472 $self->in_memory (cf::MAP_IN_MEMORY);
1473}
1474
1475sub customise_for {
1476 my ($self, $ob) = @_;
1477
1478 return find "~" . $ob->name . "/" . $self->{path}
1479 if $self->per_player;
1480
1481 $self
1482}
1483
1484# find and load all maps in the 3x3 area around a map
1485sub load_diag {
457 my ($msg) = @_; 1486 my ($map) = @_;
458 1487
459 $msg->("reloading..."); 1488 my @diag; # diagonal neighbours
460 1489
461 eval { 1490 for (0 .. 3) {
462 # 1. cancel all watchers 1491 my $neigh = $map->tile_path ($_)
463 $_->cancel for Event::all_watchers; 1492 or next;
1493 $neigh = find $neigh, $map
1494 or next;
1495 $neigh->load;
464 1496
465 # 2. unload all extensions 1497 push @diag, [$neigh->tile_path (($_ + 3) % 4), $neigh],
466 for (@exts) { 1498 [$neigh->tile_path (($_ + 1) % 4), $neigh];
467 $msg->("unloading <$_>"); 1499 }
468 unload_extension $_;
469 }
470 1500
471 # 3. unload all modules loaded from $LIBDIR 1501 for (@diag) {
472 while (my ($k, $v) = each %INC) { 1502 my $neigh = find @$_
473 next unless $v =~ /^\Q$LIBDIR\E\/.*\.pm$/; 1503 or next;
1504 $neigh->load;
1505 }
1506}
474 1507
475 $msg->("removing <$k>"); 1508sub find_sync {
476 delete $INC{$k}; 1509 my ($path, $origin) = @_;
477 1510
478 $k =~ s/\.pm$//; 1511 cf::sync_job { find $path, $origin }
479 $k =~ s/\//::/g; 1512}
480 1513
481 if (my $cb = $k->can ("unload_module")) { 1514sub do_load_sync {
482 $cb->(); 1515 my ($map) = @_;
1516
1517 cf::sync_job { $map->load };
1518}
1519
1520our %MAP_PREFETCH;
1521our $MAP_PREFETCHER = undef;
1522
1523sub find_async {
1524 my ($path, $origin) = @_;
1525
1526 $path = normalise $path, $origin && $origin->{path};
1527
1528 if (my $map = $cf::MAP{$path}) {
1529 return $map if $map->in_memory == cf::MAP_IN_MEMORY;
1530 }
1531
1532 undef $MAP_PREFETCH{$path};
1533 $MAP_PREFETCHER ||= cf::async {
1534 while (%MAP_PREFETCH) {
1535 for my $path (keys %MAP_PREFETCH) {
1536 my $map = find $path
1537 or next;
1538 $map->load;
1539
1540 delete $MAP_PREFETCH{$path};
483 } 1541 }
484
485 Symbol::delete_package $k;
486 }
487
488 # 4. get rid of safe::, as good as possible
489 Symbol::delete_package "safe::$_"
490 for qw(cf::object cf::object::player cf::player cf::map cf::party cf::region);
491
492 # 5. remove register_script_function callbacks
493 # TODO
494 1542 }
495 # 6. unload cf.pm "a bit" 1543 undef $MAP_PREFETCHER;
496 delete $INC{"cf.pm"};
497
498 # don't, removes xs symbols, too,
499 # and global variables created in xs
500 #Symbol::delete_package __PACKAGE__;
501
502 # 7. reload cf.pm
503 $msg->("reloading cf.pm");
504 require cf;
505 }; 1544 };
506 $msg->($@) if $@; 1545 $MAP_PREFETCHER->prio (6);
507 1546
508 $msg->("reloaded"); 1547 ()
509}; 1548}
510 1549
511sub perl_reload() { 1550sub save {
512 _perl_reload { 1551 my ($self) = @_;
513 warn $_[0]; 1552
514 print "$_[0]\n"; 1553 my $lock = cf::lock_acquire "map_data:" . $self->path;
1554
1555 $self->{last_save} = $cf::RUNTIME;
1556
1557 return unless $self->dirty;
1558
1559 my $save = $self->save_path; utf8::encode $save;
1560 my $uniq = $self->uniq_path; utf8::encode $uniq;
1561
1562 $self->{load_path} = $save;
1563
1564 return if $self->{deny_save};
1565
1566 local $self->{last_access} = $self->last_access;#d#
1567
1568 cf::async {
1569 $_->contr->save for $self->players;
515 }; 1570 };
516}
517 1571
518register_command "perl-reload", 0, sub { 1572 if ($uniq) {
519 my ($who, $arg) = @_; 1573 $self->_save_objects ($save, cf::IO_HEADER | cf::IO_OBJECTS);
520 1574 $self->_save_objects ($uniq, cf::IO_UNIQUES);
521 if ($who->flag (FLAG_WIZ)) {
522 _perl_reload {
523 warn $_[0];
524 $who->message ($_[0]);
525 };
526 }
527};
528
529#############################################################################
530# extcmd framework, basically convert ext <msg>
531# into pkg::->on_extcmd_arg1 (...) while shortcutting a few
532
533attach_to_players
534 on_extcmd => sub {
535 my ($pl, $buf) = @_;
536
537 my $msg = eval { from_json $buf };
538
539 if (ref $msg) {
540 if (my $cb = $extcmd{$msg->{msgtype}}) {
541 if (my %reply = $cb->[0]->($pl, $msg)) {
542 $pl->ext_reply ($msg->{msgid}, %reply);
543 }
544 }
545 } else {
546 warn "player " . ($pl->ob->name) . " sent unparseable ext message: <$buf>\n";
547 }
548
549 cf::override;
550 },
551;
552
553#############################################################################
554# load/save/clean perl data associated with a map
555
556*cf::mapsupport::on_clean = sub {
557 my ($map) = @_;
558
559 my $path = $map->tmpname;
560 defined $path or return;
561
562 unlink "$path.cfperl";
563};
564
565*cf::mapsupport::on_swapin =
566*cf::mapsupport::on_load = sub {
567 my ($map) = @_;
568
569 my $path = $map->tmpname;
570 $path = $map->path unless defined $path;
571
572 open my $fh, "<:raw", "$path.cfperl"
573 or return; # no perl data
574
575 my $data = Storable::thaw do { local $/; <$fh> };
576
577 $data->{version} <= 1
578 or return; # too new
579
580 $map->_set_obs ($data->{obs});
581};
582
583*cf::mapsupport::on_swapout = sub {
584 my ($map) = @_;
585
586 my $path = $map->tmpname;
587 $path = $map->path unless defined $path;
588
589 my $obs = $map->_get_obs;
590
591 if (defined $obs) {
592 open my $fh, ">:raw", "$path.cfperl"
593 or die "$path.cfperl: $!";
594
595 stat $path;
596
597 print $fh Storable::nfreeze {
598 size => (stat _)[7],
599 time => (stat _)[9],
600 version => 1,
601 obs => $obs,
602 };
603
604 chmod SAVE_MODE, "$path.cfperl"; # very racy, but cf-compatible *g*
605 } else { 1575 } else {
606 unlink "$path.cfperl"; 1576 $self->_save_objects ($save, cf::IO_HEADER | cf::IO_OBJECTS | cf::IO_UNIQUES);
607 }
608};
609
610attach_to_maps prio => -10000, package => cf::mapsupport::;
611
612#############################################################################
613# load/save perl data associated with player->ob objects
614
615sub all_objects(@) {
616 @_, map all_objects ($_->inv), @_
617}
618
619attach_to_players
620 on_load => sub {
621 my ($pl, $path) = @_;
622
623 for my $o (all_objects $pl->ob) {
624 if (my $value = $o->get_ob_key_value ("_perl_data")) {
625 $o->set_ob_key_value ("_perl_data");
626
627 %$o = %{ Storable::thaw pack "H*", $value };
628 }
629 }
630 }, 1577 }
631 on_save => sub { 1578}
632 my ($pl, $path) = @_;
633 1579
634 $_->set_ob_key_value (_perl_data => unpack "H*", Storable::nfreeze $_) 1580sub swap_out {
635 for grep %$_, all_objects $pl->ob; 1581 my ($self) = @_;
1582
1583 # save first because save cedes
1584 $self->save;
1585
1586 my $lock = cf::lock_acquire "map_data:" . $self->path;
1587
1588 return if $self->players;
1589 return if $self->in_memory != cf::MAP_IN_MEMORY;
1590 return if $self->{deny_save};
1591
1592 $self->clear;
1593 $self->in_memory (cf::MAP_SWAPPED);
1594}
1595
1596sub reset_at {
1597 my ($self) = @_;
1598
1599 # TODO: safety, remove and allow resettable per-player maps
1600 return 1e99 if $self->isa ("ext::map_per_player");#d#
1601 return 1e99 if $self->{deny_reset};
1602
1603 my $time = $self->fixed_resettime ? $self->{instantiate_time} : $self->last_access;
1604 my $to = List::Util::min $MAX_RESET, $self->reset_timeout || $DEFAULT_RESET;
1605
1606 $time + $to
1607}
1608
1609sub should_reset {
1610 my ($self) = @_;
1611
1612 $self->reset_at <= $cf::RUNTIME
1613}
1614
1615sub reset {
1616 my ($self) = @_;
1617
1618 my $lock = cf::lock_acquire "map_data:$self->{path}";
1619
1620 return if $self->players;
1621 return if $self->isa ("ext::map_per_player");#d#
1622
1623 warn "resetting map ", $self->path;#d#
1624
1625 $self->in_memory (cf::MAP_SWAPPED);
1626
1627 # need to save uniques path
1628 unless ($self->{deny_save}) {
1629 my $uniq = $self->uniq_path; utf8::encode $uniq;
1630
1631 $self->_save_objects ($uniq, cf::IO_UNIQUES)
1632 if $uniq;
636 }, 1633 }
637;
638 1634
639############################################################################# 1635 delete $cf::MAP{$self->path};
640# core extensions - in perl
641 1636
642=item cf::player::exists $login 1637 $self->clear;
643 1638
644Returns true when the given account exists. 1639 $_->clear_links_to ($self) for values %cf::MAP;
645 1640
646=cut 1641 $self->unlink_save;
647 1642 $self->destroy;
648sub cf::player::exists($) {
649 cf::player::find $_[0]
650 or -f sprintf "%s/%s/%s/%s.pl", cf::localdir, cf::playerdir, ($_[0]) x 2;
651} 1643}
652 1644
1645my $nuke_counter = "aaaa";
1646
1647sub nuke {
1648 my ($self) = @_;
1649
1650 delete $cf::MAP{$self->path};
1651
1652 $self->unlink_save;
1653
1654 bless $self, "cf::map";
1655 delete $self->{deny_reset};
1656 $self->{deny_save} = 1;
1657 $self->reset_timeout (1);
1658 $self->path ($self->{path} = "{nuke}/" . ($nuke_counter++));
1659
1660 $cf::MAP{$self->path} = $self;
1661
1662 $self->reset; # polite request, might not happen
1663}
1664
1665=item cf::map::unique_maps
1666
1667Returns an arrayref of paths of all shared maps that have
1668instantiated unique items. May block.
1669
1670=cut
1671
1672sub unique_maps() {
1673 my $files = aio_readdir cf::localdir . "/" . cf::uniquedir
1674 or return;
1675
1676 my @paths;
1677
1678 for (@$files) {
1679 utf8::decode $_;
1680 next if /\.pst$/;
1681 next unless /^$PATH_SEP/o;
1682
1683 push @paths, cf::map::normalise $_;
1684 }
1685
1686 \@paths
1687}
1688
1689package cf;
1690
1691=back
1692
1693=head3 cf::object
1694
1695=cut
1696
1697package cf::object;
1698
1699=over 4
1700
1701=item $ob->inv_recursive
1702
1703Returns the inventory of the object _and_ their inventories, recursively.
1704
1705=cut
1706
1707sub inv_recursive_;
1708sub inv_recursive_ {
1709 map { $_, inv_recursive_ $_->inv } @_
1710}
1711
1712sub inv_recursive {
1713 inv_recursive_ inv $_[0]
1714}
1715
1716package cf;
1717
1718=back
1719
1720=head3 cf::object::player
1721
1722=over 4
1723
653=item $player->reply ($npc, $msg[, $flags]) 1724=item $player_object->reply ($npc, $msg[, $flags])
654 1725
655Sends a message to the player, as if the npc C<$npc> replied. C<$npc> 1726Sends a message to the player, as if the npc C<$npc> replied. C<$npc>
656can be C<undef>. Does the right thing when the player is currently in a 1727can be C<undef>. Does the right thing when the player is currently in a
657dialogue with the given NPC character. 1728dialogue with the given NPC character.
658 1729
659=cut 1730=cut
660 1731
661# rough implementation of a future "reply" method that works 1732# rough implementation of a future "reply" method that works
662# with dialog boxes. 1733# with dialog boxes.
1734#TODO: the first argument must go, split into a $npc->reply_to ( method
663sub cf::object::player::reply($$$;$) { 1735sub cf::object::player::reply($$$;$) {
664 my ($self, $npc, $msg, $flags) = @_; 1736 my ($self, $npc, $msg, $flags) = @_;
665 1737
666 $flags = cf::NDI_BROWN | cf::NDI_UNIQUE unless @_ >= 4; 1738 $flags = cf::NDI_BROWN | cf::NDI_UNIQUE unless @_ >= 4;
667 1739
671 $msg = $npc->name . " says: $msg" if $npc; 1743 $msg = $npc->name . " says: $msg" if $npc;
672 $self->message ($msg, $flags); 1744 $self->message ($msg, $flags);
673 } 1745 }
674} 1746}
675 1747
676=item $player->ext_reply ($msgid, $msgtype, %msg) 1748=item $player_object->may ("access")
677 1749
678Sends an ext reply to the player. 1750Returns wether the given player is authorized to access resource "access"
1751(e.g. "command_wizcast").
679 1752
680=cut 1753=cut
681 1754
682sub cf::player::ext_reply($$$%) { 1755sub cf::object::player::may {
1756 my ($self, $access) = @_;
1757
1758 $self->flag (cf::FLAG_WIZ) ||
1759 (ref $cf::CFG{"may_$access"}
1760 ? scalar grep $self->name eq $_, @{$cf::CFG{"may_$access"}}
1761 : $cf::CFG{"may_$access"})
1762}
1763
1764=item $player_object->enter_link
1765
1766Freezes the player and moves him/her to a special map (C<{link}>).
1767
1768The player should be reasonably safe there for short amounts of time. You
1769I<MUST> call C<leave_link> as soon as possible, though.
1770
1771Will never block.
1772
1773=item $player_object->leave_link ($map, $x, $y)
1774
1775Moves the player out of the special C<{link}> map onto the specified
1776map. If the map is not valid (or omitted), the player will be moved back
1777to the location he/she was before the call to C<enter_link>, or, if that
1778fails, to the emergency map position.
1779
1780Might block.
1781
1782=cut
1783
1784sub link_map {
1785 unless ($LINK_MAP) {
1786 $LINK_MAP = cf::map::find "{link}"
1787 or cf::cleanup "FATAL: unable to provide {link} map, exiting.";
1788 $LINK_MAP->load;
1789 }
1790
1791 $LINK_MAP
1792}
1793
1794sub cf::object::player::enter_link {
1795 my ($self) = @_;
1796
1797 $self->deactivate_recursive;
1798
1799 return if UNIVERSAL::isa $self->map, "ext::map_link";
1800
1801 $self->{_link_pos} ||= [$self->map->{path}, $self->x, $self->y]
1802 if $self->map;
1803
1804 $self->enter_map ($LINK_MAP || link_map, 10, 10);
1805}
1806
1807sub cf::object::player::leave_link {
1808 my ($self, $map, $x, $y) = @_;
1809
1810 my $link_pos = delete $self->{_link_pos};
1811
1812 unless ($map) {
1813 # restore original map position
1814 ($map, $x, $y) = @{ $link_pos || [] };
1815 $map = cf::map::find $map;
1816
1817 unless ($map) {
1818 ($map, $x, $y) = @$EMERGENCY_POSITION;
1819 $map = cf::map::find $map
1820 or die "FATAL: cannot load emergency map\n";
1821 }
1822 }
1823
1824 ($x, $y) = (-1, -1)
1825 unless (defined $x) && (defined $y);
1826
1827 # use -1 or undef as default coordinates, not 0, 0
1828 ($x, $y) = ($map->enter_x, $map->enter_y)
1829 if $x <=0 && $y <= 0;
1830
1831 $map->load;
1832 $map->load_diag;
1833
1834 return unless $self->contr->active;
1835 $self->activate_recursive;
1836
1837 local $self->{_prev_pos} = $link_pos; # ugly hack for rent.ext
1838 $self->enter_map ($map, $x, $y);
1839}
1840
1841cf::player->attach (
1842 on_logout => sub {
1843 my ($pl) = @_;
1844
1845 # abort map switching before logout
1846 if ($pl->ob->{_link_pos}) {
1847 cf::sync_job {
1848 $pl->ob->leave_link
1849 };
1850 }
1851 },
1852 on_login => sub {
1853 my ($pl) = @_;
1854
1855 # try to abort aborted map switching on player login :)
1856 # should happen only on crashes
1857 if ($pl->ob->{_link_pos}) {
1858 $pl->ob->enter_link;
1859 (async {
1860 $pl->ob->reply (undef,
1861 "There was an internal problem at your last logout, "
1862 . "the server will try to bring you to your intended destination in a second.",
1863 cf::NDI_RED);
1864 # we need this sleep as the login has a concurrent enter_exit running
1865 # and this sleep increases chances of the player not ending up in scorn
1866 Coro::Timer::sleep 1;
1867 $pl->ob->leave_link;
1868 })->prio (2);
1869 }
1870 },
1871);
1872
1873=item $player_object->goto ($path, $x, $y)
1874
1875=cut
1876
1877sub cf::object::player::goto {
1878 my ($self, $path, $x, $y) = @_;
1879
1880 $self->enter_link;
1881
1882 (async {
1883 my $map = eval {
1884 my $map = cf::map::find $path;
1885 $map = $map->customise_for ($self) if $map;
1886 $map
1887 } or
1888 $self->message ("The exit to '$path' is closed", cf::NDI_UNIQUE | cf::NDI_RED);
1889
1890 $self->leave_link ($map, $x, $y);
1891 })->prio (1);
1892}
1893
1894=item $player_object->enter_exit ($exit_object)
1895
1896=cut
1897
1898sub parse_random_map_params {
1899 my ($spec) = @_;
1900
1901 my $rmp = { # defaults
1902 xsize => (cf::rndm 15, 40),
1903 ysize => (cf::rndm 15, 40),
1904 symmetry => (cf::rndm 1, cf::SYMMETRY_XY),
1905 #layout => string,
1906 };
1907
1908 for (split /\n/, $spec) {
1909 my ($k, $v) = split /\s+/, $_, 2;
1910
1911 $rmp->{lc $k} = $v if (length $k) && (length $v);
1912 }
1913
1914 $rmp
1915}
1916
1917sub prepare_random_map {
1918 my ($exit) = @_;
1919
1920 my $guard = cf::lock_acquire "exit_prepare:$exit";
1921
1922 # all this does is basically replace the /! path by
1923 # a new random map path (?random/...) with a seed
1924 # that depends on the exit object
1925
1926 my $rmp = parse_random_map_params $exit->msg;
1927
1928 if ($exit->map) {
1929 $rmp->{region} = $exit->region->name;
1930 $rmp->{origin_map} = $exit->map->path;
1931 $rmp->{origin_x} = $exit->x;
1932 $rmp->{origin_y} = $exit->y;
1933 }
1934
1935 $rmp->{random_seed} ||= $exit->random_seed;
1936
1937 my $data = cf::to_json $rmp;
1938 my $md5 = Digest::MD5::md5_hex $data;
1939 my $meta = "$cf::RANDOM_MAPS/$md5.meta";
1940
1941 if (my $fh = aio_open "$meta~", O_WRONLY | O_CREAT, 0666) {
1942 aio_write $fh, 0, (length $data), $data, 0;
1943 undef $fh;
1944 aio_rename "$meta~", $meta;
1945
1946 $exit->slaying ("?random/$md5");
1947 $exit->msg (undef);
1948 }
1949}
1950
1951sub cf::object::player::enter_exit {
683 my ($self, $id, %msg) = @_; 1952 my ($self, $exit) = @_;
684 1953
685 $msg{msgid} = $id; 1954 return unless $self->type == cf::PLAYER;
686 1955
687 $self->send ("ext " . to_json \%msg); 1956 if ($exit->slaying eq "/!") {
688} 1957 #TODO: this should de-fi-ni-te-ly not be a sync-job
1958 cf::sync_job { prepare_random_map $exit };
1959 }
689 1960
690############################################################################# 1961 my $slaying = cf::map::normalise $exit->slaying, $exit->map && $exit->map->path;
691# map scripting support 1962 my $hp = $exit->stats->hp;
1963 my $sp = $exit->stats->sp;
1964
1965 $self->enter_link;
1966
1967 (async {
1968 $self->deactivate_recursive; # just to be sure
1969 unless (eval {
1970 $self->goto ($slaying, $hp, $sp);
1971
1972 1;
1973 }) {
1974 $self->message ("Something went wrong deep within the crossfire server. "
1975 . "I'll try to bring you back to the map you were before. "
1976 . "Please report this to the dungeon master!",
1977 cf::NDI_UNIQUE | cf::NDI_RED);
1978
1979 warn "ERROR in enter_exit: $@";
1980 $self->leave_link;
1981 }
1982 })->prio (1);
1983}
1984
1985=head3 cf::client
1986
1987=over 4
1988
1989=item $client->send_drawinfo ($text, $flags)
1990
1991Sends a drawinfo packet to the client. Circumvents output buffering so
1992should not be used under normal circumstances.
1993
1994=cut
1995
1996sub cf::client::send_drawinfo {
1997 my ($self, $text, $flags) = @_;
1998
1999 utf8::encode $text;
2000 $self->send_packet (sprintf "drawinfo %d %s", $flags || cf::NDI_BLACK, $text);
2001}
2002
2003
2004=item $success = $client->query ($flags, "text", \&cb)
2005
2006Queues a query to the client, calling the given callback with
2007the reply text on a reply. flags can be C<cf::CS_QUERY_YESNO>,
2008C<cf::CS_QUERY_SINGLECHAR> or C<cf::CS_QUERY_HIDEINPUT> or C<0>.
2009
2010Queries can fail, so check the return code. Or don't, as queries will become
2011reliable at some point in the future.
2012
2013=cut
2014
2015sub cf::client::query {
2016 my ($self, $flags, $text, $cb) = @_;
2017
2018 return unless $self->state == ST_PLAYING
2019 || $self->state == ST_SETUP
2020 || $self->state == ST_CUSTOM;
2021
2022 $self->state (ST_CUSTOM);
2023
2024 utf8::encode $text;
2025 push @{ $self->{query_queue} }, [(sprintf "query %d %s", $flags, $text), $cb];
2026
2027 $self->send_packet ($self->{query_queue}[0][0])
2028 if @{ $self->{query_queue} } == 1;
2029}
2030
2031cf::client->attach (
2032 on_reply => sub {
2033 my ($ns, $msg) = @_;
2034
2035 # this weird shuffling is so that direct followup queries
2036 # get handled first
2037 my $queue = delete $ns->{query_queue}
2038 or return; # be conservative, not sure how that can happen, but we saw a crash here
2039
2040 (shift @$queue)->[1]->($msg);
2041 return unless $ns->valid; # temporary(?) workaround for callback destroying socket
2042
2043 push @{ $ns->{query_queue} }, @$queue;
2044
2045 if (@{ $ns->{query_queue} } == @$queue) {
2046 if (@$queue) {
2047 $ns->send_packet ($ns->{query_queue}[0][0]);
2048 } else {
2049 $ns->state (ST_PLAYING) if $ns->state == ST_CUSTOM;
2050 }
2051 }
2052 },
2053);
2054
2055=item $client->async (\&cb)
2056
2057Create a new coroutine, running the specified callback. The coroutine will
2058be automatically cancelled when the client gets destroyed (e.g. on logout,
2059or loss of connection).
2060
2061=cut
2062
2063sub cf::client::async {
2064 my ($self, $cb) = @_;
2065
2066 my $coro = &Coro::async ($cb);
2067
2068 $coro->on_destroy (sub {
2069 delete $self->{_coro}{$coro+0};
2070 });
2071
2072 $self->{_coro}{$coro+0} = $coro;
2073
2074 $coro
2075}
2076
2077cf::client->attach (
2078 on_destroy => sub {
2079 my ($ns) = @_;
2080
2081 $_->cancel for values %{ (delete $ns->{_coro}) || {} };
2082 },
2083);
2084
2085=back
2086
2087
2088=head2 SAFE SCRIPTING
2089
2090Functions that provide a safe environment to compile and execute
2091snippets of perl code without them endangering the safety of the server
2092itself. Looping constructs, I/O operators and other built-in functionality
2093is not available in the safe scripting environment, and the number of
2094functions and methods that can be called is greatly reduced.
2095
2096=cut
692 2097
693our $safe = new Safe "safe"; 2098our $safe = new Safe "safe";
694our $safe_hole = new Safe::Hole; 2099our $safe_hole = new Safe::Hole;
695 2100
696$SIG{FPE} = 'IGNORE'; 2101$SIG{FPE} = 'IGNORE';
697 2102
698$safe->permit_only (Opcode::opset qw(:base_core :base_mem :base_orig :base_math sort time)); 2103$safe->permit_only (Opcode::opset qw(:base_core :base_mem :base_orig :base_math sort time));
699 2104
700# here we export the classes and methods available to script code 2105# here we export the classes and methods available to script code
701 2106
2107=pod
2108
2109The following fucntions and emthods are available within a safe environment:
2110
2111 cf::object contr pay_amount pay_player map
2112 cf::object::player player
2113 cf::player peaceful
2114 cf::map trigger
2115
2116=cut
2117
702for ( 2118for (
703 ["cf::object" => qw(contr pay_amount pay_player)], 2119 ["cf::object" => qw(contr pay_amount pay_player map)],
704 ["cf::object::player" => qw(player)], 2120 ["cf::object::player" => qw(player)],
705 ["cf::player" => qw(peaceful)], 2121 ["cf::player" => qw(peaceful)],
2122 ["cf::map" => qw(trigger)],
706) { 2123) {
707 no strict 'refs'; 2124 no strict 'refs';
708 my ($pkg, @funs) = @$_; 2125 my ($pkg, @funs) = @$_;
709 *{"safe::$pkg\::$_"} = $safe_hole->wrap (\&{"$pkg\::$_"}) 2126 *{"safe::$pkg\::$_"} = $safe_hole->wrap (\&{"$pkg\::$_"})
710 for @funs; 2127 for @funs;
711} 2128}
2129
2130=over 4
2131
2132=item @retval = safe_eval $code, [var => value, ...]
2133
2134Compiled and executes the given perl code snippet. additional var/value
2135pairs result in temporary local (my) scalar variables of the given name
2136that are available in the code snippet. Example:
2137
2138 my $five = safe_eval '$first + $second', first => 1, second => 4;
2139
2140=cut
712 2141
713sub safe_eval($;@) { 2142sub safe_eval($;@) {
714 my ($code, %vars) = @_; 2143 my ($code, %vars) = @_;
715 2144
716 my $qcode = $code; 2145 my $qcode = $code;
739 } 2168 }
740 2169
741 wantarray ? @res : $res[0] 2170 wantarray ? @res : $res[0]
742} 2171}
743 2172
2173=item cf::register_script_function $function => $cb
2174
2175Register a function that can be called from within map/npc scripts. The
2176function should be reasonably secure and should be put into a package name
2177like the extension.
2178
2179Example: register a function that gets called whenever a map script calls
2180C<rent::overview>, as used by the C<rent> extension.
2181
2182 cf::register_script_function "rent::overview" => sub {
2183 ...
2184 };
2185
2186=cut
2187
744sub register_script_function { 2188sub register_script_function {
745 my ($fun, $cb) = @_; 2189 my ($fun, $cb) = @_;
746 2190
747 no strict 'refs'; 2191 no strict 'refs';
748 *{"safe::$fun"} = $safe_hole->wrap ($cb); 2192 *{"safe::$fun"} = $safe_hole->wrap ($cb);
749} 2193}
750 2194
2195=back
2196
2197=cut
2198
751############################################################################# 2199#############################################################################
752# the server's main() 2200
2201=head2 EXTENSION DATABASE SUPPORT
2202
2203Crossfire maintains a very simple database for extension use. It can
2204currently store anything that can be serialised using Storable, which
2205excludes objects.
2206
2207The parameter C<$family> should best start with the name of the extension
2208using it, it should be unique.
2209
2210=over 4
2211
2212=item $value = cf::db_get $family => $key
2213
2214Returns a single value from the database.
2215
2216=item cf::db_put $family => $key => $value
2217
2218Stores the given C<$value> in the family.
2219
2220=cut
2221
2222our $DB;
2223
2224sub db_init {
2225 unless ($DB) {
2226 $DB = BDB::db_create $DB_ENV;
2227
2228 cf::sync_job {
2229 eval {
2230 $DB->set_flags (BDB::CHKSUM);
2231
2232 BDB::db_open $DB, undef, "db", undef, BDB::BTREE,
2233 BDB::CREATE | BDB::AUTO_COMMIT, 0666;
2234 cf::cleanup "db_open(db): $!" if $!;
2235 };
2236 cf::cleanup "db_open(db): $@" if $@;
2237 };
2238
2239 my $path = cf::localdir . "/database.pst";
2240 if (stat $path) {
2241 cf::sync_job {
2242 my $pst = Storable::retrieve $path;
2243
2244 cf::db_put (board => data => $pst->{board});
2245 cf::db_put (guildrules => data => $pst->{guildrules});
2246 cf::db_put (rent => balance => $pst->{rent}{balance});
2247 BDB::db_env_txn_checkpoint $DB_ENV;
2248
2249 unlink $path;
2250 };
2251 }
2252 }
2253}
2254
2255sub db_get($$) {
2256 my $key = "$_[0]/$_[1]";
2257
2258 cf::sync_job {
2259 BDB::db_get $DB, undef, $key, my $data;
2260
2261 $! ? ()
2262 : Compress::LZF::sthaw $data
2263 }
2264}
2265
2266sub db_put($$$) {
2267 BDB::dbreq_pri 4;
2268 BDB::db_put $DB, undef, "$_[0]/$_[1]", Compress::LZF::sfreeze_cr $_[2], 0, sub { };
2269}
2270
2271#############################################################################
2272# the server's init and main functions
2273
2274sub load_faces {
2275 my $path = sprintf "%s/faces", cf::datadir;
2276
2277 warn "loading faces from $path\n";
2278
2279 my $faces;
2280 0 < aio_load $path, $faces
2281 or die "$path: $!";
2282
2283 Coro::cede;
2284 $faces = Storable::thaw $faces;
2285 Coro::cede;
2286
2287 my $meta = delete $faces->{""};
2288 $meta->{version} == 1
2289 or cf::cleanup "$path: version mismatch, cannot proceed.";
2290
2291 while (my ($face, $info) = each %$faces) {
2292 my $idx = (cf::face::find $face) || cf::face::alloc $face;
2293 cf::face::set $idx, $info->{visibility}, $info->{magicmap};
2294 cf::face::set_data $idx, 0, $info->{data32}, $info->{chksum32};
2295 Coro::cede;
2296 }
2297
2298 while (my ($face, $info) = each %$faces) {
2299 next unless $info->{smooth};
2300 my $idx = cf::face::find $face
2301 or next;
2302 if (my $smooth = cf::face::find $info->{smooth}) {
2303 cf::face::set_smooth $idx, $smooth;
2304 } else {
2305 warn "smooth face '$info->{smooth}' not found for face '$face'";
2306 }
2307 Coro::cede;
2308 }
2309
2310 1
2311}
2312
2313sub reload_resources {
2314 load_resource_file sprintf "%s/%s/regions", cf::datadir, cf::mapdir
2315 or die "unable to load regions file\n";#d#
2316 load_faces
2317 or die "unable to load faces\n";#d#
2318}
2319
2320sub init {
2321 reload_resources;
2322}
2323
2324sub cfg_load {
2325 open my $fh, "<:utf8", cf::confdir . "/config"
2326 or return;
2327
2328 local $/;
2329 *CFG = YAML::Syck::Load <$fh>;
2330
2331 $EMERGENCY_POSITION = $CFG{emergency_position} || ["/world/world_105_115", 5, 37];
2332
2333 $cf::map::MAX_RESET = $CFG{map_max_reset} if exists $CFG{map_max_reset};
2334 $cf::map::DEFAULT_RESET = $CFG{map_default_reset} if exists $CFG{map_default_reset};
2335
2336 if (exists $CFG{mlockall}) {
2337 eval {
2338 $CFG{mlockall} ? eval "mlockall()" : eval "munlockall()"
2339 and die "WARNING: m(un)lockall failed: $!\n";
2340 };
2341 warn $@ if $@;
2342 }
2343}
753 2344
754sub main { 2345sub main {
2346 # we must not ever block the main coroutine
2347 local $Coro::idle = sub {
2348 Carp::cluck "FATAL: Coro::idle was called, major BUG, use cf::sync_job!\n";#d#
2349 (async {
2350 Event::one_event;
2351 })->prio (Coro::PRIO_MAX);
2352 };
2353
2354 cfg_load;
2355 db_init;
2356 load_extensions;
2357
2358 $TICK_WATCHER->start;
755 Event::loop; 2359 Event::loop;
756} 2360}
757 2361
758############################################################################# 2362#############################################################################
759# initialisation 2363# initialisation and cleanup
760 2364
761register "<global>", __PACKAGE__; 2365# install some emergency cleanup handlers
2366BEGIN {
2367 for my $signal (qw(INT HUP TERM)) {
2368 Event->signal (
2369 reentrant => 0,
2370 data => WF_AUTOCANCEL,
2371 signal => $signal,
2372 prio => 0,
2373 cb => sub {
2374 cf::cleanup "SIG$signal";
2375 },
2376 );
2377 }
2378}
2379
2380sub emergency_save() {
2381 my $freeze_guard = cf::freeze_mainloop;
2382
2383 warn "enter emergency perl save\n";
2384
2385 cf::sync_job {
2386 # use a peculiar iteration method to avoid tripping on perl
2387 # refcount bugs in for. also avoids problems with players
2388 # and maps saved/destroyed asynchronously.
2389 warn "begin emergency player save\n";
2390 for my $login (keys %cf::PLAYER) {
2391 my $pl = $cf::PLAYER{$login} or next;
2392 $pl->valid or next;
2393 $pl->save;
2394 }
2395 warn "end emergency player save\n";
2396
2397 warn "begin emergency map save\n";
2398 for my $path (keys %cf::MAP) {
2399 my $map = $cf::MAP{$path} or next;
2400 $map->valid or next;
2401 $map->save;
2402 }
2403 warn "end emergency map save\n";
2404
2405 warn "begin emergency database checkpoint\n";
2406 BDB::db_env_txn_checkpoint $DB_ENV;
2407 warn "end emergency database checkpoint\n";
2408 };
2409
2410 warn "leave emergency perl save\n";
2411}
2412
2413sub post_cleanup {
2414 my ($make_core) = @_;
2415
2416 warn Carp::longmess "post_cleanup backtrace"
2417 if $make_core;
2418}
2419
2420sub reload() {
2421 # can/must only be called in main
2422 if ($Coro::current != $Coro::main) {
2423 warn "can only reload from main coroutine";
2424 return;
2425 }
2426
2427 warn "reloading...";
2428
2429 warn "entering sync_job";
2430
2431 cf::sync_job {
2432 cf::write_runtime; # external watchdog should not bark
2433 cf::emergency_save;
2434 cf::write_runtime; # external watchdog should not bark
2435
2436 warn "syncing database to disk";
2437 BDB::db_env_txn_checkpoint $DB_ENV;
2438
2439 # if anything goes wrong in here, we should simply crash as we already saved
2440
2441 warn "cancelling all WF_AUTOCANCEL watchers";
2442 for (Event::all_watchers) {
2443 $_->cancel if $_->data & WF_AUTOCANCEL;
2444 }
2445
2446 warn "flushing outstanding aio requests";
2447 for (;;) {
2448 BDB::flush;
2449 IO::AIO::flush;
2450 Coro::cede;
2451 last unless IO::AIO::nreqs || BDB::nreqs;
2452 warn "iterate...";
2453 }
2454
2455 ++$RELOAD;
2456
2457 warn "cancelling all extension coros";
2458 $_->cancel for values %EXT_CORO;
2459 %EXT_CORO = ();
2460
2461 warn "removing commands";
2462 %COMMAND = ();
2463
2464 warn "removing ext commands";
2465 %EXTCMD = ();
2466
2467 warn "unloading/nuking all extensions";
2468 for my $pkg (@EXTS) {
2469 warn "... unloading $pkg";
2470
2471 if (my $cb = $pkg->can ("unload")) {
2472 eval {
2473 $cb->($pkg);
2474 1
2475 } or warn "$pkg unloaded, but with errors: $@";
2476 }
2477
2478 warn "... nuking $pkg";
2479 Symbol::delete_package $pkg;
2480 }
2481
2482 warn "unloading all perl modules loaded from $LIBDIR";
2483 while (my ($k, $v) = each %INC) {
2484 next unless $v =~ /^\Q$LIBDIR\E\/.*\.pm$/;
2485
2486 warn "... unloading $k";
2487 delete $INC{$k};
2488
2489 $k =~ s/\.pm$//;
2490 $k =~ s/\//::/g;
2491
2492 if (my $cb = $k->can ("unload_module")) {
2493 $cb->();
2494 }
2495
2496 Symbol::delete_package $k;
2497 }
2498
2499 warn "getting rid of safe::, as good as possible";
2500 Symbol::delete_package "safe::$_"
2501 for qw(cf::attachable cf::object cf::object::player cf::client cf::player cf::map cf::party cf::region);
2502
2503 warn "unloading cf.pm \"a bit\"";
2504 delete $INC{"cf.pm"};
2505
2506 # don't, removes xs symbols, too,
2507 # and global variables created in xs
2508 #Symbol::delete_package __PACKAGE__;
2509
2510 warn "unload completed, starting to reload now";
2511
2512 warn "reloading cf.pm";
2513 require cf;
2514 cf::_connect_to_perl; # nominally unnecessary, but cannot hurt
2515
2516 warn "loading config and database again";
2517 cf::cfg_load;
2518
2519 warn "loading extensions";
2520 cf::load_extensions;
2521
2522 warn "reattaching attachments to objects/players";
2523 _global_reattach; # objects, sockets
2524 warn "reattaching attachments to maps";
2525 reattach $_ for values %MAP;
2526 warn "reattaching attachments to players";
2527 reattach $_ for values %PLAYER;
2528
2529 warn "loading reloadable resources";
2530 reload_resources;
2531
2532 warn "leaving sync_job";
2533
2534 1
2535 } or do {
2536 warn $@;
2537 warn "error while reloading, exiting.";
2538 exit 1;
2539 };
2540
2541 warn "reloaded";
2542};
2543
2544our $RELOAD_WATCHER; # used only during reload
2545
2546register_command "reload" => sub {
2547 my ($who, $arg) = @_;
2548
2549 if ($who->flag (FLAG_WIZ)) {
2550 $who->message ("reloading server.");
2551
2552 # doing reload synchronously and two reloads happen back-to-back,
2553 # coro crashes during coro_state_free->destroy here.
2554
2555 $RELOAD_WATCHER ||= Event->timer (
2556 reentrant => 0,
2557 after => 0,
2558 data => WF_AUTOCANCEL,
2559 cb => sub {
2560 reload;
2561 undef $RELOAD_WATCHER;
2562 },
2563 );
2564 }
2565};
762 2566
763unshift @INC, $LIBDIR; 2567unshift @INC, $LIBDIR;
764 2568
765load_extensions; 2569my $bug_warning = 0;
766 2570
767$TICK_WATCHER = Event->timer ( 2571$TICK_WATCHER = Event->timer (
2572 reentrant => 0,
2573 parked => 1,
768 prio => 1, 2574 prio => 0,
769 at => $NEXT_TICK || 1, 2575 at => $NEXT_TICK || $TICK,
2576 data => WF_AUTOCANCEL,
770 cb => sub { 2577 cb => sub {
2578 if ($Coro::current != $Coro::main) {
2579 Carp::cluck "major BUG: server tick called outside of main coro, skipping it"
2580 unless ++$bug_warning > 10;
2581 return;
2582 }
2583
2584 $NOW = Event::time;
2585
771 cf::server_tick; # one server iteration 2586 cf::server_tick; # one server iteration
772 2587 $RUNTIME += $TICK;
773 my $NOW = Event::time;
774 $NEXT_TICK += $TICK; 2588 $NEXT_TICK += $TICK;
775 2589
2590 if ($NOW >= $NEXT_RUNTIME_WRITE) {
2591 $NEXT_RUNTIME_WRITE = $NOW + 10;
2592 Coro::async_pool {
2593 write_runtime
2594 or warn "ERROR: unable to write runtime file: $!";
2595 };
2596 }
2597
2598 $WAIT_FOR_TICK->broadcast;
2599 $WAIT_FOR_TICK_ONE->send if $WAIT_FOR_TICK_ONE->awaited;
2600
2601# my $AFTER = Event::time;
2602# warn $AFTER - $NOW;#d#
2603
776 # if we are delayed by four ticks, skip them all 2604 # if we are delayed by four ticks or more, skip them all
777 $NEXT_TICK = $NOW if $NOW >= $NEXT_TICK + $TICK * 4; 2605 $NEXT_TICK = Event::time if Event::time >= $NEXT_TICK + $TICK * 4;
778 2606
779 $TICK_WATCHER->at ($NEXT_TICK); 2607 $TICK_WATCHER->at ($NEXT_TICK);
780 $TICK_WATCHER->start; 2608 $TICK_WATCHER->start;
781 }, 2609 },
782); 2610);
783 2611
2612{
2613 BDB::max_poll_time $TICK * 0.1;
2614 $BDB_POLL_WATCHER = Event->io (
2615 reentrant => 0,
2616 fd => BDB::poll_fileno,
2617 poll => 'r',
2618 prio => 0,
2619 data => WF_AUTOCANCEL,
2620 cb => \&BDB::poll_cb,
2621 );
2622 BDB::min_parallel 8;
2623
2624 BDB::set_sync_prepare {
2625 my $status;
2626 my $current = $Coro::current;
2627 (
2628 sub {
2629 $status = $!;
2630 $current->ready; undef $current;
2631 },
2632 sub {
2633 Coro::schedule while defined $current;
2634 $! = $status;
2635 },
2636 )
2637 };
2638
2639 unless ($DB_ENV) {
2640 $DB_ENV = BDB::db_env_create;
2641
2642 cf::sync_job {
2643 eval {
2644 BDB::db_env_open
2645 $DB_ENV,
2646 $BDB_ENV_DIR,
2647 BDB::INIT_LOCK | BDB::INIT_LOG | BDB::INIT_MPOOL | BDB::INIT_TXN
2648 | BDB::RECOVER | BDB::REGISTER | BDB::USE_ENVIRON | BDB::CREATE,
2649 0666;
2650
2651 cf::cleanup "db_env_open($BDB_ENV_DIR): $!" if $!;
2652
2653 $DB_ENV->set_flags (BDB::AUTO_COMMIT | BDB::REGION_INIT | BDB::TXN_NOSYNC, 1);
2654 $DB_ENV->set_lk_detect;
2655 };
2656
2657 cf::cleanup "db_env_open(db): $@" if $@;
2658 };
2659 }
2660}
2661
2662{
2663 IO::AIO::min_parallel 8;
2664
2665 undef $Coro::AIO::WATCHER;
2666 IO::AIO::max_poll_time $TICK * 0.1;
2667 $AIO_POLL_WATCHER = Event->io (
2668 reentrant => 0,
2669 data => WF_AUTOCANCEL,
2670 fd => IO::AIO::poll_fileno,
2671 poll => 'r',
2672 prio => 6,
2673 cb => \&IO::AIO::poll_cb,
2674 );
2675}
2676
2677END { cf::emergency_save }
2678
7841 26791
785 2680

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines