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.91 by elmex, Sun Dec 17 22:03:44 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
		71
		72	$Coro::main->prio (Coro::PRIO_MAX); # run main coroutine ("the server") with very high priority
		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" };
20		80
21	sub WF_AUTOCANCEL () { 1 } # automatically cancel this watcher on reload	81	sub WF_AUTOCANCEL () { 1 } # automatically cancel this watcher on reload
22		82
23	our %COMMAND = ();	83	our %COMMAND = ();
24	our %COMMAND_TIME = ();	84	our %COMMAND_TIME = ();
		85
		86	our @EXTS = (); # list of extension package names
25	our %EXTCMD = ();	87	our %EXTCMD = ();
		88	our %EXTICMD = ();
		89	our %EXT_CORO = (); # coroutines bound to extensions
		90	our %EXT_MAP = (); # pluggable maps
26		91
27	_init_vars;	92	our $RELOAD; # number of reloads so far, non-zero while in reload
28
29	our @EVENT;	93	our @EVENT;
30	our $LIBDIR = datadir . "/ext";	94	our @REFLECT; # set by XS
		95	our %REFLECT; # set by us
31		96
32	our $TICK = MAX_TIME * 1e-6;	97	our $CONFDIR = confdir;
33	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
34	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);
35		124
36	our %CFG;	125	our %CFG;
37		126
38	our $UPTIME; $UPTIME ||= time;	127	our $UPTIME; $UPTIME ||= time;
		128	our $RUNTIME;
		129	our $NOW;
		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;
39		166
40	#############################################################################	167	#############################################################################
41		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
42	=head2 GLOBAL VARIABLES	180	=head2 GLOBAL VARIABLES
43		181
44	=over 4	182	=over 4
45		183
46	=item $cf::UPTIME	184	=item $cf::UPTIME
47		185
48	The timestamp of the server start (so not actually an uptime).	186	The timestamp of the server start (so not actually an uptime).
49		187
50	=item $cf::LIBDIR	188	=item $cf::RUNTIME
51		189
52	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
53	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.
54		205
55	=item $cf::TICK	206	=item $cf::TICK
56		207
57	The interval between server ticks, in seconds.	208	The interval between server ticks, in seconds.
58		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
59	=item %cf::CFG	220	=item %cf::CFG
60		221
61	Configuration for the server, loaded from C</etc/crossfire/config>, or	222	Configuration for the server, loaded from C</etc/deliantra-server/config>, or
62	from wherever your confdir points to.	223	from wherever your confdir points to.
63		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
64	=back	243	=back
65		244
66	=cut	245	=cut
67		246
68	BEGIN {	247	$Coro::State::WARNHOOK = sub {
69	*CORE::GLOBAL::warn = sub {
70	my $msg = join "", @_;	248	my $msg = join "", @_;
		249
71	$msg .= "\n"	250	$msg .= "\n"
72	unless $msg =~ /\n$/;	251	unless $msg =~ /\n$/;
73		252
74	print STDERR "cfperl: $msg";	253	$msg =~ s/([\x00-\x08\x0b-\x1f])/sprintf "\\x%02x", ord $1/ge;
		254
75	LOG llevError, "cfperl: $msg";	255	LOG llevError, $msg;
76	};	256	};
77	}
78		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';
79	@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)
80		279
81	# 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
82	# within the Safe compartment.	281	# within the Safe compartment.
83	for my $pkg (qw(	282	for my $pkg (qw(
		283	cf::global cf::attachable
84	cf::object cf::object::player	284	cf::object cf::object::player
85	cf::client cf::player	285	cf::client cf::player
86	cf::arch cf::living	286	cf::arch cf::living
		287	cf::map cf::mapspace
87	cf::map cf::party cf::region	288	cf::party cf::region
88	)) {	289	)) {
89	no strict 'refs';
90	@{"safe::$pkg\::wrap::ISA"} = @{"$pkg\::wrap::ISA"} = $pkg;	290	@{"safe::$pkg\::wrap::ISA"} = @{"$pkg\::wrap::ISA"} = $pkg;
91	}	291	}
92		292
93	$Event::DIED = sub {	293	$EV::DIED = sub {
94	warn "error in event callback: @_";	294	Carp::cluck "error in event callback: @_";
95	};	295	};
96		296
97	my %ext_pkg;	297	#############################################################################
98	my @exts;
99	my @hook;
100		298
101	=head2 UTILITY FUNCTIONS	299	=head2 UTILITY FUNCTIONS
102		300
103	=over 4	301	=over 4
104		302
105	=cut	303	=item dumpval $ref
106		304
107	use JSON::Syck (); # TODO# replace by JSON::PC once working	305	=cut
108		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
109	=item $ref = cf::from_json $json	326	=item $ref = cf::decode_json $json
110		327
111	Converts a JSON string into the corresponding perl data structure.	328	Converts a JSON string into the corresponding perl data structure.
112		329
113	=cut
114
115	sub from_json($) {
116	$JSON::Syck::ImplicitUnicode = 1; # work around JSON::Syck bugs
117	JSON::Syck::Load $_[0]
118	}
119
120	=item $json = cf::to_json $ref	330	=item $json = cf::encode_json $ref
121		331
122	Converts a perl data structure into its JSON representation.	332	Converts a perl data structure into its JSON representation.
123		333
124	=cut	334	=cut
125		335
126	sub to_json($) {	336	our $json_coder = JSON::XS->new->utf8->max_size (1e6); # accept ~1mb max
127	$JSON::Syck::ImplicitUnicode = 0; # work around JSON::Syck bugs	337
128	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 });
129	}	754	}
130		755
131	=back	756	=back
132		757
133	=cut	758	=cut
134		759
135	#############################################################################	760	#############################################################################
136		761
137	=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).
138		771
139	=over 4	772	=over 4
140		773
141	=item $object->attach ($attachment, key => $value...)
142
143	=item $object->detach ($attachment)
144
145	Attach/detach a pre-registered attachment to an object.
146
147	=item $player->attach ($attachment, key => $value...)
148
149	=item $player->detach ($attachment)
150
151	Attach/detach a pre-registered attachment to a player.
152
153	=item $map->attach ($attachment, key => $value...)	774	=item $attachable->attach ($attachment, key => $value...)
154		775
155	=item $map->detach ($attachment)	776	=item $attachable->detach ($attachment)
156		777
157	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.
158		780
159	=item $bool = $object->attached ($name)	781	Example, attach a minesweeper attachment to the given object, making it a
		782	10x10 minesweeper game:
160		783
161	=item $bool = $player->attached ($name)	784	$obj->attach (minesweeper => width => 10, height => 10);
162		785
163	=item $bool = $map->attached ($name)	786	=item $bool = $attachable->attached ($name)
164		787
165	Checks wether the named attachment is currently attached to the object.	788	Checks wether the named attachment is currently attached to the object.
166		789
167	=item cf::attach_global ...	790	=item cf::CLASS->attach ...
168		791
169	Attach handlers for global events.	792	=item cf::CLASS->detach ...
170		793
171	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
172	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:
173		828
174	=over 4	829	=over 4
175		830
176	=item prio => $number	831	=item prio => $number
177		832
…		…
179	by another C<prio> setting). Lower priority handlers get executed	834	by another C<prio> setting). Lower priority handlers get executed
180	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
181	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
182	unless you know what you are doing.	837	unless you know what you are doing.
183		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
184	=item on_I<event> => \&cb	845	=item on_I<event> => \&cb
185		846
186	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
187	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
188	handlers are recognised generally depends on the type of object these	849	handlers are recognised generally depends on the type of object these
…		…
197	package and register them. Only handlers for eevents supported by the	858	package and register them. Only handlers for eevents supported by the
198	object/class are recognised.	859	object/class are recognised.
199		860
200	=back	861	=back
201		862
202	=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:
203		865
204	Attach handlers for a specific object type (e.g. TRANSPORT) and	866	cf::object::attachment sockpuppet =>
205	subtype. If C<$subtype> is zero or undef, matches all objects of the given	867	on_skill_attack => sub {
206	type.	868	my ($self, $victim) = @_;
207		869	...
208	=item cf::attach_to_objects ...
209
210	Attach handlers to all objects. Do not use this except for debugging or
211	very rare events, as handlers are (obviously) called for I<all> objects in
212	the game.
213
214	=item cf::attach_to_players ...
215
216	Attach handlers to all players.
217
218	=item cf::attach_to_maps ...
219
220	Attach handlers to all maps.
221
222	=item cf:register_attachment $name, ...
223
224	Register an attachment by name through which objects can refer to this
225	attachment.
226
227	=item cf:register_player_attachment $name, ...
228
229	Register an attachment by name through which players can refer to this
230	attachment.
231
232	=item cf:register_map_attachment $name, ...
233
234	Register an attachment by name through which maps can refer to this
235	attachment.
236
237	=cut
238
239	# the following variables are defined in .xs and must not be re-created
240	our @CB_GLOBAL = (); # registry for all global events
241	our @CB_OBJECT = (); # all objects (should not be used except in emergency)
242	our @CB_PLAYER = ();
243	our @CB_TYPE = (); # registry for type (cf-object class) based events
244	our @CB_MAP = ();
245
246	my %attachment;
247
248	sub _attach_cb($\%$$$) {
249	my ($registry, $undo, $event, $prio, $cb) = @_;
250
251	use sort 'stable';
252
253	$cb = [$prio, $cb];
254
255	@{$registry->[$event]} = sort
256	{ $a->[0] cmp $b->[0] }
257	@{$registry->[$event] || []}, $cb;
258
259	push @{$undo->{cb}}, [$event, $cb];
260	}
261
262	# attach handles attaching event callbacks
263	# the only thing the caller has to do is pass the correct
264	# registry (== where the callback attaches to).
265	sub _attach(\@$@) {
266	my ($registry, $klass, @arg) = @_;
267
268	my $prio = 0;
269
270	my %undo = (
271	registry => $registry,
272	cb => [],
273	);
274
275	my %cb_id = map +("on_" . lc $EVENT[$_][0], $_) , grep $EVENT[$_][1] == $klass, 0 .. $#EVENT;
276
277	while (@arg) {
278	my $type = shift @arg;
279
280	if ($type eq "prio") {
281	$prio = shift @arg;
282
283	} elsif ($type eq "package") {
284	my $pkg = shift @arg;
285
286	while (my ($name, $id) = each %cb_id) {
287	if (my $cb = $pkg->can ($name)) {
288	_attach_cb $registry, %undo, $id, $prio, $cb;
289	}
290	}	870	}
291
292	} elsif (exists $cb_id{$type}) {
293	_attach_cb $registry, %undo, $cb_id{$type}, $prio, shift @arg;
294
295	} elsif (ref $type) {
296	warn "attaching objects not supported, ignoring.\n";
297
298	} else {
299	shift @arg;
300	warn "attach argument '$type' not supported, ignoring.\n";
301	}
302	}
303
304	\%undo
305	}
306
307	sub _attach_attachment {
308	my ($obj, $name, %arg) = @_;
309
310	return if exists $obj->{_attachment}{$name};
311
312	my $res;
313
314	if (my $attach = $attachment{$name}) {
315	my $registry = $obj->registry;
316
317	for (@$attach) {
318	my ($klass, @attach) = @$_;
319	$res = _attach @$registry, $klass, @attach;
320	}
321
322	$obj->{$name} = \%arg;
323	} else {
324	warn "object uses attachment '$name' that is not available, postponing.\n";
325	}
326
327	$obj->{_attachment}{$name} = undef;
328
329	$res->{attachment} = $name;
330	$res
331	}
332
333	*cf::object::attach =
334	*cf::player::attach =
335	*cf::map::attach = sub {
336	my ($obj, $name, %arg) = @_;
337
338	_attach_attachment $obj, $name, %arg;
339	};
340
341	# all those should be optimised
342	*cf::object::detach =
343	*cf::player::detach =
344	*cf::map::detach = sub {
345	my ($obj, $name) = @_;
346
347	delete $obj->{_attachment}{$name};
348	reattach ($obj);
349	};
350
351	*cf::object::attached =
352	*cf::player::attached =
353	*cf::map::attached = sub {
354	my ($obj, $name) = @_;
355
356	exists $obj->{_attachment}{$name}
357	};
358
359	sub attach_global {
360	_attach @CB_GLOBAL, KLASS_GLOBAL, @_
361	}
362
363	sub attach_to_type {
364	my $type = shift;
365	my $subtype = shift;
366
367	_attach @{$CB_TYPE[$type + $subtype * NUM_SUBTYPES]}, KLASS_OBJECT, @_
368	}
369
370	sub attach_to_objects {
371	_attach @CB_OBJECT, KLASS_OBJECT, @_
372	}
373
374	sub attach_to_players {
375	_attach @CB_PLAYER, KLASS_PLAYER, @_
376	}
377
378	sub attach_to_maps {
379	_attach @CB_MAP, KLASS_MAP, @_
380	}
381
382	sub register_attachment {
383	my $name = shift;
384
385	$attachment{$name} = [[KLASS_OBJECT, @_]];
386	}
387
388	sub register_player_attachment {
389	my $name = shift;
390
391	$attachment{$name} = [[KLASS_PLAYER, @_]];
392	}
393
394	sub register_map_attachment {
395	my $name = shift;
396
397	$attachment{$name} = [[KLASS_MAP, @_]];
398	}
399
400	our $override;
401	our @invoke_results = (); # referenced from .xs code. TODO: play tricks with reify and mortals?
402
403	sub override {
404	$override = 1;
405	@invoke_results = ();
406	}
407
408	sub do_invoke {
409	my $event = shift;
410	my $callbacks = shift;
411
412	@invoke_results = ();
413
414	local $override;
415
416	for (@$callbacks) {
417	eval { &{$_->[1]} };
418
419	if ($@) {
420	warn "$@";
421	warn "... while processing $EVENT[$event][0](@_) event, skipping processing altogether.\n";
422	override;
423	}
424
425	return 1 if $override;
426	}
427
428	0	871	}
429	}
430		872
431	=item $bool = cf::invoke EVENT_GLOBAL_XXX, ...	873	=item $attachable->valid
432
433	=item $bool = $object->invoke (EVENT_OBJECT_XXX, ...)
434
435	=item $bool = $player->invoke (EVENT_PLAYER_XXX, ...)
436
437	=item $bool = $map->invoke (EVENT_MAP_XXX, ...)
438
439	Generate a global/object/player/map-specific event with the given arguments.
440
441	This API is preliminary (most likely, the EVENT_KLASS_xxx prefix will be
442	removed in future versions), and there is no public API to access override
443	results (if you must, access C<@cf::invoke_results> directly).
444
445	=back
446
447	=cut
448
449	#############################################################################
450
451	=head2 METHODS VALID FOR ALL CORE OBJECTS
452
453	=over 4
454
455	=item $object->valid, $player->valid, $map->valid
456		874
457	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
458	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
459	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
460	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
461	exception.	879	exception.
462		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
463	=back	1072	=back
464		1073
465	=cut	1074	=cut
466
467	*cf::object::valid =
468	*cf::player::valid =
469	*cf::map::valid = \&cf::_valid;
470		1075
471	#############################################################################	1076	#############################################################################
472	# object support	1077	# object support
473		1078
474	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 {
475	my ($obj, $data) = @_;	1113	my ($ob1, $ob2) = @_;
476		1114
477	$data = from_json $data;	1115	++$SLOW_MERGES;#d#
478		1116
479	for (@$data) {	1117	# we do the slow way here
480	my ($name, $args) = @$_;	1118	return _object_equal $ob1, $ob2
481
482	$obj->attach ($name, %{$args || {} });
483	}
484	}	1119	}
485		1120
486	# basically do the same as instantiate, without calling instantiate
487	sub reattach {	1121	sub reattach {
		1122	# basically do the same as instantiate, without calling instantiate
488	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
489	my $registry = $obj->registry;	1128	my $registry = $obj->registry;
490		1129
491	@$registry = ();	1130	@$registry = ();
492		1131
493	delete $obj->{_attachment} unless scalar keys %{ $obj->{_attachment} || {} };	1132	delete $obj->{_attachment} unless scalar keys %{ $obj->{_attachment} || {} };
494		1133
495	for my $name (keys %{ $obj->{_attachment} || {} }) {	1134	for my $name (keys %{ $obj->{_attachment} || {} }) {
496	if (my $attach = $attachment{$name}) {	1135	if (my $attach = $attachment{$name}) {
497	for (@$attach) {	1136	for (@$attach) {
498	my ($klass, @attach) = @$_;	1137	my ($klass, @attach) = @$_;
499	_attach @$registry, $klass, @attach;	1138	_attach $registry, $klass, @attach;
500	}	1139	}
501	} else {	1140	} else {
502	warn "object uses attachment '$name' that is not available, postponing.\n";	1141	warn "object uses attachment '$name' that is not available, postponing.\n";
503	}	1142	}
504	}	1143	}
505	}	1144	}
506		1145
507	sub object_freezer_save {	1146	cf::attachable->attach (
508	my ($filename, $rdata, $objs) = @_;
509
510	if (length $$rdata) {
511	warn sprintf "saving %s (%d,%d)\n",
512	$filename, length $$rdata, scalar @$objs;
513
514	if (open my $fh, ">:raw", "$filename~") {
515	chmod SAVE_MODE, $fh;
516	syswrite $fh, $$rdata;
517	close $fh;
518
519	if (@$objs && open my $fh, ">:raw", "$filename.pst~") {
520	chmod SAVE_MODE, $fh;
521	syswrite $fh, Storable::nfreeze { version => 1, objs => $objs };
522	close $fh;
523	rename "$filename.pst~", "$filename.pst";
524	} else {
525	unlink "$filename.pst";
526	}
527
528	rename "$filename~", $filename;
529	} else {
530	warn "FATAL: $filename~: $!\n";
531	}
532	} else {
533	unlink $filename;
534	unlink "$filename.pst";
535	}
536	}
537
538	sub object_freezer_as_string {
539	my ($rdata, $objs) = @_;
540
541	use Data::Dumper;
542
543	$$rdata . Dumper $objs
544	}
545
546	sub object_thawer_load {
547	my ($filename) = @_;
548
549	local $/;
550
551	my $av;
552
553	#TODO: use sysread etc.
554	if (open my $data, "<:raw:perlio", $filename) {
555	$data = <$data>;
556	if (open my $pst, "<:raw:perlio", "$filename.pst") {
557	$av = eval { (Storable::thaw <$pst>)->{objs} };
558	}
559	return ($data, $av);
560	}
561
562	()
563	}
564
565	attach_to_objects
566	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,
567	on_clone => sub {	1160	on_clone => sub {
568	my ($src, $dst) = @_;	1161	my ($src, $dst) = @_;
569		1162
570	@{$dst->registry} = @{$src->registry};	1163	@{$dst->registry} = @{$src->registry};
571		1164
572	%$dst = %$src;	1165	%$dst = %$src;
573		1166
574	%{$dst->{_attachment}} = %{$src->{_attachment}}	1167	%{$dst->{_attachment}} = %{$src->{_attachment}}
575	if exists $src->{_attachment};	1168	if exists $src->{_attachment};
576	},	1169	},
577	;	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
578		1256
579	#############################################################################	1257	#############################################################################
580	# command handling &c	1258	# command handling &c
581		1259
582	=item cf::register_command $name => \&callback($ob,$args);	1260	=item cf::register_command $name => \&callback($ob,$args);
…		…
595	push @{ $COMMAND{$name} }, [$caller, $cb];	1273	push @{ $COMMAND{$name} }, [$caller, $cb];
596	}	1274	}
597		1275
598	=item cf::register_extcmd $name => \&callback($pl,$packet);	1276	=item cf::register_extcmd $name => \&callback($pl,$packet);
599		1277
600	Register a callbackf ro execution when the client sends an extcmd packet.	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.
601		1283
602	If the callback returns something, it is sent back as if reply was being	1284	If the callback returns something, it is sent back as if reply was being
603	called.	1285	called.
604		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
605	=cut	1298	=cut
606		1299
607	sub register_extcmd {	1300	sub register_extcmd {
608	my ($name, $cb) = @_;	1301	my ($name, $cb) = @_;
609		1302
610	my $caller = caller;
611	#warn "registering extcmd '$name' to '$caller'";
612
613	$EXTCMD{$name} = [$cb, $caller];	1303	$EXTCMD{$name} = $cb;
614	}	1304	}
615		1305
616	attach_to_players	1306	sub register_exticmd {
		1307	my ($name, $cb) = @_;
		1308
		1309	$EXTICMD{$name} = $cb;
		1310	}
		1311
		1312	use File::Glob ();
		1313
		1314	cf::player->attach (
617	on_command => sub {	1315	on_unknown_command => sub {
618	my ($pl, $name, $params) = @_;	1316	my ($pl, $name, $params) = @_;
619		1317
620	my $cb = $COMMAND{$name}	1318	my $cb = $COMMAND{$name}
621	or return;	1319	or return;
622		1320
…		…
627	cf::override;	1325	cf::override;
628	},	1326	},
629	on_extcmd => sub {	1327	on_extcmd => sub {
630	my ($pl, $buf) = @_;	1328	my ($pl, $buf) = @_;
631		1329
632	my $msg = eval { from_json $buf };	1330	my $msg = eval { $pl->ns->{json_coder}->decode ($buf) };
633		1331
634	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
635	if (my $cb = $EXTCMD{$msg->{msgtype}}) {	1340	if (my $cb = $EXTCMD{$type}) {
636	if (my %reply = $cb->[0]->($pl, $msg)) {	1341	@reply = $cb->($pl, @payload);
637	$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;
638	}	1434	}
639	}	1435	}
640	} else {	1436
641	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	}
642	}	1444	}
		1445	}
		1446	};
		1447	}
643		1448
644	cf::override;	1449	#############################################################################
		1450
		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	}
645	},	1535	}
646	;	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
647		1794
648	sub register {	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 {
649	my ($base, $pkg) = @_;	1809	my ($self, $merge) = @_;
650		1810
651	#TODO	1811	# we have to keep some variables in memory intact
652	}	1812	local $self->{path};
		1813	local $self->{load_path};
653		1814
654	sub load_extension {	1815	$self->SUPER::thawer_merge ($merge);
		1816	}
		1817
		1818	sub normalise {
655	my ($path) = @_;	1819	my ($path, $base) = @_;
656		1820
657	$path =~ /([^\/\\]+)\.ext$/ or die "$path";	1821	$path = "$path"; # make sure its a string
658	my $base = $1;
659	my $pkg = $1;
660	$pkg =~ s/[^[:word:]]/_/g;
661	$pkg = "ext::$pkg";
662		1822
663	warn "loading '$path' into '$pkg'\n";	1823	$path =~ s/\.map$//;
664		1824
665	open my $fh, "<:utf8", $path	1825	# map plan:
666	or die "$path: $!";	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
667		1833
668	my $source =	1834	$path =~ s/$PATH_SEP/\//go;
669	"package $pkg; use strict; use utf8;\n"
670	. "#line 1 \"$path\"\n{\n"
671	. (do { local $/; <$fh> })
672	. "\n};\n1";
673		1835
674	eval $source	1836	# treat it as relative path if it starts with
675	or die $@ ? "$path: $@\n"	1837	# something that looks reasonable
676	: "extension disabled.\n";	1838	if ($path =~ m{^(?:\./|\.\./|\w)}) {
		1839	$base or Carp::carp "normalise called with relative path and no base: '$path'";
677		1840
678	push @exts, $pkg;	1841	$base =~ s{[^/]+/?$}{};
679	$ext_pkg{$base} = $pkg;	1842	$path = "$base/$path";
680
681	# no strict 'refs';
682	# @{"$pkg\::ISA"} = ext::;
683
684	register $base, $pkg;
685	}
686
687	sub unload_extension {
688	my ($pkg) = @_;
689
690	warn "removing extension $pkg\n";
691
692	# remove hooks
693	#TODO
694	# for my $idx (0 .. $#PLUGIN_EVENT) {
695	# delete $hook[$idx]{$pkg};
696	# }	1843	}
697		1844
698	# remove commands	1845	for ($path) {
699	for my $name (keys %COMMAND) {	1846	redo if s{//}{/};
700	my @cb = grep $_->[0] ne $pkg, @{ $COMMAND{$name} };	1847	redo if s{/\.?/}{/};
		1848	redo if s{/[^/]+/\.\./}{/};
		1849	}
701		1850
702	if (@cb) {	1851	$path
703	$COMMAND{$name} = \@cb;	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;
704	} else {	1984	} else {
705	delete $COMMAND{$name};	1985	$self->load_header_orig
706	}	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
707	}	1996	1
		1997	}
708		1998
709	# remove extcmds	1999	sub find;
710	for my $name (grep $EXTCMD{$_}[1] eq $pkg, keys %EXTCMD) {	2000	sub find {
711	delete $EXTCMD{$name};	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
712	}	2040	{
		2041	my $guard = cf::lock_acquire "map_data:$path";
713		2042
714	if (my $cb = $pkg->can ("unload")) {	2043	return unless $self->valid;
715	eval {	2044	return unless $self->in_memory == cf::MAP_SWAPPED;
716	$cb->($pkg);	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	}
717	1	2069	}
718	} or warn "$pkg unloaded, but with errors: $@";	2070	}
719	}
720		2071
721	Symbol::delete_package $pkg;	2072	$f->resolve_delayed_derefs;
722	}
723		2073
724	sub load_extensions {	2074	cf::cede_to_tick;
725	for my $ext (<$LIBDIR/*.ext>) {	2075	# now do the right thing for maps
726	next unless -r $ext;	2076	$self->link_multipart_objects;
727	eval {	2077	$self->difficulty ($self->estimate_difficulty)
728	load_extension $ext;	2078	unless $self->difficulty;
729	1	2079	cf::cede_to_tick;
730	} or warn "$ext not loaded: $@";
731	}
732	}
733		2080
734	#############################################################################	2081	unless ($self->{deny_activate}) {
735	# load/save/clean perl data associated with a map	2082	$self->decay_objects;
		2083	$self->fix_auto_apply;
		2084	$self->update_buttons;
		2085	cf::cede_to_tick;
		2086	$self->activate;
		2087	}
736		2088
737	*cf::mapsupport::on_clean = sub {	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 {
738	my ($map) = @_;	2115	my ($map) = @_;
739		2116
740	my $path = $map->tmpname;	2117	my @neigh; # diagonal neighbours
741	defined $path or return;
742		2118
743	unlink "$path.pst";	2119	for (0 .. 3) {
744	};	2120	my $neigh = $map->tile_path ($_)
		2121	or next;
		2122	$neigh = find $neigh, $map
		2123	or next;
		2124	$neigh->load;
745		2125
746	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	}
747		2130
748	#############################################################################	2131	for (grep defined $_->[0], @neigh) {
749	# load/save perl data associated with player->ob objects	2132	my ($path, $origin) = @$_;
750		2133	my $neigh = find $path, $origin
751	sub all_objects(@) {	2134	or next;
752	@_, map all_objects ($_->inv), @_	2135	$neigh->load;
		2136	}
753	}	2137	}
754		2138
755	# TODO: compatibility cruft, remove when no longer needed	2139	sub find_sync {
756	attach_to_players	2140	my ($path, $origin) = @_;
757	on_load => sub {
758	my ($pl, $path) = @_;
759		2141
760	for my $o (all_objects $pl->ob) {	2142	cf::sync_job { find $path, $origin }
761	if (my $value = $o->get_ob_key_value ("_perl_data")) {	2143	}
762	$o->set_ob_key_value ("_perl_data");
763		2144
764	%$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};
765	}	2178	}
766	}	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);
767	},	2217	}
768	;	2218	}
769		2219
770	#############################################################################	2220	sub swap_out {
		2221	my ($self) = @_;
771		2222
772	=head2 CORE EXTENSIONS	2223	# save first because save cedes
		2224	$self->save;
773		2225
774	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;
775		2404
776	=over 4	2405	=over 4
777		2406
778	=item cf::player::exists $login	2407	=item $ob->inv_recursive
779		2408
780	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.
781		2411
782	=cut	2412	=cut
783		2413
784	sub cf::player::exists($) {	2414	sub inv_recursive_;
785	cf::player::find $_[0]	2415	sub inv_recursive_ {
786	or -f sprintf "%s/%s/%s/%s.pl", cf::localdir, cf::playerdir, ($_[0]) x 2;	2416	map { $_, inv_recursive_ $_->inv } @_
787	}	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
788		2458
789	=item $player_object->reply ($npc, $msg[, $flags])	2459	=item $player_object->reply ($npc, $msg[, $flags])
790		2460
791	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>
792	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
793	dialogue with the given NPC character.	2463	dialogue with the given NPC character.
794		2464
795	=cut	2465	=cut
796		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
797	# rough implementation of a future "reply" method that works	2481	# rough implementation of a future "reply" method that works
798	# with dialog boxes.	2482	# with dialog boxes.
		2483	#TODO: the first argument must go, split into a $npc->reply_to ( method
799	sub cf::object::player::reply($$$;$) {	2484	sub cf::object::player::reply($$$;$) {
800	my ($self, $npc, $msg, $flags) = @_;	2485	my ($self, $npc, $msg, $flags) = @_;
801		2486
802	$flags = cf::NDI_BROWN | cf::NDI_UNIQUE unless @_ >= 4;	2487	$flags = cf::NDI_BROWN | cf::NDI_UNIQUE unless @_ >= 4;
803		2488
804	if ($self->{record_replies}) {	2489	if ($self->{record_replies}) {
805	push @{ $self->{record_replies} }, [$npc, $msg, $flags];	2490	push @{ $self->{record_replies} }, [$npc, $msg, $flags];
		2491
806	} 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 {
807	$msg = $npc->name . " says: $msg" if $npc;	2500	$msg = $npc->name . " says: $msg" if $npc;
808	$self->message ($msg, $flags);	2501	$self->send_msg ($SAY_CHANNEL => $msg, $flags);
		2502	}
809	}	2503	}
810	}	2504	}
811		2505
812	=item $player->ext_reply ($msgid, $msgtype, %msg)	2506	=item $object->send_msg ($channel, $msg, $color, [extra...])
813		2507
814	Sends an ext reply to the player.
815
816	=cut	2508	=cut
817		2509
818	sub cf::player::ext_reply($$$%) {	2510	sub cf::object::send_msg {
819	my ($self, $id, %msg) = @_;	2511	my $pl = shift->contr
820		2512	or return;
821	$msg{msgid} = $id;	2513	$pl->send_msg (@_);
822
823	$self->send ("ext " . to_json \%msg);
824	}	2514	}
825		2515
826	=item $player_object->may ("access")	2516	=item $player_object->may ("access")
827		2517
828	Returns wether the given player is authorized to access resource "access"	2518	Returns wether the given player is authorized to access resource "access"
…		…
837	(ref $cf::CFG{"may_$access"}	2527	(ref $cf::CFG{"may_$access"}
838	? scalar grep $self->name eq $_, @{$cf::CFG{"may_$access"}}	2528	? scalar grep $self->name eq $_, @{$cf::CFG{"may_$access"}}
839	: $cf::CFG{"may_$access"})	2529	: $cf::CFG{"may_$access"})
840	}	2530	}
841		2531
842	=cut	2532	=item $player_object->enter_link
843		2533
844	#############################################################################	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
845		3148
846	=head2 SAFE SCRIPTING	3149	=head2 SAFE SCRIPTING
847		3150
848	Functions that provide a safe environment to compile and execute	3151	Functions that provide a safe environment to compile and execute
849	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
…		…
856	our $safe = new Safe "safe";	3159	our $safe = new Safe "safe";
857	our $safe_hole = new Safe::Hole;	3160	our $safe_hole = new Safe::Hole;
858		3161
859	$SIG{FPE} = 'IGNORE';	3162	$SIG{FPE} = 'IGNORE';
860		3163
861	$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	));
862		3169
863	# here we export the classes and methods available to script code	3170	# here we export the classes and methods available to script code
864		3171
865	=pod	3172	=pod
866		3173
867	The following fucntions and emthods are available within a safe environment:	3174	The following functions and methods are available within a safe environment:
868		3175
869	cf::object contr pay_amount pay_player map	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
870	cf::object::player player	3181	cf::object::player
871	cf::player peaceful	3182	player
872	cf::map trigger	3183
		3184	cf::player
		3185	peaceful
		3186
		3187	cf::map
		3188	trigger
873		3189
874	=cut	3190	=cut
875		3191
876	for (	3192	for (
877	["cf::object" => qw(contr pay_amount pay_player map)],	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)],
878	["cf::object::player" => qw(player)],	3196	["cf::object::player" => qw(player)],
879	["cf::player" => qw(peaceful)],	3197	["cf::player" => qw(peaceful send_msg)],
880	["cf::map" => qw(trigger)],	3198	["cf::map" => qw(trigger)],
881	) {	3199	) {
882	no strict 'refs';	3200	no strict 'refs';
883	my ($pkg, @funs) = @$_;	3201	my ($pkg, @funs) = @$_;
884	*{"safe::$pkg\::$_"} = $safe_hole->wrap (\&{"$pkg\::$_"})	3202	*{"safe::$pkg\::$_"} = $safe_hole->wrap (\&{"$pkg\::$_"})
…		…
902		3220
903	my $qcode = $code;	3221	my $qcode = $code;
904	$qcode =~ s/"/‟/g; # not allowed in #line filenames	3222	$qcode =~ s/"/‟/g; # not allowed in #line filenames
905	$qcode =~ s/\n/\\n/g;	3223	$qcode =~ s/\n/\\n/g;
906		3224
		3225	%vars = (_dummy => 0) unless %vars;
		3226
		3227	my @res;
907	local $_;	3228	local $_;
908	local @safe::cf::_safe_eval_args = values %vars;
909		3229
910	my $eval =	3230	my $eval =
911	"do {\n"	3231	"do {\n"
912	. "my (" . (join ",", map "\$$_", keys %vars) . ") = \@cf::_safe_eval_args;\n"	3232	. "my (" . (join ",", map "\$$_", keys %vars) . ") = \@cf::_safe_eval_args;\n"
913	. "#line 0 \"{$qcode}\"\n"	3233	. "#line 0 \"{$qcode}\"\n"
914	. $code	3234	. $code
915	. "\n}"	3235	. "\n}"
916	;	3236	;
917		3237
		3238	if ($CFG{safe_eval}) {
918	sub_generation_inc;	3239	sub_generation_inc;
		3240	local @safe::cf::_safe_eval_args = values %vars;
919	my @res = wantarray ? $safe->reval ($eval) : scalar $safe->reval ($eval);	3241	@res = wantarray ? $safe->reval ($eval) : scalar $safe->reval ($eval);
920	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	}
921		3247
922	if ($@) {	3248	if ($@) {
923	warn "$@";	3249	warn "$@";
924	warn "while executing safe code '$code'\n";	3250	warn "while executing safe code '$code'\n";
925	warn "with arguments " . (join " ", %vars) . "\n";	3251	warn "with arguments " . (join " ", %vars) . "\n";
…		…
944	=cut	3270	=cut
945		3271
946	sub register_script_function {	3272	sub register_script_function {
947	my ($fun, $cb) = @_;	3273	my ($fun, $cb) = @_;
948		3274
949	no strict 'refs';	3275	$fun = "safe::$fun" if $CFG{safe_eval};
950	*{"safe::$fun"} = $safe_hole->wrap ($cb);	3276	*$fun = $safe_hole->wrap ($cb);
951	}	3277	}
952		3278
953	=back	3279	=back
954		3280
955	=cut	3281	=cut
956		3282
957	#############################################################################	3283	#############################################################################
		3284	# the server's init and main functions
958		3285
959	=head2 EXTENSION DATABASE SUPPORT	3286	sub load_facedata($) {
		3287	my ($path) = @_;
960		3288
961	Crossfire maintains a very simple database for extension use. It can	3289	# HACK to clear player env face cache, we need some signal framework
962	currently store anything that can be serialised using Storable, which	3290	# for this (global event?)
963	excludes objects.	3291	%ext::player_env::MUSIC_FACE_CACHE = ();
964		3292
965	The parameter C<$family> should best start with the name of the extension	3293	my $enc = JSON::XS->new->utf8->canonical->relaxed;
966	using it, it should be unique.
967		3294
968	=over 4	3295	warn "loading facedata from $path\n";
969		3296
970	=item $hashref = cf::db_get $family	3297	my $facedata;
		3298	0 < aio_load $path, $facedata
		3299	or die "$path: $!";
971		3300
972	Return a hashref for use by the extension C<$family>, which can be	3301	$facedata = Coro::Storable::thaw $facedata;
973	modified. After modifications, you have to call C<cf::db_dirty> or
974	C<cf::db_sync>.
975		3302
976	=item $value = cf::db_get $family => $key	3303	$facedata->{version} == 2
		3304	or cf::cleanup "$path: version mismatch, cannot proceed.";
977		3305
978	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;
979		3314
980	=item cf::db_put $family => $hashref	3315	{
		3316	my $faces = $facedata->{faceinfo};
981		3317
982	Stores the given family hashref into the database. Updates are delayed, if	3318	while (my ($face, $info) = each %$faces) {
983	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;
984		3320
985	=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};
986		3325
987	Stores the given C<$value> in the family hash. Updates are delayed, if you	3326	cf::cede_to_tick;
988	want the data to be synced to disk immediately, use C<cf::db_sync>.	3327	}
989		3328
990	=item cf::db_dirty	3329	while (my ($face, $info) = each %$faces) {
		3330	next unless $info->{smooth};
991		3331
992	Marks the database as dirty, to be updated at a later time.	3332	my $idx = cf::face::find $face
		3333	or next;
993		3334
994	=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	}
995		3341
996	Immediately write the database to disk I<if it is dirty>.	3342	cf::cede_to_tick;
		3343	}
		3344	}
997		3345
998	=cut	3346	{
		3347	my $anims = $facedata->{animinfo};
999		3348
1000	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	}
1001		3966
1002	{	3967	{
1003	my $path = cf::localdir . "/database.pst";	3968	# configure BDB
1004		3969
1005	sub db_load() {	3970	BDB::min_parallel 16;
1006	warn "loading database $path\n";#d# remove later	3971	BDB::max_poll_reqs $TICK * 0.1;
1007	$DB = stat $path ? Storable::retrieve $path : { };	3972	$AnyEvent::BDB::WATCHER->priority (1);
1008	}
1009		3973
1010	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);
1011		3981
1012	sub db_save() {	3982	cf::sync_job {
1013	warn "saving database $path\n";#d# remove later
1014	waitpid $pid, 0 if $pid;
1015	if (0 == ($pid = fork)) {
1016	$DB->{_meta}{version} = 1;
1017	Storable::nstore $DB, "$path~";
1018	rename "$path~", $path;
1019	cf::_exit 0 if defined $pid;
1020	}
1021	}
1022
1023	my $dirty;
1024
1025	sub db_sync() {
1026	db_save if $dirty;
1027	undef $dirty;
1028	}
1029
1030	my $idle = Event->idle (min => $TICK * 2.8, max => 10, repeat => 0, data => WF_AUTOCANCEL, cb => sub {
1031	db_sync;
1032	});
1033
1034	sub db_dirty() {
1035	$dirty = 1;
1036	$idle->start;
1037	}
1038
1039	sub db_get($;$) {
1040	@_ >= 2
1041	? $DB->{$_[0]}{$_[1]}
1042	: ($DB->{$_[0]} ||= { })
1043	}
1044
1045	sub db_put($$;$) {
1046	if (@_ >= 3) {
1047	$DB->{$_[0]}{$_[1]} = $_[2];
1048	} else {	3983	eval {
1049	$DB->{$_[0]} = $_[1];	3984	BDB::db_env_open
1050	}	3985	$DB_ENV,
1051	db_dirty;	3986	$BDBDIR,
1052	}	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;
1053		3990
1054	attach_global	3991	cf::cleanup "db_env_open($BDBDIR): $!" if $!;
1055	prio => 10000,
1056	on_cleanup => sub {
1057	db_sync;
1058	},
1059	;
1060	}
1061
1062	#############################################################################
1063	# the server's main()
1064
1065	sub cfg_load {
1066	open my $fh, "<:utf8", cf::confdir . "/config"
1067	or return;
1068
1069	local $/;
1070	*CFG = YAML::Syck::Load <$fh>;
1071	}
1072
1073	sub main {
1074	cfg_load;
1075	db_load;
1076	load_extensions;
1077	Event::loop;
1078	}
1079
1080	#############################################################################
1081	# initialisation
1082
1083	sub _perl_reload(&) {
1084	my ($msg) = @_;
1085
1086	$msg->("reloading...");
1087
1088	eval {
1089	# cancel all watchers
1090	for (Event::all_watchers) {
1091	$_->cancel if $_->data & WF_AUTOCANCEL;
1092	}
1093
1094	# unload all extensions
1095	for (@exts) {
1096	$msg->("unloading <$_>");
1097	unload_extension $_;
1098	}
1099
1100	# unload all modules loaded from $LIBDIR
1101	while (my ($k, $v) = each %INC) {
1102	next unless $v =~ /^\Q$LIBDIR\E\/.*\.pm$/;
1103
1104	$msg->("removing <$k>");
1105	delete $INC{$k};
1106
1107	$k =~ s/\.pm$//;
1108	$k =~ s/\//::/g;
1109
1110	if (my $cb = $k->can ("unload_module")) {
1111	$cb->();
1112	}	3992	};
1113		3993
1114	Symbol::delete_package $k;	3994	cf::cleanup "db_env_open(db): $@" if $@;
1115	}	3995	};
		3996	}
1116		3997
1117	# sync database to disk	3998	$BDB_DEADLOCK_WATCHER = EV::periodic 0, 3, 0, sub {
1118	cf::db_sync;	3999	BDB::db_env_lock_detect $DB_ENV, 0, BDB::LOCK_DEFAULT, 0, sub { };
1119
1120	# get rid of safe::, as good as possible
1121	Symbol::delete_package "safe::$_"
1122	for qw(cf::object cf::object::player cf::player cf::map cf::party cf::region);
1123
1124	# remove register_script_function callbacks
1125	# TODO
1126
1127	# unload cf.pm "a bit"
1128	delete $INC{"cf.pm"};
1129
1130	# don't, removes xs symbols, too,
1131	# and global variables created in xs
1132	#Symbol::delete_package __PACKAGE__;
1133
1134	# reload cf.pm
1135	$msg->("reloading cf.pm");
1136	require cf;
1137
1138	# load config and database again
1139	cf::cfg_load;
1140	cf::db_load;
1141
1142	# load extensions
1143	$msg->("load extensions");
1144	cf::load_extensions;
1145
1146	# reattach attachments to objects
1147	$msg->("reattach");
1148	_global_reattach;
1149	};	4000	};
1150	$msg->($@) if $@;	4001	$BDB_CHECKPOINT_WATCHER = EV::periodic 0, 60, 0, sub {
1151		4002	BDB::db_env_txn_checkpoint $DB_ENV, 0, 0, 0, sub { };
1152	$msg->("reloaded");
1153	};
1154
1155	sub perl_reload() {
1156	_perl_reload {
1157	warn $_[0];
1158	print "$_[0]\n";
1159	};	4003	};
		4004	$BDB_TRICKLE_WATCHER = EV::periodic 0, 10, 0, sub {
		4005	BDB::db_env_memp_trickle $DB_ENV, 20, 0, sub { };
		4006	};
1160	}	4007	}
1161		4008
1162	register "<global>", __PACKAGE__;	4009	{
		4010	# configure IO::AIO
1163		4011
1164	register_command "perl-reload" => sub {	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 {
1165	my ($who, $arg) = @_;	4020	my ($msg, @addr) = @_;
1166		4021
1167	if ($who->flag (FLAG_WIZ)) {	4022	$msg =~ s/\n//;
1168	_perl_reload {	4023
1169	warn $_[0];	4024	# limit the # of concurrent backtraces
1170	$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;
1171	};	4052	};
1172	}	4053	} else {
1173	};	4054	LOG llevInfo, "[ABT] $msg\n";
1174		4055	LOG llevInfo, "[ABT] [suppressed]\n";
1175	unshift @INC, $LIBDIR;
1176
1177	$TICK_WATCHER = Event->timer (
1178	prio => 0,
1179	at => $NEXT_TICK || 1,
1180	data => WF_AUTOCANCEL,
1181	cb => sub {
1182	cf::server_tick; # one server iteration
1183
1184	my $NOW = Event::time;
1185	$NEXT_TICK += $TICK;
1186
1187	# if we are delayed by four ticks or more, skip them all
1188	$NEXT_TICK = $NOW if $NOW >= $NEXT_TICK + $TICK * 4;
1189
1190	$TICK_WATCHER->at ($NEXT_TICK);
1191	$TICK_WATCHER->start;
1192	},	4056	}
1193	);	4057	}
1194		4058
1195	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;
1196		4062
1197	Event->io (fd => IO::AIO::poll_fileno,	4063	END { cf::emergency_save }
1198	poll => 'r',
1199	prio => 5,
1200	data => WF_AUTOCANCEL,
1201	cb => \&IO::AIO::poll_cb);
1202		4064
1203	1	4065	1
1204		4066

Diff Legend

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