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

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines