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.27 by root, Fri Jul 21 00:51:39 2006 UTC vs.
Revision 1.349 by root, Fri Aug 31 04:10:43 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/(?<![BIUGH])</&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 # replace G<male|female> tags
1478 || s{G<([^>|]*)\|([^>]*)>}{
1479 $self->gender ? $2 : $1
1480 }ge
1481 # replace H<hint text>
1482 || s{H<([^\>]*)>}
1483 {
1484 ("<fg name=\"lightblue\">[$1 (Use hintmode to suppress hints)]</fg>",
1485 "<fg name=\"lightblue\">[Hint suppressed, see hintmode]</fg>",
1486 "")
1487 [$self->{hintmode}]
1488 }ge;
1489
1490 # create single paragraphs (very hackish)
1491 s/(?<=\S)\n(?=\w)/ /g;
1492
1493 # compress some whitespace
1494 s/\s+\n/\n/g; # ws line-ends
1495 s/\n\n+/\n/g; # double lines
1496 s/^\n+//; # beginning lines
1497 s/\n+$//; # ending lines
1498
1499 $_
1500}
1501
1502sub hintmode {
1503 $_[0]{hintmode} = $_[1] if @_ > 1;
1504 $_[0]{hintmode}
1505}
1506
1507=item $player->ext_reply ($msgid, @msg)
1508
1509Sends an ext reply to the player.
1510
1511=cut
1512
1513sub ext_reply($$@) {
1514 my ($self, $id, @msg) = @_;
1515
1516 $self->ns->ext_reply ($id, @msg)
1517}
1518
1519=item $player->ext_msg ($type, @msg)
1520
1521Sends an ext event to the client.
1522
1523=cut
1524
1525sub ext_msg($$@) {
1526 my ($self, $type, @msg) = @_;
1527
1528 $self->ns->ext_msg ($type, @msg);
1529}
1530
1531=head3 cf::region
1532
1533=over 4
1534
1535=cut
1536
1537package cf::region;
1538
1539=item cf::region::find_by_path $path
1540
1541Tries to decuce the likely region for a map knowing only its path.
1542
1543=cut
1544
1545sub find_by_path($) {
1546 my ($path) = @_;
1547
1548 my ($match, $specificity);
1549
1550 for my $region (list) {
1551 if ($region->{match} && $path =~ $region->{match}) {
1552 ($match, $specificity) = ($region, $region->specificity)
1553 if $region->specificity > $specificity;
1554 }
1555 }
1556
1557 $match
1558}
1559
1560=back
1561
1562=head3 cf::map
1563
1564=over 4
1565
1566=cut
1567
1568package cf::map;
1569
1570use Fcntl;
1571use Coro::AIO;
1572
1573use overload
1574 '""' => \&as_string,
1575 fallback => 1;
1576
1577our $MAX_RESET = 3600;
1578our $DEFAULT_RESET = 3000;
1579
1580sub generate_random_map {
1581 my ($self, $rmp) = @_;
1582 # mit "rum" bekleckern, nicht
1583 $self->_create_random_map (
1584 $rmp->{wallstyle}, $rmp->{wall_name}, $rmp->{floorstyle}, $rmp->{monsterstyle},
1585 $rmp->{treasurestyle}, $rmp->{layoutstyle}, $rmp->{doorstyle}, $rmp->{decorstyle},
1586 $rmp->{origin_map}, $rmp->{final_map}, $rmp->{exitstyle}, $rmp->{this_map},
1587 $rmp->{exit_on_final_map},
1588 $rmp->{xsize}, $rmp->{ysize},
1589 $rmp->{expand2x}, $rmp->{layoutoptions1}, $rmp->{layoutoptions2}, $rmp->{layoutoptions3},
1590 $rmp->{symmetry}, $rmp->{difficulty}, $rmp->{difficulty_given}, $rmp->{difficulty_increase},
1591 $rmp->{dungeon_level}, $rmp->{dungeon_depth}, $rmp->{decoroptions}, $rmp->{orientation},
1592 $rmp->{origin_y}, $rmp->{origin_x}, $rmp->{random_seed}, $rmp->{total_map_hp},
1593 $rmp->{map_layout_style}, $rmp->{treasureoptions}, $rmp->{symmetry_used},
1594 (cf::region::find $rmp->{region}), $rmp->{custom}
1595 )
1596}
1597
1598=item cf::map->register ($regex, $prio)
1599
1600Register a handler for the map path matching the given regex at the
1601givne priority (higher is better, built-in handlers have priority 0, the
1602default).
1603
1604=cut
137 1605
138sub register { 1606sub register {
1607 my (undef, $regex, $prio) = @_;
1608 my $pkg = caller;
1609
1610 no strict;
1611 push @{"$pkg\::ISA"}, __PACKAGE__;
1612
1613 $EXT_MAP{$pkg} = [$prio, qr<$regex>];
1614}
1615
1616# also paths starting with '/'
1617$EXT_MAP{"cf::map"} = [0, qr{^(?=/)}];
1618
1619sub thawer_merge {
139 my ($base, $pkg) = @_; 1620 my ($self, $merge) = @_;
140 1621
141 for my $idx (0 .. $#EVENT) { 1622 # we have to keep some variables in memory intact
142 if (my $ref = $pkg->can ("on_$EVENT[$idx]")) { 1623 local $self->{path};
143 #warn "registering $EVENT[$idx] hook to '$pkg'\n"; 1624 local $self->{load_path};
144 $hook[$idx]{$base} = $ref;
145 }
146 }
147}
148 1625
149sub load_extension { 1626 $self->SUPER::thawer_merge ($merge);
1627}
1628
1629sub normalise {
150 my ($path) = @_; 1630 my ($path, $base) = @_;
151 1631
152 $path =~ /([^\/\\]+)\.ext$/ or die "$path"; 1632 $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 1633
158 warn "loading '$path' into '$pkg'\n"; 1634 $path =~ s/\.map$//;
159 1635
160 open my $fh, "<:utf8", $path 1636 # map plan:
161 or die "$path: $!"; 1637 #
1638 # /! non-realised random map exit (special hack!)
1639 # {... are special paths that are not being touched
1640 # ?xxx/... are special absolute paths
1641 # ?random/... random maps
1642 # /... normal maps
1643 # ~user/... per-player map of a specific user
162 1644
163 my $source = 1645 $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 1646
169 eval $source 1647 # treat it as relative path if it starts with
170 or die "$path: $@"; 1648 # something that looks reasonable
1649 if ($path =~ m{^(?:\./|\.\./|\w)}) {
1650 $base or Carp::carp "normalise called with relative path and no base: '$path'";
171 1651
172 push @exts, $pkg; 1652 $base =~ s{[^/]+/?$}{};
173 $ext_pkg{$base} = $pkg; 1653 $path = "$base/$path";
1654 }
174 1655
175# no strict 'refs'; 1656 for ($path) {
176# @{"$pkg\::ISA"} = ext::; 1657 redo if s{//}{/};
1658 redo if s{/\.?/}{/};
1659 redo if s{/[^/]+/\.\./}{/};
1660 }
177 1661
178 register $base, $pkg; 1662 $path
179} 1663}
180 1664
181sub unload_extension { 1665sub new_from_path {
1666 my (undef, $path, $base) = @_;
1667
1668 return $path if UNIVERSAL::isa $path, "cf::map"; # already a map object
1669
1670 $path = normalise $path, $base;
1671
1672 for my $pkg (sort { $EXT_MAP{$b}[0] <=> $EXT_MAP{$a}[0] } keys %EXT_MAP) {
1673 if ($path =~ $EXT_MAP{$pkg}[1]) {
1674 my $self = bless cf::map::new, $pkg;
1675 $self->{path} = $path; $self->path ($path);
1676 $self->init; # pass $1 etc.
1677 return $self;
1678 }
1679 }
1680
1681 Carp::cluck "unable to resolve path '$path' (base '$base').";
1682 ()
1683}
1684
1685sub init {
1686 my ($self) = @_;
1687
1688 $self
1689}
1690
1691sub as_string {
1692 my ($self) = @_;
1693
1694 "$self->{path}"
1695}
1696
1697# the displayed name, this is a one way mapping
1698sub visible_name {
1699 &as_string
1700}
1701
1702# the original (read-only) location
1703sub load_path {
1704 my ($self) = @_;
1705
1706 "$MAPDIR/$self->{path}.map"
1707}
1708
1709# the temporary/swap location
1710sub save_path {
1711 my ($self) = @_;
1712
1713 (my $path = $_[0]{path}) =~ s/\//$PATH_SEP/g;
1714 "$TMPDIR/$path.map"
1715}
1716
1717# the unique path, undef == no special unique path
1718sub uniq_path {
1719 my ($self) = @_;
1720
1721 (my $path = $_[0]{path}) =~ s/\//$PATH_SEP/g;
1722 "$UNIQUEDIR/$path"
1723}
1724
1725# and all this just because we cannot iterate over
1726# all maps in C++...
1727sub change_all_map_light {
182 my ($pkg) = @_; 1728 my ($change) = @_;
183 1729
184 warn "removing extension $pkg\n"; 1730 $_->change_map_light ($change)
1731 for grep $_->outdoor, values %cf::MAP;
1732}
185 1733
186 if (my $cb = $pkg->can ("on_unload")) { 1734sub decay_objects {
187 $cb->($pkg); 1735 my ($self) = @_;
1736
1737 return if $self->{deny_reset};
1738
1739 $self->do_decay_objects;
1740}
1741
1742sub unlink_save {
1743 my ($self) = @_;
1744
1745 utf8::encode (my $save = $self->save_path);
1746 IO::AIO::aioreq_pri 4; Coro::AIO::aio_unlink $save;
1747 IO::AIO::aioreq_pri 4; Coro::AIO::aio_unlink "$save.pst";
1748}
1749
1750sub load_header_from($) {
1751 my ($self, $path) = @_;
1752
1753 utf8::encode $path;
1754 #aio_open $path, O_RDONLY, 0
1755 # or return;
1756
1757 $self->_load_header ($path)
1758 or return;
1759
1760 $self->{load_path} = $path;
1761
188 } 1762 1
1763}
189 1764
190 # remove hooks 1765sub load_header_orig {
191 for my $idx (0 .. $#EVENT) { 1766 my ($self) = @_;
192 delete $hook[$idx]{$pkg};
193 }
194 1767
195 # remove commands 1768 $self->load_header_from ($self->load_path)
196 for my $name (keys %command) { 1769}
197 my @cb = grep $_->[2] ne $pkg, @{ $command{$name} };
198 1770
199 if (@cb) { 1771sub load_header_temp {
200 $command{$name} = \@cb; 1772 my ($self) = @_;
201 $COMMAND{"$name\000"} = List::Util::max map $_->[0], @cb; 1773
1774 $self->load_header_from ($self->save_path)
1775}
1776
1777sub prepare_temp {
1778 my ($self) = @_;
1779
1780 $self->last_access ((delete $self->{last_access})
1781 || $cf::RUNTIME); #d#
1782 # safety
1783 $self->{instantiate_time} = $cf::RUNTIME
1784 if $self->{instantiate_time} > $cf::RUNTIME;
1785}
1786
1787sub prepare_orig {
1788 my ($self) = @_;
1789
1790 $self->{load_original} = 1;
1791 $self->{instantiate_time} = $cf::RUNTIME;
1792 $self->last_access ($cf::RUNTIME);
1793 $self->instantiate;
1794}
1795
1796sub load_header {
1797 my ($self) = @_;
1798
1799 if ($self->load_header_temp) {
1800 $self->prepare_temp;
202 } else { 1801 } else {
203 delete $command{$name}; 1802 $self->load_header_orig
204 delete $COMMAND{"$name\000"}; 1803 or return;
205 } 1804 $self->prepare_orig;
1805 }
1806
1807 $self->{deny_reset} = 1
1808 if $self->no_reset;
1809
1810 $self->default_region (cf::region::find_by_path $self->{path})
1811 unless $self->default_region;
1812
206 } 1813 1
1814}
207 1815
208 # remove extcmds 1816sub find;
209 for my $name (grep $extcmd{$_}[1] eq $pkg, keys %extcmd) { 1817sub find {
210 delete $extcmd{$name}; 1818 my ($path, $origin) = @_;
1819
1820 $path = normalise $path, $origin && $origin->path;
1821
1822 cf::lock_wait "map_find:$path";
1823
1824 $cf::MAP{$path} || do {
1825 my $guard = cf::lock_acquire "map_find:$path";
1826 my $map = new_from_path cf::map $path
1827 or return;
1828
1829 $map->{last_save} = $cf::RUNTIME;
1830
1831 $map->load_header
1832 or return;
1833
1834 if ($map->should_reset) {#d#TODO# disabled, crashy (locking issue?)
1835 # doing this can freeze the server in a sync job, obviously
1836 #$cf::WAIT_FOR_TICK->wait;
1837 $map->reset;
1838 undef $guard;
1839 return find $path;
1840 }
1841
1842 $cf::MAP{$path} = $map
1843 }
1844}
1845
1846sub pre_load { }
1847sub post_load { }
1848
1849sub load {
1850 my ($self) = @_;
1851
1852 local $self->{deny_reset} = 1; # loading can take a long time
1853
1854 my $path = $self->{path};
1855
211 } 1856 {
1857 my $guard1 = cf::lock_acquire "map_data:$path";
1858 my $guard2 = cf::lock_acquire "map_load:$path";
212 1859
213 Symbol::delete_package $pkg; 1860 return if $self->in_memory != cf::MAP_SWAPPED;
214}
215 1861
216sub load_extensions { 1862 $self->in_memory (cf::MAP_LOADING);
217 my $LIBDIR = maps_directory "perl";
218 1863
219 for my $ext (<$LIBDIR/*.ext>) { 1864 $self->alloc;
220 next unless -r $ext;
221 eval {
222 load_extension $ext;
223 1
224 } or warn "$ext not loaded: $@";
225 }
226}
227 1865
228register_command "perl-reload", 0, sub { 1866 $self->pre_load;
229 my ($who, $arg) = @_; 1867 cf::cede_to_tick;
230 1868
231 if ($who->flag (FLAG_WIZ)) { 1869 $self->_load_objects ($self->{load_path}, 1)
232 $who->message ("reloading..."); 1870 or return;
233 1871
234 warn "reloading...\n"; 1872 $self->set_object_flag (cf::FLAG_OBJ_ORIGINAL, 1)
235 eval { 1873 if delete $self->{load_original};
236 # 1. cancel all watchers
237 $_->cancel for Event::all_watchers;
238 1874
239 # 2. unload all extensions 1875 if (my $uniq = $self->uniq_path) {
240 for (@exts) { 1876 utf8::encode $uniq;
241 $who->message ("unloading <$_>"); 1877 if (aio_open $uniq, O_RDONLY, 0) {
242 unload_extension $_; 1878 $self->clear_unique_items;
1879 $self->_load_objects ($uniq, 0);
243 } 1880 }
1881 }
244 1882
245 # 3. unload all modules loaded from $LIBDIR 1883 cf::cede_to_tick;
1884 # now do the right thing for maps
1885 $self->link_multipart_objects;
1886 $self->difficulty ($self->estimate_difficulty)
1887 unless $self->difficulty;
1888 cf::cede_to_tick;
1889
1890 unless ($self->{deny_activate}) {
1891 $self->decay_objects;
1892 $self->fix_auto_apply;
1893 $self->update_buttons;
1894 cf::cede_to_tick;
1895 $self->set_darkness_map;
1896 cf::cede_to_tick;
1897 $self->activate;
1898 }
1899
1900 $self->{last_save} = $cf::RUNTIME;
1901 $self->last_access ($cf::RUNTIME);
1902
1903 $self->in_memory (cf::MAP_IN_MEMORY);
1904 }
1905
1906 $self->post_load;
1907}
1908
1909sub customise_for {
1910 my ($self, $ob) = @_;
1911
1912 return find "~" . $ob->name . "/" . $self->{path}
1913 if $self->per_player;
1914
1915# return find "?party/" . $ob->name . "/" . $self->{path}
1916# if $self->per_party;
1917
1918 $self
1919}
1920
1921# find and load all maps in the 3x3 area around a map
1922sub load_neighbours {
1923 my ($map) = @_;
1924
1925 my @neigh; # diagonal neighbours
1926
1927 for (0 .. 3) {
1928 my $neigh = $map->tile_path ($_)
1929 or next;
1930 $neigh = find $neigh, $map
1931 or next;
1932 $neigh->load;
1933
1934 push @neigh,
1935 [$neigh->tile_path (($_ + 3) % 4), $neigh],
1936 [$neigh->tile_path (($_ + 1) % 4), $neigh];
1937 }
1938
1939 for (grep defined $_->[0], @neigh) {
1940 my ($path, $origin) = @$_;
1941 my $neigh = find $path, $origin
1942 or next;
1943 $neigh->load;
1944 }
1945}
1946
1947sub find_sync {
1948 my ($path, $origin) = @_;
1949
1950 cf::sync_job { find $path, $origin }
1951}
1952
1953sub do_load_sync {
1954 my ($map) = @_;
1955
1956 cf::LOG cf::llevDebug | cf::logBacktrace, "do_load_sync"
1957 if $Coro::current == $Coro::main;
1958
1959 cf::sync_job { $map->load };
1960}
1961
1962our %MAP_PREFETCH;
1963our $MAP_PREFETCHER = undef;
1964
1965sub find_async {
1966 my ($path, $origin, $load) = @_;
1967
1968 $path = normalise $path, $origin && $origin->{path};
1969
1970 if (my $map = $cf::MAP{$path}) {
1971 return $map if !$load || $map->in_memory == cf::MAP_IN_MEMORY;
1972 }
1973
1974 $MAP_PREFETCH{$path} |= $load;
1975
1976 $MAP_PREFETCHER ||= cf::async {
1977 while (%MAP_PREFETCH) {
246 while (my ($k, $v) = each %INC) { 1978 while (my ($k, $v) = each %MAP_PREFETCH) {
247 next unless $v =~ /^\Q$LIBDIR\E\/.*\.pm$/; 1979 if (my $map = find $k) {
248 1980 $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 } 1981 }
258 1982
259 Symbol::delete_package $k; 1983 delete $MAP_PREFETCH{$k};
260 } 1984 }
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 }; 1985 }
279 warn $@ if $@; 1986 undef $MAP_PREFETCHER;
280 $who->message ($@) if $@; 1987 };
281 warn "reloaded\n"; 1988 $MAP_PREFETCHER->prio (6);
282 1989
283 $who->message ("reloaded"); 1990 ()
1991}
1992
1993sub save {
1994 my ($self) = @_;
1995
1996 my $lock = cf::lock_acquire "map_data:$self->{path}";
1997
1998 $self->{last_save} = $cf::RUNTIME;
1999
2000 return unless $self->dirty;
2001
2002 my $save = $self->save_path; utf8::encode $save;
2003 my $uniq = $self->uniq_path; utf8::encode $uniq;
2004
2005 $self->{load_path} = $save;
2006
2007 return if $self->{deny_save};
2008
2009 local $self->{last_access} = $self->last_access;#d#
2010
2011 cf::async {
2012 $_->contr->save for $self->players;
2013 };
2014
2015 if ($uniq) {
2016 $self->_save_objects ($save, cf::IO_HEADER | cf::IO_OBJECTS);
2017 $self->_save_objects ($uniq, cf::IO_UNIQUES);
284 } else { 2018 } else {
285 $who->message ("Intruder Alert!"); 2019 $self->_save_objects ($save, cf::IO_HEADER | cf::IO_OBJECTS | cf::IO_UNIQUES);
286 } 2020 }
287};
288
289#############################################################################
290# extcmd framework, basically convert ext <id> <pkg> arg1 args
291# into pkg::->on_extcmd_arg1 (...) while shortcutting a few
292
293sub on_extcmd {
294 my ($pl, $buf) = @_;
295
296 my ($type) = $buf =~ s/^(\S+) // ? $1 : "";
297
298 $extcmd{$type}[0]->($pl, $buf)
299 if $extcmd{$type};
300} 2021}
301 2022
302############################################################################# 2023sub swap_out {
303# load/save/clean perl data associated with a map
304
305*on_mapclean = sub {
306 my ($map) = @_; 2024 my ($self) = @_;
307 2025
308 my $path = $map->tmpname; 2026 # save first because save cedes
309 defined $path or return; 2027 $self->save;
310 2028
311 unlink "$path.cfperl"; 2029 my $lock = cf::lock_acquire "map_data:$self->{path}";
312};
313 2030
314*on_mapin = 2031 return if $self->players;
315*on_mapload = sub { 2032 return if $self->in_memory != cf::MAP_IN_MEMORY;
2033 return if $self->{deny_save};
2034
2035 $self->clear;
2036 $self->in_memory (cf::MAP_SWAPPED);
2037}
2038
2039sub reset_at {
316 my ($map) = @_; 2040 my ($self) = @_;
317 2041
318 my $path = $map->tmpname; 2042 # TODO: safety, remove and allow resettable per-player maps
319 $path = $map->path unless defined $path; 2043 return 1e99 if $self->{deny_reset};
320 2044
321 open my $fh, "<:raw", "$path.cfperl" 2045 my $time = $self->fixed_resettime ? $self->{instantiate_time} : $self->last_access;
322 or return; # no perl data 2046 my $to = List::Util::min $MAX_RESET, $self->reset_timeout || $DEFAULT_RESET;
323 2047
324 my $data = Storable::thaw do { local $/; <$fh> }; 2048 $time + $to
2049}
325 2050
326 $data->{version} <= 1 2051sub should_reset {
327 or return; # too new
328
329 $map->_set_obs ($data->{obs});
330};
331
332*on_mapout = sub {
333 my ($map) = @_; 2052 my ($self) = @_;
334 2053
335 my $path = $map->tmpname; 2054 $self->reset_at <= $cf::RUNTIME
336 $path = $map->path unless defined $path; 2055}
337 2056
338 my $obs = $map->_get_obs; 2057sub reset {
2058 my ($self) = @_;
339 2059
340 if (defined $obs) { 2060 my $lock = cf::lock_acquire "map_data:$self->{path}";
341 open my $fh, ">:raw", "$path.cfperl"
342 or die "$path.cfperl: $!";
343 2061
344 stat $path; 2062 return if $self->players;
345 2063
346 print $fh Storable::nfreeze { 2064 warn "resetting map ", $self->path;
347 size => (stat _)[7],
348 time => (stat _)[9],
349 version => 1,
350 obs => $obs,
351 };
352 2065
353 chmod SAVE_MODE, "$path.cfperl"; # very racy, but cf-compatible *g* 2066 $self->in_memory (cf::MAP_SWAPPED);
354 } else { 2067
355 unlink "$path.cfperl"; 2068 # need to save uniques path
2069 unless ($self->{deny_save}) {
2070 my $uniq = $self->uniq_path; utf8::encode $uniq;
2071
2072 $self->_save_objects ($uniq, cf::IO_UNIQUES)
2073 if $uniq;
2074 }
2075
2076 delete $cf::MAP{$self->path};
2077
2078 $self->clear;
2079
2080 $_->clear_links_to ($self) for values %cf::MAP;
2081
2082 $self->unlink_save;
2083 $self->destroy;
2084}
2085
2086my $nuke_counter = "aaaa";
2087
2088sub nuke {
2089 my ($self) = @_;
2090
356 } 2091 {
357}; 2092 my $lock = cf::lock_acquire "map_data:$self->{path}";
358 2093
359############################################################################# 2094 delete $cf::MAP{$self->path};
360# load/save perl data associated with player->ob objects
361 2095
362*on_player_load = sub { 2096 bless $self, "cf::map";
363 my ($ob, $path) = @_; 2097 delete $self->{deny_reset};
2098 $self->{deny_save} = 1;
2099 $self->reset_timeout (1);
2100 $self->path ($self->{path} = "{nuke}/" . ($nuke_counter++));
364 2101
365 for my $o ($ob, $ob->inv) { 2102 $self->unlink_save;
366 if (my $value = $o->get_ob_key_value ("_perl_data")) {
367 $o->set_ob_key_value ("_perl_data");
368 2103
369 %$o = %{ Storable::thaw pack "H*", $value }; 2104 $cf::MAP{$self->path} = $self;
370 } 2105 }
2106
2107 $self->reset; # polite request, might not happen
2108}
2109
2110=item $maps = cf::map::tmp_maps
2111
2112Returns an arrayref with all map paths of currently instantiated and saved
2113maps. May block.
2114
2115=cut
2116
2117sub tmp_maps() {
371 } 2118 [
372}; 2119 map {
373 2120 utf8::decode $_;
374*on_player_save = sub { 2121 /\.map$/
375 my ($ob, $path) = @_; 2122 ? normalise $_
376 2123 : ()
377 $_->set_ob_key_value (_perl_data => unpack "H*", Storable::nfreeze $_) 2124 } @{ aio_readdir $TMPDIR or [] }
378 for grep %$_, $ob, $ob->inv; 2125 ]
379};
380
381#############################################################################
382# core extensions - in perl
383
384=item cf::player::exists $login
385
386Returns true when the given account exists.
387
388=cut
389
390sub cf::player::exists($) {
391 cf::player::find $_[0]
392 or -f sprintf "%s/%s/%s/%s.pl", cf::localdir, cf::playerdir, ($_[0]) x 2;
393} 2126}
2127
2128=item $maps = cf::map::random_maps
2129
2130Returns an arrayref with all map paths of currently instantiated and saved
2131random maps. May block.
2132
2133=cut
2134
2135sub random_maps() {
2136 [
2137 map {
2138 utf8::decode $_;
2139 /\.map$/
2140 ? normalise "?random/$_"
2141 : ()
2142 } @{ aio_readdir $RANDOMDIR or [] }
2143 ]
2144}
2145
2146=item cf::map::unique_maps
2147
2148Returns an arrayref of paths of all shared maps that have
2149instantiated unique items. May block.
2150
2151=cut
2152
2153sub unique_maps() {
2154 [
2155 map {
2156 utf8::decode $_;
2157 /\.map$/
2158 ? normalise $_
2159 : ()
2160 } @{ aio_readdir $UNIQUEDIR or [] }
2161 ]
2162}
2163
2164package cf;
2165
2166=back
2167
2168=head3 cf::object
2169
2170=cut
2171
2172package cf::object;
2173
2174=over 4
2175
2176=item $ob->inv_recursive
2177
2178Returns the inventory of the object _and_ their inventories, recursively.
2179
2180=cut
2181
2182sub inv_recursive_;
2183sub inv_recursive_ {
2184 map { $_, inv_recursive_ $_->inv } @_
2185}
2186
2187sub inv_recursive {
2188 inv_recursive_ inv $_[0]
2189}
2190
2191package cf;
2192
2193=back
2194
2195=head3 cf::object::player
2196
2197=over 4
2198
2199=item $player_object->reply ($npc, $msg[, $flags])
2200
2201Sends a message to the player, as if the npc C<$npc> replied. C<$npc>
2202can be C<undef>. Does the right thing when the player is currently in a
2203dialogue with the given NPC character.
2204
2205=cut
394 2206
395# rough implementation of a future "reply" method that works 2207# rough implementation of a future "reply" method that works
396# with dialog boxes. 2208# with dialog boxes.
2209#TODO: the first argument must go, split into a $npc->reply_to ( method
397sub cf::object::player::reply($$$;$) { 2210sub cf::object::player::reply($$$;$) {
398 my ($self, $npc, $msg, $flags) = @_; 2211 my ($self, $npc, $msg, $flags) = @_;
399 2212
400 $flags = cf::NDI_BROWN | cf::NDI_UNIQUE unless @_ >= 4; 2213 $flags = cf::NDI_BROWN | cf::NDI_UNIQUE unless @_ >= 4;
401 2214
402 if ($self->{record_replies}) { 2215 if ($self->{record_replies}) {
403 push @{ $self->{record_replies} }, [$npc, $msg, $flags]; 2216 push @{ $self->{record_replies} }, [$npc, $msg, $flags];
2217
404 } else { 2218 } else {
2219 my $pl = $self->contr;
2220
2221 if ($pl->{npc_dialog} && $pl->{npc_dialog}->{id}) {
2222 my $dialog = $pl->{npc_dialog};
2223 $dialog->{pl}->ext_msg ($dialog->{id}, update => msg => $dialog->{pl}->expand_cfpod ($msg));
2224
2225 } else {
405 $msg = $npc->name . " says: $msg" if $npc; 2226 $msg = $npc->name . " says: $msg" if $npc;
406 $self->message ($msg, $flags); 2227 $self->message ($msg, $flags);
2228 }
2229 }
2230}
2231
2232=item $object->send_msg ($channel, $msg, $color, [extra...])
2233
2234=cut
2235
2236sub cf::object::send_msg {
2237 my $pl = shift->contr
2238 or return;
2239 $pl->send_msg (@_);
2240}
2241
2242=item $player_object->may ("access")
2243
2244Returns wether the given player is authorized to access resource "access"
2245(e.g. "command_wizcast").
2246
2247=cut
2248
2249sub cf::object::player::may {
2250 my ($self, $access) = @_;
2251
2252 $self->flag (cf::FLAG_WIZ) ||
2253 (ref $cf::CFG{"may_$access"}
2254 ? scalar grep $self->name eq $_, @{$cf::CFG{"may_$access"}}
2255 : $cf::CFG{"may_$access"})
2256}
2257
2258=item $player_object->enter_link
2259
2260Freezes the player and moves him/her to a special map (C<{link}>).
2261
2262The player should be reasonably safe there for short amounts of time. You
2263I<MUST> call C<leave_link> as soon as possible, though.
2264
2265Will never block.
2266
2267=item $player_object->leave_link ($map, $x, $y)
2268
2269Moves the player out of the special C<{link}> map onto the specified
2270map. If the map is not valid (or omitted), the player will be moved back
2271to the location he/she was before the call to C<enter_link>, or, if that
2272fails, to the emergency map position.
2273
2274Might block.
2275
2276=cut
2277
2278sub link_map {
2279 unless ($LINK_MAP) {
2280 $LINK_MAP = cf::map::find "{link}"
2281 or cf::cleanup "FATAL: unable to provide {link} map, exiting.";
2282 $LINK_MAP->load;
2283 }
2284
2285 $LINK_MAP
2286}
2287
2288sub cf::object::player::enter_link {
2289 my ($self) = @_;
2290
2291 $self->deactivate_recursive;
2292
2293 return if UNIVERSAL::isa $self->map, "ext::map_link";
2294
2295 $self->{_link_pos} ||= [$self->map->{path}, $self->x, $self->y]
2296 if $self->map && $self->map->{path} ne "{link}";
2297
2298 $self->enter_map ($LINK_MAP || link_map, 10, 10);
2299}
2300
2301sub cf::object::player::leave_link {
2302 my ($self, $map, $x, $y) = @_;
2303
2304 return unless $self->contr->active;
2305
2306 my $link_pos = delete $self->{_link_pos};
2307
2308 unless ($map) {
2309 # restore original map position
2310 ($map, $x, $y) = @{ $link_pos || [] };
2311 $map = cf::map::find $map;
2312
2313 unless ($map) {
2314 ($map, $x, $y) = @$EMERGENCY_POSITION;
2315 $map = cf::map::find $map
2316 or die "FATAL: cannot load emergency map\n";
2317 }
2318 }
2319
2320 ($x, $y) = (-1, -1)
2321 unless (defined $x) && (defined $y);
2322
2323 # use -1 or undef as default coordinates, not 0, 0
2324 ($x, $y) = ($map->enter_x, $map->enter_y)
2325 if $x <=0 && $y <= 0;
2326
2327 $map->load;
2328 $map->load_neighbours;
2329
2330 return unless $self->contr->active;
2331 $self->activate_recursive;
2332
2333 local $self->{_prev_pos} = $link_pos; # ugly hack for rent.ext
2334 $self->enter_map ($map, $x, $y);
2335}
2336
2337=item $player_object->goto ($path, $x, $y[, $check->($map)[, $done->()]])
2338
2339Moves the player to the given map-path and coordinates by first freezing
2340her, loading and preparing them map, calling the provided $check callback
2341that has to return the map if sucecssful, and then unfreezes the player on
2342the new (success) or old (failed) map position. In either case, $done will
2343be called at the end of this process.
2344
2345=cut
2346
2347our $GOTOGEN;
2348
2349sub cf::object::player::goto {
2350 my ($self, $path, $x, $y, $check, $done) = @_;
2351
2352 # do generation counting so two concurrent goto's will be executed in-order
2353 my $gen = $self->{_goto_generation} = ++$GOTOGEN;
2354
2355 $self->enter_link;
2356
2357 (async {
2358 my $map = eval {
2359 my $map = cf::map::find $path;
2360
2361 if ($map) {
2362 $map = $map->customise_for ($self);
2363 $map = $check->($map) if $check && $map;
2364 } else {
2365 $self->message ("The exit to '$path' is closed", cf::NDI_UNIQUE | cf::NDI_RED);
2366 }
2367
2368 $map
2369 };
2370
2371 if ($@) {
2372 $self->message ("Something went wrong within the server, please report this incident!", cf::NDI_UNIQUE | cf::NDI_RED);
2373 LOG llevError | logBacktrace, Carp::longmess $@;
2374 }
2375
2376 if ($gen == $self->{_goto_generation}) {
2377 delete $self->{_goto_generation};
2378 $self->leave_link ($map, $x, $y);
2379 }
2380
2381 $done->() if $done;
2382 })->prio (1);
2383}
2384
2385=item $player_object->enter_exit ($exit_object)
2386
2387=cut
2388
2389sub parse_random_map_params {
2390 my ($spec) = @_;
2391
2392 my $rmp = { # defaults
2393 xsize => (cf::rndm 15, 40),
2394 ysize => (cf::rndm 15, 40),
2395 symmetry => (cf::rndm 1, cf::SYMMETRY_XY),
2396 #layout => string,
407 } 2397 };
408}
409 2398
410############################################################################# 2399 for (split /\n/, $spec) {
411# map scripting support 2400 my ($k, $v) = split /\s+/, $_, 2;
412 2401
2402 $rmp->{lc $k} = $v if (length $k) && (length $v);
2403 }
2404
2405 $rmp
2406}
2407
2408sub prepare_random_map {
2409 my ($exit) = @_;
2410
2411 my $guard = cf::lock_acquire "exit_prepare:$exit";
2412
2413 # all this does is basically replace the /! path by
2414 # a new random map path (?random/...) with a seed
2415 # that depends on the exit object
2416
2417 my $rmp = parse_random_map_params $exit->msg;
2418
2419 if ($exit->map) {
2420 $rmp->{region} = $exit->region->name;
2421 $rmp->{origin_map} = $exit->map->path;
2422 $rmp->{origin_x} = $exit->x;
2423 $rmp->{origin_y} = $exit->y;
2424 }
2425
2426 $rmp->{random_seed} ||= $exit->random_seed;
2427
2428 my $data = cf::to_json $rmp;
2429 my $md5 = Digest::MD5::md5_hex $data;
2430 my $meta = "$RANDOMDIR/$md5.meta";
2431
2432 if (my $fh = aio_open "$meta~", O_WRONLY | O_CREAT, 0666) {
2433 aio_write $fh, 0, (length $data), $data, 0;
2434 undef $fh;
2435 aio_rename "$meta~", $meta;
2436
2437 $exit->slaying ("?random/$md5");
2438 $exit->msg (undef);
2439 }
2440}
2441
2442sub cf::object::player::enter_exit {
2443 my ($self, $exit) = @_;
2444
2445 return unless $self->type == cf::PLAYER;
2446
2447 if ($exit->slaying eq "/!") {
2448 #TODO: this should de-fi-ni-te-ly not be a sync-job
2449 # the problem is that $exit might not survive long enough
2450 # so it needs to be done right now, right here
2451 cf::sync_job { prepare_random_map $exit };
2452 }
2453
2454 my $slaying = cf::map::normalise $exit->slaying, $exit->map && $exit->map->path;
2455 my $hp = $exit->stats->hp;
2456 my $sp = $exit->stats->sp;
2457
2458 $self->enter_link;
2459
2460 # if exit is damned, update players death & WoR home-position
2461 $self->contr->savebed ($slaying, $hp, $sp)
2462 if $exit->flag (FLAG_DAMNED);
2463
2464 (async {
2465 $self->deactivate_recursive; # just to be sure
2466 unless (eval {
2467 $self->goto ($slaying, $hp, $sp);
2468
2469 1;
2470 }) {
2471 $self->message ("Something went wrong deep within the crossfire server. "
2472 . "I'll try to bring you back to the map you were before. "
2473 . "Please report this to the dungeon master!",
2474 cf::NDI_UNIQUE | cf::NDI_RED);
2475
2476 warn "ERROR in enter_exit: $@";
2477 $self->leave_link;
2478 }
2479 })->prio (1);
2480}
2481
2482=head3 cf::client
2483
2484=over 4
2485
2486=item $client->send_drawinfo ($text, $flags)
2487
2488Sends a drawinfo packet to the client. Circumvents output buffering so
2489should not be used under normal circumstances.
2490
2491=cut
2492
2493sub cf::client::send_drawinfo {
2494 my ($self, $text, $flags) = @_;
2495
2496 utf8::encode $text;
2497 $self->send_packet (sprintf "drawinfo %d %s", $flags || cf::NDI_BLACK, $text);
2498}
2499
2500=item $client->send_msg ($channel, $msg, $color, [extra...])
2501
2502Send a drawinfo or msg packet to the client, formatting the msg for the
2503client if neccessary. C<$type> should be a string identifying the type of
2504the message, with C<log> being the default. If C<$color> is negative, suppress
2505the message unless the client supports the msg packet.
2506
2507=cut
2508
2509sub cf::client::send_msg {
2510 my ($self, $channel, $msg, $color, @extra) = @_;
2511
2512 $msg = $self->pl->expand_cfpod ($msg);
2513
2514 $color &= cf::NDI_CLIENT_MASK; # just in case...
2515
2516 if (ref $channel) {
2517 # send meta info to client, if not yet sent
2518 unless (exists $self->{channel}{$channel->{id}}) {
2519 $self->{channel}{$channel->{id}} = $channel;
2520 $self->ext_msg (channel_info => $channel);
2521 }
2522
2523 $channel = $channel->{id};
2524 }
2525
2526 return unless @extra || length $msg;
2527
2528 if ($self->can_msg) {
2529 # default colour, mask it out
2530 $color &= ~(cf::NDI_COLOR_MASK | cf::NDI_DEF)
2531 if $color & cf::NDI_DEF;
2532
2533 $self->send_packet ("msg " . $self->{json_coder}->encode (
2534 [$color & cf::NDI_CLIENT_MASK, $channel, $msg, @extra]));
2535 } else {
2536 if ($color >= 0) {
2537 # replace some tags by gcfclient-compatible ones
2538 for ($msg) {
2539 1 while
2540 s/<b>([^<]*)<\/b>/[b]${1}[\/b]/
2541 || s/<i>([^<]*)<\/i>/[i]${1}[\/i]/
2542 || s/<u>([^<]*)<\/u>/[ul]${1}[\/ul]/
2543 || s/<tt>([^<]*)<\/tt>/[fixed]${1}[\/fixed]/
2544 || s/<fg name=\"([^"]+)\">([^<]*)<\/fg>/[color=$1]${2}[\/color]/;
2545 }
2546
2547 $color &= cf::NDI_COLOR_MASK;
2548
2549 utf8::encode $msg;
2550
2551 if (0 && $msg =~ /\[/) {
2552 # COMMAND/INFO
2553 $self->send_packet ("drawextinfo $color 10 8 $msg")
2554 } else {
2555 $msg =~ s/\[\/?(?:b|i|u|fixed|color)[^\]]*\]//g;
2556 $self->send_packet ("drawinfo $color $msg")
2557 }
2558 }
2559 }
2560}
2561
2562=item $client->ext_msg ($type, @msg)
2563
2564Sends an ext event to the client.
2565
2566=cut
2567
2568sub cf::client::ext_msg($$@) {
2569 my ($self, $type, @msg) = @_;
2570
2571 if ($self->extcmd == 2) {
2572 $self->send_packet ("ext " . $self->{json_coder}->encode ([$type, @msg]));
2573 } elsif ($self->extcmd == 1) { # TODO: remove
2574 push @msg, msgtype => "event_$type";
2575 $self->send_packet ("ext " . $self->{json_coder}->encode ({@msg}));
2576 }
2577}
2578
2579=item $client->ext_reply ($msgid, @msg)
2580
2581Sends an ext reply to the client.
2582
2583=cut
2584
2585sub cf::client::ext_reply($$@) {
2586 my ($self, $id, @msg) = @_;
2587
2588 if ($self->extcmd == 2) {
2589 $self->send_packet ("ext " . $self->{json_coder}->encode (["reply-$id", @msg]));
2590 } elsif ($self->extcmd == 1) {
2591 #TODO: version 1, remove
2592 unshift @msg, msgtype => "reply", msgid => $id;
2593 $self->send_packet ("ext " . $self->{json_coder}->encode ({@msg}));
2594 }
2595}
2596
2597=item $success = $client->query ($flags, "text", \&cb)
2598
2599Queues a query to the client, calling the given callback with
2600the reply text on a reply. flags can be C<cf::CS_QUERY_YESNO>,
2601C<cf::CS_QUERY_SINGLECHAR> or C<cf::CS_QUERY_HIDEINPUT> or C<0>.
2602
2603Queries can fail, so check the return code. Or don't, as queries will
2604become reliable at some point in the future.
2605
2606=cut
2607
2608sub cf::client::query {
2609 my ($self, $flags, $text, $cb) = @_;
2610
2611 return unless $self->state == ST_PLAYING
2612 || $self->state == ST_SETUP
2613 || $self->state == ST_CUSTOM;
2614
2615 $self->state (ST_CUSTOM);
2616
2617 utf8::encode $text;
2618 push @{ $self->{query_queue} }, [(sprintf "query %d %s", $flags, $text), $cb];
2619
2620 $self->send_packet ($self->{query_queue}[0][0])
2621 if @{ $self->{query_queue} } == 1;
2622
2623 1
2624}
2625
2626cf::client->attach (
2627 on_connect => sub {
2628 my ($ns) = @_;
2629
2630 $ns->{json_coder} = JSON::XS->new->utf8->max_size (1e6)->convert_blessed;
2631 },
2632 on_reply => sub {
2633 my ($ns, $msg) = @_;
2634
2635 # this weird shuffling is so that direct followup queries
2636 # get handled first
2637 my $queue = delete $ns->{query_queue}
2638 or return; # be conservative, not sure how that can happen, but we saw a crash here
2639
2640 (shift @$queue)->[1]->($msg);
2641 return unless $ns->valid; # temporary(?) workaround for callback destroying socket
2642
2643 push @{ $ns->{query_queue} }, @$queue;
2644
2645 if (@{ $ns->{query_queue} } == @$queue) {
2646 if (@$queue) {
2647 $ns->send_packet ($ns->{query_queue}[0][0]);
2648 } else {
2649 $ns->state (ST_PLAYING) if $ns->state == ST_CUSTOM;
2650 }
2651 }
2652 },
2653 on_exticmd => sub {
2654 my ($ns, $buf) = @_;
2655
2656 my $msg = eval { $ns->{json_coder}->decode ($buf) };
2657
2658 if (ref $msg) {
2659 my ($type, $reply, @payload) =
2660 "ARRAY" eq ref $msg
2661 ? @$msg
2662 : ($msg->{msgtype}, $msg->{msgid}, %$msg); # TODO: version 1, remove
2663
2664 my @reply;
2665
2666 if (my $cb = $EXTICMD{$type}) {
2667 @reply = $cb->($ns, @payload);
2668 }
2669
2670 $ns->ext_reply ($reply, @reply)
2671 if $reply;
2672
2673 } else {
2674 warn "client " . ($ns->pl ? $ns->pl->ob->name : $ns->host) . " sent unparseable exti message: <$buf>\n";
2675 }
2676
2677 cf::override;
2678 },
2679);
2680
2681=item $client->async (\&cb)
2682
2683Create a new coroutine, running the specified callback. The coroutine will
2684be automatically cancelled when the client gets destroyed (e.g. on logout,
2685or loss of connection).
2686
2687=cut
2688
2689sub cf::client::async {
2690 my ($self, $cb) = @_;
2691
2692 my $coro = &Coro::async ($cb);
2693
2694 $coro->on_destroy (sub {
2695 delete $self->{_coro}{$coro+0};
2696 });
2697
2698 $self->{_coro}{$coro+0} = $coro;
2699
2700 $coro
2701}
2702
2703cf::client->attach (
2704 on_destroy => sub {
2705 my ($ns) = @_;
2706
2707 $_->cancel for values %{ (delete $ns->{_coro}) || {} };
2708 },
2709);
2710
2711=back
2712
2713
2714=head2 SAFE SCRIPTING
2715
2716Functions that provide a safe environment to compile and execute
2717snippets of perl code without them endangering the safety of the server
2718itself. Looping constructs, I/O operators and other built-in functionality
2719is not available in the safe scripting environment, and the number of
2720functions and methods that can be called is greatly reduced.
2721
2722=cut
2723
413our $safe = new Safe "ext"; 2724our $safe = new Safe "safe";
414our $safe_hole = new Safe::Hole; 2725our $safe_hole = new Safe::Hole;
415 2726
416$SIG{FPE} = 'IGNORE'; 2727$SIG{FPE} = 'IGNORE';
417 2728
418$safe->permit_only (Opcode::opset qw(:base_core :base_mem :base_orig :base_math sort time)); 2729$safe->permit_only (Opcode::opset qw(
2730 :base_core :base_mem :base_orig :base_math
2731 grepstart grepwhile mapstart mapwhile
2732 sort time
2733));
419 2734
420# here we export the classes and methods available to script code 2735# here we export the classes and methods available to script code
421 2736
2737=pod
2738
2739The following functions and methods are available within a safe environment:
2740
2741 cf::object
2742 contr pay_amount pay_player map x y force_find force_add
2743 insert remove name archname title slaying race decrease_ob_nr
2744
2745 cf::object::player
2746 player
2747
2748 cf::player
2749 peaceful
2750
2751 cf::map
2752 trigger
2753
2754=cut
2755
422for ( 2756for (
423 ["cf::object" => qw(contr pay_amount pay_player)], 2757 ["cf::object" => qw(contr pay_amount pay_player map force_find force_add x y
2758 insert remove inv name archname title slaying race
2759 decrease_ob_nr)],
424 ["cf::object::player" => qw(player)], 2760 ["cf::object::player" => qw(player)],
425 ["cf::player" => qw(peaceful)], 2761 ["cf::player" => qw(peaceful)],
2762 ["cf::map" => qw(trigger)],
426) { 2763) {
427 no strict 'refs'; 2764 no strict 'refs';
428 my ($pkg, @funs) = @$_; 2765 my ($pkg, @funs) = @$_;
429 *{"ext::$pkg\::$_"} = $safe_hole->wrap (\&{"$pkg\::$_"}) 2766 *{"safe::$pkg\::$_"} = $safe_hole->wrap (\&{"$pkg\::$_"})
430 for @funs; 2767 for @funs;
431} 2768}
2769
2770=over 4
2771
2772=item @retval = safe_eval $code, [var => value, ...]
2773
2774Compiled and executes the given perl code snippet. additional var/value
2775pairs result in temporary local (my) scalar variables of the given name
2776that are available in the code snippet. Example:
2777
2778 my $five = safe_eval '$first + $second', first => 1, second => 4;
2779
2780=cut
432 2781
433sub safe_eval($;@) { 2782sub safe_eval($;@) {
434 my ($code, %vars) = @_; 2783 my ($code, %vars) = @_;
435 2784
436 my $qcode = $code; 2785 my $qcode = $code;
437 $qcode =~ s/"/‟/g; # not allowed in #line filenames 2786 $qcode =~ s/"/‟/g; # not allowed in #line filenames
438 $qcode =~ s/\n/\\n/g; 2787 $qcode =~ s/\n/\\n/g;
439 2788
440 local $_; 2789 local $_;
441 local @ext::cf::_safe_eval_args = values %vars; 2790 local @safe::cf::_safe_eval_args = values %vars;
442 2791
443 $code = 2792 my $eval =
444 "do {\n" 2793 "do {\n"
445 . "my (" . (join ",", map "\$$_", keys %vars) . ") = \@cf::_safe_eval_args;\n" 2794 . "my (" . (join ",", map "\$$_", keys %vars) . ") = \@cf::_safe_eval_args;\n"
446 . "#line 0 \"{$qcode}\"\n" 2795 . "#line 0 \"{$qcode}\"\n"
447 . $code 2796 . $code
448 . "\n}" 2797 . "\n}"
449 ; 2798 ;
450 2799
451 sub_generation_inc; 2800 sub_generation_inc;
452 my @res = wantarray ? $safe->reval ($code) : scalar $safe->reval ($code); 2801 my @res = wantarray ? $safe->reval ($eval) : scalar $safe->reval ($eval);
453 sub_generation_inc; 2802 sub_generation_inc;
454 2803
2804 if ($@) {
2805 warn "$@";
2806 warn "while executing safe code '$code'\n";
2807 warn "with arguments " . (join " ", %vars) . "\n";
2808 }
2809
455 wantarray ? @res : $res[0] 2810 wantarray ? @res : $res[0]
456} 2811}
2812
2813=item cf::register_script_function $function => $cb
2814
2815Register a function that can be called from within map/npc scripts. The
2816function should be reasonably secure and should be put into a package name
2817like the extension.
2818
2819Example: register a function that gets called whenever a map script calls
2820C<rent::overview>, as used by the C<rent> extension.
2821
2822 cf::register_script_function "rent::overview" => sub {
2823 ...
2824 };
2825
2826=cut
457 2827
458sub register_script_function { 2828sub register_script_function {
459 my ($fun, $cb) = @_; 2829 my ($fun, $cb) = @_;
460 2830
461 no strict 'refs'; 2831 no strict 'refs';
462 *{"ext::$fun"} = $safe_hole->wrap ($cb); 2832 *{"safe::$fun"} = $safe_hole->wrap ($cb);
463} 2833}
2834
2835=back
2836
2837=cut
464 2838
465############################################################################# 2839#############################################################################
466# initialisation 2840# the server's init and main functions
467 2841
468register "<global>", __PACKAGE__; 2842sub load_facedata($) {
2843 my ($path) = @_;
2844
2845 # HACK to clear player env face cache, we need some signal framework
2846 # for this (global event?)
2847 %ext::player_env::MUSIC_FACE_CACHE = ();
2848
2849 my $enc = JSON::XS->new->utf8->canonical->relaxed;
2850
2851 warn "loading facedata from $path\n";
2852
2853 my $facedata;
2854 0 < aio_load $path, $facedata
2855 or die "$path: $!";
2856
2857 $facedata = Coro::Storable::thaw $facedata;
2858
2859 $facedata->{version} == 2
2860 or cf::cleanup "$path: version mismatch, cannot proceed.";
2861
2862 # patch in the exptable
2863 $facedata->{resource}{"res/exp_table"} = {
2864 type => FT_RSRC,
2865 data => $enc->encode ([map cf::level_to_min_exp $_, 1 .. cf::settings->max_level]),
2866 };
2867 cf::cede_to_tick;
2868
2869 {
2870 my $faces = $facedata->{faceinfo};
2871
2872 while (my ($face, $info) = each %$faces) {
2873 my $idx = (cf::face::find $face) || cf::face::alloc $face;
2874 cf::face::set_visibility $idx, $info->{visibility};
2875 cf::face::set_magicmap $idx, $info->{magicmap};
2876 cf::face::set_data $idx, 0, $info->{data32}, Digest::MD5::md5 $info->{data32};
2877 cf::face::set_data $idx, 1, $info->{data64}, Digest::MD5::md5 $info->{data64};
2878
2879 cf::cede_to_tick;
2880 }
2881
2882 while (my ($face, $info) = each %$faces) {
2883 next unless $info->{smooth};
2884 my $idx = cf::face::find $face
2885 or next;
2886 if (my $smooth = cf::face::find $info->{smooth}) {
2887 cf::face::set_smooth $idx, $smooth;
2888 cf::face::set_smoothlevel $idx, $info->{smoothlevel};
2889 } else {
2890 warn "smooth face '$info->{smooth}' not found for face '$face'";
2891 }
2892
2893 cf::cede_to_tick;
2894 }
2895 }
2896
2897 {
2898 my $anims = $facedata->{animinfo};
2899
2900 while (my ($anim, $info) = each %$anims) {
2901 cf::anim::set $anim, $info->{frames}, $info->{facings};
2902 cf::cede_to_tick;
2903 }
2904
2905 cf::anim::invalidate_all; # d'oh
2906 }
2907
2908 {
2909 # TODO: for gcfclient pleasure, we should give resources
2910 # that gcfclient doesn't grok a >10000 face index.
2911 my $res = $facedata->{resource};
2912
2913 my $soundconf = delete $res->{"res/sound.conf"};
2914
2915 while (my ($name, $info) = each %$res) {
2916 my $idx = (cf::face::find $name) || cf::face::alloc $name;
2917 my $data;
2918
2919 if ($info->{type} & 1) {
2920 # prepend meta info
2921
2922 my $meta = $enc->encode ({
2923 name => $name,
2924 %{ $info->{meta} || {} },
2925 });
2926
2927 $data = pack "(w/a*)*", $meta, $info->{data};
2928 } else {
2929 $data = $info->{data};
2930 }
2931
2932 cf::face::set_data $idx, 0, $data, Digest::MD5::md5 $data;
2933 cf::face::set_type $idx, $info->{type};
2934
2935 cf::cede_to_tick;
2936 }
2937
2938 if ($soundconf) {
2939 $soundconf = $enc->decode (delete $soundconf->{data});
2940
2941 for (0 .. SOUND_CAST_SPELL_0 - 1) {
2942 my $sound = $soundconf->{compat}[$_]
2943 or next;
2944
2945 my $face = cf::face::find "sound/$sound->[1]";
2946 cf::sound::set $sound->[0] => $face;
2947 cf::sound::old_sound_index $_, $face; # gcfclient-compat
2948 }
2949
2950 while (my ($k, $v) = each %{$soundconf->{event}}) {
2951 my $face = cf::face::find "sound/$v";
2952 cf::sound::set $k => $face;
2953 }
2954 }
2955 }
2956
2957 1
2958}
2959
2960register_exticmd fx_want => sub {
2961 my ($ns, $want) = @_;
2962
2963 while (my ($k, $v) = each %$want) {
2964 $ns->fx_want ($k, $v);
2965 }
2966};
2967
2968sub reload_regions {
2969 # HACK to clear player env face cache, we need some signal framework
2970 # for this (global event?)
2971 %ext::player_env::MUSIC_FACE_CACHE = ();
2972
2973 load_resource_file "$MAPDIR/regions"
2974 or die "unable to load regions file\n";
2975
2976 for (cf::region::list) {
2977 $_->{match} = qr/$_->{match}/
2978 if exists $_->{match};
2979 }
2980}
2981
2982sub reload_facedata {
2983 load_facedata "$DATADIR/facedata"
2984 or die "unable to load facedata\n";
2985}
2986
2987sub reload_archetypes {
2988 load_resource_file "$DATADIR/archetypes"
2989 or die "unable to load archetypes\n";
2990 #d# NEED to laod twice to resolve forward references
2991 # this really needs to be done in an extra post-pass
2992 # (which needs to be synchronous, so solve it differently)
2993 load_resource_file "$DATADIR/archetypes"
2994 or die "unable to load archetypes\n";
2995}
2996
2997sub reload_treasures {
2998 load_resource_file "$DATADIR/treasures"
2999 or die "unable to load treasurelists\n";
3000}
3001
3002sub reload_resources {
3003 warn "reloading resource files...\n";
3004
3005 reload_regions;
3006 reload_facedata;
3007 #reload_archetypes;#d#
3008 reload_archetypes;
3009 reload_treasures;
3010
3011 warn "finished reloading resource files\n";
3012}
3013
3014sub init {
3015 reload_resources;
3016}
3017
3018sub reload_config {
3019 open my $fh, "<:utf8", "$CONFDIR/config"
3020 or return;
3021
3022 local $/;
3023 *CFG = YAML::Syck::Load <$fh>;
3024
3025 $EMERGENCY_POSITION = $CFG{emergency_position} || ["/world/world_105_115", 5, 37];
3026
3027 $cf::map::MAX_RESET = $CFG{map_max_reset} if exists $CFG{map_max_reset};
3028 $cf::map::DEFAULT_RESET = $CFG{map_default_reset} if exists $CFG{map_default_reset};
3029
3030 if (exists $CFG{mlockall}) {
3031 eval {
3032 $CFG{mlockall} ? eval "mlockall()" : eval "munlockall()"
3033 and die "WARNING: m(un)lockall failed: $!\n";
3034 };
3035 warn $@ if $@;
3036 }
3037}
3038
3039sub main {
3040 # we must not ever block the main coroutine
3041 local $Coro::idle = sub {
3042 Carp::cluck "FATAL: Coro::idle was called, major BUG, use cf::sync_job!\n";#d#
3043 (async {
3044 Event::one_event;
3045 })->prio (Coro::PRIO_MAX);
3046 };
3047
3048 reload_config;
3049 db_init;
3050 load_extensions;
3051
3052 $TICK_WATCHER->start;
3053 Event::loop;
3054}
3055
3056#############################################################################
3057# initialisation and cleanup
3058
3059# install some emergency cleanup handlers
3060BEGIN {
3061 for my $signal (qw(INT HUP TERM)) {
3062 Event->signal (
3063 reentrant => 0,
3064 data => WF_AUTOCANCEL,
3065 signal => $signal,
3066 prio => 0,
3067 cb => sub {
3068 cf::cleanup "SIG$signal";
3069 },
3070 );
3071 }
3072}
3073
3074sub write_runtime {
3075 my $runtime = "$LOCALDIR/runtime";
3076
3077 # first touch the runtime file to show we are still running:
3078 # the fsync below can take a very very long time.
3079
3080 IO::AIO::aio_utime $runtime, undef, undef;
3081
3082 my $guard = cf::lock_acquire "write_runtime";
3083
3084 my $fh = aio_open "$runtime~", O_WRONLY | O_CREAT, 0644
3085 or return;
3086
3087 my $value = $cf::RUNTIME + 90 + 10;
3088 # 10 is the runtime save interval, for a monotonic clock
3089 # 60 allows for the watchdog to kill the server.
3090
3091 (aio_write $fh, 0, (length $value), $value, 0) <= 0
3092 and return;
3093
3094 # always fsync - this file is important
3095 aio_fsync $fh
3096 and return;
3097
3098 # touch it again to show we are up-to-date
3099 aio_utime $fh, undef, undef;
3100
3101 close $fh
3102 or return;
3103
3104 aio_rename "$runtime~", $runtime
3105 and return;
3106
3107 warn "runtime file written.\n";
3108
3109 1
3110}
3111
3112sub emergency_save() {
3113 my $freeze_guard = cf::freeze_mainloop;
3114
3115 warn "enter emergency perl save\n";
3116
3117 cf::sync_job {
3118 # use a peculiar iteration method to avoid tripping on perl
3119 # refcount bugs in for. also avoids problems with players
3120 # and maps saved/destroyed asynchronously.
3121 warn "begin emergency player save\n";
3122 for my $login (keys %cf::PLAYER) {
3123 my $pl = $cf::PLAYER{$login} or next;
3124 $pl->valid or next;
3125 $pl->save;
3126 }
3127 warn "end emergency player save\n";
3128
3129 warn "begin emergency map save\n";
3130 for my $path (keys %cf::MAP) {
3131 my $map = $cf::MAP{$path} or next;
3132 $map->valid or next;
3133 $map->save;
3134 }
3135 warn "end emergency map save\n";
3136
3137 warn "begin emergency database checkpoint\n";
3138 BDB::db_env_txn_checkpoint $DB_ENV;
3139 warn "end emergency database checkpoint\n";
3140 };
3141
3142 warn "leave emergency perl save\n";
3143}
3144
3145sub post_cleanup {
3146 my ($make_core) = @_;
3147
3148 warn Carp::longmess "post_cleanup backtrace"
3149 if $make_core;
3150}
3151
3152sub do_reload_perl() {
3153 # can/must only be called in main
3154 if ($Coro::current != $Coro::main) {
3155 warn "can only reload from main coroutine";
3156 return;
3157 }
3158
3159 warn "reloading...";
3160
3161 warn "entering sync_job";
3162
3163 cf::sync_job {
3164 cf::write_runtime; # external watchdog should not bark
3165 cf::emergency_save;
3166 cf::write_runtime; # external watchdog should not bark
3167
3168 warn "syncing database to disk";
3169 BDB::db_env_txn_checkpoint $DB_ENV;
3170
3171 # if anything goes wrong in here, we should simply crash as we already saved
3172
3173 warn "cancelling all WF_AUTOCANCEL watchers";
3174 for (Event::all_watchers) {
3175 $_->cancel if $_->data & WF_AUTOCANCEL;
3176 }
3177
3178 warn "flushing outstanding aio requests";
3179 for (;;) {
3180 BDB::flush;
3181 IO::AIO::flush;
3182 Coro::cede;
3183 last unless IO::AIO::nreqs || BDB::nreqs;
3184 warn "iterate...";
3185 }
3186
3187 ++$RELOAD;
3188
3189 warn "cancelling all extension coros";
3190 $_->cancel for values %EXT_CORO;
3191 %EXT_CORO = ();
3192
3193 warn "removing commands";
3194 %COMMAND = ();
3195
3196 warn "removing ext/exti commands";
3197 %EXTCMD = ();
3198 %EXTICMD = ();
3199
3200 warn "unloading/nuking all extensions";
3201 for my $pkg (@EXTS) {
3202 warn "... unloading $pkg";
3203
3204 if (my $cb = $pkg->can ("unload")) {
3205 eval {
3206 $cb->($pkg);
3207 1
3208 } or warn "$pkg unloaded, but with errors: $@";
3209 }
3210
3211 warn "... nuking $pkg";
3212 Symbol::delete_package $pkg;
3213 }
3214
3215 warn "unloading all perl modules loaded from $LIBDIR";
3216 while (my ($k, $v) = each %INC) {
3217 next unless $v =~ /^\Q$LIBDIR\E\/.*\.pm$/;
3218
3219 warn "... unloading $k";
3220 delete $INC{$k};
3221
3222 $k =~ s/\.pm$//;
3223 $k =~ s/\//::/g;
3224
3225 if (my $cb = $k->can ("unload_module")) {
3226 $cb->();
3227 }
3228
3229 Symbol::delete_package $k;
3230 }
3231
3232 warn "getting rid of safe::, as good as possible";
3233 Symbol::delete_package "safe::$_"
3234 for qw(cf::attachable cf::object cf::object::player cf::client cf::player cf::map cf::party cf::region);
3235
3236 warn "unloading cf.pm \"a bit\"";
3237 delete $INC{"cf.pm"};
3238 delete $INC{"cf/pod.pm"};
3239
3240 # don't, removes xs symbols, too,
3241 # and global variables created in xs
3242 #Symbol::delete_package __PACKAGE__;
3243
3244 warn "unload completed, starting to reload now";
3245
3246 warn "reloading cf.pm";
3247 require cf;
3248 cf::_connect_to_perl; # nominally unnecessary, but cannot hurt
3249
3250 warn "loading config and database again";
3251 cf::reload_config;
3252
3253 warn "loading extensions";
3254 cf::load_extensions;
3255
3256 warn "reattaching attachments to objects/players";
3257 _global_reattach; # objects, sockets
3258 warn "reattaching attachments to maps";
3259 reattach $_ for values %MAP;
3260 warn "reattaching attachments to players";
3261 reattach $_ for values %PLAYER;
3262
3263 warn "leaving sync_job";
3264
3265 1
3266 } or do {
3267 warn $@;
3268 warn "error while reloading, exiting.";
3269 exit 1;
3270 };
3271
3272 warn "reloaded";
3273};
3274
3275our $RELOAD_WATCHER; # used only during reload
3276
3277sub reload_perl() {
3278 # doing reload synchronously and two reloads happen back-to-back,
3279 # coro crashes during coro_state_free->destroy here.
3280
3281 $RELOAD_WATCHER ||= Event->timer (
3282 reentrant => 0,
3283 after => 0,
3284 data => WF_AUTOCANCEL,
3285 cb => sub {
3286 do_reload_perl;
3287 undef $RELOAD_WATCHER;
3288 },
3289 );
3290}
3291
3292register_command "reload" => sub {
3293 my ($who, $arg) = @_;
3294
3295 if ($who->flag (FLAG_WIZ)) {
3296 $who->message ("reloading server.");
3297 async { reload_perl };
3298 }
3299};
469 3300
470unshift @INC, $LIBDIR; 3301unshift @INC, $LIBDIR;
471 3302
472load_extensions; 3303my $bug_warning = 0;
3304
3305our @WAIT_FOR_TICK;
3306our @WAIT_FOR_TICK_BEGIN;
3307
3308sub wait_for_tick {
3309 return unless $TICK_WATCHER->is_active;
3310 return if $Coro::current == $Coro::main;
3311
3312 my $signal = new Coro::Signal;
3313 push @WAIT_FOR_TICK, $signal;
3314 $signal->wait;
3315}
3316
3317sub wait_for_tick_begin {
3318 return unless $TICK_WATCHER->is_active;
3319 return if $Coro::current == $Coro::main;
3320
3321 my $signal = new Coro::Signal;
3322 push @WAIT_FOR_TICK_BEGIN, $signal;
3323 $signal->wait;
3324}
3325
3326 my $min = 1e6;#d#
3327 my $avg = 10;
3328$TICK_WATCHER = Event->timer (
3329 reentrant => 0,
3330 parked => 1,
3331 prio => 0,
3332 at => $NEXT_TICK || $TICK,
3333 data => WF_AUTOCANCEL,
3334 cb => sub {
3335 if ($Coro::current != $Coro::main) {
3336 Carp::cluck "major BUG: server tick called outside of main coro, skipping it"
3337 unless ++$bug_warning > 10;
3338 return;
3339 }
3340
3341 $NOW = $tick_start = Event::time;
3342
3343 cf::server_tick; # one server iteration
3344
3345 0 && sync_job {#d#
3346 for(1..10) {
3347 my $t = Event::time;
3348 my $map = my $map = new_from_path cf::map "/tmp/x.map"
3349 or die;
3350
3351 $map->width (50);
3352 $map->height (50);
3353 $map->alloc;
3354 $map->_load_objects ("/tmp/x.map", 1);
3355 my $t = Event::time - $t;
3356
3357 #next unless $t < 0.0013;#d#
3358 if ($t < $min) {
3359 $min = $t;
3360 }
3361 $avg = $avg * 0.99 + $t * 0.01;
3362 }
3363 warn "XXXXXXXXXXXXXXXXXX min $min avg $avg\n";#d#
3364 exit 0;
3365 # 2007-05-22 02:33:04.569 min 0.00112509727478027 avg 0.0012259249572477
3366 };
3367
3368 $RUNTIME += $TICK;
3369 $NEXT_TICK += $TICK;
3370
3371 if ($NOW >= $NEXT_RUNTIME_WRITE) {
3372 $NEXT_RUNTIME_WRITE = $NOW + 10;
3373 Coro::async_pool {
3374 write_runtime
3375 or warn "ERROR: unable to write runtime file: $!";
3376 };
3377 }
3378
3379# my $AFTER = Event::time;
3380# warn $AFTER - $NOW;#d#
3381
3382 if (my $sig = shift @WAIT_FOR_TICK_BEGIN) {
3383 $sig->send;
3384 }
3385 while (my $sig = shift @WAIT_FOR_TICK) {
3386 $sig->send;
3387 }
3388
3389 $NOW = Event::time;
3390
3391 # if we are delayed by four ticks or more, skip them all
3392 $NEXT_TICK = $NOW if $NOW >= $NEXT_TICK + $TICK * 4;
3393
3394 $TICK_WATCHER->at ($NEXT_TICK);
3395 $TICK_WATCHER->start;
3396
3397 $LOAD = ($NOW - $tick_start) / $TICK;
3398 $LOADAVG = $LOADAVG * 0.75 + $LOAD * 0.25;
3399
3400 _post_tick;
3401
3402
3403 },
3404);
3405
3406{
3407 BDB::max_poll_time $TICK * 0.1;
3408 $BDB_POLL_WATCHER = Event->io (
3409 reentrant => 0,
3410 fd => BDB::poll_fileno,
3411 poll => 'r',
3412 prio => 0,
3413 data => WF_AUTOCANCEL,
3414 cb => \&BDB::poll_cb,
3415 );
3416 BDB::min_parallel 8;
3417
3418 BDB::set_sync_prepare {
3419 my $status;
3420 my $current = $Coro::current;
3421 (
3422 sub {
3423 $status = $!;
3424 $current->ready; undef $current;
3425 },
3426 sub {
3427 Coro::schedule while defined $current;
3428 $! = $status;
3429 },
3430 )
3431 };
3432
3433 unless ($DB_ENV) {
3434 $DB_ENV = BDB::db_env_create;
3435
3436 cf::sync_job {
3437 eval {
3438 BDB::db_env_open
3439 $DB_ENV,
3440 $BDBDIR,
3441 BDB::INIT_LOCK | BDB::INIT_LOG | BDB::INIT_MPOOL | BDB::INIT_TXN
3442 | BDB::RECOVER | BDB::REGISTER | BDB::USE_ENVIRON | BDB::CREATE,
3443 0666;
3444
3445 cf::cleanup "db_env_open($BDBDIR): $!" if $!;
3446
3447 $DB_ENV->set_flags (BDB::AUTO_COMMIT | BDB::REGION_INIT | BDB::TXN_NOSYNC, 1);
3448 $DB_ENV->set_lk_detect;
3449 };
3450
3451 cf::cleanup "db_env_open(db): $@" if $@;
3452 };
3453 }
3454}
3455
3456{
3457 IO::AIO::min_parallel 8;
3458
3459 undef $Coro::AIO::WATCHER;
3460 IO::AIO::max_poll_time $TICK * 0.1;
3461 $AIO_POLL_WATCHER = Event->io (
3462 reentrant => 0,
3463 data => WF_AUTOCANCEL,
3464 fd => IO::AIO::poll_fileno,
3465 poll => 'r',
3466 prio => 6,
3467 cb => \&IO::AIO::poll_cb,
3468 );
3469}
3470
3471my $_log_backtrace;
3472
3473sub _log_backtrace {
3474 my ($msg, @addr) = @_;
3475
3476 $msg =~ s/\n//;
3477
3478 # limit the # of concurrent backtraces
3479 if ($_log_backtrace < 2) {
3480 ++$_log_backtrace;
3481 async {
3482 my @bt = fork_call {
3483 @addr = map { sprintf "%x", $_ } @addr;
3484 my $self = (-f "/proc/$$/exe") ? "/proc/$$/exe" : $^X;
3485 open my $fh, "exec addr2line -C -f -i -e \Q$self\E @addr 2>&1 |"
3486 or die "addr2line: $!";
3487
3488 my @funcs;
3489 my @res = <$fh>;
3490 chomp for @res;
3491 while (@res) {
3492 my ($func, $line) = splice @res, 0, 2, ();
3493 push @funcs, "[$func] $line";
3494 }
3495
3496 @funcs
3497 };
3498
3499 LOG llevInfo, "[ABT] $msg\n";
3500 LOG llevInfo, "[ABT] $_\n" for @bt;
3501 --$_log_backtrace;
3502 };
3503 } else {
3504 LOG llevInfo, "[ABT] $msg\n";
3505 LOG llevInfo, "[ABT] [suppressed]\n";
3506 }
3507}
3508
3509# load additional modules
3510use cf::pod;
3511
3512END { cf::emergency_save }
473 3513
4741 35141
475 3515

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines