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

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines