ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/deliantra/server/lib/cf.pm
(Generate patch)

Comparing deliantra/server/lib/cf.pm (file contents):
Revision 1.63 by root, Fri Sep 8 17:41:41 2006 UTC vs.
Revision 1.449 by root, Sat Sep 20 00:09:27 2008 UTC

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

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines