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.40 by root, Fri Aug 25 15:21:57 2006 UTC vs.
Revision 1.303 by root, Wed Jul 11 15:57:31 2007 UTC

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

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines