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

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines