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.92 by root, Thu Dec 21 06:42:28 2006 UTC vs.
Revision 1.407 by root, Sun Jan 13 09:53:53 2008 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 Socket;
9use EV 1.86;
6use Opcode; 10use Opcode;
7use Safe; 11use Safe;
8use Safe::Hole; 12use Safe::Hole;
13use Storable ();
9 14
10use IO::AIO (); 15use Coro 4.32 ();
16use Coro::State;
17use Coro::Handle;
18use Coro::EV;
19use Coro::Timer;
20use Coro::Signal;
21use Coro::Semaphore;
22use Coro::AIO;
23use Coro::BDB;
24use Coro::Storable;
25use Coro::Util ();
26
27use JSON::XS 2.01 ();
28use BDB ();
29use Data::Dumper;
30use Digest::MD5;
31use Fcntl;
11use YAML::Syck (); 32use YAML::Syck ();
33use IO::AIO 2.51 ();
12use Time::HiRes; 34use Time::HiRes;
13use Event; 35use Compress::LZF;
14$Event::Eval = 1; # no idea why this is required, but it is 36use Digest::MD5 ();
37
38# configure various modules to our taste
39#
40$Storable::canonical = 1; # reduce rsync transfers
41Coro::State::cctx_stacksize 256000; # 1-2MB stack, for deep recursions in maze generator
42Compress::LZF::sfreeze_cr { }; # prime Compress::LZF so it does not use require later
15 43
16# work around bug in YAML::Syck - bad news for perl6, will it be as broken wrt. unicode? 44# work around bug in YAML::Syck - bad news for perl6, will it be as broken wrt. unicode?
17$YAML::Syck::ImplicitUnicode = 1; 45$YAML::Syck::ImplicitUnicode = 1;
18 46
19use strict; 47$Coro::main->prio (Coro::PRIO_MAX); # run main coroutine ("the server") with very high priority
20 48
21sub WF_AUTOCANCEL () { 1 } # automatically cancel this watcher on reload 49sub WF_AUTOCANCEL () { 1 } # automatically cancel this watcher on reload
22 50
23our %COMMAND = (); 51our %COMMAND = ();
24our %COMMAND_TIME = (); 52our %COMMAND_TIME = ();
53
54our @EXTS = (); # list of extension package names
25our %EXTCMD = (); 55our %EXTCMD = ();
56our %EXTICMD = ();
57our %EXT_CORO = (); # coroutines bound to extensions
58our %EXT_MAP = (); # pluggable maps
26 59
27_init_vars; 60our $RELOAD; # number of reloads so far
28
29our @EVENT; 61our @EVENT;
30our $LIBDIR = datadir . "/ext";
31 62
32our $TICK = MAX_TIME * 1e-6; 63our $CONFDIR = confdir;
64our $DATADIR = datadir;
65our $LIBDIR = "$DATADIR/ext";
66our $PODDIR = "$DATADIR/pod";
67our $MAPDIR = "$DATADIR/" . mapdir;
68our $LOCALDIR = localdir;
69our $TMPDIR = "$LOCALDIR/" . tmpdir;
70our $UNIQUEDIR = "$LOCALDIR/" . uniquedir;
71our $PLAYERDIR = "$LOCALDIR/" . playerdir;
72our $RANDOMDIR = "$LOCALDIR/random";
73our $BDBDIR = "$LOCALDIR/db";
74our %RESOURCE;
75
76our $TICK = MAX_TIME * 1e-6; # this is a CONSTANT(!)
33our $TICK_WATCHER; 77our $TICK_WATCHER;
78our $AIO_POLL_WATCHER;
79our $NEXT_RUNTIME_WRITE; # when should the runtime file be written
34our $NEXT_TICK; 80our $NEXT_TICK;
81our $USE_FSYNC = 1; # use fsync to write maps - default off
82
83our $BDB_POLL_WATCHER;
84our $BDB_DEADLOCK_WATCHER;
85our $BDB_CHECKPOINT_WATCHER;
86our $BDB_TRICKLE_WATCHER;
87our $DB_ENV;
35 88
36our %CFG; 89our %CFG;
37 90
38our $UPTIME; $UPTIME ||= time; 91our $UPTIME; $UPTIME ||= time;
92our $RUNTIME;
93our $NOW;
94
95our (%PLAYER, %PLAYER_LOADING); # all users
96our (%MAP, %MAP_LOADING ); # all maps
97our $LINK_MAP; # the special {link} map, which is always available
98
99# used to convert map paths into valid unix filenames by replacing / by ∕
100our $PATH_SEP = "∕"; # U+2215, chosen purely for visual reasons
101
102our $LOAD; # a number between 0 (idle) and 1 (too many objects)
103our $LOADAVG; # same thing, but with alpha-smoothing
104our $tick_start; # for load detecting purposes
105
106binmode STDOUT;
107binmode STDERR;
108
109# read virtual server time, if available
110unless ($RUNTIME || !-e "$LOCALDIR/runtime") {
111 open my $fh, "<", "$LOCALDIR/runtime"
112 or die "unable to read runtime file: $!";
113 $RUNTIME = <$fh> + 0.;
114}
115
116mkdir $_
117 for $LOCALDIR, $TMPDIR, $UNIQUEDIR, $PLAYERDIR, $RANDOMDIR, $BDBDIR;
118
119our $EMERGENCY_POSITION;
120
121sub cf::map::normalise;
39 122
40############################################################################# 123#############################################################################
41 124
42=head2 GLOBAL VARIABLES 125=head2 GLOBAL VARIABLES
43 126
45 128
46=item $cf::UPTIME 129=item $cf::UPTIME
47 130
48The timestamp of the server start (so not actually an uptime). 131The timestamp of the server start (so not actually an uptime).
49 132
50=item $cf::LIBDIR 133=item $cf::RUNTIME
51 134
52The perl library directory, where extensions and cf-specific modules can 135The time this server has run, starts at 0 and is increased by $cf::TICK on
53be found. It will be added to C<@INC> automatically. 136every server tick.
137
138=item $cf::CONFDIR $cf::DATADIR $cf::LIBDIR $cf::PODDIR
139$cf::MAPDIR $cf::LOCALDIR $cf::TMPDIR $cf::UNIQUEDIR
140$cf::PLAYERDIR $cf::RANDOMDIR $cf::BDBDIR
141
142Various directories - "/etc", read-only install directory, perl-library
143directory, pod-directory, read-only maps directory, "/var", "/var/tmp",
144unique-items directory, player file directory, random maps directory and
145database environment.
146
147=item $cf::NOW
148
149The time of the last (current) server tick.
54 150
55=item $cf::TICK 151=item $cf::TICK
56 152
57The interval between server ticks, in seconds. 153The interval between server ticks, in seconds.
58 154
155=item $cf::LOADAVG
156
157The current CPU load on the server (alpha-smoothed), as a value between 0
158(none) and 1 (overloaded), indicating how much time is spent on processing
159objects per tick. Healthy values are < 0.5.
160
161=item $cf::LOAD
162
163The raw value load value from the last tick.
164
59=item %cf::CFG 165=item %cf::CFG
60 166
61Configuration for the server, loaded from C</etc/crossfire/config>, or 167Configuration for the server, loaded from C</etc/deliantra-server/config>, or
62from wherever your confdir points to. 168from wherever your confdir points to.
169
170=item cf::wait_for_tick, cf::wait_for_tick_begin
171
172These are functions that inhibit the current coroutine one tick. cf::wait_for_tick_begin only
173returns directly I<after> the tick processing (and consequently, can only wake one process
174per tick), while cf::wait_for_tick wakes up all waiters after tick processing.
175
176=item @cf::INVOKE_RESULTS
177
178This array contains the results of the last C<invoke ()> call. When
179C<cf::override> is called C<@cf::INVOKE_RESULTS> is set to the parameters of
180that call.
63 181
64=back 182=back
65 183
66=cut 184=cut
67 185
68BEGIN { 186BEGIN {
69 *CORE::GLOBAL::warn = sub { 187 *CORE::GLOBAL::warn = sub {
70 my $msg = join "", @_; 188 my $msg = join "", @_;
189
71 $msg .= "\n" 190 $msg .= "\n"
72 unless $msg =~ /\n$/; 191 unless $msg =~ /\n$/;
73 192
74 print STDERR "cfperl: $msg"; 193 $msg =~ s/([\x00-\x08\x0b-\x1f])/sprintf "\\x%02x", ord $1/ge;
194
75 LOG llevError, "cfperl: $msg"; 195 LOG llevError, $msg;
76 }; 196 };
77} 197}
78 198
199$Coro::State::DIEHOOK = sub {
200 warn Carp::longmess $_[0];
201 Coro::terminate;
202};
203
204@safe::cf::global::ISA = @cf::global::ISA = 'cf::attachable';
205@safe::cf::object::ISA = @cf::object::ISA = 'cf::attachable';
206@safe::cf::player::ISA = @cf::player::ISA = 'cf::attachable';
207@safe::cf::client::ISA = @cf::client::ISA = 'cf::attachable';
208@safe::cf::map::ISA = @cf::map::ISA = 'cf::attachable';
209@safe::cf::arch::ISA = @cf::arch::ISA = 'cf::object';
79@safe::cf::object::player::ISA = @cf::object::player::ISA = 'cf::object'; 210@safe::cf::object::player::ISA = @cf::object::player::ISA = 'cf::object'; # not really true (yet)
80 211
81# we bless all objects into (empty) derived classes to force a method lookup 212# we bless all objects into (empty) derived classes to force a method lookup
82# within the Safe compartment. 213# within the Safe compartment.
83for my $pkg (qw( 214for my $pkg (qw(
215 cf::global cf::attachable
84 cf::object cf::object::player 216 cf::object cf::object::player
85 cf::client cf::player 217 cf::client cf::player
86 cf::arch cf::living 218 cf::arch cf::living
87 cf::map cf::party cf::region 219 cf::map cf::party cf::region
88)) { 220)) {
89 no strict 'refs'; 221 no strict 'refs';
90 @{"safe::$pkg\::wrap::ISA"} = @{"$pkg\::wrap::ISA"} = $pkg; 222 @{"safe::$pkg\::wrap::ISA"} = @{"$pkg\::wrap::ISA"} = $pkg;
91} 223}
92 224
93$Event::DIED = sub { 225$EV::DIED = sub {
94 warn "error in event callback: @_"; 226 warn "error in event callback: @_";
95}; 227};
96 228
97my %ext_pkg; 229#############################################################################
98my @exts;
99my @hook;
100 230
101=head2 UTILITY FUNCTIONS 231=head2 UTILITY FUNCTIONS
102 232
103=over 4 233=over 4
104 234
105=cut 235=item dumpval $ref
106 236
107use JSON::Syck (); # TODO# replace by JSON::PC once working 237=cut
108 238
239sub dumpval {
240 eval {
241 local $SIG{__DIE__};
242 my $d;
243 if (1) {
244 $d = new Data::Dumper([$_[0]], ["*var"]);
245 $d->Terse(1);
246 $d->Indent(2);
247 $d->Quotekeys(0);
248 $d->Useqq(1);
249 #$d->Bless(...);
250 $d->Seen($_[1]) if @_ > 1;
251 $d = $d->Dump();
252 }
253 $d =~ s/([\x00-\x07\x09\x0b\x0c\x0e-\x1f])/sprintf "\\x%02x", ord($1)/ge;
254 $d
255 } || "[unable to dump $_[0]: '$@']";
256}
257
109=item $ref = cf::from_json $json 258=item $ref = cf::decode_json $json
110 259
111Converts a JSON string into the corresponding perl data structure. 260Converts a JSON string into the corresponding perl data structure.
112 261
113=cut
114
115sub from_json($) {
116 $JSON::Syck::ImplicitUnicode = 1; # work around JSON::Syck bugs
117 JSON::Syck::Load $_[0]
118}
119
120=item $json = cf::to_json $ref 262=item $json = cf::encode_json $ref
121 263
122Converts a perl data structure into its JSON representation. 264Converts a perl data structure into its JSON representation.
123 265
124=cut 266=cut
125 267
126sub to_json($) { 268our $json_coder = JSON::XS->new->utf8->max_size (1e6); # accept ~1mb max
127 $JSON::Syck::ImplicitUnicode = 0; # work around JSON::Syck bugs 269
128 JSON::Syck::Dump $_[0] 270sub encode_json($) { $json_coder->encode ($_[0]) }
271sub decode_json($) { $json_coder->decode ($_[0]) }
272
273=item cf::lock_wait $string
274
275Wait until the given lock is available. See cf::lock_acquire.
276
277=item my $lock = cf::lock_acquire $string
278
279Wait until the given lock is available and then acquires it and returns
280a Coro::guard object. If the guard object gets destroyed (goes out of scope,
281for example when the coroutine gets canceled), the lock is automatically
282returned.
283
284Locks are *not* recursive, locking from the same coro twice results in a
285deadlocked coro.
286
287Lock names should begin with a unique identifier (for example, cf::map::find
288uses map_find and cf::map::load uses map_load).
289
290=item $locked = cf::lock_active $string
291
292Return true if the lock is currently active, i.e. somebody has locked it.
293
294=cut
295
296our %LOCK;
297our %LOCKER;#d#
298
299sub lock_wait($) {
300 my ($key) = @_;
301
302 if ($LOCKER{$key} == $Coro::current) {#d#
303 Carp::cluck "lock_wait($key) for already-acquired lock";#d#
304 return;#d#
305 }#d#
306
307 # wait for lock, if any
308 while ($LOCK{$key}) {
309 push @{ $LOCK{$key} }, $Coro::current;
310 Coro::schedule;
311 }
312}
313
314sub lock_acquire($) {
315 my ($key) = @_;
316
317 # wait, to be sure we are not locked
318 lock_wait $key;
319
320 $LOCK{$key} = [];
321 $LOCKER{$key} = $Coro::current;#d#
322
323 Coro::guard {
324 delete $LOCKER{$key};#d#
325 # wake up all waiters, to be on the safe side
326 $_->ready for @{ delete $LOCK{$key} };
327 }
328}
329
330sub lock_active($) {
331 my ($key) = @_;
332
333 ! ! $LOCK{$key}
334}
335
336sub freeze_mainloop {
337 return unless $TICK_WATCHER->is_active;
338
339 my $guard = Coro::guard {
340 $TICK_WATCHER->start;
341 };
342 $TICK_WATCHER->stop;
343 $guard
344}
345
346=item cf::periodic $interval, $cb
347
348Like EV::periodic, but randomly selects a starting point so that the actions
349get spread over timer.
350
351=cut
352
353sub periodic($$) {
354 my ($interval, $cb) = @_;
355
356 my $start = rand List::Util::min 180, $interval;
357
358 EV::periodic $start, $interval, 0, $cb
359}
360
361=item cf::get_slot $time[, $priority[, $name]]
362
363Allocate $time seconds of blocking CPU time at priority C<$priority>:
364This call blocks and returns only when you have at least C<$time> seconds
365of cpu time till the next tick. The slot is only valid till the next cede.
366
367The optional C<$name> can be used to identify the job to run. It might be
368used for statistical purposes and should identify the same time-class.
369
370Useful for short background jobs.
371
372=cut
373
374our @SLOT_QUEUE;
375our $SLOT_QUEUE;
376
377$SLOT_QUEUE->cancel if $SLOT_QUEUE;
378$SLOT_QUEUE = Coro::async {
379 $Coro::current->desc ("timeslot manager");
380
381 my $signal = new Coro::Signal;
382
383 while () {
384 next_job:
385 my $avail = cf::till_tick;
386 if ($avail > 0.01) {
387 for (0 .. $#SLOT_QUEUE) {
388 if ($SLOT_QUEUE[$_][0] < $avail) {
389 my $job = splice @SLOT_QUEUE, $_, 1, ();
390 $job->[2]->send;
391 Coro::cede;
392 goto next_job;
393 }
394 }
395 }
396
397 if (@SLOT_QUEUE) {
398 # we do not use wait_for_tick() as it returns immediately when tick is inactive
399 push @cf::WAIT_FOR_TICK, $signal;
400 $signal->wait;
401 } else {
402 Coro::schedule;
403 }
404 }
405};
406
407sub get_slot($;$$) {
408 my ($time, $pri, $name) = @_;
409
410 $time = $TICK * .6 if $time > $TICK * .6;
411 my $sig = new Coro::Signal;
412
413 push @SLOT_QUEUE, [$time, $pri, $sig, $name];
414 @SLOT_QUEUE = sort { $b->[1] <=> $a->[1] } @SLOT_QUEUE;
415 $SLOT_QUEUE->ready;
416 $sig->wait;
417}
418
419=item cf::async { BLOCK }
420
421Currently the same as Coro::async_pool, meaning you cannot use
422C<on_destroy>, C<join> or other gimmicks on these coroutines. The only
423thing you are allowed to do is call C<prio> on it.
424
425=cut
426
427BEGIN { *async = \&Coro::async_pool }
428
429=item cf::sync_job { BLOCK }
430
431The design of Deliantra requires that the main coroutine ($Coro::main)
432is always able to handle events or runnable, as Deliantra is only
433partly reentrant. Thus "blocking" it by e.g. waiting for I/O is not
434acceptable.
435
436If it must be done, put the blocking parts into C<sync_job>. This will run
437the given BLOCK in another coroutine while waiting for the result. The
438server will be frozen during this time, so the block should either finish
439fast or be very important.
440
441=cut
442
443sub sync_job(&) {
444 my ($job) = @_;
445
446 if ($Coro::current == $Coro::main) {
447 my $time = EV::time;
448
449 # this is the main coro, too bad, we have to block
450 # till the operation succeeds, freezing the server :/
451
452 LOG llevError, Carp::longmess "sync job";#d#
453
454 # TODO: use suspend/resume instead
455 # (but this is cancel-safe)
456 my $freeze_guard = freeze_mainloop;
457
458 my $busy = 1;
459 my @res;
460
461 (async {
462 $Coro::current->desc ("sync job coro");
463 @res = eval { $job->() };
464 warn $@ if $@;
465 undef $busy;
466 })->prio (Coro::PRIO_MAX);
467
468 while ($busy) {
469 if (Coro::nready) {
470 Coro::cede_notself;
471 } else {
472 EV::loop EV::LOOP_ONESHOT;
473 }
474 }
475
476 $time = EV::time - $time;
477
478 LOG llevError | logBacktrace, Carp::longmess "long sync job"
479 if $time > $TICK * 0.5 && $TICK_WATCHER->is_active;
480
481 $tick_start += $time; # do not account sync jobs to server load
482
483 wantarray ? @res : $res[0]
484 } else {
485 # we are in another coroutine, how wonderful, everything just works
486
487 $job->()
488 }
489}
490
491=item $coro = cf::async_ext { BLOCK }
492
493Like async, but this coro is automatically being canceled when the
494extension calling this is being unloaded.
495
496=cut
497
498sub async_ext(&) {
499 my $cb = shift;
500
501 my $coro = &Coro::async ($cb);
502
503 $coro->on_destroy (sub {
504 delete $EXT_CORO{$coro+0};
505 });
506 $EXT_CORO{$coro+0} = $coro;
507
508 $coro
509}
510
511=item fork_call { }, $args
512
513Executes the given code block with the given arguments in a seperate
514process, returning the results. Everything must be serialisable with
515Coro::Storable. May, of course, block. Note that the executed sub may
516never block itself or use any form of event handling.
517
518=cut
519
520sub fork_call(&@) {
521 my ($cb, @args) = @_;
522
523 # we seemingly have to make a local copy of the whole thing,
524 # otherwise perl prematurely frees the stuff :/
525 # TODO: investigate and fix (likely this will be rather laborious)
526
527 my @res = Coro::Util::fork_eval {
528 reset_signals;
529 &$cb
530 }, @args;
531
532 wantarray ? @res : $res[-1]
533}
534
535=item $value = cf::db_get $family => $key
536
537Returns a single value from the environment database.
538
539=item cf::db_put $family => $key => $value
540
541Stores the given C<$value> in the family. It can currently store binary
542data only (use Compress::LZF::sfreeze_cr/sthaw to convert to/from binary).
543
544=item $db = cf::db_table "name"
545
546Create and/or open a new database table. The string must not be "db" and must be unique
547within each server.
548
549=cut
550
551sub db_table($) {
552 my ($name) = @_;
553 my $db = BDB::db_create $DB_ENV;
554
555 eval {
556 $db->set_flags (BDB::CHKSUM);
557
558 utf8::encode $name;
559 BDB::db_open $db, undef, $name, undef, BDB::BTREE,
560 BDB::CREATE | BDB::AUTO_COMMIT, 0666;
561 cf::cleanup "db_open(db): $!" if $!;
562 };
563 cf::cleanup "db_open(db): $@" if $@;
564
565 $db
566}
567
568our $DB;
569
570sub db_init {
571 cf::sync_job {
572 $DB ||= db_table "db";
573 };
574}
575
576sub db_get($$) {
577 my $key = "$_[0]/$_[1]";
578
579 cf::sync_job {
580 BDB::db_get $DB, undef, $key, my $data;
581
582 $! ? ()
583 : $data
584 }
585}
586
587sub db_put($$$) {
588 BDB::dbreq_pri 4;
589 BDB::db_put $DB, undef, "$_[0]/$_[1]", $_[2], 0, sub { };
590}
591
592=item cf::cache $id => [$paths...], $processversion => $process
593
594Generic caching function that returns the value of the resource $id,
595caching and regenerating as required.
596
597This function can block.
598
599=cut
600
601sub cache {
602 my ($id, $src, $processversion, $process) = @_;
603
604 my $meta =
605 join "\x00",
606 $processversion,
607 map {
608 aio_stat $_
609 and Carp::croak "$_: $!";
610
611 ($_, (stat _)[7,9])
612 } @$src;
613
614 my $dbmeta = db_get cache => "$id/meta";
615 if ($dbmeta ne $meta) {
616 # changed, we may need to process
617
618 my @data;
619 my $md5;
620
621 for (0 .. $#$src) {
622 0 <= aio_load $src->[$_], $data[$_]
623 or Carp::croak "$src->[$_]: $!";
624 }
625
626 # if processing is expensive, check
627 # checksum first
628 if (1) {
629 $md5 =
630 join "\x00",
631 $processversion,
632 map {
633 cf::cede_to_tick;
634 ($src->[$_], Digest::MD5::md5_hex $data[$_])
635 } 0.. $#$src;
636
637
638 my $dbmd5 = db_get cache => "$id/md5";
639 if ($dbmd5 eq $md5) {
640 db_put cache => "$id/meta", $meta;
641
642 return db_get cache => "$id/data";
643 }
644 }
645
646 my $t1 = Time::HiRes::time;
647 my $data = $process->(\@data);
648 my $t2 = Time::HiRes::time;
649
650 warn "cache: '$id' processed in ", $t2 - $t1, "s\n";
651
652 db_put cache => "$id/data", $data;
653 db_put cache => "$id/md5" , $md5;
654 db_put cache => "$id/meta", $meta;
655
656 return $data;
657 }
658
659 db_get cache => "$id/data"
660}
661
662=item cf::datalog type => key => value, ...
663
664Log a datalog packet of the given type with the given key-value pairs.
665
666=cut
667
668sub datalog($@) {
669 my ($type, %kv) = @_;
670 warn "DATALOG ", JSON::XS->new->ascii->encode ({ %kv, type => $type });
129} 671}
130 672
131=back 673=back
132 674
133=cut 675=cut
134 676
135############################################################################# 677#############################################################################
136 678
137=head2 EVENTS AND OBJECT ATTACHMENTS 679=head2 ATTACHABLE OBJECTS
680
681Many objects in crossfire are so-called attachable objects. That means you can
682attach callbacks/event handlers (a collection of which is called an "attachment")
683to it. All such attachable objects support the following methods.
684
685In the following description, CLASS can be any of C<global>, C<object>
686C<player>, C<client> or C<map> (i.e. the attachable objects in
687Deliantra).
138 688
139=over 4 689=over 4
140 690
141=item $object->attach ($attachment, key => $value...)
142
143=item $object->detach ($attachment)
144
145Attach/detach a pre-registered attachment to an object.
146
147=item $player->attach ($attachment, key => $value...)
148
149=item $player->detach ($attachment)
150
151Attach/detach a pre-registered attachment to a player.
152
153=item $map->attach ($attachment, key => $value...)
154
155=item $map->detach ($attachment)
156
157Attach/detach a pre-registered attachment to a client.
158
159=item $client->attach ($attachment, key => $value...) 691=item $attachable->attach ($attachment, key => $value...)
160 692
161=item $client->detach ($attachment) 693=item $attachable->detach ($attachment)
162 694
163Attach/detach a pre-registered attachment to a map. 695Attach/detach a pre-registered attachment to a specific object and give it
696the specified key/value pairs as arguments.
164 697
165=item $bool = $object->attached ($name) 698Example, attach a minesweeper attachment to the given object, making it a
69910x10 minesweeper game:
166 700
167=item $bool = $player->attached ($name) 701 $obj->attach (minesweeper => width => 10, height => 10);
168 702
169=item $bool = $client->attached ($name) 703=item $bool = $attachable->attached ($name)
170
171=item $bool = $map->attached ($name)
172 704
173Checks wether the named attachment is currently attached to the object. 705Checks wether the named attachment is currently attached to the object.
174 706
175=item cf::attach_global ... 707=item cf::CLASS->attach ...
176 708
177Attach handlers for global events. 709=item cf::CLASS->detach ...
178 710
179This and all following C<attach_*>-functions expect any number of the 711Define an anonymous attachment and attach it to all objects of the given
180following handler/hook descriptions: 712CLASS. See the next function for an explanation of its arguments.
713
714You can attach to global events by using the C<cf::global> class.
715
716Example, log all player logins:
717
718 cf::player->attach (
719 on_login => sub {
720 my ($pl) = @_;
721 ...
722 },
723 );
724
725Example, attach to the jeweler skill:
726
727 cf::object->attach (
728 type => cf::SKILL,
729 subtype => cf::SK_JEWELER,
730 on_use_skill => sub {
731 my ($sk, $ob, $part, $dir, $msg) = @_;
732 ...
733 },
734 );
735
736=item cf::CLASS::attachment $name, ...
737
738Register an attachment by C<$name> through which attachable objects of the
739given CLASS can refer to this attachment.
740
741Some classes such as crossfire maps and objects can specify attachments
742that are attached at load/instantiate time, thus the need for a name.
743
744These calls expect any number of the following handler/hook descriptions:
181 745
182=over 4 746=over 4
183 747
184=item prio => $number 748=item prio => $number
185 749
187by another C<prio> setting). Lower priority handlers get executed 751by another C<prio> setting). Lower priority handlers get executed
188earlier. The default priority is C<0>, and many built-in handlers are 752earlier. The default priority is C<0>, and many built-in handlers are
189registered at priority C<-1000>, so lower priorities should not be used 753registered at priority C<-1000>, so lower priorities should not be used
190unless you know what you are doing. 754unless you know what you are doing.
191 755
756=item type => $type
757
758(Only for C<< cf::object->attach >> calls), limits the attachment to the
759given type of objects only (the additional parameter C<subtype> can be
760used to further limit to the given subtype).
761
192=item on_I<event> => \&cb 762=item on_I<event> => \&cb
193 763
194Call the given code reference whenever the named event happens (event is 764Call the given code reference whenever the named event happens (event is
195something like C<instantiate>, C<apply>, C<use_skill> and so on, and which 765something like C<instantiate>, C<apply>, C<use_skill> and so on, and which
196handlers are recognised generally depends on the type of object these 766handlers are recognised generally depends on the type of object these
205package and register them. Only handlers for eevents supported by the 775package and register them. Only handlers for eevents supported by the
206object/class are recognised. 776object/class are recognised.
207 777
208=back 778=back
209 779
210=item cf::attach_to_type $object_type, $subtype, ... 780Example, define an attachment called "sockpuppet" that calls the given
781event handler when a monster attacks:
211 782
212Attach handlers for a specific object type (e.g. TRANSPORT) and 783 cf::object::attachment sockpuppet =>
213subtype. If C<$subtype> is zero or undef, matches all objects of the given 784 on_skill_attack => sub {
214type. 785 my ($self, $victim) = @_;
215 786 ...
216=item cf::attach_to_objects ...
217
218Attach handlers to all objects. Do not use this except for debugging or
219very rare events, as handlers are (obviously) called for I<all> objects in
220the game.
221
222=item cf::attach_to_players ...
223
224Attach handlers to all players.
225
226=item cf::attach_to_clients ...
227
228Attach handlers to all players.
229
230=item cf::attach_to_maps ...
231
232Attach handlers to all maps.
233
234=item cf:register_attachment $name, ...
235
236Register an attachment by name through which objects can refer to this
237attachment.
238
239=item cf:register_player_attachment $name, ...
240
241Register an attachment by name through which players can refer to this
242attachment.
243
244=item cf:register_map_attachment $name, ...
245
246Register an attachment by name through which maps can refer to this
247attachment.
248
249=cut
250
251# the following variables are defined in .xs and must not be re-created
252our @CB_GLOBAL = (); # registry for all global events
253our @CB_OBJECT = (); # all objects (should not be used except in emergency)
254our @CB_PLAYER = ();
255our @CB_CLIENT = ();
256our @CB_TYPE = (); # registry for type (cf-object class) based events
257our @CB_MAP = ();
258
259my %attachment;
260
261sub _attach_cb($\%$$$) {
262 my ($registry, $undo, $event, $prio, $cb) = @_;
263
264 use sort 'stable';
265
266 $cb = [$prio, $cb];
267
268 @{$registry->[$event]} = sort
269 { $a->[0] cmp $b->[0] }
270 @{$registry->[$event] || []}, $cb;
271
272 push @{$undo->{cb}}, [$event, $cb];
273}
274
275# attach handles attaching event callbacks
276# the only thing the caller has to do is pass the correct
277# registry (== where the callback attaches to).
278sub _attach(\@$@) {
279 my ($registry, $klass, @arg) = @_;
280
281 my $prio = 0;
282
283 my %undo = (
284 registry => $registry,
285 cb => [],
286 );
287
288 my %cb_id = map +("on_" . lc $EVENT[$_][0], $_) , grep $EVENT[$_][1] == $klass, 0 .. $#EVENT;
289
290 while (@arg) {
291 my $type = shift @arg;
292
293 if ($type eq "prio") {
294 $prio = shift @arg;
295
296 } elsif ($type eq "package") {
297 my $pkg = shift @arg;
298
299 while (my ($name, $id) = each %cb_id) {
300 if (my $cb = $pkg->can ($name)) {
301 _attach_cb $registry, %undo, $id, $prio, $cb;
302 }
303 } 787 }
304
305 } elsif (exists $cb_id{$type}) {
306 _attach_cb $registry, %undo, $cb_id{$type}, $prio, shift @arg;
307
308 } elsif (ref $type) {
309 warn "attaching objects not supported, ignoring.\n";
310
311 } else {
312 shift @arg;
313 warn "attach argument '$type' not supported, ignoring.\n";
314 }
315 }
316
317 \%undo
318}
319
320sub _attach_attachment {
321 my ($obj, $name, %arg) = @_;
322
323 return if exists $obj->{_attachment}{$name};
324
325 my $res;
326
327 if (my $attach = $attachment{$name}) {
328 my $registry = $obj->registry;
329
330 for (@$attach) {
331 my ($klass, @attach) = @$_;
332 $res = _attach @$registry, $klass, @attach;
333 }
334
335 $obj->{$name} = \%arg;
336 } else {
337 warn "object uses attachment '$name' that is not available, postponing.\n";
338 }
339
340 $obj->{_attachment}{$name} = undef;
341
342 $res->{attachment} = $name;
343 $res
344}
345
346*cf::object::attach =
347*cf::player::attach =
348*cf::client::attach =
349*cf::map::attach = sub {
350 my ($obj, $name, %arg) = @_;
351
352 _attach_attachment $obj, $name, %arg;
353};
354
355# all those should be optimised
356*cf::object::detach =
357*cf::player::detach =
358*cf::client::detach =
359*cf::map::detach = sub {
360 my ($obj, $name) = @_;
361
362 delete $obj->{_attachment}{$name};
363 reattach ($obj);
364};
365
366*cf::object::attached =
367*cf::player::attached =
368*cf::client::attached =
369*cf::map::attached = sub {
370 my ($obj, $name) = @_;
371
372 exists $obj->{_attachment}{$name}
373};
374
375sub attach_global {
376 _attach @CB_GLOBAL, KLASS_GLOBAL, @_
377}
378
379sub attach_to_type {
380 my $type = shift;
381 my $subtype = shift;
382
383 _attach @{$CB_TYPE[$type + $subtype * NUM_SUBTYPES]}, KLASS_OBJECT, @_
384}
385
386sub attach_to_objects {
387 _attach @CB_OBJECT, KLASS_OBJECT, @_
388}
389
390sub attach_to_players {
391 _attach @CB_PLAYER, KLASS_PLAYER, @_
392}
393
394sub attach_to_clients {
395 _attach @CB_CLIENT, KLASS_CLIENT, @_
396}
397
398sub attach_to_maps {
399 _attach @CB_MAP, KLASS_MAP, @_
400}
401
402sub register_attachment {
403 my $name = shift;
404
405 $attachment{$name} = [[KLASS_OBJECT, @_]];
406}
407
408sub register_player_attachment {
409 my $name = shift;
410
411 $attachment{$name} = [[KLASS_PLAYER, @_]];
412}
413
414sub register_client_attachment {
415 my $name = shift;
416
417 $attachment{$name} = [[KLASS_CLIENT, @_]];
418}
419
420sub register_map_attachment {
421 my $name = shift;
422
423 $attachment{$name} = [[KLASS_MAP, @_]];
424}
425
426our $override;
427our @invoke_results = (); # referenced from .xs code. TODO: play tricks with reify and mortals?
428
429sub override {
430 $override = 1;
431 @invoke_results = ();
432}
433
434sub do_invoke {
435 my $event = shift;
436 my $callbacks = shift;
437
438 @invoke_results = ();
439
440 local $override;
441
442 for (@$callbacks) {
443 eval { &{$_->[1]} };
444
445 if ($@) {
446 warn "$@";
447 warn "... while processing $EVENT[$event][0](@_) event, skipping processing altogether.\n";
448 override;
449 }
450
451 return 1 if $override;
452 }
453
454 0 788 }
455}
456 789
457=item $bool = cf::invoke EVENT_GLOBAL_XXX, ... 790=item $attachable->valid
458
459=item $bool = $object->invoke (EVENT_OBJECT_XXX, ...)
460
461=item $bool = $player->invoke (EVENT_PLAYER_XXX, ...)
462
463=item $bool = $client->invoke (EVENT_CLIENT_XXX, ...)
464
465=item $bool = $map->invoke (EVENT_MAP_XXX, ...)
466
467Generate a global/object/player/map-specific event with the given arguments.
468
469This API is preliminary (most likely, the EVENT_KLASS_xxx prefix will be
470removed in future versions), and there is no public API to access override
471results (if you must, access C<@cf::invoke_results> directly).
472
473=back
474
475=cut
476
477#############################################################################
478
479=head2 METHODS VALID FOR ALL CORE OBJECTS
480
481=over 4
482
483=item $object->valid, $player->valid, $client->valid, $map->valid
484 791
485Just because you have a perl object does not mean that the corresponding 792Just because you have a perl object does not mean that the corresponding
486C-level object still exists. If you try to access an object that has no 793C-level object still exists. If you try to access an object that has no
487valid C counterpart anymore you get an exception at runtime. This method 794valid C counterpart anymore you get an exception at runtime. This method
488can be used to test for existence of the C object part without causing an 795can be used to test for existence of the C object part without causing an
489exception. 796exception.
490 797
798=cut
799
800# the following variables are defined in .xs and must not be re-created
801our @CB_GLOBAL = (); # registry for all global events
802our @CB_ATTACHABLE = (); # registry for all attachables
803our @CB_OBJECT = (); # all objects (should not be used except in emergency)
804our @CB_PLAYER = ();
805our @CB_CLIENT = ();
806our @CB_TYPE = (); # registry for type (cf-object class) based events
807our @CB_MAP = ();
808
809my %attachment;
810
811sub cf::attachable::thawer_merge {
812 # simply override everything except _meta
813 local $_[0]{_meta};
814 %{$_[0]} = %{$_[1]};
815}
816
817sub _attach_cb($$$$) {
818 my ($registry, $event, $prio, $cb) = @_;
819
820 use sort 'stable';
821
822 $cb = [$prio, $cb];
823
824 @{$registry->[$event]} = sort
825 { $a->[0] cmp $b->[0] }
826 @{$registry->[$event] || []}, $cb;
827}
828
829# hack
830my %attachable_klass = map +($_ => 1), KLASS_OBJECT, KLASS_CLIENT, KLASS_PLAYER, KLASS_MAP;
831
832# attach handles attaching event callbacks
833# the only thing the caller has to do is pass the correct
834# registry (== where the callback attaches to).
835sub _attach {
836 my ($registry, $klass, @arg) = @_;
837
838 my $object_type;
839 my $prio = 0;
840 my %cb_id = map +("on_" . lc $EVENT[$_][0], $_) , grep $EVENT[$_][1] == $klass, 0 .. $#EVENT;
841
842 #TODO: get rid of this hack
843 if ($attachable_klass{$klass}) {
844 %cb_id = (%cb_id, map +("on_" . lc $EVENT[$_][0], $_) , grep $EVENT[$_][1] == KLASS_ATTACHABLE, 0 .. $#EVENT);
845 }
846
847 while (@arg) {
848 my $type = shift @arg;
849
850 if ($type eq "prio") {
851 $prio = shift @arg;
852
853 } elsif ($type eq "type") {
854 $object_type = shift @arg;
855 $registry = $CB_TYPE[$object_type] ||= [];
856
857 } elsif ($type eq "subtype") {
858 defined $object_type or Carp::croak "subtype specified without type";
859 my $object_subtype = shift @arg;
860 $registry = $CB_TYPE[$object_type + $object_subtype * NUM_TYPES] ||= [];
861
862 } elsif ($type eq "package") {
863 my $pkg = shift @arg;
864
865 while (my ($name, $id) = each %cb_id) {
866 if (my $cb = $pkg->can ($name)) {
867 _attach_cb $registry, $id, $prio, $cb;
868 }
869 }
870
871 } elsif (exists $cb_id{$type}) {
872 _attach_cb $registry, $cb_id{$type}, $prio, shift @arg;
873
874 } elsif (ref $type) {
875 warn "attaching objects not supported, ignoring.\n";
876
877 } else {
878 shift @arg;
879 warn "attach argument '$type' not supported, ignoring.\n";
880 }
881 }
882}
883
884sub _object_attach {
885 my ($obj, $name, %arg) = @_;
886
887 return if exists $obj->{_attachment}{$name};
888
889 if (my $attach = $attachment{$name}) {
890 my $registry = $obj->registry;
891
892 for (@$attach) {
893 my ($klass, @attach) = @$_;
894 _attach $registry, $klass, @attach;
895 }
896
897 $obj->{$name} = \%arg;
898 } else {
899 warn "object uses attachment '$name' which is not available, postponing.\n";
900 }
901
902 $obj->{_attachment}{$name} = undef;
903}
904
905sub cf::attachable::attach {
906 if (ref $_[0]) {
907 _object_attach @_;
908 } else {
909 _attach shift->_attach_registry, @_;
910 }
911 _recalc_want;
912};
913
914# all those should be optimised
915sub cf::attachable::detach {
916 my ($obj, $name) = @_;
917
918 if (ref $obj) {
919 delete $obj->{_attachment}{$name};
920 reattach ($obj);
921 } else {
922 Carp::croak "cannot, currently, detach class attachments";
923 }
924 _recalc_want;
925};
926
927sub cf::attachable::attached {
928 my ($obj, $name) = @_;
929
930 exists $obj->{_attachment}{$name}
931}
932
933for my $klass (qw(ATTACHABLE GLOBAL OBJECT PLAYER CLIENT MAP)) {
934 eval "#line " . __LINE__ . " 'cf.pm'
935 sub cf::\L$klass\E::_attach_registry {
936 (\\\@CB_$klass, KLASS_$klass)
937 }
938
939 sub cf::\L$klass\E::attachment {
940 my \$name = shift;
941
942 \$attachment{\$name} = [[KLASS_$klass, \@_]];
943 }
944 ";
945 die if $@;
946}
947
948our $override;
949our @INVOKE_RESULTS = (); # referenced from .xs code. TODO: play tricks with reify and mortals?
950
951sub override {
952 $override = 1;
953 @INVOKE_RESULTS = (@_);
954}
955
956sub do_invoke {
957 my $event = shift;
958 my $callbacks = shift;
959
960 @INVOKE_RESULTS = ();
961
962 local $override;
963
964 for (@$callbacks) {
965 eval { &{$_->[1]} };
966
967 if ($@) {
968 warn "$@";
969 warn "... while processing $EVENT[$event][0](@_) event, skipping processing altogether.\n";
970 override;
971 }
972
973 return 1 if $override;
974 }
975
976 0
977}
978
979=item $bool = cf::global->invoke (EVENT_CLASS_XXX, ...)
980
981=item $bool = $attachable->invoke (EVENT_CLASS_XXX, ...)
982
983Generate an object-specific event with the given arguments.
984
985This API is preliminary (most likely, the EVENT_CLASS_xxx prefix will be
986removed in future versions), and there is no public API to access override
987results (if you must, access C<@cf::INVOKE_RESULTS> directly).
988
491=back 989=back
492 990
493=cut 991=cut
494
495*cf::object::valid =
496*cf::player::valid =
497*cf::client::valid =
498*cf::map::valid = \&cf::_valid;
499 992
500############################################################################# 993#############################################################################
501# object support 994# object support
502 995
503sub instantiate { 996sub _object_equal($$);
997sub _object_equal($$) {
998 my ($a, $b) = @_;
999
1000 return 0 unless (ref $a) eq (ref $b);
1001
1002 if ("HASH" eq ref $a) {
1003 my @ka = keys %$a;
1004 my @kb = keys %$b;
1005
1006 return 0 if @ka != @kb;
1007
1008 for (0 .. $#ka) {
1009 return 0 unless $ka[$_] eq $kb[$_];
1010 return 0 unless _object_equal $a->{$ka[$_]}, $b->{$kb[$_]};
1011 }
1012
1013 } elsif ("ARRAY" eq ref $a) {
1014
1015 return 0 if @$a != @$b;
1016
1017 for (0 .. $#$a) {
1018 return 0 unless _object_equal $a->[$_], $b->[$_];
1019 }
1020
1021 } elsif ($a ne $b) {
1022 return 0;
1023 }
1024
1025 1
1026}
1027
1028our $SLOW_MERGES;#d#
1029sub _can_merge {
504 my ($obj, $data) = @_; 1030 my ($ob1, $ob2) = @_;
505 1031
506 $data = from_json $data; 1032 ++$SLOW_MERGES;#d#
507 1033
508 for (@$data) { 1034 # we do the slow way here
509 my ($name, $args) = @$_; 1035 return _object_equal $ob1, $ob2
510
511 $obj->attach ($name, %{$args || {} });
512 }
513} 1036}
514 1037
515# basically do the same as instantiate, without calling instantiate
516sub reattach { 1038sub reattach {
1039 # basically do the same as instantiate, without calling instantiate
517 my ($obj) = @_; 1040 my ($obj) = @_;
1041
1042 bless $obj, ref $obj; # re-bless in case extensions have been reloaded
1043
518 my $registry = $obj->registry; 1044 my $registry = $obj->registry;
519 1045
520 @$registry = (); 1046 @$registry = ();
521 1047
522 delete $obj->{_attachment} unless scalar keys %{ $obj->{_attachment} || {} }; 1048 delete $obj->{_attachment} unless scalar keys %{ $obj->{_attachment} || {} };
523 1049
524 for my $name (keys %{ $obj->{_attachment} || {} }) { 1050 for my $name (keys %{ $obj->{_attachment} || {} }) {
525 if (my $attach = $attachment{$name}) { 1051 if (my $attach = $attachment{$name}) {
526 for (@$attach) { 1052 for (@$attach) {
527 my ($klass, @attach) = @$_; 1053 my ($klass, @attach) = @$_;
528 _attach @$registry, $klass, @attach; 1054 _attach $registry, $klass, @attach;
529 } 1055 }
530 } else { 1056 } else {
531 warn "object uses attachment '$name' that is not available, postponing.\n"; 1057 warn "object uses attachment '$name' that is not available, postponing.\n";
532 } 1058 }
533 } 1059 }
534} 1060}
535 1061
536sub object_freezer_save { 1062cf::attachable->attach (
537 my ($filename, $rdata, $objs) = @_;
538
539 if (length $$rdata) {
540 warn sprintf "saving %s (%d,%d)\n",
541 $filename, length $$rdata, scalar @$objs;
542
543 if (open my $fh, ">:raw", "$filename~") {
544 chmod SAVE_MODE, $fh;
545 syswrite $fh, $$rdata;
546 close $fh;
547
548 if (@$objs && open my $fh, ">:raw", "$filename.pst~") {
549 chmod SAVE_MODE, $fh;
550 syswrite $fh, Storable::nfreeze { version => 1, objs => $objs };
551 close $fh;
552 rename "$filename.pst~", "$filename.pst";
553 } else {
554 unlink "$filename.pst";
555 }
556
557 rename "$filename~", $filename;
558 } else {
559 warn "FATAL: $filename~: $!\n";
560 }
561 } else {
562 unlink $filename;
563 unlink "$filename.pst";
564 }
565}
566
567sub object_freezer_as_string {
568 my ($rdata, $objs) = @_;
569
570 use Data::Dumper;
571
572 $$rdata . Dumper $objs
573}
574
575sub object_thawer_load {
576 my ($filename) = @_;
577
578 local $/;
579
580 my $av;
581
582 #TODO: use sysread etc.
583 if (open my $data, "<:raw:perlio", $filename) {
584 $data = <$data>;
585 if (open my $pst, "<:raw:perlio", "$filename.pst") {
586 $av = eval { (Storable::thaw <$pst>)->{objs} };
587 }
588 return ($data, $av);
589 }
590
591 ()
592}
593
594attach_to_objects
595 prio => -1000000, 1063 prio => -1000000,
1064 on_instantiate => sub {
1065 my ($obj, $data) = @_;
1066
1067 $data = decode_json $data;
1068
1069 for (@$data) {
1070 my ($name, $args) = @$_;
1071
1072 $obj->attach ($name, %{$args || {} });
1073 }
1074 },
1075 on_reattach => \&reattach,
596 on_clone => sub { 1076 on_clone => sub {
597 my ($src, $dst) = @_; 1077 my ($src, $dst) = @_;
598 1078
599 @{$dst->registry} = @{$src->registry}; 1079 @{$dst->registry} = @{$src->registry};
600 1080
601 %$dst = %$src; 1081 %$dst = %$src;
602 1082
603 %{$dst->{_attachment}} = %{$src->{_attachment}} 1083 %{$dst->{_attachment}} = %{$src->{_attachment}}
604 if exists $src->{_attachment}; 1084 if exists $src->{_attachment};
605 }, 1085 },
606; 1086);
1087
1088sub object_freezer_save {
1089 my ($filename, $rdata, $objs) = @_;
1090
1091 sync_job {
1092 if (length $$rdata) {
1093 utf8::decode (my $decname = $filename);
1094 warn sprintf "saving %s (%d,%d)\n",
1095 $decname, length $$rdata, scalar @$objs;
1096
1097 if (my $fh = aio_open "$filename~", O_WRONLY | O_CREAT, 0600) {
1098 chmod SAVE_MODE, $fh;
1099 aio_write $fh, 0, (length $$rdata), $$rdata, 0;
1100 aio_fsync $fh if $cf::USE_FSYNC;
1101 close $fh;
1102
1103 if (@$objs) {
1104 if (my $fh = aio_open "$filename.pst~", O_WRONLY | O_CREAT, 0600) {
1105 chmod SAVE_MODE, $fh;
1106 my $data = Coro::Storable::nfreeze { version => 1, objs => $objs };
1107 aio_write $fh, 0, (length $data), $data, 0;
1108 aio_fsync $fh if $cf::USE_FSYNC;
1109 close $fh;
1110 aio_rename "$filename.pst~", "$filename.pst";
1111 }
1112 } else {
1113 aio_unlink "$filename.pst";
1114 }
1115
1116 aio_rename "$filename~", $filename;
1117 } else {
1118 warn "FATAL: $filename~: $!\n";
1119 }
1120 } else {
1121 aio_unlink $filename;
1122 aio_unlink "$filename.pst";
1123 }
1124 };
1125}
1126
1127sub object_freezer_as_string {
1128 my ($rdata, $objs) = @_;
1129
1130 use Data::Dumper;
1131
1132 $$rdata . Dumper $objs
1133}
1134
1135sub object_thawer_load {
1136 my ($filename) = @_;
1137
1138 my ($data, $av);
1139
1140 (aio_load $filename, $data) >= 0
1141 or return;
1142
1143 unless (aio_stat "$filename.pst") {
1144 (aio_load "$filename.pst", $av) >= 0
1145 or return;
1146
1147 my $st = eval { Coro::Storable::thaw $av };
1148 $av = $st->{objs};
1149 }
1150
1151 utf8::decode (my $decname = $filename);
1152 warn sprintf "loading %s (%d,%d)\n",
1153 $decname, length $data, scalar @{$av || []};
1154
1155 ($data, $av)
1156}
1157
1158=head2 COMMAND CALLBACKS
1159
1160=over 4
1161
1162=cut
607 1163
608############################################################################# 1164#############################################################################
609# command handling &c 1165# command handling &c
610 1166
611=item cf::register_command $name => \&callback($ob,$args); 1167=item cf::register_command $name => \&callback($ob,$args);
624 push @{ $COMMAND{$name} }, [$caller, $cb]; 1180 push @{ $COMMAND{$name} }, [$caller, $cb];
625} 1181}
626 1182
627=item cf::register_extcmd $name => \&callback($pl,$packet); 1183=item cf::register_extcmd $name => \&callback($pl,$packet);
628 1184
629Register a callbackf ro execution when the client sends an extcmd packet. 1185Register a callback for execution when the client sends an (synchronous)
1186extcmd packet. Ext commands will be processed in the order they are
1187received by the server, like other user commands. The first argument is
1188the logged-in player. Ext commands can only be processed after a player
1189has logged in successfully.
630 1190
631If the callback returns something, it is sent back as if reply was being 1191If the callback returns something, it is sent back as if reply was being
632called. 1192called.
633 1193
1194=item cf::register_exticmd $name => \&callback($ns,$packet);
1195
1196Register a callback for execution when the client sends an (asynchronous)
1197exticmd packet. Exti commands are processed by the server as soon as they
1198are received, i.e. out of order w.r.t. other commands. The first argument
1199is a client socket. Exti commands can be received anytime, even before
1200log-in.
1201
1202If the callback returns something, it is sent back as if reply was being
1203called.
1204
634=cut 1205=cut
635 1206
636sub register_extcmd { 1207sub register_extcmd {
637 my ($name, $cb) = @_; 1208 my ($name, $cb) = @_;
638 1209
639 my $caller = caller;
640 #warn "registering extcmd '$name' to '$caller'";
641
642 $EXTCMD{$name} = [$cb, $caller]; 1210 $EXTCMD{$name} = $cb;
643} 1211}
644 1212
645attach_to_players 1213sub register_exticmd {
1214 my ($name, $cb) = @_;
1215
1216 $EXTICMD{$name} = $cb;
1217}
1218
1219cf::player->attach (
646 on_command => sub { 1220 on_command => sub {
647 my ($pl, $name, $params) = @_; 1221 my ($pl, $name, $params) = @_;
648 1222
649 my $cb = $COMMAND{$name} 1223 my $cb = $COMMAND{$name}
650 or return; 1224 or return;
656 cf::override; 1230 cf::override;
657 }, 1231 },
658 on_extcmd => sub { 1232 on_extcmd => sub {
659 my ($pl, $buf) = @_; 1233 my ($pl, $buf) = @_;
660 1234
661 my $msg = eval { from_json $buf }; 1235 my $msg = eval { $pl->ns->{json_coder}->decode ($buf) };
662 1236
663 if (ref $msg) { 1237 if (ref $msg) {
1238 my ($type, $reply, @payload) =
1239 "ARRAY" eq ref $msg
1240 ? @$msg
1241 : ($msg->{msgtype}, $msg->{msgid}, %$msg); # TODO: version 1, remove
1242
1243 my @reply;
1244
664 if (my $cb = $EXTCMD{$msg->{msgtype}}) { 1245 if (my $cb = $EXTCMD{$type}) {
665 if (my %reply = $cb->[0]->($pl, $msg)) { 1246 @reply = $cb->($pl, @payload);
666 $pl->ext_reply ($msg->{msgid}, %reply); 1247 }
1248
1249 $pl->ext_reply ($reply, @reply)
1250 if $reply;
1251
1252 } else {
1253 warn "player " . ($pl->ob->name) . " sent unparseable ext message: <$buf>\n";
1254 }
1255
1256 cf::override;
1257 },
1258);
1259
1260sub load_extensions {
1261 cf::sync_job {
1262 my %todo;
1263
1264 for my $path (<$LIBDIR/*.ext>) {
1265 next unless -r $path;
1266
1267 $path =~ /([^\/\\]+)\.ext$/ or die "$path";
1268 my $base = $1;
1269 my $pkg = $1;
1270 $pkg =~ s/[^[:word:]]/_/g;
1271 $pkg = "ext::$pkg";
1272
1273 open my $fh, "<:utf8", $path
1274 or die "$path: $!";
1275
1276 my $source = do { local $/; <$fh> };
1277
1278 my %ext = (
1279 path => $path,
1280 base => $base,
1281 pkg => $pkg,
1282 );
1283
1284 $ext{meta} = { map { (split /=/, $_, 2)[0, 1] } split /\s+/, $1 }
1285 if $source =~ /\A#!.*?perl.*?#\s*(.*)$/m;
1286
1287 $ext{source} =
1288 "package $pkg; use strict; use utf8;\n"
1289 . "#line 1 \"$path\"\n{\n"
1290 . $source
1291 . "\n};\n1";
1292
1293 $todo{$base} = \%ext;
1294 }
1295
1296 my %done;
1297 while (%todo) {
1298 my $progress;
1299
1300 while (my ($k, $v) = each %todo) {
1301 for (split /,\s*/, $v->{meta}{depends}) {
1302 goto skip
1303 unless exists $done{$_};
1304 }
1305
1306 warn "... loading '$k' into '$v->{pkg}'\n";
1307
1308 unless (eval $v->{source}) {
1309 my $msg = $@ ? "$v->{path}: $@\n"
1310 : "$v->{base}: extension inactive.\n";
1311
1312 if (exists $v->{meta}{mandatory}) {
1313 warn $msg;
1314 warn "mandatory extension failed to load, exiting.\n";
1315 exit 1;
1316 }
1317
1318 warn $msg;
1319 }
1320
1321 $done{$k} = delete $todo{$k};
1322 push @EXTS, $v->{pkg};
1323 $progress = 1;
1324 }
1325
1326 skip:
1327 die "cannot load " . (join ", ", keys %todo) . ": unable to resolve dependencies\n"
1328 unless $progress;
1329 }
1330 };
1331}
1332
1333#############################################################################
1334
1335=back
1336
1337=head2 CORE EXTENSIONS
1338
1339Functions and methods that extend core crossfire objects.
1340
1341=cut
1342
1343package cf::player;
1344
1345use Coro::AIO;
1346
1347=head3 cf::player
1348
1349=over 4
1350
1351=item cf::player::num_playing
1352
1353Returns the official number of playing players, as per the Crossfire metaserver rules.
1354
1355=cut
1356
1357sub num_playing {
1358 scalar grep
1359 $_->ob->map
1360 && !$_->hidden
1361 && !$_->ob->flag (cf::FLAG_WIZ),
1362 cf::player::list
1363}
1364
1365=item cf::player::find $login
1366
1367Returns the given player object, loading it if necessary (might block).
1368
1369=cut
1370
1371sub playerdir($) {
1372 "$PLAYERDIR/"
1373 . (ref $_[0] ? $_[0]->ob->name : $_[0])
1374}
1375
1376sub path($) {
1377 my $login = ref $_[0] ? $_[0]->ob->name : $_[0];
1378
1379 (playerdir $login) . "/playerdata"
1380}
1381
1382sub find_active($) {
1383 $cf::PLAYER{$_[0]}
1384 and $cf::PLAYER{$_[0]}->active
1385 and $cf::PLAYER{$_[0]}
1386}
1387
1388sub exists($) {
1389 my ($login) = @_;
1390
1391 $cf::PLAYER{$login}
1392 or cf::sync_job { !aio_stat path $login }
1393}
1394
1395sub find($) {
1396 return $cf::PLAYER{$_[0]} || do {
1397 my $login = $_[0];
1398
1399 my $guard = cf::lock_acquire "user_find:$login";
1400
1401 $cf::PLAYER{$_[0]} || do {
1402 # rename old playerfiles to new ones
1403 #TODO: remove when no longer required
1404 aio_link +(playerdir $login) . "/$login.pl.pst", (playerdir $login) . "/playerdata.pst";
1405 aio_link +(playerdir $login) . "/$login.pl" , (playerdir $login) . "/playerdata";
1406 aio_unlink +(playerdir $login) . "/$login.pl.pst";
1407 aio_unlink +(playerdir $login) . "/$login.pl";
1408
1409 my $f = new_from_file cf::object::thawer path $login
1410 or return;
1411
1412 my $pl = cf::player::load_pl $f
1413 or return;
1414 local $cf::PLAYER_LOADING{$login} = $pl;
1415 $f->resolve_delayed_derefs;
1416 $cf::PLAYER{$login} = $pl
1417 }
1418 }
1419}
1420
1421sub save($) {
1422 my ($pl) = @_;
1423
1424 return if $pl->{deny_save};
1425
1426 my $path = path $pl;
1427 my $guard = cf::lock_acquire "user_save:$path";
1428
1429 return if $pl->{deny_save};
1430
1431 aio_mkdir playerdir $pl, 0770;
1432 $pl->{last_save} = $cf::RUNTIME;
1433
1434 $pl->save_pl ($path);
1435 cf::cede_to_tick;
1436}
1437
1438sub new($) {
1439 my ($login) = @_;
1440
1441 my $self = create;
1442
1443 $self->ob->name ($login);
1444 $self->{deny_save} = 1;
1445
1446 $cf::PLAYER{$login} = $self;
1447
1448 $self
1449}
1450
1451=item $player->send_msg ($channel, $msg, $color, [extra...])
1452
1453=cut
1454
1455sub send_msg {
1456 my $ns = shift->ns
1457 or return;
1458 $ns->send_msg (@_);
1459}
1460
1461=item $pl->quit_character
1462
1463Nukes the player without looking back. If logged in, the connection will
1464be destroyed. May block for a long time.
1465
1466=cut
1467
1468sub quit_character {
1469 my ($pl) = @_;
1470
1471 my $name = $pl->ob->name;
1472
1473 $pl->{deny_save} = 1;
1474 $pl->password ("*"); # this should lock out the player until we nuked the dir
1475
1476 $pl->invoke (cf::EVENT_PLAYER_LOGOUT, 1) if $pl->active;
1477 $pl->deactivate;
1478 $pl->invoke (cf::EVENT_PLAYER_QUIT);
1479 $pl->ns->destroy if $pl->ns;
1480
1481 my $path = playerdir $pl;
1482 my $temp = "$path~$cf::RUNTIME~deleting~";
1483 aio_rename $path, $temp;
1484 delete $cf::PLAYER{$pl->ob->name};
1485 $pl->destroy;
1486
1487 my $prefix = qr<^~\Q$name\E/>;
1488
1489 # nuke player maps
1490 $cf::MAP{$_}->nuke for grep /$prefix/, keys %cf::MAP;
1491
1492 IO::AIO::aio_rmtree $temp;
1493}
1494
1495=item $pl->kick
1496
1497Kicks a player out of the game. This destroys the connection.
1498
1499=cut
1500
1501sub kick {
1502 my ($pl, $kicker) = @_;
1503
1504 $pl->invoke (cf::EVENT_PLAYER_KICK, $kicker);
1505 $pl->killer ("kicked");
1506 $pl->ns->destroy;
1507}
1508
1509=item cf::player::list_logins
1510
1511Returns am arrayref of all valid playernames in the system, can take a
1512while and may block, so not sync_job-capable, ever.
1513
1514=cut
1515
1516sub list_logins {
1517 my $dirs = aio_readdir $PLAYERDIR
1518 or return [];
1519
1520 my @logins;
1521
1522 for my $login (@$dirs) {
1523 my $path = path $login;
1524
1525 # a .pst is a dead give-away for a valid player
1526 unless (-e "$path.pst") {
1527 my $fh = aio_open $path, Fcntl::O_RDONLY, 0 or next;
1528 aio_read $fh, 0, 512, my $buf, 0 or next;
1529 $buf !~ /^password -------------$/m or next; # official not-valid tag
1530 }
1531
1532 utf8::decode $login;
1533 push @logins, $login;
1534 }
1535
1536 \@logins
1537}
1538
1539=item $player->maps
1540
1541Returns an arrayref of map paths that are private for this
1542player. May block.
1543
1544=cut
1545
1546sub maps($) {
1547 my ($pl) = @_;
1548
1549 $pl = ref $pl ? $pl->ob->name : $pl;
1550
1551 my $files = aio_readdir playerdir $pl
1552 or return;
1553
1554 my @paths;
1555
1556 for (@$files) {
1557 utf8::decode $_;
1558 next if /\.(?:pl|pst)$/;
1559 next unless /^$PATH_SEP/o;
1560
1561 push @paths, cf::map::normalise "~$pl/$_";
1562 }
1563
1564 \@paths
1565}
1566
1567=item $protocol_xml = $player->expand_cfpod ($crossfire_pod)
1568
1569Expand crossfire pod fragments into protocol xml.
1570
1571=cut
1572
1573use re 'eval';
1574
1575my $group;
1576my $interior; $interior = qr{
1577 # match a pod interior sequence sans C<< >>
1578 (?:
1579 \ (.*?)\ (?{ $group = $^N })
1580 | < (??{$interior}) >
1581 )
1582}x;
1583
1584sub expand_cfpod {
1585 my ($self, $pod) = @_;
1586
1587 my $xml;
1588
1589 while () {
1590 if ($pod =~ /\G( (?: [^BCGHITU]+ | .(?!<) )+ )/xgcs) {
1591 $group = $1;
1592
1593 $group =~ s/&/&amp;/g;
1594 $group =~ s/</&lt;/g;
1595
1596 $xml .= $group;
1597 } elsif ($pod =~ m%\G
1598 ([BCGHITU])
1599 <
1600 (?:
1601 ([^<>]*) (?{ $group = $^N })
1602 | < $interior >
1603 )
1604 >
1605 %gcsx
1606 ) {
1607 my ($code, $data) = ($1, $group);
1608
1609 if ($code eq "B") {
1610 $xml .= "<b>" . expand_cfpod ($self, $data) . "</b>";
1611 } elsif ($code eq "I") {
1612 $xml .= "<i>" . expand_cfpod ($self, $data) . "</i>";
1613 } elsif ($code eq "U") {
1614 $xml .= "<u>" . expand_cfpod ($self, $data) . "</u>";
1615 } elsif ($code eq "C") {
1616 $xml .= "<tt>" . expand_cfpod ($self, $data) . "</tt>";
1617 } elsif ($code eq "T") {
1618 $xml .= "<big><b>" . expand_cfpod ($self, $data) . "</b></big>";
1619 } elsif ($code eq "G") {
1620 my ($male, $female) = split /\|/, $data;
1621 $data = $self->gender ? $female : $male;
1622 $xml .= expand_cfpod ($self, $data);
1623 } elsif ($code eq "H") {
1624 $xml .= ("<fg name=\"lightblue\">[" . expand_cfpod ($self, $data) . " (Use hintmode to suppress hints)]</fg>",
1625 "<fg name=\"lightblue\">[Hint suppressed, see hintmode]</fg>",
1626 "")
1627 [$self->{hintmode}];
1628 } else {
1629 $xml .= "error processing '$code($data)' directive";
1630 }
1631 } else {
1632 if ($pod =~ /\G(.+)/) {
1633 warn "parse error while expanding $pod (at $1)";
1634 }
1635 last;
1636 }
1637 }
1638
1639 for ($xml) {
1640 # create single paragraphs (very hackish)
1641 s/(?<=\S)\n(?=\w)/ /g;
1642
1643 # compress some whitespace
1644 s/\s+\n/\n/g; # ws line-ends
1645 s/\n\n+/\n/g; # double lines
1646 s/^\n+//; # beginning lines
1647 s/\n+$//; # ending lines
1648 }
1649
1650 $xml
1651}
1652
1653no re 'eval';
1654
1655sub hintmode {
1656 $_[0]{hintmode} = $_[1] if @_ > 1;
1657 $_[0]{hintmode}
1658}
1659
1660=item $player->ext_reply ($msgid, @msg)
1661
1662Sends an ext reply to the player.
1663
1664=cut
1665
1666sub ext_reply($$@) {
1667 my ($self, $id, @msg) = @_;
1668
1669 $self->ns->ext_reply ($id, @msg)
1670}
1671
1672=item $player->ext_msg ($type, @msg)
1673
1674Sends an ext event to the client.
1675
1676=cut
1677
1678sub ext_msg($$@) {
1679 my ($self, $type, @msg) = @_;
1680
1681 $self->ns->ext_msg ($type, @msg);
1682}
1683
1684=head3 cf::region
1685
1686=over 4
1687
1688=cut
1689
1690package cf::region;
1691
1692=item cf::region::find_by_path $path
1693
1694Tries to decuce the likely region for a map knowing only its path.
1695
1696=cut
1697
1698sub find_by_path($) {
1699 my ($path) = @_;
1700
1701 my ($match, $specificity);
1702
1703 for my $region (list) {
1704 if ($region->{match} && $path =~ $region->{match}) {
1705 ($match, $specificity) = ($region, $region->specificity)
1706 if $region->specificity > $specificity;
1707 }
1708 }
1709
1710 $match
1711}
1712
1713=back
1714
1715=head3 cf::map
1716
1717=over 4
1718
1719=cut
1720
1721package cf::map;
1722
1723use Fcntl;
1724use Coro::AIO;
1725
1726use overload
1727 '""' => \&as_string,
1728 fallback => 1;
1729
1730our $MAX_RESET = 3600;
1731our $DEFAULT_RESET = 3000;
1732
1733sub generate_random_map {
1734 my ($self, $rmp) = @_;
1735 # mit "rum" bekleckern, nicht
1736 $self->_create_random_map (
1737 $rmp->{wallstyle}, $rmp->{wall_name}, $rmp->{floorstyle}, $rmp->{monsterstyle},
1738 $rmp->{treasurestyle}, $rmp->{layoutstyle}, $rmp->{doorstyle}, $rmp->{decorstyle},
1739 $rmp->{origin_map}, $rmp->{final_map}, $rmp->{exitstyle}, $rmp->{this_map},
1740 $rmp->{exit_on_final_map},
1741 $rmp->{xsize}, $rmp->{ysize},
1742 $rmp->{expand2x}, $rmp->{layoutoptions1}, $rmp->{layoutoptions2}, $rmp->{layoutoptions3},
1743 $rmp->{symmetry}, $rmp->{difficulty}, $rmp->{difficulty_given}, $rmp->{difficulty_increase},
1744 $rmp->{dungeon_level}, $rmp->{dungeon_depth}, $rmp->{decoroptions}, $rmp->{orientation},
1745 $rmp->{origin_y}, $rmp->{origin_x}, $rmp->{random_seed}, $rmp->{total_map_hp},
1746 $rmp->{map_layout_style}, $rmp->{treasureoptions}, $rmp->{symmetry_used},
1747 (cf::region::find $rmp->{region}), $rmp->{custom}
1748 )
1749}
1750
1751=item cf::map->register ($regex, $prio)
1752
1753Register a handler for the map path matching the given regex at the
1754givne priority (higher is better, built-in handlers have priority 0, the
1755default).
1756
1757=cut
1758
1759sub register {
1760 my (undef, $regex, $prio) = @_;
1761 my $pkg = caller;
1762
1763 no strict;
1764 push @{"$pkg\::ISA"}, __PACKAGE__;
1765
1766 $EXT_MAP{$pkg} = [$prio, qr<$regex>];
1767}
1768
1769# also paths starting with '/'
1770$EXT_MAP{"cf::map"} = [0, qr{^(?=/)}];
1771
1772sub thawer_merge {
1773 my ($self, $merge) = @_;
1774
1775 # we have to keep some variables in memory intact
1776 local $self->{path};
1777 local $self->{load_path};
1778
1779 $self->SUPER::thawer_merge ($merge);
1780}
1781
1782sub normalise {
1783 my ($path, $base) = @_;
1784
1785 $path = "$path"; # make sure its a string
1786
1787 $path =~ s/\.map$//;
1788
1789 # map plan:
1790 #
1791 # /! non-realised random map exit (special hack!)
1792 # {... are special paths that are not being touched
1793 # ?xxx/... are special absolute paths
1794 # ?random/... random maps
1795 # /... normal maps
1796 # ~user/... per-player map of a specific user
1797
1798 $path =~ s/$PATH_SEP/\//go;
1799
1800 # treat it as relative path if it starts with
1801 # something that looks reasonable
1802 if ($path =~ m{^(?:\./|\.\./|\w)}) {
1803 $base or Carp::carp "normalise called with relative path and no base: '$path'";
1804
1805 $base =~ s{[^/]+/?$}{};
1806 $path = "$base/$path";
1807 }
1808
1809 for ($path) {
1810 redo if s{//}{/};
1811 redo if s{/\.?/}{/};
1812 redo if s{/[^/]+/\.\./}{/};
1813 }
1814
1815 $path
1816}
1817
1818sub new_from_path {
1819 my (undef, $path, $base) = @_;
1820
1821 return $path if UNIVERSAL::isa $path, "cf::map"; # already a map object
1822
1823 $path = normalise $path, $base;
1824
1825 for my $pkg (sort { $EXT_MAP{$b}[0] <=> $EXT_MAP{$a}[0] } keys %EXT_MAP) {
1826 if ($path =~ $EXT_MAP{$pkg}[1]) {
1827 my $self = bless cf::map::new, $pkg;
1828 $self->{path} = $path; $self->path ($path);
1829 $self->init; # pass $1 etc.
1830 return $self;
1831 }
1832 }
1833
1834 Carp::cluck "unable to resolve path '$path' (base '$base').";
1835 ()
1836}
1837
1838sub init {
1839 my ($self) = @_;
1840
1841 $self
1842}
1843
1844sub as_string {
1845 my ($self) = @_;
1846
1847 "$self->{path}"
1848}
1849
1850# the displayed name, this is a one way mapping
1851sub visible_name {
1852 &as_string
1853}
1854
1855# the original (read-only) location
1856sub load_path {
1857 my ($self) = @_;
1858
1859 "$MAPDIR/$self->{path}.map"
1860}
1861
1862# the temporary/swap location
1863sub save_path {
1864 my ($self) = @_;
1865
1866 (my $path = $_[0]{path}) =~ s/\//$PATH_SEP/g;
1867 "$TMPDIR/$path.map"
1868}
1869
1870# the unique path, undef == no special unique path
1871sub uniq_path {
1872 my ($self) = @_;
1873
1874 (my $path = $_[0]{path}) =~ s/\//$PATH_SEP/g;
1875 "$UNIQUEDIR/$path"
1876}
1877
1878# and all this just because we cannot iterate over
1879# all maps in C++...
1880sub change_all_map_light {
1881 my ($change) = @_;
1882
1883 $_->change_map_light ($change)
1884 for grep $_->outdoor, values %cf::MAP;
1885}
1886
1887sub decay_objects {
1888 my ($self) = @_;
1889
1890 return if $self->{deny_reset};
1891
1892 $self->do_decay_objects;
1893}
1894
1895sub unlink_save {
1896 my ($self) = @_;
1897
1898 utf8::encode (my $save = $self->save_path);
1899 IO::AIO::aioreq_pri 4; Coro::AIO::aio_unlink $save;
1900 IO::AIO::aioreq_pri 4; Coro::AIO::aio_unlink "$save.pst";
1901}
1902
1903sub load_header_from($) {
1904 my ($self, $path) = @_;
1905
1906 utf8::encode $path;
1907 my $f = new_from_file cf::object::thawer $path
1908 or return;
1909
1910 $self->_load_header ($f)
1911 or return;
1912
1913 local $MAP_LOADING{$self->{path}} = $self;
1914 $f->resolve_delayed_derefs;
1915
1916 $self->{load_path} = $path;
1917
1918 1
1919}
1920
1921sub load_header_orig {
1922 my ($self) = @_;
1923
1924 $self->load_header_from ($self->load_path)
1925}
1926
1927sub load_header_temp {
1928 my ($self) = @_;
1929
1930 $self->load_header_from ($self->save_path)
1931}
1932
1933sub prepare_temp {
1934 my ($self) = @_;
1935
1936 $self->last_access ((delete $self->{last_access})
1937 || $cf::RUNTIME); #d#
1938 # safety
1939 $self->{instantiate_time} = $cf::RUNTIME
1940 if $self->{instantiate_time} > $cf::RUNTIME;
1941}
1942
1943sub prepare_orig {
1944 my ($self) = @_;
1945
1946 $self->{load_original} = 1;
1947 $self->{instantiate_time} = $cf::RUNTIME;
1948 $self->last_access ($cf::RUNTIME);
1949 $self->instantiate;
1950}
1951
1952sub load_header {
1953 my ($self) = @_;
1954
1955 if ($self->load_header_temp) {
1956 $self->prepare_temp;
1957 } else {
1958 $self->load_header_orig
1959 or return;
1960 $self->prepare_orig;
1961 }
1962
1963 $self->{deny_reset} = 1
1964 if $self->no_reset;
1965
1966 $self->default_region (cf::region::find_by_path $self->{path})
1967 unless $self->default_region;
1968
1969 1
1970}
1971
1972sub find;
1973sub find {
1974 my ($path, $origin) = @_;
1975
1976 $path = normalise $path, $origin && $origin->path;
1977
1978 cf::lock_wait "map_data:$path";#d#remove
1979 cf::lock_wait "map_find:$path";
1980
1981 $cf::MAP{$path} || do {
1982 my $guard1 = cf::lock_acquire "map_find:$path";
1983 my $guard2 = cf::lock_acquire "map_data:$path"; # just for the fun of it
1984
1985 my $map = new_from_path cf::map $path
1986 or return;
1987
1988 $map->{last_save} = $cf::RUNTIME;
1989
1990 $map->load_header
1991 or return;
1992
1993 if ($map->should_reset) {#d#TODO# disabled, crashy (locking issue?)
1994 # doing this can freeze the server in a sync job, obviously
1995 #$cf::WAIT_FOR_TICK->wait;
1996 undef $guard1;
1997 undef $guard2;
1998 $map->reset;
1999 return find $path;
2000 }
2001
2002 $cf::MAP{$path} = $map
2003 }
2004}
2005
2006sub pre_load { }
2007sub post_load { }
2008
2009sub load {
2010 my ($self) = @_;
2011
2012 local $self->{deny_reset} = 1; # loading can take a long time
2013
2014 my $path = $self->{path};
2015
2016 {
2017 my $guard = cf::lock_acquire "map_data:$path";
2018
2019 return unless $self->valid;
2020 return unless $self->in_memory == cf::MAP_SWAPPED;
2021
2022 $self->in_memory (cf::MAP_LOADING);
2023
2024 $self->alloc;
2025
2026 $self->pre_load;
2027 cf::cede_to_tick;
2028
2029 my $f = new_from_file cf::object::thawer $self->{load_path};
2030 $f->skip_block;
2031 $self->_load_objects ($f)
2032 or return;
2033
2034 $self->set_object_flag (cf::FLAG_OBJ_ORIGINAL, 1)
2035 if delete $self->{load_original};
2036
2037 if (my $uniq = $self->uniq_path) {
2038 utf8::encode $uniq;
2039 unless (aio_stat $uniq) {
2040 if (my $f = new_from_file cf::object::thawer $uniq) {
2041 $self->clear_unique_items;
2042 $self->_load_objects ($f);
2043 $f->resolve_delayed_derefs;
667 } 2044 }
668 } 2045 }
669 } else {
670 warn "player " . ($pl->ob->name) . " sent unparseable ext message: <$buf>\n";
671 } 2046 }
672 2047
673 cf::override; 2048 $f->resolve_delayed_derefs;
2049
2050 cf::cede_to_tick;
2051 # now do the right thing for maps
2052 $self->link_multipart_objects;
2053 $self->difficulty ($self->estimate_difficulty)
2054 unless $self->difficulty;
2055 cf::cede_to_tick;
2056
2057 unless ($self->{deny_activate}) {
2058 $self->decay_objects;
2059 $self->fix_auto_apply;
2060 $self->update_buttons;
2061 cf::cede_to_tick;
2062 $self->set_darkness_map;
2063 cf::cede_to_tick;
2064 $self->activate;
2065 }
2066
2067 $self->{last_save} = $cf::RUNTIME;
2068 $self->last_access ($cf::RUNTIME);
2069
2070 $self->in_memory (cf::MAP_IN_MEMORY);
674 }, 2071 }
675;
676 2072
677sub register { 2073 $self->post_load;
2074}
2075
2076sub customise_for {
678 my ($base, $pkg) = @_; 2077 my ($self, $ob) = @_;
679 2078
680 #TODO 2079 return find "~" . $ob->name . "/" . $self->{path}
681} 2080 if $self->per_player;
682 2081
683sub load_extension { 2082# return find "?party/" . $ob->name . "/" . $self->{path}
684 my ($path) = @_; 2083# if $self->per_party;
685 2084
686 $path =~ /([^\/\\]+)\.ext$/ or die "$path"; 2085 $self
687 my $base = $1;
688 my $pkg = $1;
689 $pkg =~ s/[^[:word:]]/_/g;
690 $pkg = "ext::$pkg";
691
692 warn "loading '$path' into '$pkg'\n";
693
694 open my $fh, "<:utf8", $path
695 or die "$path: $!";
696
697 my $source =
698 "package $pkg; use strict; use utf8;\n"
699 . "#line 1 \"$path\"\n{\n"
700 . (do { local $/; <$fh> })
701 . "\n};\n1";
702
703 eval $source
704 or die $@ ? "$path: $@\n"
705 : "extension disabled.\n";
706
707 push @exts, $pkg;
708 $ext_pkg{$base} = $pkg;
709
710# no strict 'refs';
711# @{"$pkg\::ISA"} = ext::;
712
713 register $base, $pkg;
714} 2086}
715 2087
716sub unload_extension { 2088# find and load all maps in the 3x3 area around a map
717 my ($pkg) = @_; 2089sub load_neighbours {
718
719 warn "removing extension $pkg\n";
720
721 # remove hooks
722 #TODO
723# for my $idx (0 .. $#PLUGIN_EVENT) {
724# delete $hook[$idx]{$pkg};
725# }
726
727 # remove commands
728 for my $name (keys %COMMAND) {
729 my @cb = grep $_->[0] ne $pkg, @{ $COMMAND{$name} };
730
731 if (@cb) {
732 $COMMAND{$name} = \@cb;
733 } else {
734 delete $COMMAND{$name};
735 }
736 }
737
738 # remove extcmds
739 for my $name (grep $EXTCMD{$_}[1] eq $pkg, keys %EXTCMD) {
740 delete $EXTCMD{$name};
741 }
742
743 if (my $cb = $pkg->can ("unload")) {
744 eval {
745 $cb->($pkg);
746 1
747 } or warn "$pkg unloaded, but with errors: $@";
748 }
749
750 Symbol::delete_package $pkg;
751}
752
753sub load_extensions {
754 for my $ext (<$LIBDIR/*.ext>) {
755 next unless -r $ext;
756 eval {
757 load_extension $ext;
758 1
759 } or warn "$ext not loaded: $@";
760 }
761}
762
763#############################################################################
764# load/save/clean perl data associated with a map
765
766*cf::mapsupport::on_clean = sub {
767 my ($map) = @_; 2090 my ($map) = @_;
768 2091
769 my $path = $map->tmpname; 2092 my @neigh; # diagonal neighbours
770 defined $path or return;
771 2093
772 unlink "$path.pst"; 2094 for (0 .. 3) {
773}; 2095 my $neigh = $map->tile_path ($_)
2096 or next;
2097 $neigh = find $neigh, $map
2098 or next;
2099 $neigh->load;
774 2100
775attach_to_maps prio => -10000, package => cf::mapsupport::; 2101 push @neigh,
2102 [$neigh->tile_path (($_ + 3) % 4), $neigh],
2103 [$neigh->tile_path (($_ + 1) % 4), $neigh];
2104 }
776 2105
777############################################################################# 2106 for (grep defined $_->[0], @neigh) {
778# load/save perl data associated with player->ob objects 2107 my ($path, $origin) = @$_;
779 2108 my $neigh = find $path, $origin
780sub all_objects(@) { 2109 or next;
781 @_, map all_objects ($_->inv), @_ 2110 $neigh->load;
2111 }
782} 2112}
783 2113
784# TODO: compatibility cruft, remove when no longer needed 2114sub find_sync {
785attach_to_players 2115 my ($path, $origin) = @_;
786 on_load => sub {
787 my ($pl, $path) = @_;
788 2116
789 for my $o (all_objects $pl->ob) { 2117 cf::sync_job { find $path, $origin }
790 if (my $value = $o->get_ob_key_value ("_perl_data")) { 2118}
791 $o->set_ob_key_value ("_perl_data");
792 2119
793 %$o = %{ Storable::thaw pack "H*", $value }; 2120sub do_load_sync {
2121 my ($map) = @_;
2122
2123 cf::LOG cf::llevDebug | cf::logBacktrace, "do_load_sync"
2124 if $Coro::current == $Coro::main;
2125
2126 cf::sync_job { $map->load };
2127}
2128
2129our %MAP_PREFETCH;
2130our $MAP_PREFETCHER = undef;
2131
2132sub find_async {
2133 my ($path, $origin, $load) = @_;
2134
2135 $path = normalise $path, $origin && $origin->{path};
2136
2137 if (my $map = $cf::MAP{$path}) {
2138 return $map if !$load || $map->in_memory == cf::MAP_IN_MEMORY;
2139 }
2140
2141 $MAP_PREFETCH{$path} |= $load;
2142
2143 $MAP_PREFETCHER ||= cf::async {
2144 $Coro::current->{desc} = "map prefetcher";
2145
2146 while (%MAP_PREFETCH) {
2147 while (my ($k, $v) = each %MAP_PREFETCH) {
2148 if (my $map = find $k) {
2149 $map->load if $v;
2150 }
2151
2152 delete $MAP_PREFETCH{$k};
794 } 2153 }
795 } 2154 }
2155 undef $MAP_PREFETCHER;
2156 };
2157 $MAP_PREFETCHER->prio (6);
2158
2159 ()
2160}
2161
2162sub save {
2163 my ($self) = @_;
2164
2165 my $lock = cf::lock_acquire "map_data:$self->{path}";
2166
2167 $self->{last_save} = $cf::RUNTIME;
2168
2169 return unless $self->dirty;
2170
2171 my $save = $self->save_path; utf8::encode $save;
2172 my $uniq = $self->uniq_path; utf8::encode $uniq;
2173
2174 $self->{load_path} = $save;
2175
2176 return if $self->{deny_save};
2177
2178 local $self->{last_access} = $self->last_access;#d#
2179
2180 cf::async {
2181 $Coro::current->{desc} = "map player save";
2182 $_->contr->save for $self->players;
2183 };
2184
2185 if ($uniq) {
2186 $self->_save_objects ($save, cf::IO_HEADER | cf::IO_OBJECTS);
2187 $self->_save_objects ($uniq, cf::IO_UNIQUES);
2188 } else {
2189 $self->_save_objects ($save, cf::IO_HEADER | cf::IO_OBJECTS | cf::IO_UNIQUES);
796 }, 2190 }
797; 2191}
798 2192
799############################################################################# 2193sub swap_out {
2194 my ($self) = @_;
800 2195
801=head2 CORE EXTENSIONS 2196 # save first because save cedes
2197 $self->save;
802 2198
803Functions and methods that extend core crossfire objects. 2199 my $lock = cf::lock_acquire "map_data:$self->{path}";
2200
2201 return if $self->players;
2202 return if $self->in_memory != cf::MAP_IN_MEMORY;
2203 return if $self->{deny_save};
2204
2205 $self->in_memory (cf::MAP_SWAPPED);
2206
2207 $self->deactivate;
2208 $_->clear_links_to ($self) for values %cf::MAP;
2209 $self->clear;
2210}
2211
2212sub reset_at {
2213 my ($self) = @_;
2214
2215 # TODO: safety, remove and allow resettable per-player maps
2216 return 1e99 if $self->{deny_reset};
2217
2218 my $time = $self->fixed_resettime ? $self->{instantiate_time} : $self->last_access;
2219 my $to = List::Util::min $MAX_RESET, $self->reset_timeout || $DEFAULT_RESET;
2220
2221 $time + $to
2222}
2223
2224sub should_reset {
2225 my ($self) = @_;
2226
2227 $self->reset_at <= $cf::RUNTIME
2228}
2229
2230sub reset {
2231 my ($self) = @_;
2232
2233 my $lock = cf::lock_acquire "map_data:$self->{path}";
2234
2235 return if $self->players;
2236
2237 warn "resetting map ", $self->path;
2238
2239 $self->in_memory (cf::MAP_SWAPPED);
2240
2241 # need to save uniques path
2242 unless ($self->{deny_save}) {
2243 my $uniq = $self->uniq_path; utf8::encode $uniq;
2244
2245 $self->_save_objects ($uniq, cf::IO_UNIQUES)
2246 if $uniq;
2247 }
2248
2249 delete $cf::MAP{$self->path};
2250
2251 $self->deactivate;
2252 $_->clear_links_to ($self) for values %cf::MAP;
2253 $self->clear;
2254
2255 $self->unlink_save;
2256 $self->destroy;
2257}
2258
2259my $nuke_counter = "aaaa";
2260
2261sub nuke {
2262 my ($self) = @_;
2263
2264 {
2265 my $lock = cf::lock_acquire "map_data:$self->{path}";
2266
2267 delete $cf::MAP{$self->path};
2268
2269 $self->unlink_save;
2270
2271 bless $self, "cf::map";
2272 delete $self->{deny_reset};
2273 $self->{deny_save} = 1;
2274 $self->reset_timeout (1);
2275 $self->path ($self->{path} = "{nuke}/" . ($nuke_counter++));
2276
2277 $cf::MAP{$self->path} = $self;
2278 }
2279
2280 $self->reset; # polite request, might not happen
2281}
2282
2283=item $maps = cf::map::tmp_maps
2284
2285Returns an arrayref with all map paths of currently instantiated and saved
2286maps. May block.
2287
2288=cut
2289
2290sub tmp_maps() {
2291 [
2292 map {
2293 utf8::decode $_;
2294 /\.map$/
2295 ? normalise $_
2296 : ()
2297 } @{ aio_readdir $TMPDIR or [] }
2298 ]
2299}
2300
2301=item $maps = cf::map::random_maps
2302
2303Returns an arrayref with all map paths of currently instantiated and saved
2304random maps. May block.
2305
2306=cut
2307
2308sub random_maps() {
2309 [
2310 map {
2311 utf8::decode $_;
2312 /\.map$/
2313 ? normalise "?random/$_"
2314 : ()
2315 } @{ aio_readdir $RANDOMDIR or [] }
2316 ]
2317}
2318
2319=item cf::map::unique_maps
2320
2321Returns an arrayref of paths of all shared maps that have
2322instantiated unique items. May block.
2323
2324=cut
2325
2326sub unique_maps() {
2327 [
2328 map {
2329 utf8::decode $_;
2330 /\.map$/
2331 ? normalise $_
2332 : ()
2333 } @{ aio_readdir $UNIQUEDIR or [] }
2334 ]
2335}
2336
2337package cf;
2338
2339=back
2340
2341=head3 cf::object
2342
2343=cut
2344
2345package cf::object;
804 2346
805=over 4 2347=over 4
806 2348
807=item cf::player::exists $login 2349=item $ob->inv_recursive
808 2350
809Returns true when the given account exists. 2351Returns the inventory of the object _and_ their inventories, recursively.
810 2352
811=cut 2353=cut
812 2354
813sub cf::player::exists($) { 2355sub inv_recursive_;
814 cf::player::find $_[0] 2356sub inv_recursive_ {
815 or -f sprintf "%s/%s/%s/%s.pl", cf::localdir, cf::playerdir, ($_[0]) x 2; 2357 map { $_, inv_recursive_ $_->inv } @_
816} 2358}
2359
2360sub inv_recursive {
2361 inv_recursive_ inv $_[0]
2362}
2363
2364=item $ref = $ob->ref
2365
2366creates and returns a persistent reference to an objetc that can be stored as a string.
2367
2368=item $ob = cf::object::deref ($refstring)
2369
2370returns the objetc referenced by refstring. may return undef when it cnanot find the object,
2371even if the object actually exists. May block.
2372
2373=cut
2374
2375sub deref {
2376 my ($ref) = @_;
2377
2378 if ($ref =~ m{^player\/(<1\.[0-9a-f]+>)/(.*)$}) {
2379 my ($uuid, $name) = ($1, $2);
2380 my $pl = $cf::PLAYER_LOADING{$name} || cf::player::find $name
2381 or return;
2382 $pl->ob->uuid eq $uuid
2383 or return;
2384
2385 $pl->ob
2386 } else {
2387 warn "$ref: cannot resolve object reference\n";
2388 undef
2389 }
2390}
2391
2392package cf;
2393
2394=back
2395
2396=head3 cf::object::player
2397
2398=over 4
817 2399
818=item $player_object->reply ($npc, $msg[, $flags]) 2400=item $player_object->reply ($npc, $msg[, $flags])
819 2401
820Sends a message to the player, as if the npc C<$npc> replied. C<$npc> 2402Sends a message to the player, as if the npc C<$npc> replied. C<$npc>
821can be C<undef>. Does the right thing when the player is currently in a 2403can be C<undef>. Does the right thing when the player is currently in a
823 2405
824=cut 2406=cut
825 2407
826# rough implementation of a future "reply" method that works 2408# rough implementation of a future "reply" method that works
827# with dialog boxes. 2409# with dialog boxes.
2410#TODO: the first argument must go, split into a $npc->reply_to ( method
828sub cf::object::player::reply($$$;$) { 2411sub cf::object::player::reply($$$;$) {
829 my ($self, $npc, $msg, $flags) = @_; 2412 my ($self, $npc, $msg, $flags) = @_;
830 2413
831 $flags = cf::NDI_BROWN | cf::NDI_UNIQUE unless @_ >= 4; 2414 $flags = cf::NDI_BROWN | cf::NDI_UNIQUE unless @_ >= 4;
832 2415
833 if ($self->{record_replies}) { 2416 if ($self->{record_replies}) {
834 push @{ $self->{record_replies} }, [$npc, $msg, $flags]; 2417 push @{ $self->{record_replies} }, [$npc, $msg, $flags];
2418
835 } else { 2419 } else {
2420 my $pl = $self->contr;
2421
2422 if ($pl->{npc_dialog} && $pl->{npc_dialog}->{id}) {
2423 my $dialog = $pl->{npc_dialog};
2424 $dialog->{pl}->ext_msg ($dialog->{id}, update => msg => $dialog->{pl}->expand_cfpod ($msg));
2425
2426 } else {
836 $msg = $npc->name . " says: $msg" if $npc; 2427 $msg = $npc->name . " says: $msg" if $npc;
837 $self->message ($msg, $flags); 2428 $self->message ($msg, $flags);
2429 }
838 } 2430 }
839} 2431}
840 2432
841=item $player->ext_reply ($msgid, $msgtype, %msg) 2433=item $object->send_msg ($channel, $msg, $color, [extra...])
842 2434
843Sends an ext reply to the player.
844
845=cut 2435=cut
846 2436
847sub cf::player::ext_reply($$$%) { 2437sub cf::object::send_msg {
848 my ($self, $id, %msg) = @_; 2438 my $pl = shift->contr
849 2439 or return;
850 $msg{msgid} = $id; 2440 $pl->send_msg (@_);
851
852 $self->send ("ext " . to_json \%msg);
853} 2441}
854 2442
855=item $player_object->may ("access") 2443=item $player_object->may ("access")
856 2444
857Returns wether the given player is authorized to access resource "access" 2445Returns wether the given player is authorized to access resource "access"
866 (ref $cf::CFG{"may_$access"} 2454 (ref $cf::CFG{"may_$access"}
867 ? scalar grep $self->name eq $_, @{$cf::CFG{"may_$access"}} 2455 ? scalar grep $self->name eq $_, @{$cf::CFG{"may_$access"}}
868 : $cf::CFG{"may_$access"}) 2456 : $cf::CFG{"may_$access"})
869} 2457}
870 2458
871=cut 2459=item $player_object->enter_link
872 2460
873############################################################################# 2461Freezes the player and moves him/her to a special map (C<{link}>).
2462
2463The player should be reasonably safe there for short amounts of time. You
2464I<MUST> call C<leave_link> as soon as possible, though.
2465
2466Will never block.
2467
2468=item $player_object->leave_link ($map, $x, $y)
2469
2470Moves the player out of the special C<{link}> map onto the specified
2471map. If the map is not valid (or omitted), the player will be moved back
2472to the location he/she was before the call to C<enter_link>, or, if that
2473fails, to the emergency map position.
2474
2475Might block.
2476
2477=cut
2478
2479sub link_map {
2480 unless ($LINK_MAP) {
2481 $LINK_MAP = cf::map::find "{link}"
2482 or cf::cleanup "FATAL: unable to provide {link} map, exiting.";
2483 $LINK_MAP->load;
2484 }
2485
2486 $LINK_MAP
2487}
2488
2489sub cf::object::player::enter_link {
2490 my ($self) = @_;
2491
2492 $self->deactivate_recursive;
2493
2494 return if UNIVERSAL::isa $self->map, "ext::map_link";
2495
2496 $self->{_link_pos} ||= [$self->map->{path}, $self->x, $self->y]
2497 if $self->map && $self->map->{path} ne "{link}";
2498
2499 $self->enter_map ($LINK_MAP || link_map, 10, 10);
2500}
2501
2502sub cf::object::player::leave_link {
2503 my ($self, $map, $x, $y) = @_;
2504
2505 return unless $self->contr->active;
2506
2507 my $link_pos = delete $self->{_link_pos};
2508
2509 unless ($map) {
2510 # restore original map position
2511 ($map, $x, $y) = @{ $link_pos || [] };
2512 $map = cf::map::find $map;
2513
2514 unless ($map) {
2515 ($map, $x, $y) = @$EMERGENCY_POSITION;
2516 $map = cf::map::find $map
2517 or die "FATAL: cannot load emergency map\n";
2518 }
2519 }
2520
2521 ($x, $y) = (-1, -1)
2522 unless (defined $x) && (defined $y);
2523
2524 # use -1 or undef as default coordinates, not 0, 0
2525 ($x, $y) = ($map->enter_x, $map->enter_y)
2526 if $x <=0 && $y <= 0;
2527
2528 $map->load;
2529 $map->load_neighbours;
2530
2531 return unless $self->contr->active;
2532 $self->activate_recursive;
2533
2534 local $self->{_prev_pos} = $link_pos; # ugly hack for rent.ext
2535 $self->enter_map ($map, $x, $y);
2536}
2537
2538=item $player_object->goto ($path, $x, $y[, $check->($map)[, $done->()]])
2539
2540Moves the player to the given map-path and coordinates by first freezing
2541her, loading and preparing them map, calling the provided $check callback
2542that has to return the map if sucecssful, and then unfreezes the player on
2543the new (success) or old (failed) map position. In either case, $done will
2544be called at the end of this process.
2545
2546=cut
2547
2548our $GOTOGEN;
2549
2550sub cf::object::player::goto {
2551 my ($self, $path, $x, $y, $check, $done) = @_;
2552
2553 # do generation counting so two concurrent goto's will be executed in-order
2554 my $gen = $self->{_goto_generation} = ++$GOTOGEN;
2555
2556 $self->enter_link;
2557
2558 (async {
2559 $Coro::current->{desc} = "player::goto $path $x $y";
2560
2561 # *tag paths override both path and x|y
2562 if ($path =~ /^\*(.*)$/) {
2563 if (my @obs = grep $_->map, ext::map_tags::find $1) {
2564 my $ob = $obs[rand @obs];
2565
2566 # see if we actually can go there
2567 if (@obs = grep !$self->blocked ($_->map, $_->x, $_->y), $ob, $ob->tail) {
2568 $ob = $obs[rand @obs];
2569 } else {
2570 $self->message ("Wow, it's pretty crowded in there.", cf::NDI_UNIQUE | cf::NDI_RED);
2571 }
2572 # else put us there anyways for now #d#
2573
2574 ($path, $x, $y) = ($ob->map, $ob->x, $ob->y);
2575 } else {
2576 ($path, $x, $y) = (undef, undef, undef);
2577 }
2578 }
2579
2580 my $map = eval {
2581 my $map = defined $path ? cf::map::find $path : undef;
2582
2583 if ($map) {
2584 $map = $map->customise_for ($self);
2585 $map = $check->($map) if $check && $map;
2586 } else {
2587 $self->message ("The exit to '$path' is closed.", cf::NDI_UNIQUE | cf::NDI_RED);
2588 }
2589
2590 $map
2591 };
2592
2593 if ($@) {
2594 $self->message ("Something went wrong within the server, please report this incident!", cf::NDI_UNIQUE | cf::NDI_RED);
2595 LOG llevError | logBacktrace, Carp::longmess $@;
2596 }
2597
2598 if ($gen == $self->{_goto_generation}) {
2599 delete $self->{_goto_generation};
2600 $self->leave_link ($map, $x, $y);
2601 }
2602
2603 $done->() if $done;
2604 })->prio (1);
2605}
2606
2607=item $player_object->enter_exit ($exit_object)
2608
2609=cut
2610
2611sub parse_random_map_params {
2612 my ($spec) = @_;
2613
2614 my $rmp = { # defaults
2615 xsize => (cf::rndm 15, 40),
2616 ysize => (cf::rndm 15, 40),
2617 symmetry => (cf::rndm 1, cf::SYMMETRY_XY),
2618 #layout => string,
2619 };
2620
2621 for (split /\n/, $spec) {
2622 my ($k, $v) = split /\s+/, $_, 2;
2623
2624 $rmp->{lc $k} = $v if (length $k) && (length $v);
2625 }
2626
2627 $rmp
2628}
2629
2630sub prepare_random_map {
2631 my ($exit) = @_;
2632
2633 my $guard = cf::lock_acquire "exit_prepare:$exit";
2634
2635 # all this does is basically replace the /! path by
2636 # a new random map path (?random/...) with a seed
2637 # that depends on the exit object
2638
2639 my $rmp = parse_random_map_params $exit->msg;
2640
2641 if ($exit->map) {
2642 $rmp->{region} = $exit->region->name;
2643 $rmp->{origin_map} = $exit->map->path;
2644 $rmp->{origin_x} = $exit->x;
2645 $rmp->{origin_y} = $exit->y;
2646 }
2647
2648 $rmp->{random_seed} ||= $exit->random_seed;
2649
2650 my $data = cf::encode_json $rmp;
2651 my $md5 = Digest::MD5::md5_hex $data;
2652 my $meta = "$RANDOMDIR/$md5.meta";
2653
2654 if (my $fh = aio_open "$meta~", O_WRONLY | O_CREAT, 0666) {
2655 aio_write $fh, 0, (length $data), $data, 0;
2656 undef $fh;
2657 aio_rename "$meta~", $meta;
2658
2659 $exit->slaying ("?random/$md5");
2660 $exit->msg (undef);
2661 }
2662}
2663
2664sub cf::object::player::enter_exit {
2665 my ($self, $exit) = @_;
2666
2667 return unless $self->type == cf::PLAYER;
2668
2669 if ($exit->slaying eq "/!") {
2670 #TODO: this should de-fi-ni-te-ly not be a sync-job
2671 # the problem is that $exit might not survive long enough
2672 # so it needs to be done right now, right here
2673 cf::sync_job { prepare_random_map $exit };
2674 }
2675
2676 my $slaying = cf::map::normalise $exit->slaying, $exit->map && $exit->map->path;
2677 my $hp = $exit->stats->hp;
2678 my $sp = $exit->stats->sp;
2679
2680 $self->enter_link;
2681
2682 # if exit is damned, update players death & WoR home-position
2683 $self->contr->savebed ($slaying, $hp, $sp)
2684 if $exit->flag (FLAG_DAMNED);
2685
2686 (async {
2687 $Coro::current->{desc} = "enter_exit $slaying $hp $sp";
2688
2689 $self->deactivate_recursive; # just to be sure
2690 unless (eval {
2691 $self->goto ($slaying, $hp, $sp);
2692
2693 1;
2694 }) {
2695 $self->message ("Something went wrong deep within the crossfire server. "
2696 . "I'll try to bring you back to the map you were before. "
2697 . "Please report this to the dungeon master!",
2698 cf::NDI_UNIQUE | cf::NDI_RED);
2699
2700 warn "ERROR in enter_exit: $@";
2701 $self->leave_link;
2702 }
2703 })->prio (1);
2704}
2705
2706=head3 cf::client
2707
2708=over 4
2709
2710=item $client->send_drawinfo ($text, $flags)
2711
2712Sends a drawinfo packet to the client. Circumvents output buffering so
2713should not be used under normal circumstances.
2714
2715=cut
2716
2717sub cf::client::send_drawinfo {
2718 my ($self, $text, $flags) = @_;
2719
2720 utf8::encode $text;
2721 $self->send_packet (sprintf "drawinfo %d %s", $flags || cf::NDI_BLACK, $text);
2722}
2723
2724=item $client->send_msg ($channel, $msg, $color, [extra...])
2725
2726Send a drawinfo or msg packet to the client, formatting the msg for the
2727client if neccessary. C<$type> should be a string identifying the type of
2728the message, with C<log> being the default. If C<$color> is negative, suppress
2729the message unless the client supports the msg packet.
2730
2731=cut
2732
2733# non-persistent channels (usually the info channel)
2734our %CHANNEL = (
2735 "c/identify" => {
2736 id => "infobox",
2737 title => "Identify",
2738 reply => undef,
2739 tooltip => "Items recently identified",
2740 },
2741 "c/examine" => {
2742 id => "infobox",
2743 title => "Examine",
2744 reply => undef,
2745 tooltip => "Signs and other items you examined",
2746 },
2747 "c/book" => {
2748 id => "infobox",
2749 title => "Book",
2750 reply => undef,
2751 tooltip => "The contents of a note or book",
2752 },
2753 "c/lookat" => {
2754 id => "infobox",
2755 title => "Look",
2756 reply => undef,
2757 tooltip => "What you saw there",
2758 },
2759 "c/who" => {
2760 id => "infobox",
2761 title => "Players",
2762 reply => undef,
2763 tooltip => "Shows players who are currently online",
2764 },
2765 "c/body" => {
2766 id => "infobox",
2767 title => "Body Parts",
2768 reply => undef,
2769 tooltip => "Shows which body parts you posess and are available",
2770 },
2771 "c/uptime" => {
2772 id => "infobox",
2773 title => "Uptime",
2774 reply => undef,
2775 tooltip => "How long the server has been running since last restart",
2776 },
2777 "c/mapinfo" => {
2778 id => "infobox",
2779 title => "Map Info",
2780 reply => undef,
2781 tooltip => "Information related to the maps",
2782 },
2783);
2784
2785sub cf::client::send_msg {
2786 my ($self, $channel, $msg, $color, @extra) = @_;
2787
2788 $msg = $self->pl->expand_cfpod ($msg);
2789
2790 $color &= cf::NDI_CLIENT_MASK; # just in case...
2791
2792 # check predefined channels, for the benefit of C
2793 if ($CHANNEL{$channel}) {
2794 $channel = $CHANNEL{$channel};
2795
2796 $self->ext_msg (channel_info => $channel)
2797 if $self->can_msg;
2798
2799 $channel = $channel->{id};
2800
2801 } elsif (ref $channel) {
2802 # send meta info to client, if not yet sent
2803 unless (exists $self->{channel}{$channel->{id}}) {
2804 $self->{channel}{$channel->{id}} = $channel;
2805 $self->ext_msg (channel_info => $channel)
2806 if $self->can_msg;
2807 }
2808
2809 $channel = $channel->{id};
2810 }
2811
2812 return unless @extra || length $msg;
2813
2814 if ($self->can_msg) {
2815 # default colour, mask it out
2816 $color &= ~(cf::NDI_COLOR_MASK | cf::NDI_DEF)
2817 if $color & cf::NDI_DEF;
2818
2819 $self->send_packet ("msg " . $self->{json_coder}->encode (
2820 [$color & cf::NDI_CLIENT_MASK, $channel, $msg, @extra]));
2821 } else {
2822 if ($color >= 0) {
2823 # replace some tags by gcfclient-compatible ones
2824 for ($msg) {
2825 1 while
2826 s/<b>([^<]*)<\/b>/[b]${1}[\/b]/
2827 || s/<i>([^<]*)<\/i>/[i]${1}[\/i]/
2828 || s/<u>([^<]*)<\/u>/[ul]${1}[\/ul]/
2829 || s/<tt>([^<]*)<\/tt>/[fixed]${1}[\/fixed]/
2830 || s/<fg name=\"([^"]+)\">([^<]*)<\/fg>/[color=$1]${2}[\/color]/;
2831 }
2832
2833 $color &= cf::NDI_COLOR_MASK;
2834
2835 utf8::encode $msg;
2836
2837 if (0 && $msg =~ /\[/) {
2838 # COMMAND/INFO
2839 $self->send_packet ("drawextinfo $color 10 8 $msg")
2840 } else {
2841 $msg =~ s/\[\/?(?:b|i|u|fixed|color)[^\]]*\]//g;
2842 $self->send_packet ("drawinfo $color $msg")
2843 }
2844 }
2845 }
2846}
2847
2848=item $client->ext_msg ($type, @msg)
2849
2850Sends an ext event to the client.
2851
2852=cut
2853
2854sub cf::client::ext_msg($$@) {
2855 my ($self, $type, @msg) = @_;
2856
2857 if ($self->extcmd == 2) {
2858 $self->send_packet ("ext " . $self->{json_coder}->encode ([$type, @msg]));
2859 } elsif ($self->extcmd == 1) { # TODO: remove
2860 push @msg, msgtype => "event_$type";
2861 $self->send_packet ("ext " . $self->{json_coder}->encode ({@msg}));
2862 }
2863}
2864
2865=item $client->ext_reply ($msgid, @msg)
2866
2867Sends an ext reply to the client.
2868
2869=cut
2870
2871sub cf::client::ext_reply($$@) {
2872 my ($self, $id, @msg) = @_;
2873
2874 if ($self->extcmd == 2) {
2875 $self->send_packet ("ext " . $self->{json_coder}->encode (["reply-$id", @msg]));
2876 } elsif ($self->extcmd == 1) {
2877 #TODO: version 1, remove
2878 unshift @msg, msgtype => "reply", msgid => $id;
2879 $self->send_packet ("ext " . $self->{json_coder}->encode ({@msg}));
2880 }
2881}
2882
2883=item $success = $client->query ($flags, "text", \&cb)
2884
2885Queues a query to the client, calling the given callback with
2886the reply text on a reply. flags can be C<cf::CS_QUERY_YESNO>,
2887C<cf::CS_QUERY_SINGLECHAR> or C<cf::CS_QUERY_HIDEINPUT> or C<0>.
2888
2889Queries can fail, so check the return code. Or don't, as queries will
2890become reliable at some point in the future.
2891
2892=cut
2893
2894sub cf::client::query {
2895 my ($self, $flags, $text, $cb) = @_;
2896
2897 return unless $self->state == ST_PLAYING
2898 || $self->state == ST_SETUP
2899 || $self->state == ST_CUSTOM;
2900
2901 $self->state (ST_CUSTOM);
2902
2903 utf8::encode $text;
2904 push @{ $self->{query_queue} }, [(sprintf "query %d %s", $flags, $text), $cb];
2905
2906 $self->send_packet ($self->{query_queue}[0][0])
2907 if @{ $self->{query_queue} } == 1;
2908
2909 1
2910}
2911
2912cf::client->attach (
2913 on_connect => sub {
2914 my ($ns) = @_;
2915
2916 $ns->{json_coder} = JSON::XS->new->utf8->max_size (1e6)->convert_blessed;
2917 },
2918 on_reply => sub {
2919 my ($ns, $msg) = @_;
2920
2921 # this weird shuffling is so that direct followup queries
2922 # get handled first
2923 my $queue = delete $ns->{query_queue}
2924 or return; # be conservative, not sure how that can happen, but we saw a crash here
2925
2926 (shift @$queue)->[1]->($msg);
2927 return unless $ns->valid; # temporary(?) workaround for callback destroying socket
2928
2929 push @{ $ns->{query_queue} }, @$queue;
2930
2931 if (@{ $ns->{query_queue} } == @$queue) {
2932 if (@$queue) {
2933 $ns->send_packet ($ns->{query_queue}[0][0]);
2934 } else {
2935 $ns->state (ST_PLAYING) if $ns->state == ST_CUSTOM;
2936 }
2937 }
2938 },
2939 on_exticmd => sub {
2940 my ($ns, $buf) = @_;
2941
2942 my $msg = eval { $ns->{json_coder}->decode ($buf) };
2943
2944 if (ref $msg) {
2945 my ($type, $reply, @payload) =
2946 "ARRAY" eq ref $msg
2947 ? @$msg
2948 : ($msg->{msgtype}, $msg->{msgid}, %$msg); # TODO: version 1, remove
2949
2950 my @reply;
2951
2952 if (my $cb = $EXTICMD{$type}) {
2953 @reply = $cb->($ns, @payload);
2954 }
2955
2956 $ns->ext_reply ($reply, @reply)
2957 if $reply;
2958
2959 } else {
2960 warn "client " . ($ns->pl ? $ns->pl->ob->name : $ns->host) . " sent unparseable exti message: <$buf>\n";
2961 }
2962
2963 cf::override;
2964 },
2965);
2966
2967=item $client->async (\&cb)
2968
2969Create a new coroutine, running the specified callback. The coroutine will
2970be automatically cancelled when the client gets destroyed (e.g. on logout,
2971or loss of connection).
2972
2973=cut
2974
2975sub cf::client::async {
2976 my ($self, $cb) = @_;
2977
2978 my $coro = &Coro::async ($cb);
2979
2980 $coro->on_destroy (sub {
2981 delete $self->{_coro}{$coro+0};
2982 });
2983
2984 $self->{_coro}{$coro+0} = $coro;
2985
2986 $coro
2987}
2988
2989cf::client->attach (
2990 on_destroy => sub {
2991 my ($ns) = @_;
2992
2993 $_->cancel for values %{ (delete $ns->{_coro}) || {} };
2994 },
2995);
2996
2997=back
2998
874 2999
875=head2 SAFE SCRIPTING 3000=head2 SAFE SCRIPTING
876 3001
877Functions that provide a safe environment to compile and execute 3002Functions that provide a safe environment to compile and execute
878snippets of perl code without them endangering the safety of the server 3003snippets of perl code without them endangering the safety of the server
885our $safe = new Safe "safe"; 3010our $safe = new Safe "safe";
886our $safe_hole = new Safe::Hole; 3011our $safe_hole = new Safe::Hole;
887 3012
888$SIG{FPE} = 'IGNORE'; 3013$SIG{FPE} = 'IGNORE';
889 3014
890$safe->permit_only (Opcode::opset qw(:base_core :base_mem :base_orig :base_math sort time)); 3015$safe->permit_only (Opcode::opset qw(
3016 :base_core :base_mem :base_orig :base_math
3017 grepstart grepwhile mapstart mapwhile
3018 sort time
3019));
891 3020
892# here we export the classes and methods available to script code 3021# here we export the classes and methods available to script code
893 3022
894=pod 3023=pod
895 3024
896The following fucntions and emthods are available within a safe environment: 3025The following functions and methods are available within a safe environment:
897 3026
898 cf::object contr pay_amount pay_player map 3027 cf::object
3028 contr pay_amount pay_player map x y force_find force_add destroy
3029 insert remove name archname title slaying race decrease_ob_nr
3030
899 cf::object::player player 3031 cf::object::player
900 cf::player peaceful 3032 player
901 cf::map trigger 3033
3034 cf::player
3035 peaceful
3036
3037 cf::map
3038 trigger
902 3039
903=cut 3040=cut
904 3041
905for ( 3042for (
906 ["cf::object" => qw(contr pay_amount pay_player map)], 3043 ["cf::object" => qw(contr pay_amount pay_player map force_find force_add x y
3044 insert remove inv name archname title slaying race
3045 decrease_ob_nr destroy)],
907 ["cf::object::player" => qw(player)], 3046 ["cf::object::player" => qw(player)],
908 ["cf::player" => qw(peaceful)], 3047 ["cf::player" => qw(peaceful)],
909 ["cf::map" => qw(trigger)], 3048 ["cf::map" => qw(trigger)],
910) { 3049) {
911 no strict 'refs'; 3050 no strict 'refs';
982=back 3121=back
983 3122
984=cut 3123=cut
985 3124
986############################################################################# 3125#############################################################################
3126# the server's init and main functions
987 3127
988=head2 EXTENSION DATABASE SUPPORT 3128sub load_facedata($) {
3129 my ($path) = @_;
989 3130
990Crossfire maintains a very simple database for extension use. It can 3131 # HACK to clear player env face cache, we need some signal framework
991currently store anything that can be serialised using Storable, which 3132 # for this (global event?)
992excludes objects. 3133 %ext::player_env::MUSIC_FACE_CACHE = ();
993 3134
994The parameter C<$family> should best start with the name of the extension 3135 my $enc = JSON::XS->new->utf8->canonical->relaxed;
995using it, it should be unique.
996 3136
997=over 4 3137 warn "loading facedata from $path\n";
998 3138
999=item $hashref = cf::db_get $family 3139 my $facedata;
3140 0 < aio_load $path, $facedata
3141 or die "$path: $!";
1000 3142
1001Return a hashref for use by the extension C<$family>, which can be 3143 $facedata = Coro::Storable::thaw $facedata;
1002modified. After modifications, you have to call C<cf::db_dirty> or
1003C<cf::db_sync>.
1004 3144
1005=item $value = cf::db_get $family => $key 3145 $facedata->{version} == 2
3146 or cf::cleanup "$path: version mismatch, cannot proceed.";
1006 3147
1007Returns a single value from the database 3148 # patch in the exptable
1008 3149 $facedata->{resource}{"res/exp_table"} = {
1009=item cf::db_put $family => $hashref 3150 type => FT_RSRC,
1010 3151 data => $enc->encode ([map cf::level_to_min_exp $_, 1 .. cf::settings->max_level]),
1011Stores the given family hashref into the database. Updates are delayed, if
1012you want the data to be synced to disk immediately, use C<cf::db_sync>.
1013
1014=item cf::db_put $family => $key => $value
1015
1016Stores the given C<$value> in the family hash. Updates are delayed, if you
1017want the data to be synced to disk immediately, use C<cf::db_sync>.
1018
1019=item cf::db_dirty
1020
1021Marks the database as dirty, to be updated at a later time.
1022
1023=item cf::db_sync
1024
1025Immediately write the database to disk I<if it is dirty>.
1026
1027=cut
1028
1029our $DB;
1030
1031{
1032 my $path = cf::localdir . "/database.pst";
1033
1034 sub db_load() {
1035 warn "loading database $path\n";#d# remove later
1036 $DB = stat $path ? Storable::retrieve $path : { };
1037 }
1038
1039 my $pid;
1040
1041 sub db_save() {
1042 warn "saving database $path\n";#d# remove later
1043 waitpid $pid, 0 if $pid;
1044 if (0 == ($pid = fork)) {
1045 $DB->{_meta}{version} = 1;
1046 Storable::nstore $DB, "$path~";
1047 rename "$path~", $path;
1048 cf::_exit 0 if defined $pid;
1049 }
1050 }
1051
1052 my $dirty;
1053
1054 sub db_sync() {
1055 db_save if $dirty;
1056 undef $dirty;
1057 }
1058
1059 my $idle = Event->idle (min => $TICK * 2.8, max => 10, repeat => 0, data => WF_AUTOCANCEL, cb => sub {
1060 db_sync;
1061 }); 3152 };
3153 cf::cede_to_tick;
1062 3154
1063 sub db_dirty() {
1064 $dirty = 1;
1065 $idle->start;
1066 } 3155 {
3156 my $faces = $facedata->{faceinfo};
1067 3157
1068 sub db_get($;$) { 3158 while (my ($face, $info) = each %$faces) {
1069 @_ >= 2 3159 my $idx = (cf::face::find $face) || cf::face::alloc $face;
1070 ? $DB->{$_[0]}{$_[1]}
1071 : ($DB->{$_[0]} ||= { })
1072 }
1073 3160
1074 sub db_put($$;$) { 3161 cf::face::set_visibility $idx, $info->{visibility};
1075 if (@_ >= 3) { 3162 cf::face::set_magicmap $idx, $info->{magicmap};
1076 $DB->{$_[0]}{$_[1]} = $_[2]; 3163 cf::face::set_data $idx, 0, $info->{data32}, Digest::MD5::md5 $info->{data32};
1077 } else { 3164 cf::face::set_data $idx, 1, $info->{data64}, Digest::MD5::md5 $info->{data64};
1078 $DB->{$_[0]} = $_[1];
1079 }
1080 db_dirty;
1081 }
1082 3165
1083 attach_global 3166 cf::cede_to_tick;
1084 prio => 10000,
1085 on_cleanup => sub {
1086 db_sync;
1087 }, 3167 }
3168
3169 while (my ($face, $info) = each %$faces) {
3170 next unless $info->{smooth};
3171
3172 my $idx = cf::face::find $face
3173 or next;
3174
3175 if (my $smooth = cf::face::find $info->{smooth}) {
3176 cf::face::set_smooth $idx, $smooth;
3177 cf::face::set_smoothlevel $idx, $info->{smoothlevel};
3178 } else {
3179 warn "smooth face '$info->{smooth}' not found for face '$face'";
3180 }
3181
3182 cf::cede_to_tick;
3183 }
1088 ; 3184 }
1089}
1090 3185
1091############################################################################# 3186 {
1092# the server's main() 3187 my $anims = $facedata->{animinfo};
1093 3188
1094sub cfg_load { 3189 while (my ($anim, $info) = each %$anims) {
3190 cf::anim::set $anim, $info->{frames}, $info->{facings};
3191 cf::cede_to_tick;
3192 }
3193
3194 cf::anim::invalidate_all; # d'oh
3195 }
3196
3197 {
3198 # TODO: for gcfclient pleasure, we should give resources
3199 # that gcfclient doesn't grok a >10000 face index.
3200 my $res = $facedata->{resource};
3201
3202 while (my ($name, $info) = each %$res) {
3203 if (defined $info->{type}) {
3204 my $idx = (cf::face::find $name) || cf::face::alloc $name;
3205 my $data;
3206
3207 if ($info->{type} & 1) {
3208 # prepend meta info
3209
3210 my $meta = $enc->encode ({
3211 name => $name,
3212 %{ $info->{meta} || {} },
3213 });
3214
3215 $data = pack "(w/a*)*", $meta, $info->{data};
3216 } else {
3217 $data = $info->{data};
3218 }
3219
3220 cf::face::set_data $idx, 0, $data, Digest::MD5::md5 $data;
3221 cf::face::set_type $idx, $info->{type};
3222 } else {
3223 $RESOURCE{$name} = $info;
3224 }
3225
3226 cf::cede_to_tick;
3227 }
3228 }
3229
3230 cf::global->invoke (EVENT_GLOBAL_RESOURCE_UPDATE);
3231
3232 1
3233}
3234
3235cf::global->attach (on_resource_update => sub {
3236 if (my $soundconf = $RESOURCE{"res/sound.conf"}) {
3237 $soundconf = JSON::XS->new->utf8->relaxed->decode ($soundconf->{data});
3238
3239 for (0 .. SOUND_CAST_SPELL_0 - 1) {
3240 my $sound = $soundconf->{compat}[$_]
3241 or next;
3242
3243 my $face = cf::face::find "sound/$sound->[1]";
3244 cf::sound::set $sound->[0] => $face;
3245 cf::sound::old_sound_index $_, $face; # gcfclient-compat
3246 }
3247
3248 while (my ($k, $v) = each %{$soundconf->{event}}) {
3249 my $face = cf::face::find "sound/$v";
3250 cf::sound::set $k => $face;
3251 }
3252 }
3253});
3254
3255register_exticmd fx_want => sub {
3256 my ($ns, $want) = @_;
3257
3258 while (my ($k, $v) = each %$want) {
3259 $ns->fx_want ($k, $v);
3260 }
3261};
3262
3263sub reload_regions {
3264 # HACK to clear player env face cache, we need some signal framework
3265 # for this (global event?)
3266 %ext::player_env::MUSIC_FACE_CACHE = ();
3267
3268 load_resource_file "$MAPDIR/regions"
3269 or die "unable to load regions file\n";
3270
3271 for (cf::region::list) {
3272 $_->{match} = qr/$_->{match}/
3273 if exists $_->{match};
3274 }
3275}
3276
3277sub reload_facedata {
3278 load_facedata "$DATADIR/facedata"
3279 or die "unable to load facedata\n";
3280}
3281
3282sub reload_archetypes {
3283 load_resource_file "$DATADIR/archetypes"
3284 or die "unable to load archetypes\n";
3285 #d# NEED to laod twice to resolve forward references
3286 # this really needs to be done in an extra post-pass
3287 # (which needs to be synchronous, so solve it differently)
3288 load_resource_file "$DATADIR/archetypes"
3289 or die "unable to load archetypes\n";
3290}
3291
3292sub reload_treasures {
3293 load_resource_file "$DATADIR/treasures"
3294 or die "unable to load treasurelists\n";
3295}
3296
3297sub reload_resources {
3298 warn "reloading resource files...\n";
3299
3300 reload_regions;
3301 reload_facedata;
3302 #reload_archetypes;#d#
3303 reload_archetypes;
3304 reload_treasures;
3305
3306 warn "finished reloading resource files\n";
3307}
3308
3309sub init {
3310 reload_resources;
3311}
3312
3313sub reload_config {
1095 open my $fh, "<:utf8", cf::confdir . "/config" 3314 open my $fh, "<:utf8", "$CONFDIR/config"
1096 or return; 3315 or return;
1097 3316
1098 local $/; 3317 local $/;
1099 *CFG = YAML::Syck::Load <$fh>; 3318 *CFG = YAML::Syck::Load <$fh>;
3319
3320 $EMERGENCY_POSITION = $CFG{emergency_position} || ["/world/world_105_115", 5, 37];
3321
3322 $cf::map::MAX_RESET = $CFG{map_max_reset} if exists $CFG{map_max_reset};
3323 $cf::map::DEFAULT_RESET = $CFG{map_default_reset} if exists $CFG{map_default_reset};
3324
3325 if (exists $CFG{mlockall}) {
3326 eval {
3327 $CFG{mlockall} ? eval "mlockall()" : eval "munlockall()"
3328 and die "WARNING: m(un)lockall failed: $!\n";
3329 };
3330 warn $@ if $@;
3331 }
1100} 3332}
1101 3333
1102sub main { 3334sub main {
1103 cfg_load; 3335 # we must not ever block the main coroutine
1104 db_load; 3336 local $Coro::idle = sub {
3337 Carp::cluck "FATAL: Coro::idle was called, major BUG, use cf::sync_job!\n";#d#
3338 (async {
3339 $Coro::current->{desc} = "IDLE BUG HANDLER";
3340 EV::loop EV::LOOP_ONESHOT;
3341 })->prio (Coro::PRIO_MAX);
3342 };
3343
3344 reload_config;
3345 db_init;
1105 load_extensions; 3346 load_extensions;
3347
3348 $TICK_WATCHER->start;
3349 $Coro::current->prio (Coro::PRIO_MAX); # give the main loop max. priority
1106 Event::loop; 3350 EV::loop;
1107} 3351}
1108 3352
1109############################################################################# 3353#############################################################################
1110# initialisation 3354# initialisation and cleanup
1111 3355
1112sub _perl_reload(&) { 3356# install some emergency cleanup handlers
1113 my ($msg) = @_; 3357BEGIN {
1114 3358 our %SIGWATCHER = ();
1115 $msg->("reloading..."); 3359 for my $signal (qw(INT HUP TERM)) {
1116 3360 $SIGWATCHER{$signal} = EV::signal $signal, sub {
1117 eval { 3361 cf::cleanup "SIG$signal";
1118 # cancel all watchers
1119 for (Event::all_watchers) {
1120 $_->cancel if $_->data & WF_AUTOCANCEL;
1121 } 3362 };
3363 }
3364}
1122 3365
1123 # unload all extensions 3366sub write_runtime {
3367 my $runtime = "$LOCALDIR/runtime";
3368
3369 # first touch the runtime file to show we are still running:
3370 # the fsync below can take a very very long time.
3371
3372 IO::AIO::aio_utime $runtime, undef, undef;
3373
3374 my $guard = cf::lock_acquire "write_runtime";
3375
3376 my $fh = aio_open "$runtime~", O_WRONLY | O_CREAT, 0644
3377 or return;
3378
3379 my $value = $cf::RUNTIME + 90 + 10;
3380 # 10 is the runtime save interval, for a monotonic clock
3381 # 60 allows for the watchdog to kill the server.
3382
3383 (aio_write $fh, 0, (length $value), $value, 0) <= 0
3384 and return;
3385
3386 # always fsync - this file is important
3387 aio_fsync $fh
3388 and return;
3389
3390 # touch it again to show we are up-to-date
3391 aio_utime $fh, undef, undef;
3392
3393 close $fh
3394 or return;
3395
3396 aio_rename "$runtime~", $runtime
3397 and return;
3398
3399 warn "runtime file written.\n";
3400
3401 1
3402}
3403
3404sub emergency_save() {
3405 my $freeze_guard = cf::freeze_mainloop;
3406
3407 warn "enter emergency perl save\n";
3408
3409 cf::sync_job {
3410 # use a peculiar iteration method to avoid tripping on perl
3411 # refcount bugs in for. also avoids problems with players
3412 # and maps saved/destroyed asynchronously.
3413 warn "begin emergency player save\n";
3414 for my $login (keys %cf::PLAYER) {
3415 my $pl = $cf::PLAYER{$login} or next;
3416 $pl->valid or next;
3417 delete $pl->{unclean_save}; # not strictly necessary, but cannot hurt
3418 $pl->save;
3419 }
3420 warn "end emergency player save\n";
3421
3422 warn "begin emergency map save\n";
3423 for my $path (keys %cf::MAP) {
3424 my $map = $cf::MAP{$path} or next;
3425 $map->valid or next;
3426 $map->save;
3427 }
3428 warn "end emergency map save\n";
3429
3430 warn "begin emergency database checkpoint\n";
3431 BDB::db_env_txn_checkpoint $DB_ENV;
3432 warn "end emergency database checkpoint\n";
3433 };
3434
3435 warn "leave emergency perl save\n";
3436}
3437
3438sub post_cleanup {
3439 my ($make_core) = @_;
3440
3441 warn Carp::longmess "post_cleanup backtrace"
3442 if $make_core;
3443}
3444
3445sub do_reload_perl() {
3446 # can/must only be called in main
3447 if ($Coro::current != $Coro::main) {
3448 warn "can only reload from main coroutine";
3449 return;
3450 }
3451
3452 warn "reloading...";
3453
3454 warn "entering sync_job";
3455
3456 cf::sync_job {
3457 cf::write_runtime; # external watchdog should not bark
3458 cf::emergency_save;
3459 cf::write_runtime; # external watchdog should not bark
3460
3461 warn "syncing database to disk";
3462 BDB::db_env_txn_checkpoint $DB_ENV;
3463
3464 # if anything goes wrong in here, we should simply crash as we already saved
3465
3466 warn "flushing outstanding aio requests";
1124 for (@exts) { 3467 for (;;) {
1125 $msg->("unloading <$_>"); 3468 BDB::flush;
1126 unload_extension $_; 3469 IO::AIO::flush;
3470 Coro::cede_notself;
3471 last unless IO::AIO::nreqs || BDB::nreqs;
3472 warn "iterate...";
3473 }
3474
3475 ++$RELOAD;
3476
3477 warn "cancelling all extension coros";
3478 $_->cancel for values %EXT_CORO;
3479 %EXT_CORO = ();
3480
3481 warn "removing commands";
3482 %COMMAND = ();
3483
3484 warn "removing ext/exti commands";
3485 %EXTCMD = ();
3486 %EXTICMD = ();
3487
3488 warn "unloading/nuking all extensions";
3489 for my $pkg (@EXTS) {
3490 warn "... unloading $pkg";
3491
3492 if (my $cb = $pkg->can ("unload")) {
3493 eval {
3494 $cb->($pkg);
3495 1
3496 } or warn "$pkg unloaded, but with errors: $@";
1127 } 3497 }
1128 3498
3499 warn "... nuking $pkg";
3500 Symbol::delete_package $pkg;
3501 }
3502
1129 # unload all modules loaded from $LIBDIR 3503 warn "unloading all perl modules loaded from $LIBDIR";
1130 while (my ($k, $v) = each %INC) { 3504 while (my ($k, $v) = each %INC) {
1131 next unless $v =~ /^\Q$LIBDIR\E\/.*\.pm$/; 3505 next unless $v =~ /^\Q$LIBDIR\E\/.*\.pm$/;
1132 3506
1133 $msg->("removing <$k>"); 3507 warn "... unloading $k";
1134 delete $INC{$k}; 3508 delete $INC{$k};
1135 3509
1136 $k =~ s/\.pm$//; 3510 $k =~ s/\.pm$//;
1137 $k =~ s/\//::/g; 3511 $k =~ s/\//::/g;
1138 3512
1141 } 3515 }
1142 3516
1143 Symbol::delete_package $k; 3517 Symbol::delete_package $k;
1144 } 3518 }
1145 3519
1146 # sync database to disk
1147 cf::db_sync;
1148
1149 # get rid of safe::, as good as possible 3520 warn "getting rid of safe::, as good as possible";
1150 Symbol::delete_package "safe::$_" 3521 Symbol::delete_package "safe::$_"
1151 for qw(cf::object cf::object::player cf::player cf::map cf::party cf::region); 3522 for qw(cf::attachable cf::object cf::object::player cf::client cf::player cf::map cf::party cf::region);
1152 3523
1153 # remove register_script_function callbacks
1154 # TODO
1155
1156 # unload cf.pm "a bit" 3524 warn "unloading cf.pm \"a bit\"";
1157 delete $INC{"cf.pm"}; 3525 delete $INC{"cf.pm"};
3526 delete $INC{"cf/pod.pm"};
1158 3527
1159 # don't, removes xs symbols, too, 3528 # don't, removes xs symbols, too,
1160 # and global variables created in xs 3529 # and global variables created in xs
1161 #Symbol::delete_package __PACKAGE__; 3530 #Symbol::delete_package __PACKAGE__;
1162 3531
1163 # reload cf.pm 3532 warn "unload completed, starting to reload now";
3533
1164 $msg->("reloading cf.pm"); 3534 warn "reloading cf.pm";
1165 require cf; 3535 require cf;
3536 cf::_connect_to_perl; # nominally unnecessary, but cannot hurt
1166 3537
1167 # load config and database again 3538 warn "loading config and database again";
1168 cf::cfg_load; 3539 cf::reload_config;
1169 cf::db_load;
1170 3540
1171 # load extensions 3541 warn "loading extensions";
1172 $msg->("load extensions");
1173 cf::load_extensions; 3542 cf::load_extensions;
1174 3543
1175 # reattach attachments to objects 3544 warn "reattaching attachments to objects/players";
1176 $msg->("reattach"); 3545 _global_reattach; # objects, sockets
1177 _global_reattach; 3546 warn "reattaching attachments to maps";
3547 reattach $_ for values %MAP;
3548 warn "reattaching attachments to players";
3549 reattach $_ for values %PLAYER;
3550
3551 warn "leaving sync_job";
3552
3553 1
3554 } or do {
3555 warn $@;
3556 warn "error while reloading, exiting.";
3557 exit 1;
1178 }; 3558 };
1179 $msg->($@) if $@;
1180 3559
1181 $msg->("reloaded"); 3560 warn "reloaded";
1182}; 3561};
1183 3562
1184sub perl_reload() { 3563our $RELOAD_WATCHER; # used only during reload
1185 _perl_reload { 3564
1186 warn $_[0]; 3565sub reload_perl() {
1187 print "$_[0]\n"; 3566 # doing reload synchronously and two reloads happen back-to-back,
3567 # coro crashes during coro_state_free->destroy here.
3568
3569 $RELOAD_WATCHER ||= EV::timer 0, 0, sub {
3570 undef $RELOAD_WATCHER;
3571 do_reload_perl;
1188 }; 3572 };
1189} 3573}
1190 3574
1191register "<global>", __PACKAGE__;
1192
1193register_command "perl-reload" => sub { 3575register_command "reload" => sub {
1194 my ($who, $arg) = @_; 3576 my ($who, $arg) = @_;
1195 3577
1196 if ($who->flag (FLAG_WIZ)) { 3578 if ($who->flag (FLAG_WIZ)) {
1197 _perl_reload { 3579 $who->message ("reloading server.");
1198 warn $_[0]; 3580 async {
1199 $who->message ($_[0]); 3581 $Coro::current->{desc} = "perl_reload";
3582 reload_perl;
1200 }; 3583 };
1201 } 3584 }
1202}; 3585};
1203 3586
1204unshift @INC, $LIBDIR; 3587unshift @INC, $LIBDIR;
1205 3588
1206$TICK_WATCHER = Event->timer ( 3589my $bug_warning = 0;
1207 prio => 0, 3590
1208 at => $NEXT_TICK || 1, 3591our @WAIT_FOR_TICK;
1209 data => WF_AUTOCANCEL, 3592our @WAIT_FOR_TICK_BEGIN;
1210 cb => sub { 3593
3594sub wait_for_tick {
3595 return unless $TICK_WATCHER->is_active;
3596 return if $Coro::current == $Coro::main;
3597
3598 my $signal = new Coro::Signal;
3599 push @WAIT_FOR_TICK, $signal;
3600 $signal->wait;
3601}
3602
3603sub wait_for_tick_begin {
3604 return unless $TICK_WATCHER->is_active;
3605 return if $Coro::current == $Coro::main;
3606
3607 my $signal = new Coro::Signal;
3608 push @WAIT_FOR_TICK_BEGIN, $signal;
3609 $signal->wait;
3610}
3611
3612$TICK_WATCHER = EV::periodic_ns 0, $TICK, 0, sub {
3613 if ($Coro::current != $Coro::main) {
3614 Carp::cluck "major BUG: server tick called outside of main coro, skipping it"
3615 unless ++$bug_warning > 10;
3616 return;
3617 }
3618
3619 $NOW = $tick_start = EV::now;
3620
1211 cf::server_tick; # one server iteration 3621 cf::server_tick; # one server iteration
1212 3622
1213 my $NOW = Event::time; 3623 $RUNTIME += $TICK;
1214 $NEXT_TICK += $TICK; 3624 $NEXT_TICK = $_[0]->at;
1215 3625
1216 # if we are delayed by four ticks or more, skip them all 3626 if ($NOW >= $NEXT_RUNTIME_WRITE) {
1217 $NEXT_TICK = $NOW if $NOW >= $NEXT_TICK + $TICK * 4; 3627 $NEXT_RUNTIME_WRITE = List::Util::max $NEXT_RUNTIME_WRITE + 10, $NOW + 5.;
1218 3628 Coro::async_pool {
1219 $TICK_WATCHER->at ($NEXT_TICK); 3629 $Coro::current->{desc} = "runtime saver";
1220 $TICK_WATCHER->start; 3630 write_runtime
3631 or warn "ERROR: unable to write runtime file: $!";
3632 };
1221 }, 3633 }
1222);
1223 3634
3635 if (my $sig = shift @WAIT_FOR_TICK_BEGIN) {
3636 $sig->send;
3637 }
3638 while (my $sig = shift @WAIT_FOR_TICK) {
3639 $sig->send;
3640 }
3641
3642 $LOAD = ($NOW - $tick_start) / $TICK;
3643 $LOADAVG = $LOADAVG * 0.75 + $LOAD * 0.25;
3644
3645 _post_tick;
3646};
3647$TICK_WATCHER->priority (EV::MAXPRI);
3648
3649{
3650 # configure BDB
3651
3652 BDB::min_parallel 8;
3653 BDB::max_poll_reqs $TICK * 0.1;
3654 $Coro::BDB::WATCHER->priority (1);
3655
3656 unless ($DB_ENV) {
3657 $DB_ENV = BDB::db_env_create;
3658 $DB_ENV->set_flags (BDB::AUTO_COMMIT | BDB::REGION_INIT | BDB::TXN_NOSYNC
3659 | BDB::LOG_AUTOREMOVE, 1);
3660 $DB_ENV->set_timeout (30, BDB::SET_TXN_TIMEOUT);
3661 $DB_ENV->set_timeout (30, BDB::SET_LOCK_TIMEOUT);
3662
3663 cf::sync_job {
3664 eval {
3665 BDB::db_env_open
3666 $DB_ENV,
3667 $BDBDIR,
3668 BDB::INIT_LOCK | BDB::INIT_LOG | BDB::INIT_MPOOL | BDB::INIT_TXN
3669 | BDB::RECOVER | BDB::REGISTER | BDB::USE_ENVIRON | BDB::CREATE,
3670 0666;
3671
3672 cf::cleanup "db_env_open($BDBDIR): $!" if $!;
3673 };
3674
3675 cf::cleanup "db_env_open(db): $@" if $@;
3676 };
3677 }
3678
3679 $BDB_DEADLOCK_WATCHER = EV::periodic 0, 3, 0, sub {
3680 BDB::db_env_lock_detect $DB_ENV, 0, BDB::LOCK_DEFAULT, 0, sub { };
3681 };
3682 $BDB_CHECKPOINT_WATCHER = EV::periodic 0, 60, 0, sub {
3683 BDB::db_env_txn_checkpoint $DB_ENV, 0, 0, 0, sub { };
3684 };
3685 $BDB_TRICKLE_WATCHER = EV::periodic 0, 10, 0, sub {
3686 BDB::db_env_memp_trickle $DB_ENV, 20, 0, sub { };
3687 };
3688}
3689
3690{
3691 # configure IO::AIO
3692
3693 IO::AIO::min_parallel 8;
1224IO::AIO::max_poll_time $TICK * 0.2; 3694 IO::AIO::max_poll_time $TICK * 0.1;
3695 $Coro::AIO::WATCHER->priority (1);
3696}
1225 3697
1226Event->io (fd => IO::AIO::poll_fileno, 3698my $_log_backtrace;
1227 poll => 'r', 3699
1228 prio => 5, 3700sub _log_backtrace {
1229 data => WF_AUTOCANCEL, 3701 my ($msg, @addr) = @_;
1230 cb => \&IO::AIO::poll_cb); 3702
3703 $msg =~ s/\n//;
3704
3705 # limit the # of concurrent backtraces
3706 if ($_log_backtrace < 2) {
3707 ++$_log_backtrace;
3708 async {
3709 $Coro::current->{desc} = "abt $msg";
3710
3711 my @bt = fork_call {
3712 @addr = map { sprintf "%x", $_ } @addr;
3713 my $self = (-f "/proc/$$/exe") ? "/proc/$$/exe" : $^X;
3714 open my $fh, "exec addr2line -C -f -i -e \Q$self\E @addr 2>&1 |"
3715 or die "addr2line: $!";
3716
3717 my @funcs;
3718 my @res = <$fh>;
3719 chomp for @res;
3720 while (@res) {
3721 my ($func, $line) = splice @res, 0, 2, ();
3722 push @funcs, "[$func] $line";
3723 }
3724
3725 @funcs
3726 };
3727
3728 LOG llevInfo, "[ABT] $msg\n";
3729 LOG llevInfo, "[ABT] $_\n" for @bt;
3730 --$_log_backtrace;
3731 };
3732 } else {
3733 LOG llevInfo, "[ABT] $msg\n";
3734 LOG llevInfo, "[ABT] [suppressed]\n";
3735 }
3736}
3737
3738# load additional modules
3739use cf::pod;
3740
3741END { cf::emergency_save }
1231 3742
12321 37431
1233 3744

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines