ViewVC Help

View File | Revision Log | Show Annotations | Download File

/cvs/deliantra/server/lib/cf.pm

Comparing deliantra/server/lib/cf.pm (file contents):
Revision 1.83 by root, Mon Dec 11 01:30:41 2006 UTC vs.
Revision 1.510 by root, Tue Apr 6 22:59:28 2010 UTC

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

Diff Legend

–	Removed lines
+	Added lines
<	Changed lines
>	Changed lines