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.93 by root, Thu Dec 21 22:41:35 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	}	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	};
78		271
79	@safe::cf::global::ISA = @cf::global::ISA = 'cf::attachable';	272	@safe::cf::global::ISA = @cf::global::ISA = 'cf::attachable';
80	@safe::cf::object::ISA = @cf::object::ISA = 'cf::attachable';	273	@safe::cf::object::ISA = @cf::object::ISA = 'cf::attachable';
81	@safe::cf::player::ISA = @cf::player::ISA = 'cf::attachable';	274	@safe::cf::player::ISA = @cf::player::ISA = 'cf::attachable';
82	@safe::cf::client::ISA = @cf::client::ISA = 'cf::attachable';	275	@safe::cf::client::ISA = @cf::client::ISA = 'cf::attachable';
83	@safe::cf::map::ISA = @cf::map::ISA = 'cf::attachable';	276	@safe::cf::map::ISA = @cf::map::ISA = 'cf::attachable';
		277	@safe::cf::arch::ISA = @cf::arch::ISA = 'cf::object';
84	@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)
85		279
86	# 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
87	# within the Safe compartment.	281	# within the Safe compartment.
88	for my $pkg (qw(	282	for my $pkg (qw(
89	cf::global	283	cf::global cf::attachable
90	cf::object cf::object::player	284	cf::object cf::object::player
91	cf::client cf::player	285	cf::client cf::player
92	cf::arch cf::living	286	cf::arch cf::living
		287	cf::map cf::mapspace
93	cf::map cf::party cf::region	288	cf::party cf::region
94	)) {	289	)) {
95	no strict 'refs';
96	@{"safe::$pkg\::wrap::ISA"} = @{"$pkg\::wrap::ISA"} = $pkg;	290	@{"safe::$pkg\::wrap::ISA"} = @{"$pkg\::wrap::ISA"} = $pkg;
97	}	291	}
98		292
99	$Event::DIED = sub {	293	$EV::DIED = sub {
100	warn "error in event callback: @_";	294	Carp::cluck "error in event callback: @_";
101	};	295	};
102		296
103	my %ext_pkg;	297	#############################################################################
104	my @exts;
105	my @hook;
106		298
107	=head2 UTILITY FUNCTIONS	299	=head2 UTILITY FUNCTIONS
108		300
109	=over 4	301	=over 4
110		302
111	=cut	303	=item dumpval $ref
112		304
113	use JSON::Syck (); # TODO# replace by JSON::PC once working	305	=cut
114		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
115	=item $ref = cf::from_json $json	326	=item $ref = cf::decode_json $json
116		327
117	Converts a JSON string into the corresponding perl data structure.	328	Converts a JSON string into the corresponding perl data structure.
118		329
119	=cut
120
121	sub from_json($) {
122	$JSON::Syck::ImplicitUnicode = 1; # work around JSON::Syck bugs
123	JSON::Syck::Load $_[0]
124	}
125
126	=item $json = cf::to_json $ref	330	=item $json = cf::encode_json $ref
127		331
128	Converts a perl data structure into its JSON representation.	332	Converts a perl data structure into its JSON representation.
129		333
130	=cut	334	=cut
131		335
132	sub to_json($) {	336	our $json_coder = JSON::XS->new->utf8->max_size (1e6); # accept ~1mb max
133	$JSON::Syck::ImplicitUnicode = 0; # work around JSON::Syck bugs	337
134	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 });
135	}	754	}
136		755
137	=back	756	=back
138		757
139	=cut	758	=cut
140		759
141	#############################################################################	760	#############################################################################
142		761
143	=head2 ATTACHABLE OBJECTS	762	=head2 ATTACHABLE OBJECTS
144		763
145	You can define and attach attachments to each "attachable" object in	764	Many objects in deliantra are so-called attachable objects. That means you can
146	crossfire+ (objects, players, clients, maps and the special "global"	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
147	class). In the following description, CLASS can be any of C<global>,	768	In the following description, CLASS can be any of C<global>, C<object>
148	C<object> C<player>, C<client> or C<map>.	769	C<player>, C<client> or C<map> (i.e. the attachable objects in
		770	Deliantra).
149		771
150	=over 4	772	=over 4
151		773
		774	=item $attachable->attach ($attachment, key => $value...)
		775
		776	=item $attachable->detach ($attachment)
		777
		778	Attach/detach a pre-registered attachment to a specific object and give it
		779	the specified key/value pairs as arguments.
		780
		781	Example, attach a minesweeper attachment to the given object, making it a
		782	10x10 minesweeper game:
		783
		784	$obj->attach (minesweeper => width => 10, height => 10);
		785
		786	=item $bool = $attachable->attached ($name)
		787
		788	Checks wether the named attachment is currently attached to the object.
		789
		790	=item cf::CLASS->attach ...
		791
		792	=item cf::CLASS->detach ...
		793
		794	Define an anonymous attachment and attach it to all objects of the given
		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
152	=item cf::CLASS::attachment $name, ...	819	=item cf::CLASS::attachment $name, ...
153		820
154	Register an attachment by name through which attachable objects can refer	821	Register an attachment by C<$name> through which attachable objects of the
155	to this attachment.	822	given CLASS can refer to this attachment.
156		823
157	=item $bool = $attachable->attached ($name)	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.
158		826
159	Checks wether the named attachment is currently attached to the object.
160
161	=item $attachable->attach ($attachment, key => $value...)
162
163	=item $attachable->detach ($attachment)
164
165	Attach/detach a pre-registered attachment either to a specific object
166	(C<$attachable>) or all objects of the given class (if C<$attachable> is a
167	class in a static method call).
168
169	You can attach to global events by using the C<cf::global> class.
170
171	These method calls expect any number of the following handler/hook	827	These calls expect any number of the following handler/hook descriptions:
172	descriptions:
173		828
174	=over 4	829	=over 4
175		830
176	=item prio => $number	831	=item prio => $number
177		832
…		…
203	package and register them. Only handlers for eevents supported by the	858	package and register them. Only handlers for eevents supported by the
204	object/class are recognised.	859	object/class are recognised.
205		860
206	=back	861	=back
207		862
		863	Example, define an attachment called "sockpuppet" that calls the given
		864	event handler when a monster attacks:
		865
		866	cf::object::attachment sockpuppet =>
		867	on_skill_attack => sub {
		868	my ($self, $victim) = @_;
		869	...
		870	}
		871	}
		872
		873	=item $attachable->valid
		874
		875	Just because you have a perl object does not mean that the corresponding
		876	C-level object still exists. If you try to access an object that has no
		877	valid C counterpart anymore you get an exception at runtime. This method
		878	can be used to test for existence of the C object part without causing an
		879	exception.
		880
208	=cut	881	=cut
209		882
210	# the following variables are defined in .xs and must not be re-created	883	# the following variables are defined in .xs and must not be re-created
211	our @CB_GLOBAL = (); # registry for all global events	884	our @CB_GLOBAL = (); # registry for all global events
		885	our @CB_ATTACHABLE = (); # registry for all attachables
212	our @CB_OBJECT = (); # all objects (should not be used except in emergency)	886	our @CB_OBJECT = (); # all objects (should not be used except in emergency)
213	our @CB_PLAYER = ();	887	our @CB_PLAYER = ();
214	our @CB_CLIENT = ();	888	our @CB_CLIENT = ();
215	our @CB_TYPE = (); # registry for type (cf-object class) based events	889	our @CB_TYPE = (); # registry for type (cf-object class) based events
216	our @CB_MAP = ();	890	our @CB_MAP = ();
217		891
218	my %attachment;	892	my %attachment;
		893
		894	sub cf::attachable::thawer_merge {
		895	# simply override everything except _meta
		896	local $_[0]{_meta};
		897	%{$_[0]} = %{$_[1]};
		898	}
219		899
220	sub _attach_cb($$$$) {	900	sub _attach_cb($$$$) {
221	my ($registry, $event, $prio, $cb) = @_;	901	my ($registry, $event, $prio, $cb) = @_;
222		902
223	use sort 'stable';	903	use sort 'stable';
…		…
226		906
227	@{$registry->[$event]} = sort	907	@{$registry->[$event]} = sort
228	{ $a->[0] cmp $b->[0] }	908	{ $a->[0] cmp $b->[0] }
229	@{$registry->[$event] || []}, $cb;	909	@{$registry->[$event] || []}, $cb;
230	}	910	}
		911
		912	# hack
		913	my %attachable_klass = map +($_ => 1), KLASS_OBJECT, KLASS_CLIENT, KLASS_PLAYER, KLASS_MAP;
231		914
232	# attach handles attaching event callbacks	915	# attach handles attaching event callbacks
233	# the only thing the caller has to do is pass the correct	916	# the only thing the caller has to do is pass the correct
234	# registry (== where the callback attaches to).	917	# registry (== where the callback attaches to).
235	sub _attach {	918	sub _attach {
…		…
237		920
238	my $object_type;	921	my $object_type;
239	my $prio = 0;	922	my $prio = 0;
240	my %cb_id = map +("on_" . lc $EVENT[$_][0], $_) , grep $EVENT[$_][1] == $klass, 0 .. $#EVENT;	923	my %cb_id = map +("on_" . lc $EVENT[$_][0], $_) , grep $EVENT[$_][1] == $klass, 0 .. $#EVENT;
241		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
242	while (@arg) {	930	while (@arg) {
243	my $type = shift @arg;	931	my $type = shift @arg;
244		932
245	if ($type eq "prio") {	933	if ($type eq "prio") {
246	$prio = shift @arg;	934	$prio = shift @arg;
…		…
250	$registry = $CB_TYPE[$object_type] ||= [];	938	$registry = $CB_TYPE[$object_type] ||= [];
251		939
252	} elsif ($type eq "subtype") {	940	} elsif ($type eq "subtype") {
253	defined $object_type or Carp::croak "subtype specified without type";	941	defined $object_type or Carp::croak "subtype specified without type";
254	my $object_subtype = shift @arg;	942	my $object_subtype = shift @arg;
255	$registry = $CB_TYPE[$object_type + $object_subtype * NUM_SUBTYPES] ||= [];	943	$registry = $CB_TYPE[$object_type + $object_subtype * NUM_TYPES] ||= [];
256		944
257	} elsif ($type eq "package") {	945	} elsif ($type eq "package") {
258	my $pkg = shift @arg;	946	my $pkg = shift @arg;
259		947
260	while (my ($name, $id) = each %cb_id) {	948	while (my ($name, $id) = each %cb_id) {
…		…
289	_attach $registry, $klass, @attach;	977	_attach $registry, $klass, @attach;
290	}	978	}
291		979
292	$obj->{$name} = \%arg;	980	$obj->{$name} = \%arg;
293	} else {	981	} else {
294	warn "object uses attachment '$name' that is not available, postponing.\n";	982	warn "object uses attachment '$name' which is not available, postponing.\n";
295	}	983	}
296		984
297	$obj->{_attachment}{$name} = undef;	985	$obj->{_attachment}{$name} = undef;
298	}	986	}
299		987
…		…
301	if (ref $_[0]) {	989	if (ref $_[0]) {
302	_object_attach @_;	990	_object_attach @_;
303	} else {	991	} else {
304	_attach shift->_attach_registry, @_;	992	_attach shift->_attach_registry, @_;
305	}	993	}
		994	_recalc_want;
306	};	995	};
307		996
308	# all those should be optimised	997	# all those should be optimised
309	sub cf::attachable::detach {	998	sub cf::attachable::detach {
310	my ($obj, $name) = @_;	999	my ($obj, $name) = @_;
…		…
313	delete $obj->{_attachment}{$name};	1002	delete $obj->{_attachment}{$name};
314	reattach ($obj);	1003	reattach ($obj);
315	} else {	1004	} else {
316	Carp::croak "cannot, currently, detach class attachments";	1005	Carp::croak "cannot, currently, detach class attachments";
317	}	1006	}
		1007	_recalc_want;
318	};	1008	};
319		1009
320	sub cf::attachable::attached {	1010	sub cf::attachable::attached {
321	my ($obj, $name) = @_;	1011	my ($obj, $name) = @_;
322		1012
323	exists $obj->{_attachment}{$name}	1013	exists $obj->{_attachment}{$name}
324	}	1014	}
325		1015
326	for my $klass (qw(GLOBAL OBJECT PLAYER CLIENT MAP)) {	1016	for my $klass (qw(ATTACHABLE GLOBAL OBJECT PLAYER CLIENT MAP)) {
327	eval "#line " . __LINE__ . " 'cf.pm'	1017	eval "#line " . __LINE__ . " 'cf.pm'
328	sub cf::\L$klass\E::_attach_registry {	1018	sub cf::\L$klass\E::_attach_registry {
329	(\\\@CB_$klass, KLASS_$klass)	1019	(\\\@CB_$klass, KLASS_$klass)
330	}	1020	}
331		1021
…		…
337	";	1027	";
338	die if $@;	1028	die if $@;
339	}	1029	}
340		1030
341	our $override;	1031	our $override;
342	our @invoke_results = (); # referenced from .xs code. TODO: play tricks with reify and mortals?	1032	our @INVOKE_RESULTS = (); # referenced from .xs code. TODO: play tricks with reify and mortals?
343		1033
344	sub override {	1034	sub override {
345	$override = 1;	1035	$override = 1;
346	@invoke_results = ();	1036	@INVOKE_RESULTS = (@_);
347	}	1037	}
348		1038
349	sub do_invoke {	1039	sub do_invoke {
350	my $event = shift;	1040	my $event = shift;
351	my $callbacks = shift;	1041	my $callbacks = shift;
352		1042
353	@invoke_results = ();	1043	@INVOKE_RESULTS = ();
354		1044
355	local $override;	1045	local $override;
356		1046
357	for (@$callbacks) {	1047	for (@$callbacks) {
358	eval { &{$_->[1]} };	1048	eval { &{$_->[1]} };
…		…
367	}	1057	}
368		1058
369	0	1059	0
370	}	1060	}
371		1061
372	=item $bool = cf::invoke EVENT_GLOBAL_XXX, ...	1062	=item $bool = cf::global->invoke (EVENT_CLASS_XXX, ...)
373		1063
374	=item $bool = $object->invoke (EVENT_OBJECT_XXX, ...)
375
376	=item $bool = $player->invoke (EVENT_PLAYER_XXX, ...)
377
378	=item $bool = $client->invoke (EVENT_CLIENT_XXX, ...)	1064	=item $bool = $attachable->invoke (EVENT_CLASS_XXX, ...)
379		1065
380	=item $bool = $map->invoke (EVENT_MAP_XXX, ...)
381
382	Generate a global/object/player/map-specific event with the given arguments.	1066	Generate an object-specific event with the given arguments.
383		1067
384	This API is preliminary (most likely, the EVENT_KLASS_xxx prefix will be	1068	This API is preliminary (most likely, the EVENT_CLASS_xxx prefix will be
385	removed in future versions), and there is no public API to access override	1069	removed in future versions), and there is no public API to access override
386	results (if you must, access C<@cf::invoke_results> directly).	1070	results (if you must, access C<@cf::INVOKE_RESULTS> directly).
387
388	=back
389
390	=cut
391
392	#############################################################################
393
394	=head2 METHODS VALID FOR ALL ATTACHABLE OBJECTS
395
396	Attachable objects includes objects, players, clients and maps.
397
398	=over 4
399
400	=item $object->valid
401
402	Just because you have a perl object does not mean that the corresponding
403	C-level object still exists. If you try to access an object that has no
404	valid C counterpart anymore you get an exception at runtime. This method
405	can be used to test for existence of the C object part without causing an
406	exception.
407		1071
408	=back	1072	=back
409		1073
410	=cut	1074	=cut
411		1075
412	#############################################################################	1076	#############################################################################
413	# object support	1077	# object support
414		1078
415	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 {
416	my ($obj, $data) = @_;	1113	my ($ob1, $ob2) = @_;
417		1114
418	$data = from_json $data;	1115	++$SLOW_MERGES;#d#
419		1116
420	for (@$data) {	1117	# we do the slow way here
421	my ($name, $args) = @$_;	1118	return _object_equal $ob1, $ob2
422
423	$obj->attach ($name, %{$args || {} });
424	}
425	}	1119	}
426		1120
427	# basically do the same as instantiate, without calling instantiate
428	sub reattach {	1121	sub reattach {
		1122	# basically do the same as instantiate, without calling instantiate
429	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
430	my $registry = $obj->registry;	1128	my $registry = $obj->registry;
431		1129
432	@$registry = ();	1130	@$registry = ();
433		1131
434	delete $obj->{_attachment} unless scalar keys %{ $obj->{_attachment} || {} };	1132	delete $obj->{_attachment} unless scalar keys %{ $obj->{_attachment} || {} };
…		…
443	warn "object uses attachment '$name' that is not available, postponing.\n";	1141	warn "object uses attachment '$name' that is not available, postponing.\n";
444	}	1142	}
445	}	1143	}
446	}	1144	}
447		1145
448	sub object_freezer_save {	1146	cf::attachable->attach (
449	my ($filename, $rdata, $objs) = @_;
450
451	if (length $$rdata) {
452	warn sprintf "saving %s (%d,%d)\n",
453	$filename, length $$rdata, scalar @$objs;
454
455	if (open my $fh, ">:raw", "$filename~") {
456	chmod SAVE_MODE, $fh;
457	syswrite $fh, $$rdata;
458	close $fh;
459
460	if (@$objs && open my $fh, ">:raw", "$filename.pst~") {
461	chmod SAVE_MODE, $fh;
462	syswrite $fh, Storable::nfreeze { version => 1, objs => $objs };
463	close $fh;
464	rename "$filename.pst~", "$filename.pst";
465	} else {
466	unlink "$filename.pst";
467	}
468
469	rename "$filename~", $filename;
470	} else {
471	warn "FATAL: $filename~: $!\n";
472	}
473	} else {
474	unlink $filename;
475	unlink "$filename.pst";
476	}
477	}
478
479	sub object_freezer_as_string {
480	my ($rdata, $objs) = @_;
481
482	use Data::Dumper;
483
484	$$rdata . Dumper $objs
485	}
486
487	sub object_thawer_load {
488	my ($filename) = @_;
489
490	local $/;
491
492	my $av;
493
494	#TODO: use sysread etc.
495	if (open my $data, "<:raw:perlio", $filename) {
496	$data = <$data>;
497	if (open my $pst, "<:raw:perlio", "$filename.pst") {
498	$av = eval { (Storable::thaw <$pst>)->{objs} };
499	}
500	return ($data, $av);
501	}
502
503	()
504	}
505
506	cf::object->attach (
507	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,
508	on_clone => sub {	1160	on_clone => sub {
509	my ($src, $dst) = @_;	1161	my ($src, $dst) = @_;
510		1162
511	@{$dst->registry} = @{$src->registry};	1163	@{$dst->registry} = @{$src->registry};
512		1164
…		…
515	%{$dst->{_attachment}} = %{$src->{_attachment}}	1167	%{$dst->{_attachment}} = %{$src->{_attachment}}
516	if exists $src->{_attachment};	1168	if exists $src->{_attachment};
517	},	1169	},
518	);	1170	);
519		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
		1256
520	#############################################################################	1257	#############################################################################
521	# command handling &c	1258	# command handling &c
522		1259
523	=item cf::register_command $name => \&callback($ob,$args);	1260	=item cf::register_command $name => \&callback($ob,$args);
524		1261
…		…
536	push @{ $COMMAND{$name} }, [$caller, $cb];	1273	push @{ $COMMAND{$name} }, [$caller, $cb];
537	}	1274	}
538		1275
539	=item cf::register_extcmd $name => \&callback($pl,$packet);	1276	=item cf::register_extcmd $name => \&callback($pl,$packet);
540		1277
541	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.
542		1283
543	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
544	called.	1285	called.
545		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
546	=cut	1298	=cut
547		1299
548	sub register_extcmd {	1300	sub register_extcmd {
549	my ($name, $cb) = @_;	1301	my ($name, $cb) = @_;
550		1302
551	my $caller = caller;
552	#warn "registering extcmd '$name' to '$caller'";
553
554	$EXTCMD{$name} = [$cb, $caller];	1303	$EXTCMD{$name} = $cb;
555	}	1304	}
		1305
		1306	sub register_exticmd {
		1307	my ($name, $cb) = @_;
		1308
		1309	$EXTICMD{$name} = $cb;
		1310	}
		1311
		1312	use File::Glob ();
556		1313
557	cf::player->attach (	1314	cf::player->attach (
558	on_command => sub {	1315	on_unknown_command => sub {
559	my ($pl, $name, $params) = @_;	1316	my ($pl, $name, $params) = @_;
560		1317
561	my $cb = $COMMAND{$name}	1318	my $cb = $COMMAND{$name}
562	or return;	1319	or return;
563		1320
…		…
568	cf::override;	1325	cf::override;
569	},	1326	},
570	on_extcmd => sub {	1327	on_extcmd => sub {
571	my ($pl, $buf) = @_;	1328	my ($pl, $buf) = @_;
572		1329
573	my $msg = eval { from_json $buf };	1330	my $msg = eval { $pl->ns->{json_coder}->decode ($buf) };
574		1331
575	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
576	if (my $cb = $EXTCMD{$msg->{msgtype}}) {	1340	if (my $cb = $EXTCMD{$type}) {
577	if (my %reply = $cb->[0]->($pl, $msg)) {	1341	@reply = $cb->($pl, @payload);
578	$pl->ext_reply ($msg->{msgid}, %reply);
579	}
580	}	1342	}
		1343
		1344	$pl->ext_reply ($reply, @reply)
		1345	if $reply;
		1346
581	} else {	1347	} else {
582	warn "player " . ($pl->ob->name) . " sent unparseable ext message: <$buf>\n";	1348	warn "player " . ($pl->ob->name) . " sent unparseable ext message: <$buf>\n";
583	}	1349	}
584		1350
585	cf::override;	1351	cf::override;
586	},	1352	},
587	);	1353	);
588		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;
		1434	}
		1435	}
		1436
		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	}
		1444	}
		1445	}
		1446	};
		1447	}
		1448
		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	}
		1535	}
		1536	}
		1537
		1538	sub save($) {
		1539	my ($pl) = @_;
		1540
		1541	return if $pl->{deny_save};
		1542
		1543	my $path = path $pl;
		1544	my $guard = cf::lock_acquire "user_save:$path";
		1545
		1546	return if $pl->{deny_save};
		1547
		1548	aio_mkdir playerdir $pl, 0770;
		1549	$pl->{last_save} = $cf::RUNTIME;
		1550
		1551	cf::get_slot 0.01;
		1552
		1553	$pl->save_pl ($path);
		1554	cf::cede_to_tick;
		1555	}
		1556
		1557	sub new($) {
		1558	my ($login) = @_;
		1559
		1560	my $self = create;
		1561
		1562	$self->ob->name ($login);
		1563	$self->{deny_save} = 1;
		1564
		1565	$cf::PLAYER{$login} = $self;
		1566
		1567	$self
		1568	}
		1569
		1570	=item $player->send_msg ($channel, $msg, $color, [extra...])
		1571
		1572	=cut
		1573
		1574	sub send_msg {
		1575	my $ns = shift->ns
		1576	or return;
		1577	$ns->send_msg (@_);
		1578	}
		1579
		1580	=item $pl->quit_character
		1581
		1582	Nukes the player without looking back. If logged in, the connection will
		1583	be destroyed. May block for a long time.
		1584
		1585	=cut
		1586
		1587	sub quit_character {
		1588	my ($pl) = @_;
		1589
		1590	my $name = $pl->ob->name;
		1591
		1592	$pl->{deny_save} = 1;
		1593	$pl->password ("*"); # this should lock out the player until we have nuked the dir
		1594
		1595	$pl->invoke (cf::EVENT_PLAYER_LOGOUT, 1) if $pl->active;
		1596	$pl->deactivate;
		1597	my $killer = cf::arch::get "killer_quit"; $pl->killer ($killer); $killer->destroy;
		1598	$pl->ob->check_score;
		1599	$pl->invoke (cf::EVENT_PLAYER_QUIT);
		1600	$pl->ns->destroy if $pl->ns;
		1601
		1602	my $path = playerdir $pl;
		1603	my $temp = "$path~$cf::RUNTIME~deleting~";
		1604	aio_rename $path, $temp;
		1605	delete $cf::PLAYER{$pl->ob->name};
		1606	$pl->destroy;
		1607
		1608	my $prefix = qr<^~\Q$name\E/>;
		1609
		1610	# nuke player maps
		1611	$cf::MAP{$_}->nuke for grep /$prefix/, keys %cf::MAP;
		1612
		1613	IO::AIO::aio_rmtree $temp;
		1614	}
		1615
		1616	=item $pl->kick
		1617
		1618	Kicks a player out of the game. This destroys the connection.
		1619
		1620	=cut
		1621
		1622	sub kick {
		1623	my ($pl, $kicker) = @_;
		1624
		1625	$pl->invoke (cf::EVENT_PLAYER_KICK, $kicker);
		1626	$pl->killer ("kicked");
		1627	$pl->ns->destroy;
		1628	}
		1629
		1630	=item cf::player::list_logins
		1631
		1632	Returns am arrayref of all valid playernames in the system, can take a
		1633	while and may block, so not sync_job-capable, ever.
		1634
		1635	=cut
		1636
		1637	sub list_logins {
		1638	my $dirs = aio_readdir $PLAYERDIR
		1639	or return [];
		1640
		1641	my @logins;
		1642
		1643	for my $login (@$dirs) {
		1644	my $path = path $login;
		1645
		1646	# a .pst is a dead give-away for a valid player
		1647	# if no pst file found, open and chekc for blocked users
		1648	if (aio_stat "$path.pst") {
		1649	my $fh = aio_open $path, Fcntl::O_RDONLY, 0 or next;
		1650	aio_read $fh, 0, 512, my $buf, 0 or next;
		1651	$buf !~ /^password -------------$/m or next; # official not-valid tag
		1652	}
		1653
		1654	utf8::decode $login;
		1655	push @logins, $login;
		1656	}
		1657
		1658	\@logins
		1659	}
		1660
		1661	=item $player->maps
		1662
		1663	Returns an arrayref of map paths that are private for this
		1664	player. May block.
		1665
		1666	=cut
		1667
		1668	sub maps($) {
		1669	my ($pl) = @_;
		1670
		1671	$pl = ref $pl ? $pl->ob->name : $pl;
		1672
		1673	my $files = aio_readdir playerdir $pl
		1674	or return;
		1675
		1676	my @paths;
		1677
		1678	for (@$files) {
		1679	utf8::decode $_;
		1680	next if /\.(?:pl|pst)$/;
		1681	next unless /^$PATH_SEP/o;
		1682
		1683	push @paths, cf::map::normalise "~$pl/$_";
		1684	}
		1685
		1686	\@paths
		1687	}
		1688
		1689	=item $protocol_xml = $player->expand_cfpod ($cfpod)
		1690
		1691	Expand deliantra pod fragments into protocol xml.
		1692
		1693	=item $player->ext_reply ($msgid, @msg)
		1694
		1695	Sends an ext reply to the player.
		1696
		1697	=cut
		1698
		1699	sub ext_reply($$@) {
		1700	my ($self, $id, @msg) = @_;
		1701
		1702	$self->ns->ext_reply ($id, @msg)
		1703	}
		1704
		1705	=item $player->ext_msg ($type, @msg)
		1706
		1707	Sends an ext event to the client.
		1708
		1709	=cut
		1710
		1711	sub ext_msg($$@) {
		1712	my ($self, $type, @msg) = @_;
		1713
		1714	$self->ns->ext_msg ($type, @msg);
		1715	}
		1716
		1717	=head3 cf::region
		1718
		1719	=over 4
		1720
		1721	=cut
		1722
		1723	package cf::region;
		1724
		1725	=item cf::region::find_by_path $path
		1726
		1727	Tries to decuce the likely region for a map knowing only its path.
		1728
		1729	=cut
		1730
		1731	sub find_by_path($) {
		1732	my ($path) = @_;
		1733
		1734	my ($match, $specificity);
		1735
		1736	for my $region (list) {
		1737	if ($region->{match} && $path =~ $region->{match}) {
		1738	($match, $specificity) = ($region, $region->specificity)
		1739	if $region->specificity > $specificity;
		1740	}
		1741	}
		1742
		1743	$match
		1744	}
		1745
		1746	=back
		1747
		1748	=head3 cf::map
		1749
		1750	=over 4
		1751
		1752	=cut
		1753
		1754	package cf::map;
		1755
		1756	use Fcntl;
		1757	use Coro::AIO;
		1758
		1759	use overload
		1760	'""' => \&as_string,
		1761	fallback => 1;
		1762
		1763	our $MAX_RESET = 3600;
		1764	our $DEFAULT_RESET = 3000;
		1765
		1766	sub generate_random_map {
		1767	my ($self, $rmp) = @_;
		1768
		1769	my $lock = cf::lock_acquire "generate_random_map"; # the random map generator is NOT reentrant ATM
		1770
		1771	# mit "rum" bekleckern, nicht
		1772	$self->_create_random_map (
		1773	$rmp->{wallstyle}, $rmp->{wall_name}, $rmp->{floorstyle}, $rmp->{monsterstyle},
		1774	$rmp->{treasurestyle}, $rmp->{layoutstyle}, $rmp->{doorstyle}, $rmp->{decorstyle}, $rmp->{miningstyle},
		1775	$rmp->{origin_map}, $rmp->{final_map}, $rmp->{exitstyle}, $rmp->{this_map},
		1776	$rmp->{exit_on_final_map},
		1777	$rmp->{xsize}, $rmp->{ysize},
		1778	$rmp->{expand2x}, $rmp->{layoutoptions1}, $rmp->{layoutoptions2}, $rmp->{layoutoptions3},
		1779	$rmp->{symmetry}, $rmp->{difficulty}, $rmp->{difficulty_given}, $rmp->{difficulty_increase},
		1780	$rmp->{dungeon_level}, $rmp->{dungeon_depth}, $rmp->{decoroptions}, $rmp->{orientation},
		1781	$rmp->{origin_y}, $rmp->{origin_x}, $rmp->{random_seed}, $rmp->{total_map_hp},
		1782	$rmp->{map_layout_style}, $rmp->{treasureoptions}, $rmp->{symmetry_used},
		1783	(cf::region::find $rmp->{region}), $rmp->{custom}
		1784	)
		1785	}
		1786
		1787	=item cf::map->register ($regex, $prio)
		1788
		1789	Register a handler for the map path matching the given regex at the
		1790	givne priority (higher is better, built-in handlers have priority 0, the
		1791	default).
		1792
		1793	=cut
		1794
589	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 {
590	my ($base, $pkg) = @_;	1809	my ($self, $merge) = @_;
591		1810
592	#TODO	1811	# we have to keep some variables in memory intact
593	}	1812	local $self->{path};
		1813	local $self->{load_path};
594		1814
595	sub load_extension {	1815	$self->SUPER::thawer_merge ($merge);
		1816	}
		1817
		1818	sub normalise {
596	my ($path) = @_;	1819	my ($path, $base) = @_;
597		1820
598	$path =~ /([^\/\\]+)\.ext$/ or die "$path";	1821	$path = "$path"; # make sure its a string
599	my $base = $1;
600	my $pkg = $1;
601	$pkg =~ s/[^[:word:]]/_/g;
602	$pkg = "ext::$pkg";
603		1822
604	warn "loading '$path' into '$pkg'\n";	1823	$path =~ s/\.map$//;
605		1824
606	open my $fh, "<:utf8", $path	1825	# map plan:
607	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
608		1833
609	my $source =	1834	$path =~ s/$PATH_SEP/\//go;
610	"package $pkg; use strict; use utf8;\n"
611	. "#line 1 \"$path\"\n{\n"
612	. (do { local $/; <$fh> })
613	. "\n};\n1";
614		1835
615	eval $source	1836	# treat it as relative path if it starts with
616	or die $@ ? "$path: $@\n"	1837	# something that looks reasonable
617	: "extension disabled.\n";	1838	if ($path =~ m{^(?:\./|\.\./|\w)}) {
		1839	$base or Carp::carp "normalise called with relative path and no base: '$path'";
618		1840
619	push @exts, $pkg;	1841	$base =~ s{[^/]+/?$}{};
620	$ext_pkg{$base} = $pkg;	1842	$path = "$base/$path";
621
622	# no strict 'refs';
623	# @{"$pkg\::ISA"} = ext::;
624
625	register $base, $pkg;
626	}
627
628	sub unload_extension {
629	my ($pkg) = @_;
630
631	warn "removing extension $pkg\n";
632
633	# remove hooks
634	#TODO
635	# for my $idx (0 .. $#PLUGIN_EVENT) {
636	# delete $hook[$idx]{$pkg};
637	# }	1843	}
638		1844
639	# remove commands	1845	for ($path) {
640	for my $name (keys %COMMAND) {	1846	redo if s{//}{/};
641	my @cb = grep $_->[0] ne $pkg, @{ $COMMAND{$name} };	1847	redo if s{/\.?/}{/};
		1848	redo if s{/[^/]+/\.\./}{/};
		1849	}
642		1850
643	if (@cb) {	1851	$path
644	$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;
645	} else {	1984	} else {
646	delete $COMMAND{$name};	1985	$self->load_header_orig
647	}	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
648	}	1996	1
		1997	}
649		1998
650	# remove extcmds	1999	sub find;
651	for my $name (grep $EXTCMD{$_}[1] eq $pkg, keys %EXTCMD) {	2000	sub find {
652	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
653	}	2040	{
		2041	my $guard = cf::lock_acquire "map_data:$path";
654		2042
655	if (my $cb = $pkg->can ("unload")) {	2043	return unless $self->valid;
656	eval {	2044	return unless $self->in_memory == cf::MAP_SWAPPED;
657	$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	}
658	1	2069	}
659	} or warn "$pkg unloaded, but with errors: $@";	2070	}
660	}
661		2071
662	Symbol::delete_package $pkg;	2072	$f->resolve_delayed_derefs;
663	}
664		2073
665	sub load_extensions {	2074	cf::cede_to_tick;
666	for my $ext (<$LIBDIR/*.ext>) {	2075	# now do the right thing for maps
667	next unless -r $ext;	2076	$self->link_multipart_objects;
668	eval {	2077	$self->difficulty ($self->estimate_difficulty)
669	load_extension $ext;	2078	unless $self->difficulty;
670	1	2079	cf::cede_to_tick;
671	} or warn "$ext not loaded: $@";
672	}
673	}
674		2080
675	#############################################################################	2081	unless ($self->{deny_activate}) {
676	# 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	}
677		2088
678	*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 {
679	my ($map) = @_;	2115	my ($map) = @_;
680		2116
681	my $path = $map->tmpname;	2117	my @neigh; # diagonal neighbours
682	defined $path or return;
683		2118
684	unlink "$path.pst";	2119	for (0 .. 3) {
685	};	2120	my $neigh = $map->tile_path ($_)
		2121	or next;
		2122	$neigh = find $neigh, $map
		2123	or next;
		2124	$neigh->load;
686		2125
687	cf::map->attach (prio => -10000, package => cf::mapsupport::);	2126	push @neigh,
		2127	[$neigh->tile_path (($_ + 3) % 4), $neigh],
		2128	[$neigh->tile_path (($_ + 1) % 4), $neigh];
		2129	}
688		2130
689	#############################################################################	2131	for (grep defined $_->[0], @neigh) {
690	# load/save perl data associated with player->ob objects	2132	my ($path, $origin) = @$_;
691		2133	my $neigh = find $path, $origin
692	sub all_objects(@) {	2134	or next;
693	@_, map all_objects ($_->inv), @_	2135	$neigh->load;
		2136	}
694	}	2137	}
695		2138
696	# TODO: compatibility cruft, remove when no longer needed	2139	sub find_sync {
697	cf::player->attach (	2140	my ($path, $origin) = @_;
698	on_load => sub {
699	my ($pl, $path) = @_;
700		2141
701	for my $o (all_objects $pl->ob) {	2142	cf::sync_job { find $path, $origin }
702	if (my $value = $o->get_ob_key_value ("_perl_data")) {	2143	}
703	$o->set_ob_key_value ("_perl_data");
704		2144
705	%$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};
706	}	2178	}
707	}	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);
708	},	2217	}
709	);	2218	}
710		2219
711	#############################################################################	2220	sub swap_out {
		2221	my ($self) = @_;
712		2222
713	=head2 CORE EXTENSIONS	2223	# save first because save cedes
		2224	$self->save;
714		2225
715	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;
716		2404
717	=over 4	2405	=over 4
718		2406
719	=item cf::player::exists $login	2407	=item $ob->inv_recursive
720		2408
721	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.
722		2411
723	=cut	2412	=cut
724		2413
725	sub cf::player::exists($) {	2414	sub inv_recursive_;
726	cf::player::find $_[0]	2415	sub inv_recursive_ {
727	or -f sprintf "%s/%s/%s/%s.pl", cf::localdir, cf::playerdir, ($_[0]) x 2;	2416	map { $_, inv_recursive_ $_->inv } @_
728	}	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
729		2458
730	=item $player_object->reply ($npc, $msg[, $flags])	2459	=item $player_object->reply ($npc, $msg[, $flags])
731		2460
732	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>
733	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
734	dialogue with the given NPC character.	2463	dialogue with the given NPC character.
735		2464
736	=cut	2465	=cut
737		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
738	# rough implementation of a future "reply" method that works	2481	# rough implementation of a future "reply" method that works
739	# with dialog boxes.	2482	# with dialog boxes.
		2483	#TODO: the first argument must go, split into a $npc->reply_to ( method
740	sub cf::object::player::reply($$$;$) {	2484	sub cf::object::player::reply($$$;$) {
741	my ($self, $npc, $msg, $flags) = @_;	2485	my ($self, $npc, $msg, $flags) = @_;
742		2486
743	$flags = cf::NDI_BROWN | cf::NDI_UNIQUE unless @_ >= 4;	2487	$flags = cf::NDI_BROWN | cf::NDI_UNIQUE unless @_ >= 4;
744		2488
745	if ($self->{record_replies}) {	2489	if ($self->{record_replies}) {
746	push @{ $self->{record_replies} }, [$npc, $msg, $flags];	2490	push @{ $self->{record_replies} }, [$npc, $msg, $flags];
		2491
747	} 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 {
748	$msg = $npc->name . " says: $msg" if $npc;	2500	$msg = $npc->name . " says: $msg" if $npc;
749	$self->message ($msg, $flags);	2501	$self->send_msg ($SAY_CHANNEL => $msg, $flags);
		2502	}
750	}	2503	}
751	}	2504	}
752		2505
753	=item $player->ext_reply ($msgid, $msgtype, %msg)	2506	=item $object->send_msg ($channel, $msg, $color, [extra...])
754		2507
755	Sends an ext reply to the player.
756
757	=cut	2508	=cut
758		2509
759	sub cf::player::ext_reply($$$%) {	2510	sub cf::object::send_msg {
760	my ($self, $id, %msg) = @_;	2511	my $pl = shift->contr
761		2512	or return;
762	$msg{msgid} = $id;	2513	$pl->send_msg (@_);
763
764	$self->send ("ext " . to_json \%msg);
765	}	2514	}
766		2515
767	=item $player_object->may ("access")	2516	=item $player_object->may ("access")
768		2517
769	Returns wether the given player is authorized to access resource "access"	2518	Returns wether the given player is authorized to access resource "access"
…		…
778	(ref $cf::CFG{"may_$access"}	2527	(ref $cf::CFG{"may_$access"}
779	? scalar grep $self->name eq $_, @{$cf::CFG{"may_$access"}}	2528	? scalar grep $self->name eq $_, @{$cf::CFG{"may_$access"}}
780	: $cf::CFG{"may_$access"})	2529	: $cf::CFG{"may_$access"})
781	}	2530	}
782		2531
783	=cut	2532	=item $player_object->enter_link
784		2533
785	#############################################################################	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
786		3148
787	=head2 SAFE SCRIPTING	3149	=head2 SAFE SCRIPTING
788		3150
789	Functions that provide a safe environment to compile and execute	3151	Functions that provide a safe environment to compile and execute
790	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
…		…
797	our $safe = new Safe "safe";	3159	our $safe = new Safe "safe";
798	our $safe_hole = new Safe::Hole;	3160	our $safe_hole = new Safe::Hole;
799		3161
800	$SIG{FPE} = 'IGNORE';	3162	$SIG{FPE} = 'IGNORE';
801		3163
802	$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	));
803		3169
804	# here we export the classes and methods available to script code	3170	# here we export the classes and methods available to script code
805		3171
806	=pod	3172	=pod
807		3173
808	The following fucntions and emthods are available within a safe environment:	3174	The following functions and methods are available within a safe environment:
809		3175
810	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
811	cf::object::player player	3181	cf::object::player
812	cf::player peaceful	3182	player
813	cf::map trigger	3183
		3184	cf::player
		3185	peaceful
		3186
		3187	cf::map
		3188	trigger
814		3189
815	=cut	3190	=cut
816		3191
817	for (	3192	for (
818	["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)],
819	["cf::object::player" => qw(player)],	3196	["cf::object::player" => qw(player)],
820	["cf::player" => qw(peaceful)],	3197	["cf::player" => qw(peaceful send_msg)],
821	["cf::map" => qw(trigger)],	3198	["cf::map" => qw(trigger)],
822	) {	3199	) {
823	no strict 'refs';	3200	no strict 'refs';
824	my ($pkg, @funs) = @$_;	3201	my ($pkg, @funs) = @$_;
825	*{"safe::$pkg\::$_"} = $safe_hole->wrap (\&{"$pkg\::$_"})	3202	*{"safe::$pkg\::$_"} = $safe_hole->wrap (\&{"$pkg\::$_"})
…		…
843		3220
844	my $qcode = $code;	3221	my $qcode = $code;
845	$qcode =~ s/"/‟/g; # not allowed in #line filenames	3222	$qcode =~ s/"/‟/g; # not allowed in #line filenames
846	$qcode =~ s/\n/\\n/g;	3223	$qcode =~ s/\n/\\n/g;
847		3224
		3225	%vars = (_dummy => 0) unless %vars;
		3226
		3227	my @res;
848	local $_;	3228	local $_;
849	local @safe::cf::_safe_eval_args = values %vars;
850		3229
851	my $eval =	3230	my $eval =
852	"do {\n"	3231	"do {\n"
853	. "my (" . (join ",", map "\$$_", keys %vars) . ") = \@cf::_safe_eval_args;\n"	3232	. "my (" . (join ",", map "\$$_", keys %vars) . ") = \@cf::_safe_eval_args;\n"
854	. "#line 0 \"{$qcode}\"\n"	3233	. "#line 0 \"{$qcode}\"\n"
855	. $code	3234	. $code
856	. "\n}"	3235	. "\n}"
857	;	3236	;
858		3237
		3238	if ($CFG{safe_eval}) {
859	sub_generation_inc;	3239	sub_generation_inc;
		3240	local @safe::cf::_safe_eval_args = values %vars;
860	my @res = wantarray ? $safe->reval ($eval) : scalar $safe->reval ($eval);	3241	@res = wantarray ? $safe->reval ($eval) : scalar $safe->reval ($eval);
861	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	}
862		3247
863	if ($@) {	3248	if ($@) {
864	warn "$@";	3249	warn "$@";
865	warn "while executing safe code '$code'\n";	3250	warn "while executing safe code '$code'\n";
866	warn "with arguments " . (join " ", %vars) . "\n";	3251	warn "with arguments " . (join " ", %vars) . "\n";
…		…
885	=cut	3270	=cut
886		3271
887	sub register_script_function {	3272	sub register_script_function {
888	my ($fun, $cb) = @_;	3273	my ($fun, $cb) = @_;
889		3274
890	no strict 'refs';	3275	$fun = "safe::$fun" if $CFG{safe_eval};
891	*{"safe::$fun"} = $safe_hole->wrap ($cb);	3276	*$fun = $safe_hole->wrap ($cb);
892	}	3277	}
893		3278
894	=back	3279	=back
895		3280
896	=cut	3281	=cut
897		3282
898	#############################################################################	3283	#############################################################################
		3284	# the server's init and main functions
899		3285
900	=head2 EXTENSION DATABASE SUPPORT	3286	sub load_facedata($) {
		3287	my ($path) = @_;
901		3288
902	Crossfire maintains a very simple database for extension use. It can	3289	# HACK to clear player env face cache, we need some signal framework
903	currently store anything that can be serialised using Storable, which	3290	# for this (global event?)
904	excludes objects.	3291	%ext::player_env::MUSIC_FACE_CACHE = ();
905		3292
906	The parameter C<$family> should best start with the name of the extension	3293	my $enc = JSON::XS->new->utf8->canonical->relaxed;
907	using it, it should be unique.
908		3294
909	=over 4	3295	warn "loading facedata from $path\n";
910		3296
911	=item $hashref = cf::db_get $family	3297	my $facedata;
		3298	0 < aio_load $path, $facedata
		3299	or die "$path: $!";
912		3300
913	Return a hashref for use by the extension C<$family>, which can be	3301	$facedata = Coro::Storable::thaw $facedata;
914	modified. After modifications, you have to call C<cf::db_dirty> or
915	C<cf::db_sync>.
916		3302
917	=item $value = cf::db_get $family => $key	3303	$facedata->{version} == 2
		3304	or cf::cleanup "$path: version mismatch, cannot proceed.";
918		3305
919	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;
920		3314
921	=item cf::db_put $family => $hashref	3315	{
		3316	my $faces = $facedata->{faceinfo};
922		3317
923	Stores the given family hashref into the database. Updates are delayed, if	3318	while (my ($face, $info) = each %$faces) {
924	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;
925		3320
926	=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};
927		3325
928	Stores the given C<$value> in the family hash. Updates are delayed, if you	3326	cf::cede_to_tick;
929	want the data to be synced to disk immediately, use C<cf::db_sync>.	3327	}
930		3328
931	=item cf::db_dirty	3329	while (my ($face, $info) = each %$faces) {
		3330	next unless $info->{smooth};
932		3331
933	Marks the database as dirty, to be updated at a later time.	3332	my $idx = cf::face::find $face
		3333	or next;
934		3334
935	=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	}
936		3341
937	Immediately write the database to disk I<if it is dirty>.	3342	cf::cede_to_tick;
		3343	}
		3344	}
938		3345
939	=cut	3346	{
		3347	my $anims = $facedata->{animinfo};
940		3348
941	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	}
942		3966
943	{	3967	{
944	my $path = cf::localdir . "/database.pst";	3968	# configure BDB
945		3969
946	sub db_load() {	3970	BDB::min_parallel 16;
947	warn "loading database $path\n";#d# remove later	3971	BDB::max_poll_reqs $TICK * 0.1;
948	$DB = stat $path ? Storable::retrieve $path : { };	3972	$AnyEvent::BDB::WATCHER->priority (1);
949	}
950		3973
951	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);
952		3981
953	sub db_save() {	3982	cf::sync_job {
954	warn "saving database $path\n";#d# remove later
955	waitpid $pid, 0 if $pid;
956	if (0 == ($pid = fork)) {
957	$DB->{_meta}{version} = 1;
958	Storable::nstore $DB, "$path~";
959	rename "$path~", $path;
960	cf::_exit 0 if defined $pid;
961	}
962	}
963
964	my $dirty;
965
966	sub db_sync() {
967	db_save if $dirty;
968	undef $dirty;
969	}
970
971	my $idle = Event->idle (min => $TICK * 2.8, max => 10, repeat => 0, data => WF_AUTOCANCEL, cb => sub {
972	db_sync;
973	});
974
975	sub db_dirty() {
976	$dirty = 1;
977	$idle->start;
978	}
979
980	sub db_get($;$) {
981	@_ >= 2
982	? $DB->{$_[0]}{$_[1]}
983	: ($DB->{$_[0]} ||= { })
984	}
985
986	sub db_put($$;$) {
987	if (@_ >= 3) {
988	$DB->{$_[0]}{$_[1]} = $_[2];
989	} else {	3983	eval {
990	$DB->{$_[0]} = $_[1];	3984	BDB::db_env_open
991	}	3985	$DB_ENV,
992	db_dirty;	3986	$BDBDIR,
993	}	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;
994		3990
995	cf::global->attach (	3991	cf::cleanup "db_env_open($BDBDIR): $!" if $!;
996	prio => 10000,
997	on_cleanup => sub {
998	db_sync;
999	},
1000	);
1001	}
1002
1003	#############################################################################
1004	# the server's main()
1005
1006	sub cfg_load {
1007	open my $fh, "<:utf8", cf::confdir . "/config"
1008	or return;
1009
1010	local $/;
1011	*CFG = YAML::Syck::Load <$fh>;
1012	}
1013
1014	sub main {
1015	cfg_load;
1016	db_load;
1017	load_extensions;
1018	Event::loop;
1019	}
1020
1021	#############################################################################
1022	# initialisation
1023
1024	sub _perl_reload(&) {
1025	my ($msg) = @_;
1026
1027	$msg->("reloading...");
1028
1029	eval {
1030	# cancel all watchers
1031	for (Event::all_watchers) {
1032	$_->cancel if $_->data & WF_AUTOCANCEL;
1033	}
1034
1035	# unload all extensions
1036	for (@exts) {
1037	$msg->("unloading <$_>");
1038	unload_extension $_;
1039	}
1040
1041	# unload all modules loaded from $LIBDIR
1042	while (my ($k, $v) = each %INC) {
1043	next unless $v =~ /^\Q$LIBDIR\E\/.*\.pm$/;
1044
1045	$msg->("removing <$k>");
1046	delete $INC{$k};
1047
1048	$k =~ s/\.pm$//;
1049	$k =~ s/\//::/g;
1050
1051	if (my $cb = $k->can ("unload_module")) {
1052	$cb->();
1053	}	3992	};
1054		3993
1055	Symbol::delete_package $k;	3994	cf::cleanup "db_env_open(db): $@" if $@;
1056	}	3995	};
		3996	}
1057		3997
1058	# sync database to disk	3998	$BDB_DEADLOCK_WATCHER = EV::periodic 0, 3, 0, sub {
1059	cf::db_sync;	3999	BDB::db_env_lock_detect $DB_ENV, 0, BDB::LOCK_DEFAULT, 0, sub { };
1060
1061	# get rid of safe::, as good as possible
1062	Symbol::delete_package "safe::$_"
1063	for qw(cf::object cf::object::player cf::player cf::map cf::party cf::region);
1064
1065	# remove register_script_function callbacks
1066	# TODO
1067
1068	# unload cf.pm "a bit"
1069	delete $INC{"cf.pm"};
1070
1071	# don't, removes xs symbols, too,
1072	# and global variables created in xs
1073	#Symbol::delete_package __PACKAGE__;
1074
1075	# reload cf.pm
1076	$msg->("reloading cf.pm");
1077	require cf;
1078
1079	# load config and database again
1080	cf::cfg_load;
1081	cf::db_load;
1082
1083	# load extensions
1084	$msg->("load extensions");
1085	cf::load_extensions;
1086
1087	# reattach attachments to objects
1088	$msg->("reattach");
1089	_global_reattach;
1090	};	4000	};
1091	$msg->($@) if $@;	4001	$BDB_CHECKPOINT_WATCHER = EV::periodic 0, 60, 0, sub {
1092		4002	BDB::db_env_txn_checkpoint $DB_ENV, 0, 0, 0, sub { };
1093	$msg->("reloaded");
1094	};
1095
1096	sub perl_reload() {
1097	_perl_reload {
1098	warn $_[0];
1099	print "$_[0]\n";
1100	};	4003	};
		4004	$BDB_TRICKLE_WATCHER = EV::periodic 0, 10, 0, sub {
		4005	BDB::db_env_memp_trickle $DB_ENV, 20, 0, sub { };
		4006	};
1101	}	4007	}
1102		4008
1103	register "<global>", __PACKAGE__;	4009	{
		4010	# configure IO::AIO
1104		4011
1105	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 {
1106	my ($who, $arg) = @_;	4020	my ($msg, @addr) = @_;
1107		4021
1108	if ($who->flag (FLAG_WIZ)) {	4022	$msg =~ s/\n//;
1109	_perl_reload {	4023
1110	warn $_[0];	4024	# limit the # of concurrent backtraces
1111	$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;
1112	};	4052	};
1113	}	4053	} else {
1114	};	4054	LOG llevInfo, "[ABT] $msg\n";
1115		4055	LOG llevInfo, "[ABT] [suppressed]\n";
1116	unshift @INC, $LIBDIR;
1117
1118	$TICK_WATCHER = Event->timer (
1119	prio => 0,
1120	at => $NEXT_TICK || 1,
1121	data => WF_AUTOCANCEL,
1122	cb => sub {
1123	cf::server_tick; # one server iteration
1124
1125	my $NOW = Event::time;
1126	$NEXT_TICK += $TICK;
1127
1128	# if we are delayed by four ticks or more, skip them all
1129	$NEXT_TICK = $NOW if $NOW >= $NEXT_TICK + $TICK * 4;
1130
1131	$TICK_WATCHER->at ($NEXT_TICK);
1132	$TICK_WATCHER->start;
1133	},	4056	}
1134	);	4057	}
1135		4058
1136	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;
1137		4062
1138	Event->io (fd => IO::AIO::poll_fileno,	4063	END { cf::emergency_save }
1139	poll => 'r',
1140	prio => 5,
1141	data => WF_AUTOCANCEL,
1142	cb => \&IO::AIO::poll_cb);
1143		4064
1144	1	4065	1
1145		4066

Diff Legend

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