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

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines