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.25 by root, Thu Jul 20 07:22:40 2006 UTC vs.
Revision 1.327 by root, Wed Aug 1 17:22:51 2007 UTC

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

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines