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

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines