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.85 by root, Mon Dec 11 22:56:57 2006 UTC vs.
Revision 1.158 by root, Wed Jan 10 19:52:43 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;
5	use Storable;	8	use Storable;
6	use Opcode;	9	use Opcode;
7	use Safe;	10	use Safe;
8	use Safe::Hole;	11	use Safe::Hole;
9		12
		13	use Coro 3.3 ();
		14	use Coro::Event;
		15	use Coro::Timer;
		16	use Coro::Signal;
		17	use Coro::Semaphore;
		18	use Coro::AIO;
		19
		20	use Data::Dumper;
		21	use Digest::MD5;
		22	use Fcntl;
10	use IO::AIO ();	23	use IO::AIO 2.32 ();
11	use YAML::Syck ();	24	use YAML::Syck ();
12	use Time::HiRes;	25	use Time::HiRes;
13	use Event;	26
14	$Event::Eval = 1; # no idea why this is required, but it is	27	use Event; $Event::Eval = 1; # no idea why this is required, but it is
		28
		29	sub WF_AUTOCANCEL () { 1 } # automatically cancel this watcher on reload
15		30
16	# work around bug in YAML::Syck - bad news for perl6, will it be as broken wrt. unicode?	31	# work around bug in YAML::Syck - bad news for perl6, will it be as broken wrt. unicode?
17	$YAML::Syck::ImplicitUnicode = 1;	32	$YAML::Syck::ImplicitUnicode = 1;
18		33
19	use strict;	34	$Coro::main->prio (Coro::PRIO_MAX); # run main coroutine ("the server") with very high priority
20		35
21	our %COMMAND = ();	36	our %COMMAND = ();
22	our %COMMAND_TIME = ();	37	our %COMMAND_TIME = ();
23	our %EXTCMD = ();	38	our %EXTCMD = ();
24		39
25	_init_vars;
26
27	our @EVENT;	40	our @EVENT;
28	our $LIBDIR = maps_directory "perl";	41	our $LIBDIR = datadir . "/ext";
29		42
30	our $TICK = MAX_TIME * 1e-6;	43	our $TICK = MAX_TIME * 1e-6;
31	our $TICK_WATCHER;	44	our $TICK_WATCHER;
32	our $NEXT_TICK;	45	our $NEXT_TICK;
		46	our $NOW;
33		47
34	our %CFG;	48	our %CFG;
35		49
36	our $UPTIME; $UPTIME ||= time;	50	our $UPTIME; $UPTIME ||= time;
		51	our $RUNTIME;
		52
		53	our %PLAYER; # all users
		54	our %MAP; # all maps
		55	our $LINK_MAP; # the special {link} map
		56	our $RANDOM_MAPS = cf::localdir . "/random";
		57	our %EXT_CORO; # coroutines bound to extensions
		58
		59	our $WAIT_FOR_TICK; $WAIT_FOR_TICK ||= new Coro::Signal;
		60	our $WAIT_FOR_TICK_ONE; $WAIT_FOR_TICK_ONE ||= new Coro::Signal;
		61
		62	binmode STDOUT;
		63	binmode STDERR;
		64
		65	# read virtual server time, if available
		66	unless ($RUNTIME || !-e cf::localdir . "/runtime") {
		67	open my $fh, "<", cf::localdir . "/runtime"
		68	or die "unable to read runtime file: $!";
		69	$RUNTIME = <$fh> + 0.;
		70	}
		71
		72	mkdir cf::localdir;
		73	mkdir cf::localdir . "/" . cf::playerdir;
		74	mkdir cf::localdir . "/" . cf::tmpdir;
		75	mkdir cf::localdir . "/" . cf::uniquedir;
		76	mkdir $RANDOM_MAPS;
		77
		78	# a special map that is always available
		79	our $LINK_MAP;
		80	our $EMERGENCY_POSITION;
37		81
38	#############################################################################	82	#############################################################################
39		83
40	=head2 GLOBAL VARIABLES	84	=head2 GLOBAL VARIABLES
41		85
42	=over 4	86	=over 4
43		87
44	=item $cf::UPTIME	88	=item $cf::UPTIME
45		89
46	The timestamp of the server start (so not actually an uptime).	90	The timestamp of the server start (so not actually an uptime).
		91
		92	=item $cf::RUNTIME
		93
		94	The time this server has run, starts at 0 and is increased by $cf::TICK on
		95	every server tick.
47		96
48	=item $cf::LIBDIR	97	=item $cf::LIBDIR
49		98
50	The perl library directory, where extensions and cf-specific modules can	99	The perl library directory, where extensions and cf-specific modules can
51	be found. It will be added to C<@INC> automatically.	100	be found. It will be added to C<@INC> automatically.
52		101
		102	=item $cf::NOW
		103
		104	The time of the last (current) server tick.
		105
53	=item $cf::TICK	106	=item $cf::TICK
54		107
55	The interval between server ticks, in seconds.	108	The interval between server ticks, in seconds.
56		109
57	=item %cf::CFG	110	=item %cf::CFG
58		111
59	Configuration for the server, loaded from C</etc/crossfire/config>, or	112	Configuration for the server, loaded from C</etc/crossfire/config>, or
60	from wherever your confdir points to.	113	from wherever your confdir points to.
		114
		115	=item $cf::WAIT_FOR_TICK, $cf::WAIT_FOR_TICK_ONE
		116
		117	These are Coro::Signal objects that are C<< ->broadcast >> (WAIT_FOR_TICK)
		118	or C<< ->send >> (WAIT_FOR_TICK_ONE) on after normal server tick
		119	processing has been done. Call C<< ->wait >> on them to maximise the
		120	window of cpu time available, or simply to synchronise to the server tick.
61		121
62	=back	122	=back
63		123
64	=cut	124	=cut
65		125
66	BEGIN {	126	BEGIN {
67	*CORE::GLOBAL::warn = sub {	127	*CORE::GLOBAL::warn = sub {
68	my $msg = join "", @_;	128	my $msg = join "", @_;
		129	utf8::encode $msg;
		130
69	$msg .= "\n"	131	$msg .= "\n"
70	unless $msg =~ /\n$/;	132	unless $msg =~ /\n$/;
71		133
72	print STDERR "cfperl: $msg";
73	LOG llevError, "cfperl: $msg";	134	LOG llevError, $msg;
74	};	135	};
75	}	136	}
76		137
		138	@safe::cf::global::ISA = @cf::global::ISA = 'cf::attachable';
		139	@safe::cf::object::ISA = @cf::object::ISA = 'cf::attachable';
		140	@safe::cf::player::ISA = @cf::player::ISA = 'cf::attachable';
		141	@safe::cf::client::ISA = @cf::client::ISA = 'cf::attachable';
		142	@safe::cf::map::ISA = @cf::map::ISA = 'cf::attachable';
77	@safe::cf::object::player::ISA = @cf::object::player::ISA = 'cf::object';	143	@safe::cf::object::player::ISA = @cf::object::player::ISA = 'cf::object';
78		144
79	# we bless all objects into (empty) derived classes to force a method lookup	145	# we bless all objects into (empty) derived classes to force a method lookup
80	# within the Safe compartment.	146	# within the Safe compartment.
81	for my $pkg (qw(cf::object cf::object::player cf::player cf::map cf::party cf::region cf::arch cf::living)) {	147	for my $pkg (qw(
		148	cf::global cf::attachable
		149	cf::object cf::object::player
		150	cf::client cf::player
		151	cf::arch cf::living
		152	cf::map cf::party cf::region
		153	)) {
82	no strict 'refs';	154	no strict 'refs';
83	@{"safe::$pkg\::wrap::ISA"} = @{"$pkg\::wrap::ISA"} = $pkg;	155	@{"safe::$pkg\::wrap::ISA"} = @{"$pkg\::wrap::ISA"} = $pkg;
84	}	156	}
85		157
86	$Event::DIED = sub {	158	$Event::DIED = sub {
…		…
93		165
94	=head2 UTILITY FUNCTIONS	166	=head2 UTILITY FUNCTIONS
95		167
96	=over 4	168	=over 4
97		169
		170	=item dumpval $ref
		171
98	=cut	172	=cut
		173
		174	sub dumpval {
		175	eval {
		176	local $SIG{__DIE__};
		177	my $d;
		178	if (1) {
		179	$d = new Data::Dumper([$_[0]], ["*var"]);
		180	$d->Terse(1);
		181	$d->Indent(2);
		182	$d->Quotekeys(0);
		183	$d->Useqq(1);
		184	#$d->Bless(...);
		185	$d->Seen($_[1]) if @_ > 1;
		186	$d = $d->Dump();
		187	}
		188	$d =~ s/([\x00-\x07\x09\x0b\x0c\x0e-\x1f])/sprintf "\\x%02x", ord($1)/ge;
		189	$d
		190	} || "[unable to dump $_[0]: '$@']";
		191	}
99		192
100	use JSON::Syck (); # TODO# replace by JSON::PC once working	193	use JSON::Syck (); # TODO# replace by JSON::PC once working
101		194
102	=item $ref = cf::from_json $json	195	=item $ref = cf::from_json $json
103		196
…		…
119	sub to_json($) {	212	sub to_json($) {
120	$JSON::Syck::ImplicitUnicode = 0; # work around JSON::Syck bugs	213	$JSON::Syck::ImplicitUnicode = 0; # work around JSON::Syck bugs
121	JSON::Syck::Dump $_[0]	214	JSON::Syck::Dump $_[0]
122	}	215	}
123		216
		217	=item cf::lock_wait $string
		218
		219	Wait until the given lock is available. See cf::lock_acquire.
		220
		221	=item my $lock = cf::lock_acquire $string
		222
		223	Wait until the given lock is available and then acquires it and returns
		224	a Coro::guard object. If the guard object gets destroyed (goes out of scope,
		225	for example when the coroutine gets canceled), the lock is automatically
		226	returned.
		227
		228	Lock names should begin with a unique identifier (for example, cf::map::find
		229	uses map_find and cf::map::load uses map_load).
		230
		231	=cut
		232
		233	our %LOCK;
		234
		235	sub lock_wait($) {
		236	my ($key) = @_;
		237
		238	# wait for lock, if any
		239	while ($LOCK{$key}) {
		240	push @{ $LOCK{$key} }, $Coro::current;
		241	Coro::schedule;
		242	}
		243	}
		244
		245	sub lock_acquire($) {
		246	my ($key) = @_;
		247
		248	# wait, to be sure we are not locked
		249	lock_wait $key;
		250
		251	$LOCK{$key} = [];
		252
		253	Coro::guard {
		254	# wake up all waiters, to be on the safe side
		255	$_->ready for @{ delete $LOCK{$key} };
		256	}
		257	}
		258
		259	sub freeze_mainloop {
		260	return unless $TICK_WATCHER->is_active;
		261
		262	my $guard = Coro::guard { $TICK_WATCHER->start };
		263	$TICK_WATCHER->stop;
		264	$guard
		265	}
		266
		267	=item cf::async { BLOCK }
		268
		269	Currently the same as Coro::async_pool, meaning you cannot use
		270	C<on_destroy>, C<join> or other gimmicks on these coroutines. The only
		271	thing you are allowed to do is call C<prio> on it.
		272
		273	=cut
		274
		275	BEGIN { *async = \&Coro::async_pool }
		276
		277	=item cf::sync_job { BLOCK }
		278
		279	The design of crossfire+ requires that the main coro ($Coro::main) is
		280	always able to handle events or runnable, as crossfire+ is only partly
		281	reentrant. Thus "blocking" it by e.g. waiting for I/O is not acceptable.
		282
		283	If it must be done, put the blocking parts into C<sync_job>. This will run
		284	the given BLOCK in another coroutine while waiting for the result. The
		285	server will be frozen during this time, so the block should either finish
		286	fast or be very important.
		287
		288	=cut
		289
		290	sub sync_job(&) {
		291	my ($job) = @_;
		292
		293	if ($Coro::current == $Coro::main) {
		294	# this is the main coro, too bad, we have to block
		295	# till the operation succeeds, freezing the server :/
		296
		297	# TODO: use suspend/resume instead
		298	# (but this is cancel-safe)
		299	my $freeze_guard = freeze_mainloop;
		300
		301	my $busy = 1;
		302	my @res;
		303
		304	(async {
		305	@res = eval { $job->() };
		306	warn $@ if $@;
		307	undef $busy;
		308	})->prio (Coro::PRIO_MAX);
		309
		310	while ($busy) {
		311	Coro::cede or Event::one_event;
		312	}
		313
		314	wantarray ? @res : $res[0]
		315	} else {
		316	# we are in another coroutine, how wonderful, everything just works
		317
		318	$job->()
		319	}
		320	}
		321
		322	=item $coro = cf::async_ext { BLOCK }
		323
		324	Like async, but this coro is automcatially being canceled when the
		325	extension calling this is being unloaded.
		326
		327	=cut
		328
		329	sub async_ext(&) {
		330	my $cb = shift;
		331
		332	my $coro = &Coro::async ($cb);
		333
		334	$coro->on_destroy (sub {
		335	delete $EXT_CORO{$coro+0};
		336	});
		337	$EXT_CORO{$coro+0} = $coro;
		338
		339	$coro
		340	}
		341
		342	sub write_runtime {
		343	my $runtime = cf::localdir . "/runtime";
		344
		345	my $fh = aio_open "$runtime~", O_WRONLY | O_CREAT, 0644
		346	or return;
		347
		348	my $value = $cf::RUNTIME + 1 + 10; # 10 is the runtime save interval, for a monotonic clock
		349	(aio_write $fh, 0, (length $value), $value, 0) <= 0
		350	and return;
		351
		352	aio_fsync $fh
		353	and return;
		354
		355	close $fh
		356	or return;
		357
		358	aio_rename "$runtime~", $runtime
		359	and return;
		360
		361	1
		362	}
		363
124	=back	364	=back
125		365
126	=cut	366	=cut
127		367
128	#############################################################################	368	#############################################################################
129		369
130	=head2 EVENTS AND OBJECT ATTACHMENTS	370	package cf::path;
		371
		372	use overload
		373	'""' => \&as_string;
		374
		375	# used to convert map paths into valid unix filenames by repalcing / by ∕
		376	our $PATH_SEP = "∕"; # U+2215, chosen purely for visual reasons
		377
		378	sub new {
		379	my ($class, $path, $base) = @_;
		380
		381	$path = $path->as_string if ref $path;
		382
		383	my $self = bless { }, $class;
		384
		385	# {... are special paths that are not touched
		386	# ?xxx/... are special absolute paths
		387	# ?random/... random maps
		388	# /! non-realised random map exit
		389	# /... normal maps
		390	# ~/... per-player maps without a specific player (DO NOT USE)
		391	# ~user/... per-player map of a specific user
		392
		393	$path =~ s/$PATH_SEP/\//go;
		394
		395	if ($path =~ /^{/) {
		396	# fine as it is
		397	} elsif ($path =~ s{^\?random/}{}) {
		398	Coro::AIO::aio_load "$cf::RANDOM_MAPS/$path.meta", my $data;
		399	$self->{random} = cf::from_json $data;
		400	} else {
		401	if ($path =~ s{^~([^/]+)?}{}) {
		402	$self->{user_rel} = 1;
		403
		404	if (defined $1) {
		405	$self->{user} = $1;
		406	} elsif ($base =~ m{^~([^/]+)/}) {
		407	$self->{user} = $1;
		408	} else {
		409	warn "cannot resolve user-relative path without user <$path,$base>\n";
		410	}
		411	} elsif ($path =~ /^\//) {
		412	# already absolute
		413	} else {
		414	$base =~ s{[^/]+/?$}{};
		415	return $class->new ("$base/$path");
		416	}
		417
		418	for ($path) {
		419	redo if s{/\.?/}{/};
		420	redo if s{/[^/]+/\.\./}{/};
		421	}
		422	}
		423
		424	$self->{path} = $path;
		425
		426	$self
		427	}
		428
		429	# the name / primary key / in-game path
		430	sub as_string {
		431	my ($self) = @_;
		432
		433	$self->{user_rel} ? "~$self->{user}$self->{path}"
		434	: $self->{random} ? "?random/$self->{path}"
		435	: $self->{path}
		436	}
		437
		438	# the displayed name, this is a one way mapping
		439	sub visible_name {
		440	my ($self) = @_;
		441
		442	# if (my $rmp = $self->{random}) {
		443	# # todo: be more intelligent about this
		444	# "?random/$rmp->{origin_map}+$rmp->{origin_x}+$rmp->{origin_y}/$rmp->{dungeon_level}"
		445	# } else {
		446	$self->as_string
		447	# }
		448	}
		449
		450	# escape the /'s in the path
		451	sub _escaped_path {
		452	(my $path = $_[0]{path}) =~ s/\//$PATH_SEP/g;
		453	$path
		454	}
		455
		456	# the original (read-only) location
		457	sub load_path {
		458	my ($self) = @_;
		459
		460	sprintf "%s/%s/%s", cf::datadir, cf::mapdir, $self->{path}
		461	}
		462
		463	# the temporary/swap location
		464	sub save_path {
		465	my ($self) = @_;
		466
		467	$self->{user_rel} ? sprintf "%s/%s/%s/%s", cf::localdir, cf::playerdir, $self->{user}, $self->_escaped_path
		468	: $self->{random} ? sprintf "%s/%s", $RANDOM_MAPS, $self->{path}
		469	: sprintf "%s/%s/%s", cf::localdir, cf::tmpdir, $self->_escaped_path
		470	}
		471
		472	# the unique path, might be eq to save_path
		473	sub uniq_path {
		474	my ($self) = @_;
		475
		476	$self->{user_rel} || $self->{random}
		477	? undef
		478	: sprintf "%s/%s/%s", cf::localdir, cf::uniquedir, $self->_escaped_path
		479	}
		480
		481	# return random map parameters, or undef
		482	sub random_map_params {
		483	my ($self) = @_;
		484
		485	$self->{random}
		486	}
		487
		488	# this is somewhat ugly, but style maps do need special treatment
		489	sub is_style_map {
		490	$_[0]{path} =~ m{^/styles/}
		491	}
		492
		493	package cf;
		494
		495	#############################################################################
		496
		497	=head2 ATTACHABLE OBJECTS
		498
		499	Many objects in crossfire are so-called attachable objects. That means you can
		500	attach callbacks/event handlers (a collection of which is called an "attachment")
		501	to it. All such attachable objects support the following methods.
		502
		503	In the following description, CLASS can be any of C<global>, C<object>
		504	C<player>, C<client> or C<map> (i.e. the attachable objects in
		505	crossfire+).
131		506
132	=over 4	507	=over 4
133		508
134	=item $object->attach ($attachment, key => $value...)
135
136	=item $object->detach ($attachment)
137
138	Attach/detach a pre-registered attachment to an object.
139
140	=item $player->attach ($attachment, key => $value...)
141
142	=item $player->detach ($attachment)
143
144	Attach/detach a pre-registered attachment to a player.
145
146	=item $map->attach ($attachment, key => $value...)	509	=item $attachable->attach ($attachment, key => $value...)
147		510
148	=item $map->detach ($attachment)	511	=item $attachable->detach ($attachment)
149		512
150	Attach/detach a pre-registered attachment to a map.	513	Attach/detach a pre-registered attachment to a specific object and give it
		514	the specified key/value pairs as arguments.
151		515
152	=item $bool = $object->attached ($name)	516	Example, attach a minesweeper attachment to the given object, making it a
		517	10x10 minesweeper game:
153		518
154	=item $bool = $player->attached ($name)	519	$obj->attach (minesweeper => width => 10, height => 10);
155		520
156	=item $bool = $map->attached ($name)	521	=item $bool = $attachable->attached ($name)
157		522
158	Checks wether the named attachment is currently attached to the object.	523	Checks wether the named attachment is currently attached to the object.
159		524
160	=item cf::attach_global ...	525	=item cf::CLASS->attach ...
161		526
162	Attach handlers for global events.	527	=item cf::CLASS->detach ...
163		528
164	This and all following C<attach_*>-functions expect any number of the	529	Define an anonymous attachment and attach it to all objects of the given
165	following handler/hook descriptions:	530	CLASS. See the next function for an explanation of its arguments.
		531
		532	You can attach to global events by using the C<cf::global> class.
		533
		534	Example, log all player logins:
		535
		536	cf::player->attach (
		537	on_login => sub {
		538	my ($pl) = @_;
		539	...
		540	},
		541	);
		542
		543	Example, attach to the jeweler skill:
		544
		545	cf::object->attach (
		546	type => cf::SKILL,
		547	subtype => cf::SK_JEWELER,
		548	on_use_skill => sub {
		549	my ($sk, $ob, $part, $dir, $msg) = @_;
		550	...
		551	},
		552	);
		553
		554	=item cf::CLASS::attachment $name, ...
		555
		556	Register an attachment by C<$name> through which attachable objects of the
		557	given CLASS can refer to this attachment.
		558
		559	Some classes such as crossfire maps and objects can specify attachments
		560	that are attached at load/instantiate time, thus the need for a name.
		561
		562	These calls expect any number of the following handler/hook descriptions:
166		563
167	=over 4	564	=over 4
168		565
169	=item prio => $number	566	=item prio => $number
170		567
…		…
172	by another C<prio> setting). Lower priority handlers get executed	569	by another C<prio> setting). Lower priority handlers get executed
173	earlier. The default priority is C<0>, and many built-in handlers are	570	earlier. The default priority is C<0>, and many built-in handlers are
174	registered at priority C<-1000>, so lower priorities should not be used	571	registered at priority C<-1000>, so lower priorities should not be used
175	unless you know what you are doing.	572	unless you know what you are doing.
176		573
		574	=item type => $type
		575
		576	(Only for C<< cf::object->attach >> calls), limits the attachment to the
		577	given type of objects only (the additional parameter C<subtype> can be
		578	used to further limit to the given subtype).
		579
177	=item on_I<event> => \&cb	580	=item on_I<event> => \&cb
178		581
179	Call the given code reference whenever the named event happens (event is	582	Call the given code reference whenever the named event happens (event is
180	something like C<instantiate>, C<apply>, C<use_skill> and so on, and which	583	something like C<instantiate>, C<apply>, C<use_skill> and so on, and which
181	handlers are recognised generally depends on the type of object these	584	handlers are recognised generally depends on the type of object these
…		…
190	package and register them. Only handlers for eevents supported by the	593	package and register them. Only handlers for eevents supported by the
191	object/class are recognised.	594	object/class are recognised.
192		595
193	=back	596	=back
194		597
195	=item cf::attach_to_type $object_type, $subtype, ...	598	Example, define an attachment called "sockpuppet" that calls the given
		599	event handler when a monster attacks:
196		600
197	Attach handlers for a specific object type (e.g. TRANSPORT) and	601	cf::object::attachment sockpuppet =>
198	subtype. If C<$subtype> is zero or undef, matches all objects of the given	602	on_skill_attack => sub {
199	type.	603	my ($self, $victim) = @_;
200		604	...
201	=item cf::attach_to_objects ...
202
203	Attach handlers to all objects. Do not use this except for debugging or
204	very rare events, as handlers are (obviously) called for I<all> objects in
205	the game.
206
207	=item cf::attach_to_players ...
208
209	Attach handlers to all players.
210
211	=item cf::attach_to_maps ...
212
213	Attach handlers to all maps.
214
215	=item cf:register_attachment $name, ...
216
217	Register an attachment by name through which objects can refer to this
218	attachment.
219
220	=item cf:register_player_attachment $name, ...
221
222	Register an attachment by name through which players can refer to this
223	attachment.
224
225	=item cf:register_map_attachment $name, ...
226
227	Register an attachment by name through which maps can refer to this
228	attachment.
229
230	=cut
231
232	# the following variables are defined in .xs and must not be re-created
233	our @CB_GLOBAL = (); # registry for all global events
234	our @CB_OBJECT = (); # all objects (should not be used except in emergency)
235	our @CB_PLAYER = ();
236	our @CB_TYPE = (); # registry for type (cf-object class) based events
237	our @CB_MAP = ();
238
239	my %attachment;
240
241	sub _attach_cb($\%$$$) {
242	my ($registry, $undo, $event, $prio, $cb) = @_;
243
244	use sort 'stable';
245
246	$cb = [$prio, $cb];
247
248	@{$registry->[$event]} = sort
249	{ $a->[0] cmp $b->[0] }
250	@{$registry->[$event] || []}, $cb;
251
252	push @{$undo->{cb}}, [$event, $cb];
253	}
254
255	# attach handles attaching event callbacks
256	# the only thing the caller has to do is pass the correct
257	# registry (== where the callback attaches to).
258	sub _attach(\@$@) {
259	my ($registry, $klass, @arg) = @_;
260
261	my $prio = 0;
262
263	my %undo = (
264	registry => $registry,
265	cb => [],
266	);
267
268	my %cb_id = map +("on_" . lc $EVENT[$_][0], $_) , grep $EVENT[$_][1] == $klass, 0 .. $#EVENT;
269
270	while (@arg) {
271	my $type = shift @arg;
272
273	if ($type eq "prio") {
274	$prio = shift @arg;
275
276	} elsif ($type eq "package") {
277	my $pkg = shift @arg;
278
279	while (my ($name, $id) = each %cb_id) {
280	if (my $cb = $pkg->can ($name)) {
281	_attach_cb $registry, %undo, $id, $prio, $cb;
282	}
283	}	605	}
284
285	} elsif (exists $cb_id{$type}) {
286	_attach_cb $registry, %undo, $cb_id{$type}, $prio, shift @arg;
287
288	} elsif (ref $type) {
289	warn "attaching objects not supported, ignoring.\n";
290
291	} else {
292	shift @arg;
293	warn "attach argument '$type' not supported, ignoring.\n";
294	}
295	}
296
297	\%undo
298	}
299
300	sub _attach_attachment {
301	my ($obj, $name, %arg) = @_;
302
303	return if exists $obj->{_attachment}{$name};
304
305	my $res;
306
307	if (my $attach = $attachment{$name}) {
308	my $registry = $obj->registry;
309
310	for (@$attach) {
311	my ($klass, @attach) = @$_;
312	$res = _attach @$registry, $klass, @attach;
313	}
314
315	$obj->{$name} = \%arg;
316	} else {
317	warn "object uses attachment '$name' that is not available, postponing.\n";
318	}
319
320	$obj->{_attachment}{$name} = undef;
321
322	$res->{attachment} = $name;
323	$res
324	}
325
326	*cf::object::attach =
327	*cf::player::attach =
328	*cf::map::attach = sub {
329	my ($obj, $name, %arg) = @_;
330
331	_attach_attachment $obj, $name, %arg;
332	};
333
334	# all those should be optimised
335	*cf::object::detach =
336	*cf::player::detach =
337	*cf::map::detach = sub {
338	my ($obj, $name) = @_;
339
340	delete $obj->{_attachment}{$name};
341	reattach ($obj);
342	};
343
344	*cf::object::attached =
345	*cf::player::attached =
346	*cf::map::attached = sub {
347	my ($obj, $name) = @_;
348
349	exists $obj->{_attachment}{$name}
350	};
351
352	sub attach_global {
353	_attach @CB_GLOBAL, KLASS_GLOBAL, @_
354	}
355
356	sub attach_to_type {
357	my $type = shift;
358	my $subtype = shift;
359
360	_attach @{$CB_TYPE[$type + $subtype * NUM_SUBTYPES]}, KLASS_OBJECT, @_
361	}
362
363	sub attach_to_objects {
364	_attach @CB_OBJECT, KLASS_OBJECT, @_
365	}
366
367	sub attach_to_players {
368	_attach @CB_PLAYER, KLASS_PLAYER, @_
369	}
370
371	sub attach_to_maps {
372	_attach @CB_MAP, KLASS_MAP, @_
373	}
374
375	sub register_attachment {
376	my $name = shift;
377
378	$attachment{$name} = [[KLASS_OBJECT, @_]];
379	}
380
381	sub register_player_attachment {
382	my $name = shift;
383
384	$attachment{$name} = [[KLASS_PLAYER, @_]];
385	}
386
387	sub register_map_attachment {
388	my $name = shift;
389
390	$attachment{$name} = [[KLASS_MAP, @_]];
391	}
392
393	our $override;
394	our @invoke_results = (); # referenced from .xs code. TODO: play tricks with reify and mortals?
395
396	sub override {
397	$override = 1;
398	@invoke_results = ();
399	}
400
401	sub do_invoke {
402	my $event = shift;
403	my $callbacks = shift;
404
405	@invoke_results = ();
406
407	local $override;
408
409	for (@$callbacks) {
410	eval { &{$_->[1]} };
411
412	if ($@) {
413	warn "$@";
414	warn "... while processing $EVENT[$event][0](@_) event, skipping processing altogether.\n";
415	override;
416	}
417
418	return 1 if $override;
419	}
420
421	0	606	}
422	}
423		607
424	=item $bool = cf::invoke EVENT_GLOBAL_XXX, ...	608	=item $attachable->valid
425
426	=item $bool = $object->invoke (EVENT_OBJECT_XXX, ...)
427
428	=item $bool = $player->invoke (EVENT_PLAYER_XXX, ...)
429
430	=item $bool = $map->invoke (EVENT_MAP_XXX, ...)
431
432	Generate a global/object/player/map-specific event with the given arguments.
433
434	This API is preliminary (most likely, the EVENT_KLASS_xxx prefix will be
435	removed in future versions), and there is no public API to access override
436	results (if you must, access C<@cf::invoke_results> directly).
437
438	=back
439
440	=cut
441
442	#############################################################################
443
444	=head2 METHODS VALID FOR ALL CORE OBJECTS
445
446	=over 4
447
448	=item $object->valid, $player->valid, $map->valid
449		609
450	Just because you have a perl object does not mean that the corresponding	610	Just because you have a perl object does not mean that the corresponding
451	C-level object still exists. If you try to access an object that has no	611	C-level object still exists. If you try to access an object that has no
452	valid C counterpart anymore you get an exception at runtime. This method	612	valid C counterpart anymore you get an exception at runtime. This method
453	can be used to test for existence of the C object part without causing an	613	can be used to test for existence of the C object part without causing an
454	exception.	614	exception.
455		615
		616	=cut
		617
		618	# the following variables are defined in .xs and must not be re-created
		619	our @CB_GLOBAL = (); # registry for all global events
		620	our @CB_ATTACHABLE = (); # registry for all attachables
		621	our @CB_OBJECT = (); # all objects (should not be used except in emergency)
		622	our @CB_PLAYER = ();
		623	our @CB_CLIENT = ();
		624	our @CB_TYPE = (); # registry for type (cf-object class) based events
		625	our @CB_MAP = ();
		626
		627	my %attachment;
		628
		629	sub _attach_cb($$$$) {
		630	my ($registry, $event, $prio, $cb) = @_;
		631
		632	use sort 'stable';
		633
		634	$cb = [$prio, $cb];
		635
		636	@{$registry->[$event]} = sort
		637	{ $a->[0] cmp $b->[0] }
		638	@{$registry->[$event] || []}, $cb;
		639	}
		640
		641	# hack
		642	my %attachable_klass = map +($_ => 1), KLASS_OBJECT, KLASS_CLIENT, KLASS_PLAYER, KLASS_MAP;
		643
		644	# attach handles attaching event callbacks
		645	# the only thing the caller has to do is pass the correct
		646	# registry (== where the callback attaches to).
		647	sub _attach {
		648	my ($registry, $klass, @arg) = @_;
		649
		650	my $object_type;
		651	my $prio = 0;
		652	my %cb_id = map +("on_" . lc $EVENT[$_][0], $_) , grep $EVENT[$_][1] == $klass, 0 .. $#EVENT;
		653
		654	#TODO: get rid of this hack
		655	if ($attachable_klass{$klass}) {
		656	%cb_id = (%cb_id, map +("on_" . lc $EVENT[$_][0], $_) , grep $EVENT[$_][1] == KLASS_ATTACHABLE, 0 .. $#EVENT);
		657	}
		658
		659	while (@arg) {
		660	my $type = shift @arg;
		661
		662	if ($type eq "prio") {
		663	$prio = shift @arg;
		664
		665	} elsif ($type eq "type") {
		666	$object_type = shift @arg;
		667	$registry = $CB_TYPE[$object_type] ||= [];
		668
		669	} elsif ($type eq "subtype") {
		670	defined $object_type or Carp::croak "subtype specified without type";
		671	my $object_subtype = shift @arg;
		672	$registry = $CB_TYPE[$object_type + $object_subtype * NUM_SUBTYPES] ||= [];
		673
		674	} elsif ($type eq "package") {
		675	my $pkg = shift @arg;
		676
		677	while (my ($name, $id) = each %cb_id) {
		678	if (my $cb = $pkg->can ($name)) {
		679	_attach_cb $registry, $id, $prio, $cb;
		680	}
		681	}
		682
		683	} elsif (exists $cb_id{$type}) {
		684	_attach_cb $registry, $cb_id{$type}, $prio, shift @arg;
		685
		686	} elsif (ref $type) {
		687	warn "attaching objects not supported, ignoring.\n";
		688
		689	} else {
		690	shift @arg;
		691	warn "attach argument '$type' not supported, ignoring.\n";
		692	}
		693	}
		694	}
		695
		696	sub _object_attach {
		697	my ($obj, $name, %arg) = @_;
		698
		699	return if exists $obj->{_attachment}{$name};
		700
		701	if (my $attach = $attachment{$name}) {
		702	my $registry = $obj->registry;
		703
		704	for (@$attach) {
		705	my ($klass, @attach) = @$_;
		706	_attach $registry, $klass, @attach;
		707	}
		708
		709	$obj->{$name} = \%arg;
		710	} else {
		711	warn "object uses attachment '$name' that is not available, postponing.\n";
		712	}
		713
		714	$obj->{_attachment}{$name} = undef;
		715	}
		716
		717	sub cf::attachable::attach {
		718	if (ref $_[0]) {
		719	_object_attach @_;
		720	} else {
		721	_attach shift->_attach_registry, @_;
		722	}
		723	};
		724
		725	# all those should be optimised
		726	sub cf::attachable::detach {
		727	my ($obj, $name) = @_;
		728
		729	if (ref $obj) {
		730	delete $obj->{_attachment}{$name};
		731	reattach ($obj);
		732	} else {
		733	Carp::croak "cannot, currently, detach class attachments";
		734	}
		735	};
		736
		737	sub cf::attachable::attached {
		738	my ($obj, $name) = @_;
		739
		740	exists $obj->{_attachment}{$name}
		741	}
		742
		743	for my $klass (qw(ATTACHABLE GLOBAL OBJECT PLAYER CLIENT MAP)) {
		744	eval "#line " . __LINE__ . " 'cf.pm'
		745	sub cf::\L$klass\E::_attach_registry {
		746	(\\\@CB_$klass, KLASS_$klass)
		747	}
		748
		749	sub cf::\L$klass\E::attachment {
		750	my \$name = shift;
		751
		752	\$attachment{\$name} = [[KLASS_$klass, \@_]];
		753	}
		754	";
		755	die if $@;
		756	}
		757
		758	our $override;
		759	our @invoke_results = (); # referenced from .xs code. TODO: play tricks with reify and mortals?
		760
		761	sub override {
		762	$override = 1;
		763	@invoke_results = ();
		764	}
		765
		766	sub do_invoke {
		767	my $event = shift;
		768	my $callbacks = shift;
		769
		770	@invoke_results = ();
		771
		772	local $override;
		773
		774	for (@$callbacks) {
		775	eval { &{$_->[1]} };
		776
		777	if ($@) {
		778	warn "$@";
		779	warn "... while processing $EVENT[$event][0](@_) event, skipping processing altogether.\n";
		780	override;
		781	}
		782
		783	return 1 if $override;
		784	}
		785
		786	0
		787	}
		788
		789	=item $bool = cf::global::invoke (EVENT_CLASS_XXX, ...)
		790
		791	=item $bool = $attachable->invoke (EVENT_CLASS_XXX, ...)
		792
		793	Generate an object-specific event with the given arguments.
		794
		795	This API is preliminary (most likely, the EVENT_CLASS_xxx prefix will be
		796	removed in future versions), and there is no public API to access override
		797	results (if you must, access C<@cf::invoke_results> directly).
		798
456	=back	799	=back
457		800
458	=cut	801	=cut
459
460	*cf::object::valid =
461	*cf::player::valid =
462	*cf::map::valid = \&cf::_valid;
463		802
464	#############################################################################	803	#############################################################################
465	# object support	804	# object support
466		805
467	sub instantiate {
468	my ($obj, $data) = @_;
469
470	$data = from_json $data;
471
472	for (@$data) {
473	my ($name, $args) = @$_;
474
475	$obj->attach ($name, %{$args || {} });
476	}
477	}
478
479	# basically do the same as instantiate, without calling instantiate
480	sub reattach {	806	sub reattach {
		807	# basically do the same as instantiate, without calling instantiate
481	my ($obj) = @_;	808	my ($obj) = @_;
		809
482	my $registry = $obj->registry;	810	my $registry = $obj->registry;
483		811
484	@$registry = ();	812	@$registry = ();
485		813
486	delete $obj->{_attachment} unless scalar keys %{ $obj->{_attachment} || {} };	814	delete $obj->{_attachment} unless scalar keys %{ $obj->{_attachment} || {} };
487		815
488	for my $name (keys %{ $obj->{_attachment} || {} }) {	816	for my $name (keys %{ $obj->{_attachment} || {} }) {
489	if (my $attach = $attachment{$name}) {	817	if (my $attach = $attachment{$name}) {
490	for (@$attach) {	818	for (@$attach) {
491	my ($klass, @attach) = @$_;	819	my ($klass, @attach) = @$_;
492	_attach @$registry, $klass, @attach;	820	_attach $registry, $klass, @attach;
493	}	821	}
494	} else {	822	} else {
495	warn "object uses attachment '$name' that is not available, postponing.\n";	823	warn "object uses attachment '$name' that is not available, postponing.\n";
496	}	824	}
497	}	825	}
498	}	826	}
499		827
500	sub object_freezer_save {	828	cf::attachable->attach (
501	my ($filename, $rdata, $objs) = @_;
502
503	if (length $$rdata) {
504	warn sprintf "saving %s (%d,%d)\n",
505	$filename, length $$rdata, scalar @$objs;
506
507	if (open my $fh, ">:raw", "$filename~") {
508	chmod SAVE_MODE, $fh;
509	syswrite $fh, $$rdata;
510	close $fh;
511
512	if (@$objs && open my $fh, ">:raw", "$filename.pst~") {
513	chmod SAVE_MODE, $fh;
514	syswrite $fh, Storable::nfreeze { version => 1, objs => $objs };
515	close $fh;
516	rename "$filename.pst~", "$filename.pst";
517	} else {
518	unlink "$filename.pst";
519	}
520
521	rename "$filename~", $filename;
522	} else {
523	warn "FATAL: $filename~: $!\n";
524	}
525	} else {
526	unlink $filename;
527	unlink "$filename.pst";
528	}
529	}
530
531	sub object_freezer_as_string {
532	my ($rdata, $objs) = @_;
533
534	use Data::Dumper;
535
536	$$rdata . Dumper $objs
537	}
538
539	sub object_thawer_load {
540	my ($filename) = @_;
541
542	local $/;
543
544	my $av;
545
546	#TODO: use sysread etc.
547	if (open my $data, "<:raw:perlio", $filename) {
548	$data = <$data>;
549	if (open my $pst, "<:raw:perlio", "$filename.pst") {
550	$av = eval { (Storable::thaw <$pst>)->{objs} };
551	}
552	return ($data, $av);
553	}
554
555	()
556	}
557
558	attach_to_objects
559	prio => -1000000,	829	prio => -1000000,
		830	on_instantiate => sub {
		831	my ($obj, $data) = @_;
		832
		833	$data = from_json $data;
		834
		835	for (@$data) {
		836	my ($name, $args) = @$_;
		837
		838	$obj->attach ($name, %{$args || {} });
		839	}
		840	},
		841	on_reattach => \&reattach,
560	on_clone => sub {	842	on_clone => sub {
561	my ($src, $dst) = @_;	843	my ($src, $dst) = @_;
562		844
563	@{$dst->registry} = @{$src->registry};	845	@{$dst->registry} = @{$src->registry};
564		846
565	%$dst = %$src;	847	%$dst = %$src;
566		848
567	%{$dst->{_attachment}} = %{$src->{_attachment}}	849	%{$dst->{_attachment}} = %{$src->{_attachment}}
568	if exists $src->{_attachment};	850	if exists $src->{_attachment};
569	},	851	},
570	;	852	);
		853
		854	sub object_freezer_save {
		855	my ($filename, $rdata, $objs) = @_;
		856
		857	sync_job {
		858	if (length $$rdata) {
		859	warn sprintf "saving %s (%d,%d)\n",
		860	$filename, length $$rdata, scalar @$objs;
		861
		862	if (my $fh = aio_open "$filename~", O_WRONLY | O_CREAT, 0600) {
		863	chmod SAVE_MODE, $fh;
		864	aio_write $fh, 0, (length $$rdata), $$rdata, 0;
		865	aio_fsync $fh;
		866	close $fh;
		867
		868	if (@$objs) {
		869	if (my $fh = aio_open "$filename.pst~", O_WRONLY | O_CREAT, 0600) {
		870	chmod SAVE_MODE, $fh;
		871	my $data = Storable::nfreeze { version => 1, objs => $objs };
		872	aio_write $fh, 0, (length $data), $data, 0;
		873	aio_fsync $fh;
		874	close $fh;
		875	aio_rename "$filename.pst~", "$filename.pst";
		876	}
		877	} else {
		878	aio_unlink "$filename.pst";
		879	}
		880
		881	aio_rename "$filename~", $filename;
		882	} else {
		883	warn "FATAL: $filename~: $!\n";
		884	}
		885	} else {
		886	aio_unlink $filename;
		887	aio_unlink "$filename.pst";
		888	}
		889	}
		890	}
		891
		892	sub object_freezer_as_string {
		893	my ($rdata, $objs) = @_;
		894
		895	use Data::Dumper;
		896
		897	$$rdata . Dumper $objs
		898	}
		899
		900	sub object_thawer_load {
		901	my ($filename) = @_;
		902
		903	my ($data, $av);
		904
		905	(aio_load $filename, $data) >= 0
		906	or return;
		907
		908	unless (aio_stat "$filename.pst") {
		909	(aio_load "$filename.pst", $av) >= 0
		910	or return;
		911	$av = eval { (Storable::thaw $av)->{objs} };
		912	}
		913
		914	warn sprintf "loading %s (%d)\n",
		915	$filename, length $data, scalar @{$av || []};#d#
		916	return ($data, $av);
		917	}
571		918
572	#############################################################################	919	#############################################################################
573	# command handling &c	920	# command handling &c
574		921
575	=item cf::register_command $name => \&callback($ob,$args);	922	=item cf::register_command $name => \&callback($ob,$args);
…		…
604	#warn "registering extcmd '$name' to '$caller'";	951	#warn "registering extcmd '$name' to '$caller'";
605		952
606	$EXTCMD{$name} = [$cb, $caller];	953	$EXTCMD{$name} = [$cb, $caller];
607	}	954	}
608		955
609	attach_to_players	956	cf::player->attach (
610	on_command => sub {	957	on_command => sub {
611	my ($pl, $name, $params) = @_;	958	my ($pl, $name, $params) = @_;
612		959
613	my $cb = $COMMAND{$name}	960	my $cb = $COMMAND{$name}
614	or return;	961	or return;
…		…
634	warn "player " . ($pl->ob->name) . " sent unparseable ext message: <$buf>\n";	981	warn "player " . ($pl->ob->name) . " sent unparseable ext message: <$buf>\n";
635	}	982	}
636		983
637	cf::override;	984	cf::override;
638	},	985	},
639	;	986	);
640		987
641	sub register {	988	sub register {
642	my ($base, $pkg) = @_;	989	my ($base, $pkg) = @_;
643		990
644	#TODO	991	#TODO
…		…
713		1060
714	Symbol::delete_package $pkg;	1061	Symbol::delete_package $pkg;
715	}	1062	}
716		1063
717	sub load_extensions {	1064	sub load_extensions {
718	my $LIBDIR = maps_directory "perl";
719
720	for my $ext (<$LIBDIR/*.ext>) {	1065	for my $ext (<$LIBDIR/*.ext>) {
721	next unless -r $ext;	1066	next unless -r $ext;
722	eval {	1067	eval {
723	load_extension $ext;	1068	load_extension $ext;
724	1	1069	1
…		…
736	defined $path or return;	1081	defined $path or return;
737		1082
738	unlink "$path.pst";	1083	unlink "$path.pst";
739	};	1084	};
740		1085
741	attach_to_maps prio => -10000, package => cf::mapsupport::;	1086	cf::map->attach (prio => -10000, package => cf::mapsupport::);
742		1087
743	#############################################################################	1088	#############################################################################
744	# load/save perl data associated with player->ob objects
745		1089
746	sub all_objects(@) {	1090	=head2 CORE EXTENSIONS
747	@_, map all_objects ($_->inv), @_
748	}
749		1091
750	# TODO: compatibility cruft, remove when no longer needed	1092	Functions and methods that extend core crossfire objects.
751	attach_to_players	1093
752	on_load => sub {	1094	=cut
		1095
		1096	package cf::player;
		1097
		1098	use Coro::AIO;
		1099
		1100	=head3 cf::player
		1101
		1102	=over 4
		1103
		1104	=item cf::player::find $login
		1105
		1106	Returns the given player object, loading it if necessary (might block).
		1107
		1108	=cut
		1109
		1110	sub playerdir($) {
		1111	cf::localdir
		1112	. "/"
		1113	. cf::playerdir
		1114	. "/"
		1115	. (ref $_[0] ? $_[0]->ob->name : $_[0])
		1116	}
		1117
		1118	sub path($) {
		1119	my $login = ref $_[0] ? $_[0]->ob->name : $_[0];
		1120
		1121	(playerdir $login) . "/$login.pl"
		1122	}
		1123
		1124	sub find_active($) {
		1125	$cf::PLAYER{$_[0]}
		1126	and $cf::PLAYER{$_[0]}->active
		1127	and $cf::PLAYER{$_[0]}
		1128	}
		1129
		1130	sub exists($) {
		1131	my ($login) = @_;
		1132
		1133	$cf::PLAYER{$login}
		1134	or cf::sync_job { !aio_stat $login }
		1135	}
		1136
		1137	sub find($) {
		1138	return $cf::PLAYER{$_[0]} || do {
		1139	my $login = $_[0];
		1140
		1141	my $guard = cf::lock_acquire "user_find:$login";
		1142
		1143	$cf::PLAYER{$_[0]} || do {
		1144	my $pl = load_pl path $login
		1145	or return;
		1146	$cf::PLAYER{$login} = $pl
		1147	}
		1148	}
		1149	}
		1150
		1151	sub save($) {
		1152	my ($pl) = @_;
		1153
		1154	return if $pl->{deny_save};
		1155
		1156	my $path = path $pl;
		1157	my $guard = cf::lock_acquire "user_save:$path";
		1158
		1159	return if $pl->{deny_save};
		1160
		1161	aio_mkdir playerdir $pl, 0770;
		1162	$pl->{last_save} = $cf::RUNTIME;
		1163
		1164	$pl->save_pl ($path);
		1165	Coro::cede;
		1166	}
		1167
		1168	sub new($) {
		1169	my ($login) = @_;
		1170
		1171	my $self = create;
		1172
		1173	$self->ob->name ($login);
		1174	$self->{deny_save} = 1;
		1175
		1176	$cf::PLAYER{$login} = $self;
		1177
		1178	$self
		1179	}
		1180
		1181	=item $pl->quit_character
		1182
		1183	Nukes the player without looking back. If logged in, the connection will
		1184	be destroyed. May block for a long time.
		1185
		1186	=cut
		1187
		1188	sub quit_character {
		1189	my ($pl) = @_;
		1190
		1191	$pl->{deny_save} = 1;
		1192	$pl->password ("*"); # this should lock out the player until we nuked the dir
		1193
		1194	$pl->invoke (cf::EVENT_PLAYER_LOGOUT, 1) if $pl->active;
		1195	$pl->deactivate;
		1196	$pl->invoke (cf::EVENT_PLAYER_QUIT);
		1197	$pl->ns->destroy if $pl->ns;
		1198
		1199	my $path = playerdir $pl;
		1200	my $temp = "$path~$cf::RUNTIME~deleting~";
		1201	aio_rename $path, $temp;
		1202	delete $cf::PLAYER{$pl->ob->name};
		1203	$pl->destroy;
		1204	IO::AIO::aio_rmtree $temp;
		1205	}
		1206
		1207	=item cf::player::list_logins
		1208
		1209	Returns am arrayref of all valid playernames in the system, can take a
		1210	while and may block, so not sync_job-capable, ever.
		1211
		1212	=cut
		1213
		1214	sub list_logins {
		1215	my $dirs = aio_readdir cf::localdir . "/" . cf::playerdir
		1216	or return [];
		1217
		1218	my @logins;
		1219
		1220	for my $login (@$dirs) {
		1221	my $fh = aio_open path $login, Fcntl::O_RDONLY, 0 or next;
		1222	aio_read $fh, 0, 512, my $buf, 0 or next;
		1223	$buf !~ /^password -------------$/m or next; # official not-valid tag
		1224
		1225	utf8::decode $login;
		1226	push @logins, $login;
		1227	}
		1228
		1229	\@logins
		1230	}
		1231
		1232	=item $player->maps
		1233
		1234	Returns an arrayref of cf::path's of all maps that are private for this
		1235	player. May block.
		1236
		1237	=cut
		1238
		1239	sub maps($) {
		1240	my ($pl) = @_;
		1241
		1242	my $files = aio_readdir playerdir $pl
		1243	or return;
		1244
		1245	my @paths;
		1246
		1247	for (@$files) {
		1248	utf8::decode $_;
		1249	next if /\.(?:pl|pst)$/;
		1250	next unless /^$PATH_SEP/o;
		1251
		1252	push @paths, new cf::path "~" . $pl->ob->name . "/" . $_;
		1253	}
		1254
		1255	\@paths
		1256	}
		1257
		1258	=item $player->ext_reply ($msgid, $msgtype, %msg)
		1259
		1260	Sends an ext reply to the player.
		1261
		1262	=cut
		1263
		1264	sub ext_reply($$$%) {
		1265	my ($self, $id, %msg) = @_;
		1266
		1267	$msg{msgid} = $id;
		1268
		1269	$self->send ("ext " . cf::to_json \%msg);
		1270	}
		1271
		1272	package cf;
		1273
		1274	=back
		1275
		1276
		1277	=head3 cf::map
		1278
		1279	=over 4
		1280
		1281	=cut
		1282
		1283	package cf::map;
		1284
		1285	use Fcntl;
		1286	use Coro::AIO;
		1287
		1288	our $MAX_RESET = 3600;
		1289	our $DEFAULT_RESET = 3000;
		1290
		1291	sub generate_random_map {
		1292	my ($path, $rmp) = @_;
		1293
		1294	# mit "rum" bekleckern, nicht
		1295	cf::map::_create_random_map
		1296	$path,
		1297	$rmp->{wallstyle}, $rmp->{wall_name}, $rmp->{floorstyle}, $rmp->{monsterstyle},
		1298	$rmp->{treasurestyle}, $rmp->{layoutstyle}, $rmp->{doorstyle}, $rmp->{decorstyle},
		1299	$rmp->{origin_map}, $rmp->{final_map}, $rmp->{exitstyle}, $rmp->{this_map},
		1300	$rmp->{exit_on_final_map},
		1301	$rmp->{xsize}, $rmp->{ysize},
		1302	$rmp->{expand2x}, $rmp->{layoutoptions1}, $rmp->{layoutoptions2}, $rmp->{layoutoptions3},
		1303	$rmp->{symmetry}, $rmp->{difficulty}, $rmp->{difficulty_given}, $rmp->{difficulty_increase},
		1304	$rmp->{dungeon_level}, $rmp->{dungeon_depth}, $rmp->{decoroptions}, $rmp->{orientation},
		1305	$rmp->{origin_y}, $rmp->{origin_x}, $rmp->{random_seed}, $rmp->{total_map_hp},
		1306	$rmp->{map_layout_style}, $rmp->{treasureoptions}, $rmp->{symmetry_used},
		1307	(cf::region::find $rmp->{region})
		1308	}
		1309
		1310	# and all this just because we cannot iterate over
		1311	# all maps in C++...
		1312	sub change_all_map_light {
		1313	my ($change) = @_;
		1314
		1315	$_->change_map_light ($change)
		1316	for grep $_->outdoor, values %cf::MAP;
		1317	}
		1318
		1319	sub try_load_header($) {
753	my ($pl, $path) = @_;	1320	my ($path) = @_;
754		1321
755	for my $o (all_objects $pl->ob) {	1322	utf8::encode $path;
756	if (my $value = $o->get_ob_key_value ("_perl_data")) {	1323	aio_open $path, O_RDONLY, 0
757	$o->set_ob_key_value ("_perl_data");	1324	or return;
758		1325
759	%$o = %{ Storable::thaw pack "H*", $value };	1326	my $map = cf::map::new
		1327	or return;
		1328
		1329	# for better error messages only, will be overwritten
		1330	$map->path ($path);
		1331
		1332	$map->load_header ($path)
		1333	or return;
		1334
		1335	$map->{load_path} = $path;
		1336
		1337	$map
		1338	}
		1339
		1340	sub find;
		1341	sub find {
		1342	my ($path, $origin) = @_;
		1343
		1344	#warn "find<$path,$origin>\n";#d#
		1345
		1346	$path = new cf::path $path, $origin && $origin->path;
		1347	my $key = $path->as_string;
		1348
		1349	cf::lock_wait "map_find:$key";
		1350
		1351	$cf::MAP{$key} || do {
		1352	my $guard = cf::lock_acquire "map_find:$key";
		1353
		1354	# do it the slow way
		1355	my $map = try_load_header $path->save_path;
		1356
		1357	Coro::cede;
		1358
		1359	if ($map) {
		1360	$map->last_access ((delete $map->{last_access})
		1361	|| $cf::RUNTIME); #d#
		1362	# safety
		1363	$map->{instantiate_time} = $cf::RUNTIME
		1364	if $map->{instantiate_time} > $cf::RUNTIME;
		1365	} else {
		1366	if (my $rmp = $path->random_map_params) {
		1367	$map = generate_random_map $key, $rmp;
		1368	} else {
		1369	$map = try_load_header $path->load_path;
760	}	1370	}
		1371
		1372	$map or return;
		1373
		1374	$map->{load_original} = 1;
		1375	$map->{instantiate_time} = $cf::RUNTIME;
		1376	$map->last_access ($cf::RUNTIME);
		1377	$map->instantiate;
		1378
		1379	# per-player maps become, after loading, normal maps
		1380	$map->per_player (0) if $path->{user_rel};
761	}	1381	}
		1382
		1383	$map->path ($key);
		1384	$map->{path} = $path;
		1385	$map->{last_save} = $cf::RUNTIME;
		1386
		1387	Coro::cede;
		1388
		1389	if ($map->should_reset) {
		1390	$map->reset;
		1391	undef $guard;
		1392	$map = find $path
		1393	or return;
		1394	}
		1395
		1396	$cf::MAP{$key} = $map
762	},	1397	}
763	;	1398	}
764		1399
765	#############################################################################	1400	sub load {
		1401	my ($self) = @_;
766		1402
767	=head2 CORE EXTENSIONS	1403	my $path = $self->{path};
		1404	my $guard = cf::lock_acquire "map_load:" . $path->as_string;
768		1405
769	Functions and methods that extend core crossfire objects.	1406	return if $self->in_memory != cf::MAP_SWAPPED;
		1407
		1408	$self->in_memory (cf::MAP_LOADING);
		1409
		1410	$self->alloc;
		1411	$self->load_objects ($self->{load_path}, 1)
		1412	or return;
		1413
		1414	$self->set_object_flag (cf::FLAG_OBJ_ORIGINAL, 1)
		1415	if delete $self->{load_original};
		1416
		1417	if (my $uniq = $path->uniq_path) {
		1418	utf8::encode $uniq;
		1419	if (aio_open $uniq, O_RDONLY, 0) {
		1420	$self->clear_unique_items;
		1421	$self->load_objects ($uniq, 0);
		1422	}
		1423	}
		1424
		1425	Coro::cede;
		1426
		1427	# now do the right thing for maps
		1428	$self->link_multipart_objects;
		1429
		1430	if ($self->{path}->is_style_map) {
		1431	$self->{deny_save} = 1;
		1432	$self->{deny_reset} = 1;
		1433	} else {
		1434	$self->fix_auto_apply;
		1435	$self->decay_objects;
		1436	$self->update_buttons;
		1437	$self->set_darkness_map;
		1438	$self->difficulty ($self->estimate_difficulty)
		1439	unless $self->difficulty;
		1440	$self->activate;
		1441	}
		1442
		1443	Coro::cede;
		1444
		1445	$self->in_memory (cf::MAP_IN_MEMORY);
		1446	}
		1447
		1448	# find and load all maps in the 3x3 area around a map
		1449	sub load_diag {
		1450	my ($map) = @_;
		1451
		1452	my @diag; # diagonal neighbours
		1453
		1454	for (0 .. 3) {
		1455	my $neigh = $map->tile_path ($_)
		1456	or next;
		1457	$neigh = find $neigh, $map
		1458	or next;
		1459	$neigh->load;
		1460
		1461	push @diag, [$neigh->tile_path (($_ + 3) % 4), $neigh],
		1462	[$neigh->tile_path (($_ + 1) % 4), $neigh];
		1463	}
		1464
		1465	for (@diag) {
		1466	my $neigh = find @$_
		1467	or next;
		1468	$neigh->load;
		1469	}
		1470	}
		1471
		1472	sub find_sync {
		1473	my ($path, $origin) = @_;
		1474
		1475	cf::sync_job { find $path, $origin }
		1476	}
		1477
		1478	sub do_load_sync {
		1479	my ($map) = @_;
		1480
		1481	cf::sync_job { $map->load };
		1482	}
		1483
		1484	our %MAP_PREFETCH;
		1485	our $MAP_PREFETCHER = Coro::async {
		1486	while () {
		1487	while (%MAP_PREFETCH) {
		1488	my $key = each %MAP_PREFETCH
		1489	or next;
		1490	my $path = delete $MAP_PREFETCH{$key};
		1491
		1492	my $map = find $path
		1493	or next;
		1494	$map->load;
		1495	}
		1496	Coro::schedule;
		1497	}
		1498	};
		1499
		1500	sub find_async {
		1501	my ($path, $origin) = @_;
		1502
		1503	$path = new cf::path $path, $origin && $origin->path;
		1504	my $key = $path->as_string;
		1505
		1506	if (my $map = $cf::MAP{$key}) {
		1507	return $map if $map->in_memory == cf::MAP_IN_MEMORY;
		1508	}
		1509
		1510	$MAP_PREFETCH{$key} = $path;
		1511	$MAP_PREFETCHER->ready;
		1512
		1513	()
		1514	}
		1515
		1516	sub save {
		1517	my ($self) = @_;
		1518
		1519	my $lock = cf::lock_acquire "map_data:" . $self->path;
		1520
		1521	$self->{last_save} = $cf::RUNTIME;
		1522
		1523	return unless $self->dirty;
		1524
		1525	my $save = $self->{path}->save_path; utf8::encode $save;
		1526	my $uniq = $self->{path}->uniq_path; utf8::encode $uniq;
		1527
		1528	$self->{load_path} = $save;
		1529
		1530	return if $self->{deny_save};
		1531
		1532	local $self->{last_access} = $self->last_access;#d#
		1533
		1534	cf::async {
		1535	$_->contr->save for $self->players;
		1536	};
		1537
		1538	if ($uniq) {
		1539	$self->save_objects ($save, cf::IO_HEADER | cf::IO_OBJECTS);
		1540	$self->save_objects ($uniq, cf::IO_UNIQUES);
		1541	} else {
		1542	$self->save_objects ($save, cf::IO_HEADER | cf::IO_OBJECTS | cf::IO_UNIQUES);
		1543	}
		1544	}
		1545
		1546	sub swap_out {
		1547	my ($self) = @_;
		1548
		1549	# save first because save cedes
		1550	$self->save;
		1551
		1552	my $lock = cf::lock_acquire "map_data:" . $self->path;
		1553
		1554	return if $self->players;
		1555	return if $self->in_memory != cf::MAP_IN_MEMORY;
		1556	return if $self->{deny_save};
		1557
		1558	$self->clear;
		1559	$self->in_memory (cf::MAP_SWAPPED);
		1560	}
		1561
		1562	sub reset_at {
		1563	my ($self) = @_;
		1564
		1565	# TODO: safety, remove and allow resettable per-player maps
		1566	return 1e99 if $self->{path}{user_rel};
		1567	return 1e99 if $self->{deny_reset};
		1568
		1569	my $time = $self->fixed_resettime ? $self->{instantiate_time} : $self->last_access;
		1570	my $to = List::Util::min $MAX_RESET, $self->reset_timeout || $DEFAULT_RESET;
		1571
		1572	$time + $to
		1573	}
		1574
		1575	sub should_reset {
		1576	my ($self) = @_;
		1577
		1578	$self->reset_at <= $cf::RUNTIME
		1579	}
		1580
		1581	sub unlink_save {
		1582	my ($self) = @_;
		1583
		1584	utf8::encode (my $save = $self->{path}->save_path);
		1585	aioreq_pri 3; IO::AIO::aio_unlink $save;
		1586	aioreq_pri 3; IO::AIO::aio_unlink "$save.pst";
		1587	}
		1588
		1589	sub rename {
		1590	my ($self, $new_path) = @_;
		1591
		1592	$self->unlink_save;
		1593
		1594	delete $cf::MAP{$self->path};
		1595	$self->{path} = new cf::path $new_path;
		1596	$self->path ($self->{path}->as_string);
		1597	$cf::MAP{$self->path} = $self;
		1598
		1599	$self->save;
		1600	}
		1601
		1602	sub reset {
		1603	my ($self) = @_;
		1604
		1605	my $lock = cf::lock_acquire "map_data:" . $self->path;
		1606
		1607	return if $self->players;
		1608	return if $self->{path}{user_rel};#d#
		1609
		1610	warn "resetting map ", $self->path;#d#
		1611
		1612	delete $cf::MAP{$self->path};
		1613
		1614	$_->clear_links_to ($self) for values %cf::MAP;
		1615
		1616	$self->unlink_save;
		1617	$self->destroy;
		1618	}
		1619
		1620	my $nuke_counter = "aaaa";
		1621
		1622	sub nuke {
		1623	my ($self) = @_;
		1624
		1625	$self->{deny_save} = 1;
		1626	$self->reset_timeout (1);
		1627	$self->rename ("{nuke}/" . ($nuke_counter++));
		1628	$self->reset; # polite request, might not happen
		1629	}
		1630
		1631	sub customise_for {
		1632	my ($map, $ob) = @_;
		1633
		1634	if ($map->per_player) {
		1635	return cf::map::find "~" . $ob->name . "/" . $map->{path}{path};
		1636	}
		1637
		1638	$map
		1639	}
		1640
		1641	=item cf::map::unique_maps
		1642
		1643	Returns an arrayref of cf::path's of all shared maps that have
		1644	instantiated unique items. May block.
		1645
		1646	=cut
		1647
		1648	sub unique_maps() {
		1649	my $files = aio_readdir cf::localdir . "/" . cf::uniquedir
		1650	or return;
		1651
		1652	my @paths;
		1653
		1654	for (@$files) {
		1655	utf8::decode $_;
		1656	next if /\.pst$/;
		1657	next unless /^$PATH_SEP/o;
		1658
		1659	push @paths, new cf::path $_;
		1660	}
		1661
		1662	\@paths
		1663	}
		1664
		1665	package cf;
		1666
		1667	=back
		1668
		1669	=head3 cf::object
		1670
		1671	=cut
		1672
		1673	package cf::object;
770		1674
771	=over 4	1675	=over 4
772		1676
773	=item cf::player::exists $login	1677	=item $ob->inv_recursive
774		1678
775	Returns true when the given account exists.	1679	Returns the inventory of the object _and_ their inventories, recursively.
776		1680
777	=cut	1681	=cut
778		1682
779	sub cf::player::exists($) {	1683	sub inv_recursive_;
780	cf::player::find $_[0]	1684	sub inv_recursive_ {
781	or -f sprintf "%s/%s/%s/%s.pl", cf::localdir, cf::playerdir, ($_[0]) x 2;	1685	map { $_, inv_recursive_ $_->inv } @_
782	}	1686	}
		1687
		1688	sub inv_recursive {
		1689	inv_recursive_ inv $_[0]
		1690	}
		1691
		1692	package cf;
		1693
		1694	=back
		1695
		1696	=head3 cf::object::player
		1697
		1698	=over 4
783		1699
784	=item $player_object->reply ($npc, $msg[, $flags])	1700	=item $player_object->reply ($npc, $msg[, $flags])
785		1701
786	Sends a message to the player, as if the npc C<$npc> replied. C<$npc>	1702	Sends a message to the player, as if the npc C<$npc> replied. C<$npc>
787	can be C<undef>. Does the right thing when the player is currently in a	1703	can be C<undef>. Does the right thing when the player is currently in a
…		…
789		1705
790	=cut	1706	=cut
791		1707
792	# rough implementation of a future "reply" method that works	1708	# rough implementation of a future "reply" method that works
793	# with dialog boxes.	1709	# with dialog boxes.
		1710	#TODO: the first argument must go, split into a $npc->reply_to ( method
794	sub cf::object::player::reply($$$;$) {	1711	sub cf::object::player::reply($$$;$) {
795	my ($self, $npc, $msg, $flags) = @_;	1712	my ($self, $npc, $msg, $flags) = @_;
796		1713
797	$flags = cf::NDI_BROWN | cf::NDI_UNIQUE unless @_ >= 4;	1714	$flags = cf::NDI_BROWN | cf::NDI_UNIQUE unless @_ >= 4;
798		1715
…		…
802	$msg = $npc->name . " says: $msg" if $npc;	1719	$msg = $npc->name . " says: $msg" if $npc;
803	$self->message ($msg, $flags);	1720	$self->message ($msg, $flags);
804	}	1721	}
805	}	1722	}
806		1723
807	=item $player->ext_reply ($msgid, $msgtype, %msg)
808
809	Sends an ext reply to the player.
810
811	=cut
812
813	sub cf::player::ext_reply($$$%) {
814	my ($self, $id, %msg) = @_;
815
816	$msg{msgid} = $id;
817
818	$self->send ("ext " . to_json \%msg);
819	}
820
821	=item $player_object->may ("access")	1724	=item $player_object->may ("access")
822		1725
823	Returns wether the given player is authorized to access resource "access"	1726	Returns wether the given player is authorized to access resource "access"
824	(e.g. "command_wizcast").	1727	(e.g. "command_wizcast").
825		1728
…		…
832	(ref $cf::CFG{"may_$access"}	1735	(ref $cf::CFG{"may_$access"}
833	? scalar grep $self->name eq $_, @{$cf::CFG{"may_$access"}}	1736	? scalar grep $self->name eq $_, @{$cf::CFG{"may_$access"}}
834	: $cf::CFG{"may_$access"})	1737	: $cf::CFG{"may_$access"})
835	}	1738	}
836		1739
837	=cut	1740	=item $player_object->enter_link
838		1741
839	#############################################################################	1742	Freezes the player and moves him/her to a special map (C<{link}>).
		1743
		1744	The player should be reaosnably safe there for short amounts of time. You
		1745	I<MUST> call C<leave_link> as soon as possible, though.
		1746
		1747	=item $player_object->leave_link ($map, $x, $y)
		1748
		1749	Moves the player out of the specila link map onto the given map. If the
		1750	map is not valid (or omitted), the player will be moved back to the
		1751	location he/she was before the call to C<enter_link>, or, if that fails,
		1752	to the emergency map position.
		1753
		1754	Might block.
		1755
		1756	=cut
		1757
		1758	sub cf::object::player::enter_link {
		1759	my ($self) = @_;
		1760
		1761	$self->deactivate_recursive;
		1762
		1763	return if $self->map == $LINK_MAP;
		1764
		1765	$self->{_link_pos} ||= [$self->map->{path}, $self->x, $self->y]
		1766	if $self->map;
		1767
		1768	$self->enter_map ($LINK_MAP, 20, 20);
		1769	}
		1770
		1771	sub cf::object::player::leave_link {
		1772	my ($self, $map, $x, $y) = @_;
		1773
		1774	my $link_pos = delete $self->{_link_pos};
		1775
		1776	unless ($map) {
		1777	# restore original map position
		1778	($map, $x, $y) = @{ $link_pos || [] };
		1779	$map = cf::map::find $map;
		1780
		1781	unless ($map) {
		1782	($map, $x, $y) = @$EMERGENCY_POSITION;
		1783	$map = cf::map::find $map
		1784	or die "FATAL: cannot load emergency map\n";
		1785	}
		1786	}
		1787
		1788	($x, $y) = (-1, -1)
		1789	unless (defined $x) && (defined $y);
		1790
		1791	# use -1 or undef as default coordinates, not 0, 0
		1792	($x, $y) = ($map->enter_x, $map->enter_y)
		1793	if $x <=0 && $y <= 0;
		1794
		1795	$map->load;
		1796	$map->load_diag;
		1797
		1798	return unless $self->contr->active;
		1799	$self->activate_recursive;
		1800	$self->enter_map ($map, $x, $y);
		1801	}
		1802
		1803	cf::player->attach (
		1804	on_logout => sub {
		1805	my ($pl) = @_;
		1806
		1807	# abort map switching before logout
		1808	if ($pl->ob->{_link_pos}) {
		1809	cf::sync_job {
		1810	$pl->ob->leave_link
		1811	};
		1812	}
		1813	},
		1814	on_login => sub {
		1815	my ($pl) = @_;
		1816
		1817	# try to abort aborted map switching on player login :)
		1818	# should happen only on crashes
		1819	if ($pl->ob->{_link_pos}) {
		1820	$pl->ob->enter_link;
		1821	(async {
		1822	# we need this sleep as the login has a concurrent enter_exit running
		1823	# and this sleep increases chances of the player not ending up in scorn
		1824	$pl->ob->reply (undef,
		1825	"There was an internal problem at your last logout, "
		1826	. "the server will try to bring you to your intended destination in a second.",
		1827	cf::NDI_RED);
		1828	Coro::Timer::sleep 1;
		1829	$pl->ob->leave_link;
		1830	})->prio (2);
		1831	}
		1832	},
		1833	);
		1834
		1835	=item $player_object->goto ($path, $x, $y)
		1836
		1837	=cut
		1838
		1839	sub cf::object::player::goto {
		1840	my ($self, $path, $x, $y) = @_;
		1841
		1842	$path = new cf::path $path;
		1843
		1844	$self->enter_link;
		1845
		1846	(async {
		1847	my $map = cf::map::find $path->as_string;
		1848	$map = $map->customise_for ($self) if $map;
		1849
		1850	# warn "entering ", $map->path, " at ($x, $y)\n"
		1851	# if $map;
		1852
		1853	$map or $self->message ("The exit to '" . ($path->visible_name) . "' is closed", cf::NDI_UNIQUE | cf::NDI_RED);
		1854
		1855	$self->leave_link ($map, $x, $y);
		1856	})->prio (1);
		1857	}
		1858
		1859	=item $player_object->enter_exit ($exit_object)
		1860
		1861	=cut
		1862
		1863	sub parse_random_map_params {
		1864	my ($spec) = @_;
		1865
		1866	my $rmp = { # defaults
		1867	xsize => 10,
		1868	ysize => 10,
		1869	};
		1870
		1871	for (split /\n/, $spec) {
		1872	my ($k, $v) = split /\s+/, $_, 2;
		1873
		1874	$rmp->{lc $k} = $v if (length $k) && (length $v);
		1875	}
		1876
		1877	$rmp
		1878	}
		1879
		1880	sub prepare_random_map {
		1881	my ($exit) = @_;
		1882
		1883	# all this does is basically replace the /! path by
		1884	# a new random map path (?random/...) with a seed
		1885	# that depends on the exit object
		1886
		1887	my $rmp = parse_random_map_params $exit->msg;
		1888
		1889	if ($exit->map) {
		1890	$rmp->{region} = $exit->map->region_name;
		1891	$rmp->{origin_map} = $exit->map->path;
		1892	$rmp->{origin_x} = $exit->x;
		1893	$rmp->{origin_y} = $exit->y;
		1894	}
		1895
		1896	$rmp->{random_seed} ||= $exit->random_seed;
		1897
		1898	my $data = cf::to_json $rmp;
		1899	my $md5 = Digest::MD5::md5_hex $data;
		1900
		1901	if (my $fh = aio_open "$cf::RANDOM_MAPS/$md5.meta", O_WRONLY | O_CREAT, 0666) {
		1902	aio_write $fh, 0, (length $data), $data, 0;
		1903
		1904	$exit->slaying ("?random/$md5");
		1905	$exit->msg (undef);
		1906	}
		1907	}
		1908
		1909	sub cf::object::player::enter_exit {
		1910	my ($self, $exit) = @_;
		1911
		1912	return unless $self->type == cf::PLAYER;
		1913
		1914	$self->enter_link;
		1915
		1916	(async {
		1917	$self->deactivate_recursive; # just to be sure
		1918	unless (eval {
		1919	prepare_random_map $exit
		1920	if $exit->slaying eq "/!";
		1921
		1922	my $path = new cf::path $exit->slaying, $exit->map && $exit->map->path;
		1923	$self->goto ($path, $exit->stats->hp, $exit->stats->sp);
		1924
		1925	1;
		1926	}) {
		1927	$self->message ("Something went wrong deep within the crossfire server. "
		1928	. "I'll try to bring you back to the map you were before. "
		1929	. "Please report this to the dungeon master!",
		1930	cf::NDI_UNIQUE | cf::NDI_RED);
		1931
		1932	warn "ERROR in enter_exit: $@";
		1933	$self->leave_link;
		1934	}
		1935	})->prio (1);
		1936	}
		1937
		1938	=head3 cf::client
		1939
		1940	=over 4
		1941
		1942	=item $client->send_drawinfo ($text, $flags)
		1943
		1944	Sends a drawinfo packet to the client. Circumvents output buffering so
		1945	should not be used under normal circumstances.
		1946
		1947	=cut
		1948
		1949	sub cf::client::send_drawinfo {
		1950	my ($self, $text, $flags) = @_;
		1951
		1952	utf8::encode $text;
		1953	$self->send_packet (sprintf "drawinfo %d %s", $flags, $text);
		1954	}
		1955
		1956
		1957	=item $success = $client->query ($flags, "text", \&cb)
		1958
		1959	Queues a query to the client, calling the given callback with
		1960	the reply text on a reply. flags can be C<cf::CS_QUERY_YESNO>,
		1961	C<cf::CS_QUERY_SINGLECHAR> or C<cf::CS_QUERY_HIDEINPUT> or C<0>.
		1962
		1963	Queries can fail, so check the return code. Or don't, as queries will become
		1964	reliable at some point in the future.
		1965
		1966	=cut
		1967
		1968	sub cf::client::query {
		1969	my ($self, $flags, $text, $cb) = @_;
		1970
		1971	return unless $self->state == ST_PLAYING
		1972	|| $self->state == ST_SETUP
		1973	|| $self->state == ST_CUSTOM;
		1974
		1975	$self->state (ST_CUSTOM);
		1976
		1977	utf8::encode $text;
		1978	push @{ $self->{query_queue} }, [(sprintf "query %d %s", $flags, $text), $cb];
		1979
		1980	$self->send_packet ($self->{query_queue}[0][0])
		1981	if @{ $self->{query_queue} } == 1;
		1982	}
		1983
		1984	cf::client->attach (
		1985	on_reply => sub {
		1986	my ($ns, $msg) = @_;
		1987
		1988	# this weird shuffling is so that direct followup queries
		1989	# get handled first
		1990	my $queue = delete $ns->{query_queue}
		1991	or return; # be conservative, not sure how that can happen, but we saw a crash here
		1992
		1993	(shift @$queue)->[1]->($msg);
		1994
		1995	push @{ $ns->{query_queue} }, @$queue;
		1996
		1997	if (@{ $ns->{query_queue} } == @$queue) {
		1998	if (@$queue) {
		1999	$ns->send_packet ($ns->{query_queue}[0][0]);
		2000	} else {
		2001	$ns->state (ST_PLAYING) if $ns->state == ST_CUSTOM;
		2002	}
		2003	}
		2004	},
		2005	);
		2006
		2007	=item $client->async (\&cb)
		2008
		2009	Create a new coroutine, running the specified callback. The coroutine will
		2010	be automatically cancelled when the client gets destroyed (e.g. on logout,
		2011	or loss of connection).
		2012
		2013	=cut
		2014
		2015	sub cf::client::async {
		2016	my ($self, $cb) = @_;
		2017
		2018	my $coro = &Coro::async ($cb);
		2019
		2020	$coro->on_destroy (sub {
		2021	delete $self->{_coro}{$coro+0};
		2022	});
		2023
		2024	$self->{_coro}{$coro+0} = $coro;
		2025
		2026	$coro
		2027	}
		2028
		2029	cf::client->attach (
		2030	on_destroy => sub {
		2031	my ($ns) = @_;
		2032
		2033	$_->cancel for values %{ (delete $ns->{_coro}) || {} };
		2034	},
		2035	);
		2036
		2037	=back
		2038
840		2039
841	=head2 SAFE SCRIPTING	2040	=head2 SAFE SCRIPTING
842		2041
843	Functions that provide a safe environment to compile and execute	2042	Functions that provide a safe environment to compile and execute
844	snippets of perl code without them endangering the safety of the server	2043	snippets of perl code without them endangering the safety of the server
…		…
859		2058
860	=pod	2059	=pod
861		2060
862	The following fucntions and emthods are available within a safe environment:	2061	The following fucntions and emthods are available within a safe environment:
863		2062
864	cf::object contr pay_amount pay_player	2063	cf::object contr pay_amount pay_player map
865	cf::object::player player	2064	cf::object::player player
866	cf::player peaceful	2065	cf::player peaceful
		2066	cf::map trigger
867		2067
868	=cut	2068	=cut
869		2069
870	for (	2070	for (
871	["cf::object" => qw(contr pay_amount pay_player)],	2071	["cf::object" => qw(contr pay_amount pay_player map)],
872	["cf::object::player" => qw(player)],	2072	["cf::object::player" => qw(player)],
873	["cf::player" => qw(peaceful)],	2073	["cf::player" => qw(peaceful)],
		2074	["cf::map" => qw(trigger)],
874	) {	2075	) {
875	no strict 'refs';	2076	no strict 'refs';
876	my ($pkg, @funs) = @$_;	2077	my ($pkg, @funs) = @$_;
877	*{"safe::$pkg\::$_"} = $safe_hole->wrap (\&{"$pkg\::$_"})	2078	*{"safe::$pkg\::$_"} = $safe_hole->wrap (\&{"$pkg\::$_"})
878	for @funs;	2079	for @funs;
…		…
994		2195
995	{	2196	{
996	my $path = cf::localdir . "/database.pst";	2197	my $path = cf::localdir . "/database.pst";
997		2198
998	sub db_load() {	2199	sub db_load() {
999	warn "loading database $path\n";#d# remove later
1000	$DB = stat $path ? Storable::retrieve $path : { };	2200	$DB = stat $path ? Storable::retrieve $path : { };
1001	}	2201	}
1002		2202
1003	my $pid;	2203	my $pid;
1004		2204
1005	sub db_save() {	2205	sub db_save() {
1006	warn "saving database $path\n";#d# remove later
1007	waitpid $pid, 0 if $pid;	2206	waitpid $pid, 0 if $pid;
1008	if (0 == ($pid = fork)) {	2207	if (0 == ($pid = fork)) {
1009	$DB->{_meta}{version} = 1;	2208	$DB->{_meta}{version} = 1;
1010	Storable::nstore $DB, "$path~";	2209	Storable::nstore $DB, "$path~";
1011	rename "$path~", $path;	2210	rename "$path~", $path;
…		…
1018	sub db_sync() {	2217	sub db_sync() {
1019	db_save if $dirty;	2218	db_save if $dirty;
1020	undef $dirty;	2219	undef $dirty;
1021	}	2220	}
1022		2221
1023	my $idle = Event->idle (min => $TICK * 2.8, max => 10, repeat => 0, cb => sub {	2222	my $idle = Event->idle (min => $TICK * 2.8, max => 10, repeat => 0, data => WF_AUTOCANCEL, cb => sub {
1024	db_sync;	2223	db_sync;
1025	});	2224	});
1026		2225
1027	sub db_dirty() {	2226	sub db_dirty() {
1028	$dirty = 1;	2227	$dirty = 1;
…		…
1042	$DB->{$_[0]} = $_[1];	2241	$DB->{$_[0]} = $_[1];
1043	}	2242	}
1044	db_dirty;	2243	db_dirty;
1045	}	2244	}
1046		2245
1047	attach_global	2246	cf::global->attach (
1048	prio => 10000,	2247	prio => 10000,
1049	on_cleanup => sub {	2248	on_cleanup => sub {
1050	db_sync;	2249	db_sync;
1051	},	2250	},
1052	;	2251	);
1053	}	2252	}
1054		2253
1055	#############################################################################	2254	#############################################################################
1056	# the server's main()	2255	# the server's main()
1057		2256
…		…
1059	open my $fh, "<:utf8", cf::confdir . "/config"	2258	open my $fh, "<:utf8", cf::confdir . "/config"
1060	or return;	2259	or return;
1061		2260
1062	local $/;	2261	local $/;
1063	*CFG = YAML::Syck::Load <$fh>;	2262	*CFG = YAML::Syck::Load <$fh>;
		2263
		2264	$EMERGENCY_POSITION = $CFG{emergency_position} || ["/world/world_105_115", 5, 37];
		2265
		2266	$cf::map::MAX_RESET = $CFG{map_max_reset} if exists $CFG{map_max_reset};
		2267	$cf::map::DEFAULT_RESET = $CFG{map_default_reset} if exists $CFG{map_default_reset};
		2268
		2269	if (exists $CFG{mlockall}) {
		2270	eval {
		2271	$CFG{mlockall} ? eval "mlockall()" : eval "munlockall()"
		2272	and die "WARNING: m(un)lockall failed: $!\n";
		2273	};
		2274	warn $@ if $@;
		2275	}
1064	}	2276	}
1065		2277
1066	sub main {	2278	sub main {
		2279	# we must not ever block the main coroutine
		2280	local $Coro::idle = sub {
		2281	Carp::cluck "FATAL: Coro::idle was called, major BUG, use cf::sync_job!\n";#d#
		2282	async { Event::one_event };
		2283	};
		2284
1067	cfg_load;	2285	cfg_load;
1068	db_load;	2286	db_load;
1069	load_extensions;	2287	load_extensions;
1070	Event::loop;	2288	Event::loop;
1071	}	2289	}
1072		2290
1073	#############################################################################	2291	#############################################################################
1074	# initialisation	2292	# initialisation and cleanup
1075		2293
		2294	# install some emergency cleanup handlers
		2295	BEGIN {
		2296	for my $signal (qw(INT HUP TERM)) {
		2297	Event->signal (
		2298	data => WF_AUTOCANCEL,
		2299	signal => $signal,
		2300	cb => sub {
		2301	cf::cleanup "SIG$signal";
		2302	},
		2303	);
		2304	}
		2305	}
		2306
		2307	sub emergency_save() {
		2308	my $freeze_guard = cf::freeze_mainloop;
		2309
		2310	warn "enter emergency perl save\n";
		2311
		2312	cf::sync_job {
		2313	# use a peculiar iteration method to avoid tripping on perl
		2314	# refcount bugs in for. also avoids problems with players
		2315	# and maps saved/Destroyed asynchronously.
		2316	warn "begin emergency player save\n";
		2317	for my $login (keys %cf::PLAYER) {
		2318	my $pl = $cf::PLAYER{$login} or next;
		2319	$pl->valid or next;
		2320	$pl->save;
		2321	}
		2322	warn "end emergency player save\n";
		2323
		2324	warn "begin emergency map save\n";
		2325	for my $path (keys %cf::MAP) {
		2326	my $map = $cf::MAP{$path} or next;
		2327	$map->valid or next;
		2328	$map->save;
		2329	}
		2330	warn "end emergency map save\n";
		2331	};
		2332
		2333	warn "leave emergency perl save\n";
		2334	}
		2335
1076	sub _perl_reload(&) {	2336	sub reload() {
1077	my ($msg) = @_;	2337	# can/must only be called in main
		2338	if ($Coro::current != $Coro::main) {
		2339	warn "can only reload from main coroutine\n";
		2340	return;
		2341	}
1078		2342
1079	$msg->("reloading...");	2343	warn "reloading...";
		2344
		2345	my $guard = freeze_mainloop;
		2346	cf::emergency_save;
1080		2347
1081	eval {	2348	eval {
		2349	# if anything goes wrong in here, we should simply crash as we already saved
		2350
1082	# cancel all watchers	2351	# cancel all watchers
1083	$_->cancel for Event::all_watchers;	2352	for (Event::all_watchers) {
		2353	$_->cancel if $_->data & WF_AUTOCANCEL;
		2354	}
		2355
		2356	# cancel all extension coros
		2357	$_->cancel for values %EXT_CORO;
		2358	%EXT_CORO = ();
1084		2359
1085	# unload all extensions	2360	# unload all extensions
1086	for (@exts) {	2361	for (@exts) {
1087	$msg->("unloading <$_>");	2362	warn "unloading <$_>";
1088	unload_extension $_;	2363	unload_extension $_;
1089	}	2364	}
1090		2365
1091	# unload all modules loaded from $LIBDIR	2366	# unload all modules loaded from $LIBDIR
1092	while (my ($k, $v) = each %INC) {	2367	while (my ($k, $v) = each %INC) {
1093	next unless $v =~ /^\Q$LIBDIR\E\/.*\.pm$/;	2368	next unless $v =~ /^\Q$LIBDIR\E\/.*\.pm$/;
1094		2369
1095	$msg->("removing <$k>");	2370	warn "removing <$k>";
1096	delete $INC{$k};	2371	delete $INC{$k};
1097		2372
1098	$k =~ s/\.pm$//;	2373	$k =~ s/\.pm$//;
1099	$k =~ s/\//::/g;	2374	$k =~ s/\//::/g;
1100		2375
…		…
1105	Symbol::delete_package $k;	2380	Symbol::delete_package $k;
1106	}	2381	}
1107		2382
1108	# sync database to disk	2383	# sync database to disk
1109	cf::db_sync;	2384	cf::db_sync;
		2385	IO::AIO::flush;
1110		2386
1111	# get rid of safe::, as good as possible	2387	# get rid of safe::, as good as possible
1112	Symbol::delete_package "safe::$_"	2388	Symbol::delete_package "safe::$_"
1113	for qw(cf::object cf::object::player cf::player cf::map cf::party cf::region);	2389	for qw(cf::attachable cf::object cf::object::player cf::client cf::player cf::map cf::party cf::region);
1114		2390
1115	# remove register_script_function callbacks	2391	# remove register_script_function callbacks
1116	# TODO	2392	# TODO
1117		2393
1118	# unload cf.pm "a bit"	2394	# unload cf.pm "a bit"
…		…
1121	# don't, removes xs symbols, too,	2397	# don't, removes xs symbols, too,
1122	# and global variables created in xs	2398	# and global variables created in xs
1123	#Symbol::delete_package __PACKAGE__;	2399	#Symbol::delete_package __PACKAGE__;
1124		2400
1125	# reload cf.pm	2401	# reload cf.pm
1126	$msg->("reloading cf.pm");	2402	warn "reloading cf.pm";
1127	require cf;	2403	require cf;
		2404	cf::_connect_to_perl; # nominally unnecessary, but cannot hurt
1128		2405
1129	# load config and database again	2406	# load config and database again
1130	cf::cfg_load;	2407	cf::cfg_load;
1131	cf::db_load;	2408	cf::db_load;
1132		2409
1133	# load extensions	2410	# load extensions
1134	$msg->("load extensions");	2411	warn "load extensions";
1135	cf::load_extensions;	2412	cf::load_extensions;
1136		2413
1137	# reattach attachments to objects	2414	# reattach attachments to objects
1138	$msg->("reattach");	2415	warn "reattach";
1139	_global_reattach;	2416	_global_reattach;
		2417	reattach $_ for values %MAP;
1140	};	2418	};
1141	$msg->($@) if $@;
1142		2419
1143	$msg->("reloaded");	2420	if ($@) {
		2421	warn $@;
		2422	warn "error while reloading, exiting.";
		2423	exit 1;
		2424	}
		2425
		2426	warn "reloaded successfully";
1144	};	2427	};
1145		2428
1146	sub perl_reload() {	2429	#############################################################################
1147	_perl_reload {	2430
1148	warn $_[0];	2431	unless ($LINK_MAP) {
1149	print "$_[0]\n";	2432	$LINK_MAP = cf::map::new;
1150	};	2433
		2434	$LINK_MAP->width (41);
		2435	$LINK_MAP->height (41);
		2436	$LINK_MAP->alloc;
		2437	$LINK_MAP->path ("{link}");
		2438	$LINK_MAP->{path} = bless { path => "{link}" }, "cf::path";
		2439	$LINK_MAP->in_memory (MAP_IN_MEMORY);
		2440
		2441	# dirty hack because... archetypes are not yet loaded
		2442	Event->timer (
		2443	after => 10,
		2444	cb => sub {
		2445	$_[0]->w->cancel;
		2446
		2447	# provide some exits "home"
		2448	my $exit = cf::object::new "exit";
		2449
		2450	$exit->slaying ($EMERGENCY_POSITION->[0]);
		2451	$exit->stats->hp ($EMERGENCY_POSITION->[1]);
		2452	$exit->stats->sp ($EMERGENCY_POSITION->[2]);
		2453
		2454	$LINK_MAP->insert ($exit->clone, 19, 19);
		2455	$LINK_MAP->insert ($exit->clone, 19, 20);
		2456	$LINK_MAP->insert ($exit->clone, 19, 21);
		2457	$LINK_MAP->insert ($exit->clone, 20, 19);
		2458	$LINK_MAP->insert ($exit->clone, 20, 21);
		2459	$LINK_MAP->insert ($exit->clone, 21, 19);
		2460	$LINK_MAP->insert ($exit->clone, 21, 20);
		2461	$LINK_MAP->insert ($exit->clone, 21, 21);
		2462
		2463	$exit->destroy;
		2464	});
		2465
		2466	$LINK_MAP->{deny_save} = 1;
		2467	$LINK_MAP->{deny_reset} = 1;
		2468
		2469	$cf::MAP{$LINK_MAP->path} = $LINK_MAP;
1151	}	2470	}
1152		2471
1153	register "<global>", __PACKAGE__;	2472	register "<global>", __PACKAGE__;
1154		2473
1155	register_command "perl-reload" => sub {	2474	register_command "reload" => sub {
1156	my ($who, $arg) = @_;	2475	my ($who, $arg) = @_;
1157		2476
1158	if ($who->flag (FLAG_WIZ)) {	2477	if ($who->flag (FLAG_WIZ)) {
1159	_perl_reload {	2478	$who->message ("start of reload.");
1160	warn $_[0];	2479	reload;
1161	$who->message ($_[0]);	2480	$who->message ("end of reload.");
1162	};
1163	}	2481	}
1164	};	2482	};
1165		2483
1166	unshift @INC, $LIBDIR;	2484	unshift @INC, $LIBDIR;
1167		2485
1168	$TICK_WATCHER = Event->timer (	2486	$TICK_WATCHER = Event->timer (
		2487	reentrant => 0,
1169	prio => 1,	2488	prio => 0,
1170	async => 1,
1171	at => $NEXT_TICK || 1,	2489	at => $NEXT_TICK || $TICK,
		2490	data => WF_AUTOCANCEL,
1172	cb => sub {	2491	cb => sub {
1173	cf::server_tick; # one server iteration	2492	cf::server_tick; # one server iteration
1174		2493	$RUNTIME += $TICK;
1175	my $NOW = Event::time;
1176	$NEXT_TICK += $TICK;	2494	$NEXT_TICK += $TICK;
1177		2495
		2496	$WAIT_FOR_TICK->broadcast;
		2497	$WAIT_FOR_TICK_ONE->send if $WAIT_FOR_TICK_ONE->awaited;
		2498
1178	# if we are delayed by four ticks or more, skip them all	2499	# if we are delayed by four ticks or more, skip them all
1179	$NEXT_TICK = $NOW if $NOW >= $NEXT_TICK + $TICK * 4;	2500	$NEXT_TICK = Event::time if Event::time >= $NEXT_TICK + $TICK * 4;
1180		2501
1181	$TICK_WATCHER->at ($NEXT_TICK);	2502	$TICK_WATCHER->at ($NEXT_TICK);
1182	$TICK_WATCHER->start;	2503	$TICK_WATCHER->start;
1183	},	2504	},
1184	);	2505	);
1185		2506
1186	IO::AIO::max_poll_time $TICK * 0.2;	2507	IO::AIO::max_poll_time $TICK * 0.2;
1187		2508
		2509	Event->io (
1188	Event->io (fd => IO::AIO::poll_fileno,	2510	fd => IO::AIO::poll_fileno,
1189	poll => 'r',	2511	poll => 'r',
1190	prio => 5,	2512	prio => 5,
		2513	data => WF_AUTOCANCEL,
1191	cb => \&IO::AIO::poll_cb);	2514	cb => \&IO::AIO::poll_cb,
		2515	);
		2516
		2517	Event->timer (
		2518	data => WF_AUTOCANCEL,
		2519	after => 0,
		2520	interval => 10,
		2521	cb => sub {
		2522	(Coro::unblock_sub {
		2523	write_runtime
		2524	or warn "ERROR: unable to write runtime file: $!";
		2525	})->();
		2526	},
		2527	);
		2528
		2529	END { cf::emergency_save }
1192		2530
1193	1	2531	1
1194		2532

Diff Legend

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