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

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines