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

Diff Legend

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