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.94 by root, Thu Dec 21 23:02:54 2006 UTC vs.
Revision 1.408 by root, Mon Jan 14 10:12:12 2008 UTC

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

Diff Legend

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