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.92 by root, Thu Dec 21 06:42:28 2006 UTC vs.
Revision 1.290 by root, Mon Jul 2 03:15:30 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
21sub WF_AUTOCANCEL () { 1 } # automatically cancel this watcher on reload 48sub WF_AUTOCANCEL () { 1 } # automatically cancel this watcher on reload
22 49
23our %COMMAND = (); 50our %COMMAND = ();
24our %COMMAND_TIME = (); 51our %COMMAND_TIME = ();
52
53our @EXTS = (); # list of extension package names
25our %EXTCMD = (); 54our %EXTCMD = ();
55our %EXTICMD = ();
56our %EXT_CORO = (); # coroutines bound to extensions
57our %EXT_MAP = (); # pluggable maps
26 58
27_init_vars; 59our $RELOAD; # number of reloads so far
28
29our @EVENT; 60our @EVENT;
30our $LIBDIR = datadir . "/ext";
31 61
32our $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(!)
33our $TICK_WATCHER; 75our $TICK_WATCHER;
76our $AIO_POLL_WATCHER;
77our $NEXT_RUNTIME_WRITE; # when should the runtime file be written
34our $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;
35 84
36our %CFG; 85our %CFG;
37 86
38our $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;
39 117
40############################################################################# 118#############################################################################
41 119
42=head2 GLOBAL VARIABLES 120=head2 GLOBAL VARIABLES
43 121
45 123
46=item $cf::UPTIME 124=item $cf::UPTIME
47 125
48The timestamp of the server start (so not actually an uptime). 126The timestamp of the server start (so not actually an uptime).
49 127
50=item $cf::LIBDIR 128=item $cf::RUNTIME
51 129
52The 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
53be 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.
54 145
55=item $cf::TICK 146=item $cf::TICK
56 147
57The 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.
58 159
59=item %cf::CFG 160=item %cf::CFG
60 161
61Configuration for the server, loaded from C</etc/crossfire/config>, or 162Configuration for the server, loaded from C</etc/crossfire/config>, or
62from 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.
63 170
64=back 171=back
65 172
66=cut 173=cut
67 174
68BEGIN { 175BEGIN {
69 *CORE::GLOBAL::warn = sub { 176 *CORE::GLOBAL::warn = sub {
70 my $msg = join "", @_; 177 my $msg = join "", @_;
178
71 $msg .= "\n" 179 $msg .= "\n"
72 unless $msg =~ /\n$/; 180 unless $msg =~ /\n$/;
73 181
74 print STDERR "cfperl: $msg"; 182 $msg =~ s/([\x00-\x08\x0b-\x1f])/sprintf "\\x%02x", ord $1/ge;
183
184 utf8::encode $msg;
75 LOG llevError, "cfperl: $msg"; 185 LOG llevError, $msg;
76 }; 186 };
77} 187}
78 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';
79@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)
80 196
81# 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
82# within the Safe compartment. 198# within the Safe compartment.
83for my $pkg (qw( 199for my $pkg (qw(
200 cf::global cf::attachable
84 cf::object cf::object::player 201 cf::object cf::object::player
85 cf::client cf::player 202 cf::client cf::player
86 cf::arch cf::living 203 cf::arch cf::living
87 cf::map cf::party cf::region 204 cf::map cf::party cf::region
88)) { 205)) {
92 209
93$Event::DIED = sub { 210$Event::DIED = sub {
94 warn "error in event callback: @_"; 211 warn "error in event callback: @_";
95}; 212};
96 213
97my %ext_pkg; 214#############################################################################
98my @exts;
99my @hook;
100 215
101=head2 UTILITY FUNCTIONS 216=head2 UTILITY FUNCTIONS
102 217
103=over 4 218=over 4
104 219
105=cut 220=item dumpval $ref
106 221
107use 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}
108 242
109=item $ref = cf::from_json $json 243=item $ref = cf::from_json $json
110 244
111Converts a JSON string into the corresponding perl data structure. 245Converts a JSON string into the corresponding perl data structure.
112 246
113=cut
114
115sub from_json($) {
116 $JSON::Syck::ImplicitUnicode = 1; # work around JSON::Syck bugs
117 JSON::Syck::Load $_[0]
118}
119
120=item $json = cf::to_json $ref 247=item $json = cf::to_json $ref
121 248
122Converts a perl data structure into its JSON representation. 249Converts a perl data structure into its JSON representation.
123 250
124=cut 251=cut
125 252
126sub to_json($) { 253our $json_coder = JSON::XS->new->utf8->max_size (1e6); # accept ~1mb max
127 $JSON::Syck::ImplicitUnicode = 0; # work around JSON::Syck bugs 254
128 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 });
129} 574}
130 575
131=back 576=back
132 577
133=cut 578=cut
134 579
135############################################################################# 580#############################################################################
136 581
137=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).
138 591
139=over 4 592=over 4
140 593
141=item $object->attach ($attachment, key => $value...)
142
143=item $object->detach ($attachment)
144
145Attach/detach a pre-registered attachment to an object.
146
147=item $player->attach ($attachment, key => $value...)
148
149=item $player->detach ($attachment)
150
151Attach/detach a pre-registered attachment to a player.
152
153=item $map->attach ($attachment, key => $value...)
154
155=item $map->detach ($attachment)
156
157Attach/detach a pre-registered attachment to a client.
158
159=item $client->attach ($attachment, key => $value...) 594=item $attachable->attach ($attachment, key => $value...)
160 595
161=item $client->detach ($attachment) 596=item $attachable->detach ($attachment)
162 597
163Attach/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.
164 600
165=item $bool = $object->attached ($name) 601Example, attach a minesweeper attachment to the given object, making it a
60210x10 minesweeper game:
166 603
167=item $bool = $player->attached ($name) 604 $obj->attach (minesweeper => width => 10, height => 10);
168 605
169=item $bool = $client->attached ($name) 606=item $bool = $attachable->attached ($name)
170
171=item $bool = $map->attached ($name)
172 607
173Checks wether the named attachment is currently attached to the object. 608Checks wether the named attachment is currently attached to the object.
174 609
175=item cf::attach_global ... 610=item cf::CLASS->attach ...
176 611
177Attach handlers for global events. 612=item cf::CLASS->detach ...
178 613
179This and all following C<attach_*>-functions expect any number of the 614Define an anonymous attachment and attach it to all objects of the given
180following 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:
181 648
182=over 4 649=over 4
183 650
184=item prio => $number 651=item prio => $number
185 652
187by another C<prio> setting). Lower priority handlers get executed 654by another C<prio> setting). Lower priority handlers get executed
188earlier. 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
189registered at priority C<-1000>, so lower priorities should not be used 656registered at priority C<-1000>, so lower priorities should not be used
190unless you know what you are doing. 657unless you know what you are doing.
191 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
192=item on_I<event> => \&cb 665=item on_I<event> => \&cb
193 666
194Call the given code reference whenever the named event happens (event is 667Call the given code reference whenever the named event happens (event is
195something 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
196handlers are recognised generally depends on the type of object these 669handlers are recognised generally depends on the type of object these
205package and register them. Only handlers for eevents supported by the 678package and register them. Only handlers for eevents supported by the
206object/class are recognised. 679object/class are recognised.
207 680
208=back 681=back
209 682
210=item cf::attach_to_type $object_type, $subtype, ... 683Example, define an attachment called "sockpuppet" that calls the given
684event handler when a monster attacks:
211 685
212Attach handlers for a specific object type (e.g. TRANSPORT) and 686 cf::object::attachment sockpuppet =>
213subtype. If C<$subtype> is zero or undef, matches all objects of the given 687 on_skill_attack => sub {
214type. 688 my ($self, $victim) = @_;
215 689 ...
216=item cf::attach_to_objects ...
217
218Attach handlers to all objects. Do not use this except for debugging or
219very rare events, as handlers are (obviously) called for I<all> objects in
220the game.
221
222=item cf::attach_to_players ...
223
224Attach handlers to all players.
225
226=item cf::attach_to_clients ...
227
228Attach handlers to all players.
229
230=item cf::attach_to_maps ...
231
232Attach handlers to all maps.
233
234=item cf:register_attachment $name, ...
235
236Register an attachment by name through which objects can refer to this
237attachment.
238
239=item cf:register_player_attachment $name, ...
240
241Register an attachment by name through which players can refer to this
242attachment.
243
244=item cf:register_map_attachment $name, ...
245
246Register an attachment by name through which maps can refer to this
247attachment.
248
249=cut
250
251# the following variables are defined in .xs and must not be re-created
252our @CB_GLOBAL = (); # registry for all global events
253our @CB_OBJECT = (); # all objects (should not be used except in emergency)
254our @CB_PLAYER = ();
255our @CB_CLIENT = ();
256our @CB_TYPE = (); # registry for type (cf-object class) based events
257our @CB_MAP = ();
258
259my %attachment;
260
261sub _attach_cb($\%$$$) {
262 my ($registry, $undo, $event, $prio, $cb) = @_;
263
264 use sort 'stable';
265
266 $cb = [$prio, $cb];
267
268 @{$registry->[$event]} = sort
269 { $a->[0] cmp $b->[0] }
270 @{$registry->[$event] || []}, $cb;
271
272 push @{$undo->{cb}}, [$event, $cb];
273}
274
275# attach handles attaching event callbacks
276# the only thing the caller has to do is pass the correct
277# registry (== where the callback attaches to).
278sub _attach(\@$@) {
279 my ($registry, $klass, @arg) = @_;
280
281 my $prio = 0;
282
283 my %undo = (
284 registry => $registry,
285 cb => [],
286 );
287
288 my %cb_id = map +("on_" . lc $EVENT[$_][0], $_) , grep $EVENT[$_][1] == $klass, 0 .. $#EVENT;
289
290 while (@arg) {
291 my $type = shift @arg;
292
293 if ($type eq "prio") {
294 $prio = shift @arg;
295
296 } elsif ($type eq "package") {
297 my $pkg = shift @arg;
298
299 while (my ($name, $id) = each %cb_id) {
300 if (my $cb = $pkg->can ($name)) {
301 _attach_cb $registry, %undo, $id, $prio, $cb;
302 }
303 } 690 }
304
305 } elsif (exists $cb_id{$type}) {
306 _attach_cb $registry, %undo, $cb_id{$type}, $prio, shift @arg;
307
308 } elsif (ref $type) {
309 warn "attaching objects not supported, ignoring.\n";
310
311 } else {
312 shift @arg;
313 warn "attach argument '$type' not supported, ignoring.\n";
314 }
315 }
316
317 \%undo
318}
319
320sub _attach_attachment {
321 my ($obj, $name, %arg) = @_;
322
323 return if exists $obj->{_attachment}{$name};
324
325 my $res;
326
327 if (my $attach = $attachment{$name}) {
328 my $registry = $obj->registry;
329
330 for (@$attach) {
331 my ($klass, @attach) = @$_;
332 $res = _attach @$registry, $klass, @attach;
333 }
334
335 $obj->{$name} = \%arg;
336 } else {
337 warn "object uses attachment '$name' that is not available, postponing.\n";
338 }
339
340 $obj->{_attachment}{$name} = undef;
341
342 $res->{attachment} = $name;
343 $res
344}
345
346*cf::object::attach =
347*cf::player::attach =
348*cf::client::attach =
349*cf::map::attach = sub {
350 my ($obj, $name, %arg) = @_;
351
352 _attach_attachment $obj, $name, %arg;
353};
354
355# all those should be optimised
356*cf::object::detach =
357*cf::player::detach =
358*cf::client::detach =
359*cf::map::detach = sub {
360 my ($obj, $name) = @_;
361
362 delete $obj->{_attachment}{$name};
363 reattach ($obj);
364};
365
366*cf::object::attached =
367*cf::player::attached =
368*cf::client::attached =
369*cf::map::attached = sub {
370 my ($obj, $name) = @_;
371
372 exists $obj->{_attachment}{$name}
373};
374
375sub attach_global {
376 _attach @CB_GLOBAL, KLASS_GLOBAL, @_
377}
378
379sub attach_to_type {
380 my $type = shift;
381 my $subtype = shift;
382
383 _attach @{$CB_TYPE[$type + $subtype * NUM_SUBTYPES]}, KLASS_OBJECT, @_
384}
385
386sub attach_to_objects {
387 _attach @CB_OBJECT, KLASS_OBJECT, @_
388}
389
390sub attach_to_players {
391 _attach @CB_PLAYER, KLASS_PLAYER, @_
392}
393
394sub attach_to_clients {
395 _attach @CB_CLIENT, KLASS_CLIENT, @_
396}
397
398sub attach_to_maps {
399 _attach @CB_MAP, KLASS_MAP, @_
400}
401
402sub register_attachment {
403 my $name = shift;
404
405 $attachment{$name} = [[KLASS_OBJECT, @_]];
406}
407
408sub register_player_attachment {
409 my $name = shift;
410
411 $attachment{$name} = [[KLASS_PLAYER, @_]];
412}
413
414sub register_client_attachment {
415 my $name = shift;
416
417 $attachment{$name} = [[KLASS_CLIENT, @_]];
418}
419
420sub register_map_attachment {
421 my $name = shift;
422
423 $attachment{$name} = [[KLASS_MAP, @_]];
424}
425
426our $override;
427our @invoke_results = (); # referenced from .xs code. TODO: play tricks with reify and mortals?
428
429sub override {
430 $override = 1;
431 @invoke_results = ();
432}
433
434sub do_invoke {
435 my $event = shift;
436 my $callbacks = shift;
437
438 @invoke_results = ();
439
440 local $override;
441
442 for (@$callbacks) {
443 eval { &{$_->[1]} };
444
445 if ($@) {
446 warn "$@";
447 warn "... while processing $EVENT[$event][0](@_) event, skipping processing altogether.\n";
448 override;
449 }
450
451 return 1 if $override;
452 }
453
454 0 691 }
455}
456 692
457=item $bool = cf::invoke EVENT_GLOBAL_XXX, ... 693=item $attachable->valid
458
459=item $bool = $object->invoke (EVENT_OBJECT_XXX, ...)
460
461=item $bool = $player->invoke (EVENT_PLAYER_XXX, ...)
462
463=item $bool = $client->invoke (EVENT_CLIENT_XXX, ...)
464
465=item $bool = $map->invoke (EVENT_MAP_XXX, ...)
466
467Generate a global/object/player/map-specific event with the given arguments.
468
469This API is preliminary (most likely, the EVENT_KLASS_xxx prefix will be
470removed in future versions), and there is no public API to access override
471results (if you must, access C<@cf::invoke_results> directly).
472
473=back
474
475=cut
476
477#############################################################################
478
479=head2 METHODS VALID FOR ALL CORE OBJECTS
480
481=over 4
482
483=item $object->valid, $player->valid, $client->valid, $map->valid
484 694
485Just 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
486C-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
487valid C counterpart anymore you get an exception at runtime. This method 697valid C counterpart anymore you get an exception at runtime. This method
488can 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
489exception. 699exception.
490 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
491=back 892=back
492 893
493=cut 894=cut
494
495*cf::object::valid =
496*cf::player::valid =
497*cf::client::valid =
498*cf::map::valid = \&cf::_valid;
499 895
500############################################################################# 896#############################################################################
501# object support 897# object support
502 898
503sub instantiate {
504 my ($obj, $data) = @_;
505
506 $data = from_json $data;
507
508 for (@$data) {
509 my ($name, $args) = @$_;
510
511 $obj->attach ($name, %{$args || {} });
512 }
513}
514
515# basically do the same as instantiate, without calling instantiate
516sub reattach { 899sub reattach {
900 # basically do the same as instantiate, without calling instantiate
517 my ($obj) = @_; 901 my ($obj) = @_;
902
903 bless $obj, ref $obj; # re-bless in case extensions have been reloaded
904
518 my $registry = $obj->registry; 905 my $registry = $obj->registry;
519 906
520 @$registry = (); 907 @$registry = ();
521 908
522 delete $obj->{_attachment} unless scalar keys %{ $obj->{_attachment} || {} }; 909 delete $obj->{_attachment} unless scalar keys %{ $obj->{_attachment} || {} };
523 910
524 for my $name (keys %{ $obj->{_attachment} || {} }) { 911 for my $name (keys %{ $obj->{_attachment} || {} }) {
525 if (my $attach = $attachment{$name}) { 912 if (my $attach = $attachment{$name}) {
526 for (@$attach) { 913 for (@$attach) {
527 my ($klass, @attach) = @$_; 914 my ($klass, @attach) = @$_;
528 _attach @$registry, $klass, @attach; 915 _attach $registry, $klass, @attach;
529 } 916 }
530 } else { 917 } else {
531 warn "object uses attachment '$name' that is not available, postponing.\n"; 918 warn "object uses attachment '$name' that is not available, postponing.\n";
532 } 919 }
533 } 920 }
534} 921}
535 922
536sub object_freezer_save { 923cf::attachable->attach (
537 my ($filename, $rdata, $objs) = @_;
538
539 if (length $$rdata) {
540 warn sprintf "saving %s (%d,%d)\n",
541 $filename, length $$rdata, scalar @$objs;
542
543 if (open my $fh, ">:raw", "$filename~") {
544 chmod SAVE_MODE, $fh;
545 syswrite $fh, $$rdata;
546 close $fh;
547
548 if (@$objs && open my $fh, ">:raw", "$filename.pst~") {
549 chmod SAVE_MODE, $fh;
550 syswrite $fh, Storable::nfreeze { version => 1, objs => $objs };
551 close $fh;
552 rename "$filename.pst~", "$filename.pst";
553 } else {
554 unlink "$filename.pst";
555 }
556
557 rename "$filename~", $filename;
558 } else {
559 warn "FATAL: $filename~: $!\n";
560 }
561 } else {
562 unlink $filename;
563 unlink "$filename.pst";
564 }
565}
566
567sub object_freezer_as_string {
568 my ($rdata, $objs) = @_;
569
570 use Data::Dumper;
571
572 $$rdata . Dumper $objs
573}
574
575sub object_thawer_load {
576 my ($filename) = @_;
577
578 local $/;
579
580 my $av;
581
582 #TODO: use sysread etc.
583 if (open my $data, "<:raw:perlio", $filename) {
584 $data = <$data>;
585 if (open my $pst, "<:raw:perlio", "$filename.pst") {
586 $av = eval { (Storable::thaw <$pst>)->{objs} };
587 }
588 return ($data, $av);
589 }
590
591 ()
592}
593
594attach_to_objects
595 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,
596 on_clone => sub { 937 on_clone => sub {
597 my ($src, $dst) = @_; 938 my ($src, $dst) = @_;
598 939
599 @{$dst->registry} = @{$src->registry}; 940 @{$dst->registry} = @{$src->registry};
600 941
601 %$dst = %$src; 942 %$dst = %$src;
602 943
603 %{$dst->{_attachment}} = %{$src->{_attachment}} 944 %{$dst->{_attachment}} = %{$src->{_attachment}}
604 if exists $src->{_attachment}; 945 if exists $src->{_attachment};
605 }, 946 },
606; 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
607 1019
608############################################################################# 1020#############################################################################
609# command handling &c 1021# command handling &c
610 1022
611=item cf::register_command $name => \&callback($ob,$args); 1023=item cf::register_command $name => \&callback($ob,$args);
624 push @{ $COMMAND{$name} }, [$caller, $cb]; 1036 push @{ $COMMAND{$name} }, [$caller, $cb];
625} 1037}
626 1038
627=item cf::register_extcmd $name => \&callback($pl,$packet); 1039=item cf::register_extcmd $name => \&callback($pl,$packet);
628 1040
629Register a callbackf ro execution when the client sends an extcmd packet. 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.
630 1046
631If the callback returns something, it is sent back as if reply was being 1047If the callback returns something, it is sent back as if reply was being
632called. 1048called.
633 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
634=cut 1061=cut
635 1062
636sub register_extcmd { 1063sub register_extcmd {
637 my ($name, $cb) = @_; 1064 my ($name, $cb) = @_;
638 1065
639 my $caller = caller;
640 #warn "registering extcmd '$name' to '$caller'";
641
642 $EXTCMD{$name} = [$cb, $caller]; 1066 $EXTCMD{$name} = $cb;
643} 1067}
644 1068
645attach_to_players 1069sub register_exticmd {
1070 my ($name, $cb) = @_;
1071
1072 $EXTICMD{$name} = $cb;
1073}
1074
1075cf::player->attach (
646 on_command => sub { 1076 on_command => sub {
647 my ($pl, $name, $params) = @_; 1077 my ($pl, $name, $params) = @_;
648 1078
649 my $cb = $COMMAND{$name} 1079 my $cb = $COMMAND{$name}
650 or return; 1080 or return;
656 cf::override; 1086 cf::override;
657 }, 1087 },
658 on_extcmd => sub { 1088 on_extcmd => sub {
659 my ($pl, $buf) = @_; 1089 my ($pl, $buf) = @_;
660 1090
661 my $msg = eval { from_json $buf }; 1091 my $msg = eval { $pl->ns->{json_coder}->decode ($buf) };
662 1092
663 if (ref $msg) { 1093 if (ref $msg) {
664 if (my $cb = $EXTCMD{$msg->{msgtype}}) { 1094 if (my $cb = $EXTCMD{$msg->{msgtype}}) {
665 if (my %reply = $cb->[0]->($pl, $msg)) { 1095 if (my %reply = $cb->($pl, $msg)) {
666 $pl->ext_reply ($msg->{msgid}, %reply); 1096 $pl->ext_reply ($msg->{msgid}, %reply);
667 } 1097 }
668 } 1098 }
669 } else { 1099 } else {
670 warn "player " . ($pl->ob->name) . " sent unparseable ext message: <$buf>\n"; 1100 warn "player " . ($pl->ob->name) . " sent unparseable ext message: <$buf>\n";
671 } 1101 }
672 1102
673 cf::override; 1103 cf::override;
674 }, 1104 },
675; 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}
1179
1180#############################################################################
1181
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 " . $self->ns->{json_coder}->encode (\%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
676 1512
677sub register { 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 {
678 my ($base, $pkg) = @_; 1527 my ($self, $merge) = @_;
679 1528
680 #TODO 1529 # we have to keep some variables in memory intact
681} 1530 local $self->{path};
1531 local $self->{load_path};
682 1532
683sub load_extension { 1533 $self->SUPER::thawer_merge ($merge);
1534}
1535
1536sub normalise {
684 my ($path) = @_; 1537 my ($path, $base) = @_;
685 1538
686 $path =~ /([^\/\\]+)\.ext$/ or die "$path"; 1539 $path = "$path"; # make sure its a string
687 my $base = $1;
688 my $pkg = $1;
689 $pkg =~ s/[^[:word:]]/_/g;
690 $pkg = "ext::$pkg";
691 1540
692 warn "loading '$path' into '$pkg'\n"; 1541 $path =~ s/\.map$//;
693 1542
694 open my $fh, "<:utf8", $path 1543 # map plan:
695 or die "$path: $!"; 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
696 1551
697 my $source = 1552 $path =~ s/$PATH_SEP/\//go;
698 "package $pkg; use strict; use utf8;\n"
699 . "#line 1 \"$path\"\n{\n"
700 . (do { local $/; <$fh> })
701 . "\n};\n1";
702 1553
703 eval $source 1554 # treat it as relative path if it starts with
704 or die $@ ? "$path: $@\n" 1555 # something that looks reasonable
705 : "extension disabled.\n"; 1556 if ($path =~ m{^(?:\./|\.\./|\w)}) {
1557 $base or Carp::carp "normalise called with relative path and no base: '$path'";
706 1558
707 push @exts, $pkg; 1559 $base =~ s{[^/]+/?$}{};
708 $ext_pkg{$base} = $pkg; 1560 $path = "$base/$path";
709
710# no strict 'refs';
711# @{"$pkg\::ISA"} = ext::;
712
713 register $base, $pkg;
714}
715
716sub unload_extension {
717 my ($pkg) = @_;
718
719 warn "removing extension $pkg\n";
720
721 # remove hooks
722 #TODO
723# for my $idx (0 .. $#PLUGIN_EVENT) {
724# delete $hook[$idx]{$pkg};
725# } 1561 }
726 1562
727 # remove commands 1563 for ($path) {
728 for my $name (keys %COMMAND) { 1564 redo if s{//}{/};
729 my @cb = grep $_->[0] ne $pkg, @{ $COMMAND{$name} }; 1565 redo if s{/\.?/}{/};
1566 redo if s{/[^/]+/\.\./}{/};
1567 }
730 1568
731 if (@cb) { 1569 $path
732 $COMMAND{$name} = \@cb; 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;
733 } else { 1708 } else {
734 delete $COMMAND{$name}; 1709 $self->load_header_orig
735 } 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
736 } 1720 1
1721}
737 1722
738 # remove extcmds 1723sub find;
739 for my $name (grep $EXTCMD{$_}[1] eq $pkg, keys %EXTCMD) { 1724sub find {
740 delete $EXTCMD{$name}; 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
741 } 1763 {
1764 my $guard = cf::lock_acquire "map_load:$path";
742 1765
743 if (my $cb = $pkg->can ("unload")) { 1766 return if $self->in_memory != cf::MAP_SWAPPED;
744 eval { 1767
745 $cb->($pkg); 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);
746 1 1786 }
747 } or warn "$pkg unloaded, but with errors: $@"; 1787 }
748 }
749 1788
750 Symbol::delete_package $pkg; 1789 Coro::cede;
751} 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;
752 1795
753sub load_extensions { 1796 unless ($self->{deny_activate}) {
754 for my $ext (<$LIBDIR/*.ext>) { 1797 $self->decay_objects;
755 next unless -r $ext; 1798 $self->fix_auto_apply;
756 eval { 1799 $self->update_buttons;
757 load_extension $ext; 1800 Coro::cede;
758 1 1801 $self->set_darkness_map;
759 } or warn "$ext not loaded: $@"; 1802 Coro::cede;
760 } 1803 $self->activate;
761} 1804 }
762 1805
763############################################################################# 1806 $self->in_memory (cf::MAP_IN_MEMORY);
764# load/save/clean perl data associated with a map 1807 }
765 1808
766*cf::mapsupport::on_clean = sub { 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 {
767 my ($map) = @_; 1826 my ($map) = @_;
768 1827
769 my $path = $map->tmpname; 1828 my @diag; # diagonal neighbours
770 defined $path or return;
771 1829
772 unlink "$path.pst"; 1830 for (0 .. 3) {
773}; 1831 my $neigh = $map->tile_path ($_)
1832 or next;
1833 $neigh = find $neigh, $map
1834 or next;
1835 $neigh->load;
774 1836
775attach_to_maps prio => -10000, package => cf::mapsupport::; 1837 push @diag, [$neigh->tile_path (($_ + 3) % 4), $neigh],
1838 [$neigh->tile_path (($_ + 1) % 4), $neigh];
1839 }
776 1840
777############################################################################# 1841 for (@diag) {
778# load/save perl data associated with player->ob objects 1842 my $neigh = find @$_
779 1843 or next;
780sub all_objects(@) { 1844 $neigh->load;
781 @_, map all_objects ($_->inv), @_ 1845 }
782} 1846}
783 1847
784# TODO: compatibility cruft, remove when no longer needed 1848sub find_sync {
785attach_to_players 1849 my ($path, $origin) = @_;
786 on_load => sub {
787 my ($pl, $path) = @_;
788 1850
789 for my $o (all_objects $pl->ob) { 1851 cf::sync_job { find $path, $origin }
790 if (my $value = $o->get_ob_key_value ("_perl_data")) { 1852}
791 $o->set_ob_key_value ("_perl_data");
792 1853
793 %$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};
794 } 1881 }
795 } 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);
796 }, 1917 }
797; 1918}
798 1919
799############################################################################# 1920sub swap_out {
1921 my ($self) = @_;
800 1922
801=head2 CORE EXTENSIONS 1923 # save first because save cedes
1924 $self->save;
802 1925
803Functions 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;
804 2066
805=over 4 2067=over 4
806 2068
807=item cf::player::exists $login 2069=item $ob->inv_recursive
808 2070
809Returns true when the given account exists. 2071Returns the inventory of the object _and_ their inventories, recursively.
810 2072
811=cut 2073=cut
812 2074
813sub cf::player::exists($) { 2075sub inv_recursive_;
814 cf::player::find $_[0] 2076sub inv_recursive_ {
815 or -f sprintf "%s/%s/%s/%s.pl", cf::localdir, cf::playerdir, ($_[0]) x 2; 2077 map { $_, inv_recursive_ $_->inv } @_
816} 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
817 2091
818=item $player_object->reply ($npc, $msg[, $flags]) 2092=item $player_object->reply ($npc, $msg[, $flags])
819 2093
820Sends 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>
821can 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
823 2097
824=cut 2098=cut
825 2099
826# rough implementation of a future "reply" method that works 2100# rough implementation of a future "reply" method that works
827# with dialog boxes. 2101# with dialog boxes.
2102#TODO: the first argument must go, split into a $npc->reply_to ( method
828sub cf::object::player::reply($$$;$) { 2103sub cf::object::player::reply($$$;$) {
829 my ($self, $npc, $msg, $flags) = @_; 2104 my ($self, $npc, $msg, $flags) = @_;
830 2105
831 $flags = cf::NDI_BROWN | cf::NDI_UNIQUE unless @_ >= 4; 2106 $flags = cf::NDI_BROWN | cf::NDI_UNIQUE unless @_ >= 4;
832 2107
833 if ($self->{record_replies}) { 2108 if ($self->{record_replies}) {
834 push @{ $self->{record_replies} }, [$npc, $msg, $flags]; 2109 push @{ $self->{record_replies} }, [$npc, $msg, $flags];
2110
835 } 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 {
836 $msg = $npc->name . " says: $msg" if $npc; 2124 $msg = $npc->name . " says: $msg" if $npc;
837 $self->message ($msg, $flags); 2125 $self->message ($msg, $flags);
2126 }
838 } 2127 }
839}
840
841=item $player->ext_reply ($msgid, $msgtype, %msg)
842
843Sends an ext reply to the player.
844
845=cut
846
847sub cf::player::ext_reply($$$%) {
848 my ($self, $id, %msg) = @_;
849
850 $msg{msgid} = $id;
851
852 $self->send ("ext " . to_json \%msg);
853} 2128}
854 2129
855=item $player_object->may ("access") 2130=item $player_object->may ("access")
856 2131
857Returns wether the given player is authorized to access resource "access" 2132Returns wether the given player is authorized to access resource "access"
866 (ref $cf::CFG{"may_$access"} 2141 (ref $cf::CFG{"may_$access"}
867 ? scalar grep $self->name eq $_, @{$cf::CFG{"may_$access"}} 2142 ? scalar grep $self->name eq $_, @{$cf::CFG{"may_$access"}}
868 : $cf::CFG{"may_$access"}) 2143 : $cf::CFG{"may_$access"})
869} 2144}
870 2145
871=cut 2146=item $player_object->enter_link
872 2147
873############################################################################# 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 " . $self->{json_coder}->encode ([$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 " . $self->{json_coder}->encode (\%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_connect => sub {
2463 my ($ns) = @_;
2464
2465 $ns->{json_coder} = JSON::XS->new->utf8->max_size (1e6)->convert_blessed;
2466 },
2467 on_reply => sub {
2468 my ($ns, $msg) = @_;
2469
2470 # this weird shuffling is so that direct followup queries
2471 # get handled first
2472 my $queue = delete $ns->{query_queue}
2473 or return; # be conservative, not sure how that can happen, but we saw a crash here
2474
2475 (shift @$queue)->[1]->($msg);
2476 return unless $ns->valid; # temporary(?) workaround for callback destroying socket
2477
2478 push @{ $ns->{query_queue} }, @$queue;
2479
2480 if (@{ $ns->{query_queue} } == @$queue) {
2481 if (@$queue) {
2482 $ns->send_packet ($ns->{query_queue}[0][0]);
2483 } else {
2484 $ns->state (ST_PLAYING) if $ns->state == ST_CUSTOM;
2485 }
2486 }
2487 },
2488 on_exticmd => sub {
2489 my ($ns, $buf) = @_;
2490
2491 my $msg = eval { $ns->{json_coder}->decode ($buf) };
2492
2493 if (ref $msg) {
2494 if (my $cb = $EXTICMD{$msg->{msgtype}}) {
2495 if (my %reply = $cb->($ns, $msg)) {
2496 $reply{msgid} = $msg->{msgid};
2497 $ns->send ("ext " . $ns->{json_coder}->encode (\%reply));
2498 }
2499 }
2500 } else {
2501 warn "client " . ($ns->pl ? $ns->pl->ob->name : $ns->host) . " sent unparseable exti message: <$buf>\n";
2502 }
2503
2504 cf::override;
2505 },
2506);
2507
2508=item $client->async (\&cb)
2509
2510Create a new coroutine, running the specified callback. The coroutine will
2511be automatically cancelled when the client gets destroyed (e.g. on logout,
2512or loss of connection).
2513
2514=cut
2515
2516sub cf::client::async {
2517 my ($self, $cb) = @_;
2518
2519 my $coro = &Coro::async ($cb);
2520
2521 $coro->on_destroy (sub {
2522 delete $self->{_coro}{$coro+0};
2523 });
2524
2525 $self->{_coro}{$coro+0} = $coro;
2526
2527 $coro
2528}
2529
2530cf::client->attach (
2531 on_destroy => sub {
2532 my ($ns) = @_;
2533
2534 $_->cancel for values %{ (delete $ns->{_coro}) || {} };
2535 },
2536);
2537
2538=back
2539
874 2540
875=head2 SAFE SCRIPTING 2541=head2 SAFE SCRIPTING
876 2542
877Functions that provide a safe environment to compile and execute 2543Functions that provide a safe environment to compile and execute
878snippets of perl code without them endangering the safety of the server 2544snippets of perl code without them endangering the safety of the server
891 2557
892# here we export the classes and methods available to script code 2558# here we export the classes and methods available to script code
893 2559
894=pod 2560=pod
895 2561
896The following fucntions and emthods are available within a safe environment: 2562The following functions and methods are available within a safe environment:
897 2563
898 cf::object contr pay_amount pay_player map 2564 cf::object contr pay_amount pay_player map
899 cf::object::player player 2565 cf::object::player player
900 cf::player peaceful 2566 cf::player peaceful
901 cf::map trigger 2567 cf::map trigger
982=back 2648=back
983 2649
984=cut 2650=cut
985 2651
986############################################################################# 2652#############################################################################
2653# the server's init and main functions
987 2654
988=head2 EXTENSION DATABASE SUPPORT 2655sub load_facedata($) {
2656 my ($path) = @_;
989 2657
990Crossfire maintains a very simple database for extension use. It can 2658 warn "loading facedata from $path\n";
991currently store anything that can be serialised using Storable, which
992excludes objects.
993 2659
994The parameter C<$family> should best start with the name of the extension 2660 my $facedata;
995using it, it should be unique. 2661 0 < aio_load $path, $facedata
2662 or die "$path: $!";
996 2663
997=over 4 2664 $facedata = Coro::Storable::thaw $facedata;
998 2665
999=item $hashref = cf::db_get $family 2666 $facedata->{version} == 2
2667 or cf::cleanup "$path: version mismatch, cannot proceed.";
1000 2668
1001Return a hashref for use by the extension C<$family>, which can be
1002modified. After modifications, you have to call C<cf::db_dirty> or
1003C<cf::db_sync>.
1004
1005=item $value = cf::db_get $family => $key
1006
1007Returns a single value from the database
1008
1009=item cf::db_put $family => $hashref
1010
1011Stores the given family hashref into the database. Updates are delayed, if
1012you want the data to be synced to disk immediately, use C<cf::db_sync>.
1013
1014=item cf::db_put $family => $key => $value
1015
1016Stores the given C<$value> in the family hash. Updates are delayed, if you
1017want the data to be synced to disk immediately, use C<cf::db_sync>.
1018
1019=item cf::db_dirty
1020
1021Marks the database as dirty, to be updated at a later time.
1022
1023=item cf::db_sync
1024
1025Immediately write the database to disk I<if it is dirty>.
1026
1027=cut
1028
1029our $DB;
1030
1031{
1032 my $path = cf::localdir . "/database.pst";
1033
1034 sub db_load() {
1035 warn "loading database $path\n";#d# remove later
1036 $DB = stat $path ? Storable::retrieve $path : { };
1037 } 2669 {
2670 my $faces = $facedata->{faceinfo};
1038 2671
1039 my $pid; 2672 while (my ($face, $info) = each %$faces) {
1040 2673 my $idx = (cf::face::find $face) || cf::face::alloc $face;
1041 sub db_save() { 2674 cf::face::set $idx, $info->{visibility}, $info->{magicmap};
1042 warn "saving database $path\n";#d# remove later 2675 cf::face::set_data $idx, 0, $info->{data32}, $info->{chksum32};
1043 waitpid $pid, 0 if $pid; 2676 cf::face::set_data $idx, 1, $info->{data64}, $info->{chksum64};
1044 if (0 == ($pid = fork)) { 2677 Coro::cede;
1045 $DB->{_meta}{version} = 1;
1046 Storable::nstore $DB, "$path~";
1047 rename "$path~", $path;
1048 cf::_exit 0 if defined $pid;
1049 }
1050 }
1051
1052 my $dirty;
1053
1054 sub db_sync() {
1055 db_save if $dirty;
1056 undef $dirty;
1057 }
1058
1059 my $idle = Event->idle (min => $TICK * 2.8, max => 10, repeat => 0, data => WF_AUTOCANCEL, cb => sub {
1060 db_sync;
1061 });
1062
1063 sub db_dirty() {
1064 $dirty = 1;
1065 $idle->start;
1066 }
1067
1068 sub db_get($;$) {
1069 @_ >= 2
1070 ? $DB->{$_[0]}{$_[1]}
1071 : ($DB->{$_[0]} ||= { })
1072 }
1073
1074 sub db_put($$;$) {
1075 if (@_ >= 3) {
1076 $DB->{$_[0]}{$_[1]} = $_[2];
1077 } else {
1078 $DB->{$_[0]} = $_[1];
1079 }
1080 db_dirty;
1081 }
1082
1083 attach_global
1084 prio => 10000,
1085 on_cleanup => sub {
1086 db_sync;
1087 }, 2678 }
2679
2680 while (my ($face, $info) = each %$faces) {
2681 next unless $info->{smooth};
2682 my $idx = cf::face::find $face
2683 or next;
2684 if (my $smooth = cf::face::find $info->{smooth}) {
2685 cf::face::set_smooth $idx, $smooth, $info->{smoothlevel};
2686 } else {
2687 warn "smooth face '$info->{smooth}' not found for face '$face'";
2688 }
2689 Coro::cede;
2690 }
1088 ; 2691 }
1089}
1090 2692
1091############################################################################# 2693 {
1092# the server's main() 2694 my $anims = $facedata->{animinfo};
2695
2696 while (my ($anim, $info) = each %$anims) {
2697 cf::anim::set $anim, $info->{frames}, $info->{facings};
2698 Coro::cede;
2699 }
2700
2701 cf::anim::invalidate_all; # d'oh
2702 }
2703
2704 1
2705}
2706
2707sub reload_regions {
2708 load_resource_file "$MAPDIR/regions"
2709 or die "unable to load regions file\n";
2710}
2711
2712sub reload_facedata {
2713 load_facedata "$DATADIR/facedata"
2714 or die "unable to load facedata\n";
2715}
2716
2717sub reload_archetypes {
2718 load_resource_file "$DATADIR/archetypes"
2719 or die "unable to load archetypes\n";
2720 #d# NEED to laod twice to resolve forward references
2721 # this really needs to be done in an extra post-pass
2722 # (which needs to be synchronous, so solve it differently)
2723 load_resource_file "$DATADIR/archetypes"
2724 or die "unable to load archetypes\n";
2725}
2726
2727sub reload_treasures {
2728 load_resource_file "$DATADIR/treasures"
2729 or die "unable to load treasurelists\n";
2730}
2731
2732sub reload_resources {
2733 warn "reloading resource files...\n";
2734
2735 reload_regions;
2736 reload_facedata;
2737 #reload_archetypes;#d#
2738 reload_archetypes;
2739 reload_treasures;
2740
2741 warn "finished reloading resource files\n";
2742}
2743
2744sub init {
2745 reload_resources;
2746}
1093 2747
1094sub cfg_load { 2748sub cfg_load {
1095 open my $fh, "<:utf8", cf::confdir . "/config" 2749 open my $fh, "<:utf8", "$CONFDIR/config"
1096 or return; 2750 or return;
1097 2751
1098 local $/; 2752 local $/;
1099 *CFG = YAML::Syck::Load <$fh>; 2753 *CFG = YAML::Syck::Load <$fh>;
2754
2755 $EMERGENCY_POSITION = $CFG{emergency_position} || ["/world/world_105_115", 5, 37];
2756
2757 $cf::map::MAX_RESET = $CFG{map_max_reset} if exists $CFG{map_max_reset};
2758 $cf::map::DEFAULT_RESET = $CFG{map_default_reset} if exists $CFG{map_default_reset};
2759
2760 if (exists $CFG{mlockall}) {
2761 eval {
2762 $CFG{mlockall} ? eval "mlockall()" : eval "munlockall()"
2763 and die "WARNING: m(un)lockall failed: $!\n";
2764 };
2765 warn $@ if $@;
2766 }
1100} 2767}
1101 2768
1102sub main { 2769sub main {
2770 # we must not ever block the main coroutine
2771 local $Coro::idle = sub {
2772 Carp::cluck "FATAL: Coro::idle was called, major BUG, use cf::sync_job!\n";#d#
2773 (async {
2774 Event::one_event;
2775 })->prio (Coro::PRIO_MAX);
2776 };
2777
1103 cfg_load; 2778 cfg_load;
1104 db_load; 2779 db_init;
1105 load_extensions; 2780 load_extensions;
2781
2782 $TICK_WATCHER->start;
1106 Event::loop; 2783 Event::loop;
1107} 2784}
1108 2785
1109############################################################################# 2786#############################################################################
1110# initialisation 2787# initialisation and cleanup
1111 2788
1112sub _perl_reload(&) { 2789# install some emergency cleanup handlers
2790BEGIN {
2791 for my $signal (qw(INT HUP TERM)) {
2792 Event->signal (
2793 reentrant => 0,
2794 data => WF_AUTOCANCEL,
2795 signal => $signal,
2796 prio => 0,
2797 cb => sub {
2798 cf::cleanup "SIG$signal";
2799 },
2800 );
2801 }
2802}
2803
2804sub write_runtime {
2805 my $runtime = "$LOCALDIR/runtime";
2806
2807 # first touch the runtime file to show we are still running:
2808 # the fsync below can take a very very long time.
2809
2810 IO::AIO::aio_utime $runtime, undef, undef;
2811
2812 my $guard = cf::lock_acquire "write_runtime";
2813
2814 my $fh = aio_open "$runtime~", O_WRONLY | O_CREAT, 0644
2815 or return;
2816
2817 my $value = $cf::RUNTIME + 90 + 10;
2818 # 10 is the runtime save interval, for a monotonic clock
2819 # 60 allows for the watchdog to kill the server.
2820
2821 (aio_write $fh, 0, (length $value), $value, 0) <= 0
2822 and return;
2823
2824 # always fsync - this file is important
2825 aio_fsync $fh
2826 and return;
2827
2828 # touch it again to show we are up-to-date
2829 aio_utime $fh, undef, undef;
2830
2831 close $fh
2832 or return;
2833
2834 aio_rename "$runtime~", $runtime
2835 and return;
2836
2837 warn "runtime file written.\n";
2838
2839 1
2840}
2841
2842sub emergency_save() {
2843 my $freeze_guard = cf::freeze_mainloop;
2844
2845 warn "enter emergency perl save\n";
2846
2847 cf::sync_job {
2848 # use a peculiar iteration method to avoid tripping on perl
2849 # refcount bugs in for. also avoids problems with players
2850 # and maps saved/destroyed asynchronously.
2851 warn "begin emergency player save\n";
2852 for my $login (keys %cf::PLAYER) {
2853 my $pl = $cf::PLAYER{$login} or next;
2854 $pl->valid or next;
2855 $pl->save;
2856 }
2857 warn "end emergency player save\n";
2858
2859 warn "begin emergency map save\n";
2860 for my $path (keys %cf::MAP) {
2861 my $map = $cf::MAP{$path} or next;
2862 $map->valid or next;
2863 $map->save;
2864 }
2865 warn "end emergency map save\n";
2866
2867 warn "begin emergency database checkpoint\n";
2868 BDB::db_env_txn_checkpoint $DB_ENV;
2869 warn "end emergency database checkpoint\n";
2870 };
2871
2872 warn "leave emergency perl save\n";
2873}
2874
2875sub post_cleanup {
1113 my ($msg) = @_; 2876 my ($make_core) = @_;
1114 2877
1115 $msg->("reloading..."); 2878 warn Carp::longmess "post_cleanup backtrace"
2879 if $make_core;
2880}
1116 2881
1117 eval { 2882sub do_reload_perl() {
1118 # cancel all watchers 2883 # can/must only be called in main
2884 if ($Coro::current != $Coro::main) {
2885 warn "can only reload from main coroutine";
2886 return;
2887 }
2888
2889 warn "reloading...";
2890
2891 warn "entering sync_job";
2892
2893 cf::sync_job {
2894 cf::write_runtime; # external watchdog should not bark
2895 cf::emergency_save;
2896 cf::write_runtime; # external watchdog should not bark
2897
2898 warn "syncing database to disk";
2899 BDB::db_env_txn_checkpoint $DB_ENV;
2900
2901 # if anything goes wrong in here, we should simply crash as we already saved
2902
2903 warn "cancelling all WF_AUTOCANCEL watchers";
1119 for (Event::all_watchers) { 2904 for (Event::all_watchers) {
1120 $_->cancel if $_->data & WF_AUTOCANCEL; 2905 $_->cancel if $_->data & WF_AUTOCANCEL;
1121 } 2906 }
1122 2907
1123 # unload all extensions 2908 warn "flushing outstanding aio requests";
1124 for (@exts) { 2909 for (;;) {
1125 $msg->("unloading <$_>"); 2910 BDB::flush;
1126 unload_extension $_; 2911 IO::AIO::flush;
2912 Coro::cede;
2913 last unless IO::AIO::nreqs || BDB::nreqs;
2914 warn "iterate...";
2915 }
2916
2917 ++$RELOAD;
2918
2919 warn "cancelling all extension coros";
2920 $_->cancel for values %EXT_CORO;
2921 %EXT_CORO = ();
2922
2923 warn "removing commands";
2924 %COMMAND = ();
2925
2926 warn "removing ext/exti commands";
2927 %EXTCMD = ();
2928 %EXTICMD = ();
2929
2930 warn "unloading/nuking all extensions";
2931 for my $pkg (@EXTS) {
2932 warn "... unloading $pkg";
2933
2934 if (my $cb = $pkg->can ("unload")) {
2935 eval {
2936 $cb->($pkg);
2937 1
2938 } or warn "$pkg unloaded, but with errors: $@";
1127 } 2939 }
1128 2940
2941 warn "... nuking $pkg";
2942 Symbol::delete_package $pkg;
2943 }
2944
1129 # unload all modules loaded from $LIBDIR 2945 warn "unloading all perl modules loaded from $LIBDIR";
1130 while (my ($k, $v) = each %INC) { 2946 while (my ($k, $v) = each %INC) {
1131 next unless $v =~ /^\Q$LIBDIR\E\/.*\.pm$/; 2947 next unless $v =~ /^\Q$LIBDIR\E\/.*\.pm$/;
1132 2948
1133 $msg->("removing <$k>"); 2949 warn "... unloading $k";
1134 delete $INC{$k}; 2950 delete $INC{$k};
1135 2951
1136 $k =~ s/\.pm$//; 2952 $k =~ s/\.pm$//;
1137 $k =~ s/\//::/g; 2953 $k =~ s/\//::/g;
1138 2954
1141 } 2957 }
1142 2958
1143 Symbol::delete_package $k; 2959 Symbol::delete_package $k;
1144 } 2960 }
1145 2961
1146 # sync database to disk
1147 cf::db_sync;
1148
1149 # get rid of safe::, as good as possible 2962 warn "getting rid of safe::, as good as possible";
1150 Symbol::delete_package "safe::$_" 2963 Symbol::delete_package "safe::$_"
1151 for qw(cf::object cf::object::player cf::player cf::map cf::party cf::region); 2964 for qw(cf::attachable cf::object cf::object::player cf::client cf::player cf::map cf::party cf::region);
1152 2965
1153 # remove register_script_function callbacks
1154 # TODO
1155
1156 # unload cf.pm "a bit" 2966 warn "unloading cf.pm \"a bit\"";
1157 delete $INC{"cf.pm"}; 2967 delete $INC{"cf.pm"};
2968 delete $INC{"cf/pod.pm"};
1158 2969
1159 # don't, removes xs symbols, too, 2970 # don't, removes xs symbols, too,
1160 # and global variables created in xs 2971 # and global variables created in xs
1161 #Symbol::delete_package __PACKAGE__; 2972 #Symbol::delete_package __PACKAGE__;
1162 2973
1163 # reload cf.pm 2974 warn "unload completed, starting to reload now";
2975
1164 $msg->("reloading cf.pm"); 2976 warn "reloading cf.pm";
1165 require cf; 2977 require cf;
2978 cf::_connect_to_perl; # nominally unnecessary, but cannot hurt
1166 2979
1167 # load config and database again 2980 warn "loading config and database again";
1168 cf::cfg_load; 2981 cf::cfg_load;
1169 cf::db_load;
1170 2982
1171 # load extensions 2983 warn "loading extensions";
1172 $msg->("load extensions");
1173 cf::load_extensions; 2984 cf::load_extensions;
1174 2985
1175 # reattach attachments to objects 2986 warn "reattaching attachments to objects/players";
1176 $msg->("reattach"); 2987 _global_reattach; # objects, sockets
1177 _global_reattach; 2988 warn "reattaching attachments to maps";
2989 reattach $_ for values %MAP;
2990 warn "reattaching attachments to players";
2991 reattach $_ for values %PLAYER;
2992
2993 warn "leaving sync_job";
2994
2995 1
2996 } or do {
2997 warn $@;
2998 warn "error while reloading, exiting.";
2999 exit 1;
1178 }; 3000 };
1179 $msg->($@) if $@;
1180 3001
1181 $msg->("reloaded"); 3002 warn "reloaded";
1182}; 3003};
1183 3004
1184sub perl_reload() { 3005our $RELOAD_WATCHER; # used only during reload
1185 _perl_reload { 3006
1186 warn $_[0]; 3007sub reload_perl() {
1187 print "$_[0]\n"; 3008 # doing reload synchronously and two reloads happen back-to-back,
3009 # coro crashes during coro_state_free->destroy here.
3010
3011 $RELOAD_WATCHER ||= Event->timer (
3012 reentrant => 0,
3013 after => 0,
3014 data => WF_AUTOCANCEL,
3015 cb => sub {
3016 do_reload_perl;
3017 undef $RELOAD_WATCHER;
3018 },
1188 }; 3019 );
1189} 3020}
1190 3021
1191register "<global>", __PACKAGE__;
1192
1193register_command "perl-reload" => sub { 3022register_command "reload" => sub {
1194 my ($who, $arg) = @_; 3023 my ($who, $arg) = @_;
1195 3024
1196 if ($who->flag (FLAG_WIZ)) { 3025 if ($who->flag (FLAG_WIZ)) {
1197 _perl_reload { 3026 $who->message ("reloading server.");
1198 warn $_[0]; 3027 async { reload_perl };
1199 $who->message ($_[0]); 3028 }
3029};
3030
3031unshift @INC, $LIBDIR;
3032
3033my $bug_warning = 0;
3034
3035our @WAIT_FOR_TICK;
3036our @WAIT_FOR_TICK_BEGIN;
3037
3038sub wait_for_tick {
3039 return unless $TICK_WATCHER->is_active;
3040 return if $Coro::current == $Coro::main;
3041
3042 my $signal = new Coro::Signal;
3043 push @WAIT_FOR_TICK, $signal;
3044 $signal->wait;
3045}
3046
3047sub wait_for_tick_begin {
3048 return unless $TICK_WATCHER->is_active;
3049 return if $Coro::current == $Coro::main;
3050
3051 my $signal = new Coro::Signal;
3052 push @WAIT_FOR_TICK_BEGIN, $signal;
3053 $signal->wait;
3054}
3055
3056 my $min = 1e6;#d#
3057 my $avg = 10;
3058$TICK_WATCHER = Event->timer (
3059 reentrant => 0,
3060 parked => 1,
3061 prio => 0,
3062 at => $NEXT_TICK || $TICK,
3063 data => WF_AUTOCANCEL,
3064 cb => sub {
3065 if ($Coro::current != $Coro::main) {
3066 Carp::cluck "major BUG: server tick called outside of main coro, skipping it"
3067 unless ++$bug_warning > 10;
3068 return;
3069 }
3070
3071 $NOW = $tick_start = Event::time;
3072
3073 cf::server_tick; # one server iteration
3074
3075 0 && sync_job {#d#
3076 for(1..10) {
3077 my $t = Event::time;
3078 my $map = my $map = new_from_path cf::map "/tmp/x.map"
3079 or die;
3080
3081 $map->width (50);
3082 $map->height (50);
3083 $map->alloc;
3084 $map->_load_objects ("/tmp/x.map", 1);
3085 my $t = Event::time - $t;
3086
3087 #next unless $t < 0.0013;#d#
3088 if ($t < $min) {
3089 $min = $t;
3090 }
3091 $avg = $avg * 0.99 + $t * 0.01;
3092 }
3093 warn "XXXXXXXXXXXXXXXXXX min $min avg $avg\n";#d#
3094 exit 0;
3095 # 2007-05-22 02:33:04.569 min 0.00112509727478027 avg 0.0012259249572477
1200 }; 3096 };
1201 }
1202};
1203 3097
1204unshift @INC, $LIBDIR; 3098 $RUNTIME += $TICK;
1205
1206$TICK_WATCHER = Event->timer (
1207 prio => 0,
1208 at => $NEXT_TICK || 1,
1209 data => WF_AUTOCANCEL,
1210 cb => sub {
1211 cf::server_tick; # one server iteration
1212
1213 my $NOW = Event::time;
1214 $NEXT_TICK += $TICK; 3099 $NEXT_TICK += $TICK;
3100
3101 if ($NOW >= $NEXT_RUNTIME_WRITE) {
3102 $NEXT_RUNTIME_WRITE = $NOW + 10;
3103 Coro::async_pool {
3104 write_runtime
3105 or warn "ERROR: unable to write runtime file: $!";
3106 };
3107 }
3108
3109# my $AFTER = Event::time;
3110# warn $AFTER - $NOW;#d#
3111
3112 if (my $sig = shift @WAIT_FOR_TICK_BEGIN) {
3113 $sig->send;
3114 }
3115 while (my $sig = shift @WAIT_FOR_TICK) {
3116 $sig->send;
3117 }
3118
3119 $NOW = Event::time;
1215 3120
1216 # if we are delayed by four ticks or more, skip them all 3121 # if we are delayed by four ticks or more, skip them all
1217 $NEXT_TICK = $NOW if $NOW >= $NEXT_TICK + $TICK * 4; 3122 $NEXT_TICK = $NOW if $NOW >= $NEXT_TICK + $TICK * 4;
1218 3123
1219 $TICK_WATCHER->at ($NEXT_TICK); 3124 $TICK_WATCHER->at ($NEXT_TICK);
1220 $TICK_WATCHER->start; 3125 $TICK_WATCHER->start;
3126
3127 $LOAD = ($NOW - $tick_start) / $TICK;
3128 $LOADAVG = $LOADAVG * 0.75 + $LOAD * 0.25;
3129
3130 _post_tick;
3131
3132
1221 }, 3133 },
1222); 3134);
1223 3135
3136{
3137 BDB::max_poll_time $TICK * 0.1;
3138 $BDB_POLL_WATCHER = Event->io (
3139 reentrant => 0,
3140 fd => BDB::poll_fileno,
3141 poll => 'r',
3142 prio => 0,
3143 data => WF_AUTOCANCEL,
3144 cb => \&BDB::poll_cb,
3145 );
3146 BDB::min_parallel 8;
3147
3148 BDB::set_sync_prepare {
3149 my $status;
3150 my $current = $Coro::current;
3151 (
3152 sub {
3153 $status = $!;
3154 $current->ready; undef $current;
3155 },
3156 sub {
3157 Coro::schedule while defined $current;
3158 $! = $status;
3159 },
3160 )
3161 };
3162
3163 unless ($DB_ENV) {
3164 $DB_ENV = BDB::db_env_create;
3165
3166 cf::sync_job {
3167 eval {
3168 BDB::db_env_open
3169 $DB_ENV,
3170 $BDBDIR,
3171 BDB::INIT_LOCK | BDB::INIT_LOG | BDB::INIT_MPOOL | BDB::INIT_TXN
3172 | BDB::RECOVER | BDB::REGISTER | BDB::USE_ENVIRON | BDB::CREATE,
3173 0666;
3174
3175 cf::cleanup "db_env_open($BDBDIR): $!" if $!;
3176
3177 $DB_ENV->set_flags (BDB::AUTO_COMMIT | BDB::REGION_INIT | BDB::TXN_NOSYNC, 1);
3178 $DB_ENV->set_lk_detect;
3179 };
3180
3181 cf::cleanup "db_env_open(db): $@" if $@;
3182 };
3183 }
3184}
3185
3186{
3187 IO::AIO::min_parallel 8;
3188
3189 undef $Coro::AIO::WATCHER;
1224IO::AIO::max_poll_time $TICK * 0.2; 3190 IO::AIO::max_poll_time $TICK * 0.1;
1225 3191 $AIO_POLL_WATCHER = Event->io (
1226Event->io (fd => IO::AIO::poll_fileno, 3192 reentrant => 0,
1227 poll => 'r',
1228 prio => 5,
1229 data => WF_AUTOCANCEL, 3193 data => WF_AUTOCANCEL,
3194 fd => IO::AIO::poll_fileno,
3195 poll => 'r',
3196 prio => 6,
1230 cb => \&IO::AIO::poll_cb); 3197 cb => \&IO::AIO::poll_cb,
3198 );
3199}
3200
3201my $_log_backtrace;
3202
3203sub _log_backtrace {
3204 my ($msg, @addr) = @_;
3205
3206 $msg =~ s/\n//;
3207
3208 # limit the # of concurrent backtraces
3209 if ($_log_backtrace < 2) {
3210 ++$_log_backtrace;
3211 async {
3212 my @bt = fork_call {
3213 @addr = map { sprintf "%x", $_ } @addr;
3214 my $self = (-f "/proc/$$/exe") ? "/proc/$$/exe" : $^X;
3215 open my $fh, "exec addr2line -C -f -i -e \Q$self\E @addr 2>&1 |"
3216 or die "addr2line: $!";
3217
3218 my @funcs;
3219 my @res = <$fh>;
3220 chomp for @res;
3221 while (@res) {
3222 my ($func, $line) = splice @res, 0, 2, ();
3223 push @funcs, "[$func] $line";
3224 }
3225
3226 @funcs
3227 };
3228
3229 LOG llevInfo, "[ABT] $msg\n";
3230 LOG llevInfo, "[ABT] $_\n" for @bt;
3231 --$_log_backtrace;
3232 };
3233 } else {
3234 LOG llevInfo, "[ABT] $msg\n";
3235 LOG llevInfo, "[ABT] [suppressed]\n";
3236 }
3237}
3238
3239# load additional modules
3240use cf::pod;
3241
3242END { cf::emergency_save }
1231 3243
12321 32441
1233 3245

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines