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.44 by root, Sat Aug 26 08:44:06 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;
		23	use IO::AIO 2.32 ();
		24	use YAML::Syck ();
10	use Time::HiRes;	25	use Time::HiRes;
11	use Event;	26
12	$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
13		28
14	use strict;	29	sub WF_AUTOCANCEL () { 1 } # automatically cancel this watcher on reload
15		30
		31	# work around bug in YAML::Syck - bad news for perl6, will it be as broken wrt. unicode?
		32	$YAML::Syck::ImplicitUnicode = 1;
		33
		34	$Coro::main->prio (Coro::PRIO_MAX); # run main coroutine ("the server") with very high priority
		35
16	our %COMMAND = ();	36	our %COMMAND = ();
		37	our %COMMAND_TIME = ();
		38	our %EXTCMD = ();
		39
17	our @EVENT;	40	our @EVENT;
18	our @PLUGIN_EVENT;	41	our $LIBDIR = datadir . "/ext";
19	our %PROP_TYPE;
20	our %PROP_IDX;
21	our $LIBDIR = maps_directory "perl";
22		42
23	our $TICK = MAX_TIME * 1e-6;	43	our $TICK = MAX_TIME * 1e-6;
24	our $TICK_WATCHER;	44	our $TICK_WATCHER;
25	our $NEXT_TICK;	45	our $NEXT_TICK;
		46	our $NOW;
		47
		48	our %CFG;
		49
		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;
		81
		82	#############################################################################
		83
		84	=head2 GLOBAL VARIABLES
		85
		86	=over 4
		87
		88	=item $cf::UPTIME
		89
		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.
		96
		97	=item $cf::LIBDIR
		98
		99	The perl library directory, where extensions and cf-specific modules can
		100	be found. It will be added to C<@INC> automatically.
		101
		102	=item $cf::NOW
		103
		104	The time of the last (current) server tick.
		105
		106	=item $cf::TICK
		107
		108	The interval between server ticks, in seconds.
		109
		110	=item %cf::CFG
		111
		112	Configuration for the server, loaded from C</etc/crossfire/config>, or
		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.
		121
		122	=back
		123
		124	=cut
26		125
27	BEGIN {	126	BEGIN {
28	@PLUGIN_EVENT = map lc, @PLUGIN_EVENT;
29
30	*CORE::GLOBAL::warn = sub {	127	*CORE::GLOBAL::warn = sub {
31	my $msg = join "", @_;	128	my $msg = join "", @_;
		129	utf8::encode $msg;
		130
32	$msg .= "\n"	131	$msg .= "\n"
33	unless $msg =~ /\n$/;	132	unless $msg =~ /\n$/;
34		133
35	print STDERR "cfperl: $msg";
36	LOG llevError, "cfperl: $msg";	134	LOG llevError, $msg;
37	};	135	};
38	}	136	}
39		137
40	my %ignore_set = (MAP_PROP_PATH => 1); # I hate the plug-in api. Deeply!	138	@safe::cf::global::ISA = @cf::global::ISA = 'cf::attachable';
41		139	@safe::cf::object::ISA = @cf::object::ISA = 'cf::attachable';
42	# generate property mutators	140	@safe::cf::player::ISA = @cf::player::ISA = 'cf::attachable';
43	sub prop_gen {	141	@safe::cf::client::ISA = @cf::client::ISA = 'cf::attachable';
44	my ($prefix, $class) = @_;	142	@safe::cf::map::ISA = @cf::map::ISA = 'cf::attachable';
45
46	no strict 'refs';
47
48	for my $prop (keys %PROP_TYPE) {
49	$prop =~ /^\Q$prefix\E_(.*$)/ or next;
50	my $sub = lc $1;
51
52	my $type = $PROP_TYPE{$prop};
53	my $idx = $PROP_IDX {$prop};
54
55	*{"$class\::get_$sub"} = *{"$class\::$sub"} = sub {
56	$_[0]->get_property ($type, $idx)
57	};
58
59	*{"$class\::set_$sub"} = sub {
60	$_[0]->set_property ($type, $idx, $_[1]);
61	} unless $ignore_set{$prop};
62	}
63	}
64
65	# auto-generate most of the API
66
67	prop_gen OBJECT_PROP => "cf::object";
68	# CFAPI_OBJECT_ANIMATION?
69	prop_gen PLAYER_PROP => "cf::object::player";
70
71	prop_gen MAP_PROP => "cf::map";
72	prop_gen ARCH_PROP => "cf::arch";
73
74	# guessed hierarchies
75
76	@safe::cf::object::player::ISA = @cf::object::player::ISA = 'cf::object';	143	@safe::cf::object::player::ISA = @cf::object::player::ISA = 'cf::object';
77	@safe::cf::object::map::ISA = @cf::object::map::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::map cf::object::player cf::player cf::map cf::party cf::region cf::arch)) {	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 {
…		…
88	};	160	};
89		161
90	my %ext_pkg;	162	my %ext_pkg;
91	my @exts;	163	my @exts;
92	my @hook;	164	my @hook;
93	my %command;	165
94	my %extcmd;	166	=head2 UTILITY FUNCTIONS
		167
		168	=over 4
		169
		170	=item dumpval $ref
		171
		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	}
		192
		193	use JSON::Syck (); # TODO# replace by JSON::PC once working
		194
		195	=item $ref = cf::from_json $json
		196
		197	Converts a JSON string into the corresponding perl data structure.
		198
		199	=cut
		200
		201	sub from_json($) {
		202	$JSON::Syck::ImplicitUnicode = 1; # work around JSON::Syck bugs
		203	JSON::Syck::Load $_[0]
		204	}
		205
		206	=item $json = cf::to_json $ref
		207
		208	Converts a perl data structure into its JSON representation.
		209
		210	=cut
		211
		212	sub to_json($) {
		213	$JSON::Syck::ImplicitUnicode = 0; # work around JSON::Syck bugs
		214	JSON::Syck::Dump $_[0]
		215	}
		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
		364	=back
		365
		366	=cut
95		367
96	#############################################################################	368	#############################################################################
97	# object support
98		369
99	sub reattach {	370	package cf::path;
100	warn "reattach<@_>\n";
101	}
102		371
103	sub instantiate {	372	use overload
104	warn "instantiate<@_>\n";	373	'""' => \&as_string;
105	}
106		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
107	sub clone {	378	sub new {
108	warn "clone<@_>\n";	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
109	}	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;
110		494
111	#############################################################################	495	#############################################################################
112	# "new" plug-in system
113		496
114	=item cf::object::attach ... # NYI	497	=head2 ATTACHABLE OBJECTS
115		498
116	=item cf::attach_global ...	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.
117		502
118	=item cf::attach_to_type ...	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+).
119		506
120	=item cf::attach_to_objects ...	507	=over 4
121		508
122	=item cf::attach_to_players ...	509	=item $attachable->attach ($attachment, key => $value...)
123		510
124	=item cf::attach_to_maps ...	511	=item $attachable->detach ($attachment)
125		512
126	prio => $number, # lower is earlier	513	Attach/detach a pre-registered attachment to a specific object and give it
127	on_xxx => \&cb,	514	the specified key/value pairs as arguments.
		515
		516	Example, attach a minesweeper attachment to the given object, making it a
		517	10x10 minesweeper game:
		518
		519	$obj->attach (minesweeper => width => 10, height => 10);
		520
		521	=item $bool = $attachable->attached ($name)
		522
		523	Checks wether the named attachment is currently attached to the object.
		524
		525	=item cf::CLASS->attach ...
		526
		527	=item cf::CLASS->detach ...
		528
		529	Define an anonymous attachment and attach it to all objects of the given
		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:
		563
		564	=over 4
		565
		566	=item prio => $number
		567
		568	Set the priority for all following handlers/hooks (unless overwritten
		569	by another C<prio> setting). Lower priority handlers get executed
		570	earlier. The default priority is C<0>, and many built-in handlers are
		571	registered at priority C<-1000>, so lower priorities should not be used
		572	unless you know what you are doing.
		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
		580	=item on_I<event> => \&cb
		581
		582	Call the given code reference whenever the named event happens (event is
		583	something like C<instantiate>, C<apply>, C<use_skill> and so on, and which
		584	handlers are recognised generally depends on the type of object these
		585	handlers attach to).
		586
		587	See F<include/eventinc.h> for the full list of events supported, and their
		588	class.
		589
128	package => package::,	590	=item package => package::
		591
		592	Look for sub functions of the name C<< on_I<event> >> in the given
		593	package and register them. Only handlers for eevents supported by the
		594	object/class are recognised.
		595
		596	=back
		597
		598	Example, define an attachment called "sockpuppet" that calls the given
		599	event handler when a monster attacks:
		600
		601	cf::object::attachment sockpuppet =>
		602	on_skill_attack => sub {
		603	my ($self, $victim) = @_;
		604	...
		605	}
		606	}
		607
		608	=item $attachable->valid
		609
		610	Just because you have a perl object does not mean that the corresponding
		611	C-level object still exists. If you try to access an object that has no
		612	valid C counterpart anymore you get an exception at runtime. This method
		613	can be used to test for existence of the C object part without causing an
		614	exception.
129		615
130	=cut	616	=cut
131		617
132	# the following variables are defined in .xs and must not be re-created	618	# the following variables are defined in .xs and must not be re-created
133	our @CB_GLOBAL = (); # registry for all global events	619	our @CB_GLOBAL = (); # registry for all global events
134	our @CB_OBJECT = ();	620	our @CB_ATTACHABLE = (); # registry for all attachables
		621	our @CB_OBJECT = (); # all objects (should not be used except in emergency)
135	our @CB_PLAYER = ();	622	our @CB_PLAYER = ();
		623	our @CB_CLIENT = ();
136	our @CB_TYPE = (); # registry for type (cf-object class) based events	624	our @CB_TYPE = (); # registry for type (cf-object class) based events
137	our @CB_MAP = ();	625	our @CB_MAP = ();
138		626
		627	my %attachment;
		628
139	sub _attach_cb($\%$$$) {	629	sub _attach_cb($$$$) {
140	my ($registry, $undo, $event, $prio, $cb) = @_;	630	my ($registry, $event, $prio, $cb) = @_;
141		631
142	use sort 'stable';	632	use sort 'stable';
143		633
144	$cb = [$prio, $cb];	634	$cb = [$prio, $cb];
145		635
146	@{$registry->[$event]} = sort	636	@{$registry->[$event]} = sort
147	{ $a->[0] cmp $b->[0] }	637	{ $a->[0] cmp $b->[0] }
148	@{$registry->[$event] || []}, $cb;	638	@{$registry->[$event] || []}, $cb;
149
150	push @{$undo->{cb}}, [$event, $cb];
151	}	639	}
		640
		641	# hack
		642	my %attachable_klass = map +($_ => 1), KLASS_OBJECT, KLASS_CLIENT, KLASS_PLAYER, KLASS_MAP;
152		643
153	# attach handles attaching event callbacks	644	# attach handles attaching event callbacks
154	# the only thing the caller has to do is pass the correct	645	# the only thing the caller has to do is pass the correct
155	# registry (== where the callback attaches to).	646	# registry (== where the callback attaches to).
156	sub _attach(\@$\@) {	647	sub _attach {
157	my ($registry, $klass, $arg) = @_;	648	my ($registry, $klass, @arg) = @_;
158		649
		650	my $object_type;
159	my $prio = 0;	651	my $prio = 0;
160
161	my %undo = (
162	registry => $registry,
163	cb => [],
164	);
165
166	my %cb_id = map +("on_" . lc $EVENT[$_][0], $_) , grep $EVENT[$_][1] == $klass, 0 .. $#EVENT;	652	my %cb_id = map +("on_" . lc $EVENT[$_][0], $_) , grep $EVENT[$_][1] == $klass, 0 .. $#EVENT;
167		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
168	while (@$arg) {	659	while (@arg) {
169	my $type = shift @$arg;	660	my $type = shift @arg;
170		661
171	if ($type eq "prio") {	662	if ($type eq "prio") {
172	$prio = shift @$arg;	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] ||= [];
173		673
174	} elsif ($type eq "package") {	674	} elsif ($type eq "package") {
175	my $pkg = shift @$arg;	675	my $pkg = shift @arg;
176		676
177	while (my ($name, $id) = each %cb_id) {	677	while (my ($name, $id) = each %cb_id) {
178	if (my $cb = $pkg->can ($name)) {	678	if (my $cb = $pkg->can ($name)) {
179	_attach_cb $registry, %undo, $id, $prio, $cb;	679	_attach_cb $registry, $id, $prio, $cb;
180	}	680	}
181	}	681	}
182		682
183	} elsif (exists $cb_id{$type}) {	683	} elsif (exists $cb_id{$type}) {
184	_attach_cb $registry, %undo, $cb_id{$type}, $prio, shift @$arg;	684	_attach_cb $registry, $cb_id{$type}, $prio, shift @arg;
185		685
186	} elsif (ref $type) {	686	} elsif (ref $type) {
187	warn "attaching objects not supported, ignoring.\n";	687	warn "attaching objects not supported, ignoring.\n";
188		688
189	} else {	689	} else {
190	shift @$arg;	690	shift @arg;
191	warn "attach argument '$type' not supported, ignoring.\n";	691	warn "attach argument '$type' not supported, ignoring.\n";
192	}	692	}
193	}	693	}
194
195	\%undo
196	}	694	}
197		695
198	sub cf::object::attach {	696	sub _object_attach {
199	die;	697	my ($obj, $name, %arg) = @_;
200	}
201		698
202	sub attach_global {	699	return if exists $obj->{_attachment}{$name};
203	_attach @CB_GLOBAL, KLASS_GLOBAL, @_
204	}
205		700
206	sub attach_to_type {	701	if (my $attach = $attachment{$name}) {
207	my $type = shift;	702	my $registry = $obj->registry;
208	_attach @{$CB_TYPE[$type]}, KLASS_OBJECT, @_
209	}
210		703
211	sub attach_to_objects {	704	for (@$attach) {
212	_attach @CB_OBJECT, KLASS_OBJECT, @_	705	my ($klass, @attach) = @$_;
213	}	706	_attach $registry, $klass, @attach;
		707	}
214		708
215	sub attach_to_players {	709	$obj->{$name} = \%arg;
216	_attach @CB_PLAYER, KLASS_PLAYER, @_	710	} else {
217	}	711	warn "object uses attachment '$name' that is not available, postponing.\n";
		712	}
218		713
219	sub attach_to_maps {	714	$obj->{_attachment}{$name} = undef;
220	_attach @CB_MAP, KLASS_MAP, @_	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 $@;
221	}	756	}
222		757
223	our $override;	758	our $override;
		759	our @invoke_results = (); # referenced from .xs code. TODO: play tricks with reify and mortals?
224		760
225	sub override() {	761	sub override {
226	$override = 1	762	$override = 1;
		763	@invoke_results = ();
227	}	764	}
228		765
229	sub invoke {	766	sub do_invoke {
230	my $event = shift;	767	my $event = shift;
231	my $callbacks = shift;	768	my $callbacks = shift;
232		769
		770	@invoke_results = ();
		771
233	local $override;	772	local $override;
234		773
235	for (@$callbacks) {	774	for (@$callbacks) {
236	eval { &{$_->[1]} };	775	eval { &{$_->[1]} };
237		776
238	if ($@) {	777	if ($@) {
239	warn "$@";	778	warn "$@";
240	warn "... while processing $EVENT[$event][0] event, skipping processing altogether.\n";	779	warn "... while processing $EVENT[$event][0](@_) event, skipping processing altogether.\n";
241	override;	780	override;
242	}	781	}
243		782
244	return 1 if $override;	783	return 1 if $override;
245	}	784	}
246		785
247	0	786	0
248	}	787	}
249		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
		799	=back
		800
		801	=cut
		802
250	#############################################################################	803	#############################################################################
251	# old plug-in events	804	# object support
252		805
253	sub inject_event {	806	sub reattach {
254	my $extension = shift;	807	# basically do the same as instantiate, without calling instantiate
255	my $event_code = shift;	808	my ($obj) = @_;
256		809
257	my $cb = $hook[$event_code]{$extension}	810	my $registry = $obj->registry;
		811
		812	@$registry = ();
		813
		814	delete $obj->{_attachment} unless scalar keys %{ $obj->{_attachment} || {} };
		815
		816	for my $name (keys %{ $obj->{_attachment} || {} }) {
		817	if (my $attach = $attachment{$name}) {
		818	for (@$attach) {
		819	my ($klass, @attach) = @$_;
		820	_attach $registry, $klass, @attach;
		821	}
		822	} else {
		823	warn "object uses attachment '$name' that is not available, postponing.\n";
		824	}
		825	}
		826	}
		827
		828	cf::attachable->attach (
		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,
		842	on_clone => sub {
		843	my ($src, $dst) = @_;
		844
		845	@{$dst->registry} = @{$src->registry};
		846
		847	%$dst = %$src;
		848
		849	%{$dst->{_attachment}} = %{$src->{_attachment}}
		850	if exists $src->{_attachment};
		851	},
		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
258	or return;	906	or return;
259		907
260	&$cb	908	unless (aio_stat "$filename.pst") {
261	}	909	(aio_load "$filename.pst", $av) >= 0
262
263	sub inject_global_event {
264	my $event = shift;
265
266	my $cb = $hook[$event]
267	or return;	910	or return;
268		911	$av = eval { (Storable::thaw $av)->{objs} };
269	List::Util::max map &$_, values %$cb
270	}
271
272	sub inject_command {
273	my ($name, $obj, $params) = @_;
274
275	for my $cmd (@{ $command{$name} }) {
276	$cmd->[1]->($obj, $params);
277	}	912	}
278		913
279	-1	914	warn sprintf "loading %s (%d)\n",
		915	$filename, length $data, scalar @{$av || []};#d#
		916	return ($data, $av);
280	}	917	}
		918
		919	#############################################################################
		920	# command handling &c
		921
		922	=item cf::register_command $name => \&callback($ob,$args);
		923
		924	Register a callback for execution when the client sends the user command
		925	$name.
		926
		927	=cut
281		928
282	sub register_command {	929	sub register_command {
283	my ($name, $time, $cb) = @_;	930	my ($name, $cb) = @_;
284		931
285	my $caller = caller;	932	my $caller = caller;
286	#warn "registering command '$name/$time' to '$caller'";	933	#warn "registering command '$name/$time' to '$caller'";
287		934
288	push @{ $command{$name} }, [$time, $cb, $caller];	935	push @{ $COMMAND{$name} }, [$caller, $cb];
289	$COMMAND{"$name\000"} = List::Util::max map $_->[0], @{ $command{$name} };
290	}	936	}
		937
		938	=item cf::register_extcmd $name => \&callback($pl,$packet);
		939
		940	Register a callbackf ro execution when the client sends an extcmd packet.
		941
		942	If the callback returns something, it is sent back as if reply was being
		943	called.
		944
		945	=cut
291		946
292	sub register_extcmd {	947	sub register_extcmd {
293	my ($name, $cb) = @_;	948	my ($name, $cb) = @_;
294		949
295	my $caller = caller;	950	my $caller = caller;
296	#warn "registering extcmd '$name' to '$caller'";	951	#warn "registering extcmd '$name' to '$caller'";
297		952
298	$extcmd{$name} = [$cb, $caller];	953	$EXTCMD{$name} = [$cb, $caller];
299	}	954	}
		955
		956	cf::player->attach (
		957	on_command => sub {
		958	my ($pl, $name, $params) = @_;
		959
		960	my $cb = $COMMAND{$name}
		961	or return;
		962
		963	for my $cmd (@$cb) {
		964	$cmd->[1]->($pl->ob, $params);
		965	}
		966
		967	cf::override;
		968	},
		969	on_extcmd => sub {
		970	my ($pl, $buf) = @_;
		971
		972	my $msg = eval { from_json $buf };
		973
		974	if (ref $msg) {
		975	if (my $cb = $EXTCMD{$msg->{msgtype}}) {
		976	if (my %reply = $cb->[0]->($pl, $msg)) {
		977	$pl->ext_reply ($msg->{msgid}, %reply);
		978	}
		979	}
		980	} else {
		981	warn "player " . ($pl->ob->name) . " sent unparseable ext message: <$buf>\n";
		982	}
		983
		984	cf::override;
		985	},
		986	);
300		987
301	sub register {	988	sub register {
302	my ($base, $pkg) = @_;	989	my ($base, $pkg) = @_;
303		990
304	for my $idx (0 .. $#PLUGIN_EVENT) {	991	#TODO
305	if (my $ref = $pkg->can ("on_$PLUGIN_EVENT[$idx]")) {
306	#warn "registering $PLUGIN_EVENT[$idx] hook to '$pkg'\n";
307	$hook[$idx]{$base} = $ref;
308	}
309	}
310	}	992	}
311		993
312	sub load_extension {	994	sub load_extension {
313	my ($path) = @_;	995	my ($path) = @_;
314		996
…		…
328	. "#line 1 \"$path\"\n{\n"	1010	. "#line 1 \"$path\"\n{\n"
329	. (do { local $/; <$fh> })	1011	. (do { local $/; <$fh> })
330	. "\n};\n1";	1012	. "\n};\n1";
331		1013
332	eval $source	1014	eval $source
333	or die "$path: $@";	1015	or die $@ ? "$path: $@\n"
		1016	: "extension disabled.\n";
334		1017
335	push @exts, $pkg;	1018	push @exts, $pkg;
336	$ext_pkg{$base} = $pkg;	1019	$ext_pkg{$base} = $pkg;
337		1020
338	# no strict 'refs';	1021	# no strict 'refs';
…		…
345	my ($pkg) = @_;	1028	my ($pkg) = @_;
346		1029
347	warn "removing extension $pkg\n";	1030	warn "removing extension $pkg\n";
348		1031
349	# remove hooks	1032	# remove hooks
		1033	#TODO
350	for my $idx (0 .. $#PLUGIN_EVENT) {	1034	# for my $idx (0 .. $#PLUGIN_EVENT) {
351	delete $hook[$idx]{$pkg};	1035	# delete $hook[$idx]{$pkg};
352	}	1036	# }
353		1037
354	# remove commands	1038	# remove commands
355	for my $name (keys %command) {	1039	for my $name (keys %COMMAND) {
356	my @cb = grep $_->[2] ne $pkg, @{ $command{$name} };	1040	my @cb = grep $_->[0] ne $pkg, @{ $COMMAND{$name} };
357		1041
358	if (@cb) {	1042	if (@cb) {
359	$command{$name} = \@cb;	1043	$COMMAND{$name} = \@cb;
360	$COMMAND{"$name\000"} = List::Util::max map $_->[0], @cb;
361	} else {	1044	} else {
362	delete $command{$name};
363	delete $COMMAND{"$name\000"};	1045	delete $COMMAND{$name};
364	}	1046	}
365	}	1047	}
366		1048
367	# remove extcmds	1049	# remove extcmds
368	for my $name (grep $extcmd{$_}[1] eq $pkg, keys %extcmd) {	1050	for my $name (grep $EXTCMD{$_}[1] eq $pkg, keys %EXTCMD) {
369	delete $extcmd{$name};	1051	delete $EXTCMD{$name};
370	}	1052	}
371		1053
372	if (my $cb = $pkg->can ("unload")) {	1054	if (my $cb = $pkg->can ("unload")) {
373	eval {	1055	eval {
374	$cb->($pkg);	1056	$cb->($pkg);
…		…
378		1060
379	Symbol::delete_package $pkg;	1061	Symbol::delete_package $pkg;
380	}	1062	}
381		1063
382	sub load_extensions {	1064	sub load_extensions {
383	my $LIBDIR = maps_directory "perl";
384
385	for my $ext (<$LIBDIR/*.ext>) {	1065	for my $ext (<$LIBDIR/*.ext>) {
386	next unless -r $ext;	1066	next unless -r $ext;
387	eval {	1067	eval {
388	load_extension $ext;	1068	load_extension $ext;
389	1	1069	1
390	} or warn "$ext not loaded: $@";	1070	} or warn "$ext not loaded: $@";
391	}	1071	}
392	}	1072	}
393		1073
394	sub _perl_reload(&) {
395	my ($msg) = @_;
396
397	$msg->("reloading...");
398
399	eval {
400	# 1. cancel all watchers
401	$_->cancel for Event::all_watchers;
402
403	# 2. unload all extensions
404	for (@exts) {
405	$msg->("unloading <$_>");
406	unload_extension $_;
407	}
408
409	# 3. unload all modules loaded from $LIBDIR
410	while (my ($k, $v) = each %INC) {
411	next unless $v =~ /^\Q$LIBDIR\E\/.*\.pm$/;
412
413	$msg->("removing <$k>");
414	delete $INC{$k};
415
416	$k =~ s/\.pm$//;
417	$k =~ s/\//::/g;
418
419	if (my $cb = $k->can ("unload_module")) {
420	$cb->();
421	}
422
423	Symbol::delete_package $k;
424	}
425
426	# 4. get rid of safe::, as good as possible
427	Symbol::delete_package "safe::$_"
428	for qw(cf::object cf::object::map cf::object::player cf::player cf::map cf::party cf::region);
429
430	# 5. remove register_script_function callbacks
431	# TODO
432
433	# 6. unload cf.pm "a bit"
434	delete $INC{"cf.pm"};
435
436	# don't, removes xs symbols, too,
437	# and global variables created in xs
438	#Symbol::delete_package __PACKAGE__;
439
440	# 7. reload cf.pm
441	$msg->("reloading cf.pm");
442	require cf;
443	};
444	$msg->($@) if $@;
445
446	$msg->("reloaded");
447	};
448
449	sub perl_reload() {
450	_perl_reload {
451	warn $_[0];
452	print "$_[0]\n";
453	};
454	}
455
456	register_command "perl-reload", 0, sub {
457	my ($who, $arg) = @_;
458
459	if ($who->flag (FLAG_WIZ)) {
460	_perl_reload {
461	warn $_[0];
462	$who->message ($_[0]);
463	};
464	}
465	};
466
467	#############################################################################
468	# utility functions
469
470	use JSON::Syck (); # TODO# replace by JSON::PC once working
471
472	sub from_json($) {
473	$JSON::Syck::ImplicitUnicode = 1; # work around JSON::Syck bugs
474	JSON::Syck::Load $_[0]
475	}
476
477	sub to_json($) {
478	$JSON::Syck::ImplicitUnicode = 0; # work around JSON::Syck bugs
479	JSON::Syck::Dump $_[0]
480	}
481
482	#############################################################################
483	# extcmd framework, basically convert ext <msg>
484	# into pkg::->on_extcmd_arg1 (...) while shortcutting a few
485
486	attach_to_players
487	on_extcmd => sub {
488	my ($pl, $buf) = @_;
489
490	my $msg = eval { from_json $buf };
491
492	if (ref $msg) {
493	if (my $cb = $extcmd{$msg->{msgtype}}) {
494	if (my %reply = $cb->[0]->($pl, $msg)) {
495	$pl->ext_reply ($msg->{msgid}, %reply);
496	}
497	}
498	} else {
499	warn "player " . ($pl->ob->name) . " sent unparseable ext message: <$buf>\n";
500	}
501
502	cf::override;
503	},
504	;
505
506	#############################################################################	1074	#############################################################################
507	# load/save/clean perl data associated with a map	1075	# load/save/clean perl data associated with a map
508		1076
509	*cf::mapsupport::on_clean = sub {	1077	*cf::mapsupport::on_clean = sub {
510	my ($map) = @_;	1078	my ($map) = @_;
511		1079
512	my $path = $map->tmpname;	1080	my $path = $map->tmpname;
513	defined $path or return;	1081	defined $path or return;
514		1082
515	unlink "$path.cfperl";	1083	unlink "$path.pst";
516	};	1084	};
517		1085
518	*cf::mapsupport::on_swapin =	1086	cf::map->attach (prio => -10000, package => cf::mapsupport::);
519	*cf::mapsupport::on_load = sub {	1087
		1088	#############################################################################
		1089
		1090	=head2 CORE EXTENSIONS
		1091
		1092	Functions and methods that extend core crossfire objects.
		1093
		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($) {
		1320	my ($path) = @_;
		1321
		1322	utf8::encode $path;
		1323	aio_open $path, O_RDONLY, 0
		1324	or return;
		1325
		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;
		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};
		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
		1397	}
		1398	}
		1399
		1400	sub load {
		1401	my ($self) = @_;
		1402
		1403	my $path = $self->{path};
		1404	my $guard = cf::lock_acquire "map_load:" . $path->as_string;
		1405
		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 {
520	my ($map) = @_;	1450	my ($map) = @_;
521		1451
522	my $path = $map->tmpname;	1452	my @diag; # diagonal neighbours
523	$path = $map->path unless defined $path;
524		1453
525	open my $fh, "<:raw", "$path.cfperl"	1454	for (0 .. 3) {
526	or return; # no perl data	1455	my $neigh = $map->tile_path ($_)
		1456	or next;
		1457	$neigh = find $neigh, $map
		1458	or next;
		1459	$neigh->load;
527		1460
528	my $data = Storable::thaw do { local $/; <$fh> };	1461	push @diag, [$neigh->tile_path (($_ + 3) % 4), $neigh],
		1462	[$neigh->tile_path (($_ + 1) % 4), $neigh];
		1463	}
529		1464
530	$data->{version} <= 1	1465	for (@diag) {
531	or return; # too new	1466	my $neigh = find @$_
		1467	or next;
		1468	$neigh->load;
		1469	}
		1470	}
532		1471
533	$map->_set_obs ($data->{obs});	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	}
534	};	1498	};
535		1499
536	*cf::mapsupport::on_swapout = sub {	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 {
537	my ($map) = @_;	1517	my ($self) = @_;
538		1518
539	my $path = $map->tmpname;	1519	my $lock = cf::lock_acquire "map_data:" . $self->path;
540	$path = $map->path unless defined $path;
541		1520
542	my $obs = $map->_get_obs;	1521	$self->{last_save} = $cf::RUNTIME;
543		1522
544	if (defined $obs) {	1523	return unless $self->dirty;
545	open my $fh, ">:raw", "$path.cfperl"
546	or die "$path.cfperl: $!";
547		1524
548	stat $path;	1525	my $save = $self->{path}->save_path; utf8::encode $save;
		1526	my $uniq = $self->{path}->uniq_path; utf8::encode $uniq;
549		1527
550	print $fh Storable::nfreeze {	1528	$self->{load_path} = $save;
551	size => (stat _)[7],	1529
552	time => (stat _)[9],	1530	return if $self->{deny_save};
553	version => 1,	1531
554	obs => $obs,	1532	local $self->{last_access} = $self->last_access;#d#
		1533
		1534	cf::async {
		1535	$_->contr->save for $self->players;
555	};	1536	};
556		1537
557	chmod SAVE_MODE, "$path.cfperl"; # very racy, but cf-compatible *g*	1538	if ($uniq) {
		1539	$self->save_objects ($save, cf::IO_HEADER | cf::IO_OBJECTS);
		1540	$self->save_objects ($uniq, cf::IO_UNIQUES);
558	} else {	1541	} else {
559	unlink "$path.cfperl";	1542	$self->save_objects ($save, cf::IO_HEADER | cf::IO_OBJECTS | cf::IO_UNIQUES);
560	}
561	};
562
563	attach_to_maps prio => -10000, package => cf::mapsupport::;
564
565	#############################################################################
566	# load/save perl data associated with player->ob objects
567
568	sub all_objects(@) {
569	@_, map all_objects ($_->inv), @_
570	}
571
572	attach_to_players
573	on_load => sub {
574	my ($pl, $path) = @_;
575
576	for my $o (all_objects $pl->ob) {
577	if (my $value = $o->get_ob_key_value ("_perl_data")) {
578	$o->set_ob_key_value ("_perl_data");
579
580	%$o = %{ Storable::thaw pack "H*", $value };
581	}
582	}
583	},	1543	}
584	on_save => sub {	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 {
585	my ($pl, $path) = @_;	1590	my ($self, $new_path) = @_;
586		1591
587	$_->set_ob_key_value (_perl_data => unpack "H*", Storable::nfreeze $_)	1592	$self->unlink_save;
588	for grep %$_, all_objects $pl->ob;	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};
589	},	1636	}
590	;
591		1637
592	#############################################################################	1638	$map
593	# core extensions - in perl
594
595	=item cf::player::exists $login
596
597	Returns true when the given account exists.
598
599	=cut
600
601	sub cf::player::exists($) {
602	cf::player::find $_[0]
603	or -f sprintf "%s/%s/%s/%s.pl", cf::localdir, cf::playerdir, ($_[0]) x 2;
604	}	1639	}
605		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;
		1674
		1675	=over 4
		1676
		1677	=item $ob->inv_recursive
		1678
		1679	Returns the inventory of the object _and_ their inventories, recursively.
		1680
		1681	=cut
		1682
		1683	sub inv_recursive_;
		1684	sub inv_recursive_ {
		1685	map { $_, inv_recursive_ $_->inv } @_
		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
		1699
606	=item $player->reply ($npc, $msg[, $flags])	1700	=item $player_object->reply ($npc, $msg[, $flags])
607		1701
608	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>
609	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
610	dialogue with the given NPC character.	1704	dialogue with the given NPC character.
611		1705
612	=cut	1706	=cut
613		1707
614	# rough implementation of a future "reply" method that works	1708	# rough implementation of a future "reply" method that works
615	# with dialog boxes.	1709	# with dialog boxes.
		1710	#TODO: the first argument must go, split into a $npc->reply_to ( method
616	sub cf::object::player::reply($$$;$) {	1711	sub cf::object::player::reply($$$;$) {
617	my ($self, $npc, $msg, $flags) = @_;	1712	my ($self, $npc, $msg, $flags) = @_;
618		1713
619	$flags = cf::NDI_BROWN | cf::NDI_UNIQUE unless @_ >= 4;	1714	$flags = cf::NDI_BROWN | cf::NDI_UNIQUE unless @_ >= 4;
620		1715
…		…
624	$msg = $npc->name . " says: $msg" if $npc;	1719	$msg = $npc->name . " says: $msg" if $npc;
625	$self->message ($msg, $flags);	1720	$self->message ($msg, $flags);
626	}	1721	}
627	}	1722	}
628		1723
629	=item $player->ext_reply ($msgid, $msgtype, %msg)	1724	=item $player_object->may ("access")
630		1725
631	Sends an ext reply to the player.	1726	Returns wether the given player is authorized to access resource "access"
		1727	(e.g. "command_wizcast").
632		1728
633	=cut	1729	=cut
634		1730
635	sub cf::player::ext_reply($$$%) {	1731	sub cf::object::player::may {
		1732	my ($self, $access) = @_;
		1733
		1734	$self->flag (cf::FLAG_WIZ) ||
		1735	(ref $cf::CFG{"may_$access"}
		1736	? scalar grep $self->name eq $_, @{$cf::CFG{"may_$access"}}
		1737	: $cf::CFG{"may_$access"})
		1738	}
		1739
		1740	=item $player_object->enter_link
		1741
		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 {
636	my ($self, $id, %msg) = @_;	1910	my ($self, $exit) = @_;
637		1911
638	$msg{msgid} = $id;	1912	return unless $self->type == cf::PLAYER;
639		1913
640	$self->send ("ext " . to_json \%msg);	1914	$self->enter_link;
641	}
642		1915
643	#############################################################################	1916	(async {
644	# map scripting support	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
		2039
		2040	=head2 SAFE SCRIPTING
		2041
		2042	Functions that provide a safe environment to compile and execute
		2043	snippets of perl code without them endangering the safety of the server
		2044	itself. Looping constructs, I/O operators and other built-in functionality
		2045	is not available in the safe scripting environment, and the number of
		2046	functions and methods that can be called is greatly reduced.
		2047
		2048	=cut
645		2049
646	our $safe = new Safe "safe";	2050	our $safe = new Safe "safe";
647	our $safe_hole = new Safe::Hole;	2051	our $safe_hole = new Safe::Hole;
648		2052
649	$SIG{FPE} = 'IGNORE';	2053	$SIG{FPE} = 'IGNORE';
650		2054
651	$safe->permit_only (Opcode::opset qw(:base_core :base_mem :base_orig :base_math sort time));	2055	$safe->permit_only (Opcode::opset qw(:base_core :base_mem :base_orig :base_math sort time));
652		2056
653	# here we export the classes and methods available to script code	2057	# here we export the classes and methods available to script code
654		2058
		2059	=pod
		2060
		2061	The following fucntions and emthods are available within a safe environment:
		2062
		2063	cf::object contr pay_amount pay_player map
		2064	cf::object::player player
		2065	cf::player peaceful
		2066	cf::map trigger
		2067
		2068	=cut
		2069
655	for (	2070	for (
656	["cf::object" => qw(contr pay_amount pay_player)],	2071	["cf::object" => qw(contr pay_amount pay_player map)],
657	["cf::object::player" => qw(player)],	2072	["cf::object::player" => qw(player)],
658	["cf::player" => qw(peaceful)],	2073	["cf::player" => qw(peaceful)],
		2074	["cf::map" => qw(trigger)],
659	) {	2075	) {
660	no strict 'refs';	2076	no strict 'refs';
661	my ($pkg, @funs) = @$_;	2077	my ($pkg, @funs) = @$_;
662	*{"safe::$pkg\::$_"} = $safe_hole->wrap (\&{"$pkg\::$_"})	2078	*{"safe::$pkg\::$_"} = $safe_hole->wrap (\&{"$pkg\::$_"})
663	for @funs;	2079	for @funs;
664	}	2080	}
		2081
		2082	=over 4
		2083
		2084	=item @retval = safe_eval $code, [var => value, ...]
		2085
		2086	Compiled and executes the given perl code snippet. additional var/value
		2087	pairs result in temporary local (my) scalar variables of the given name
		2088	that are available in the code snippet. Example:
		2089
		2090	my $five = safe_eval '$first + $second', first => 1, second => 4;
		2091
		2092	=cut
665		2093
666	sub safe_eval($;@) {	2094	sub safe_eval($;@) {
667	my ($code, %vars) = @_;	2095	my ($code, %vars) = @_;
668		2096
669	my $qcode = $code;	2097	my $qcode = $code;
…		…
692	}	2120	}
693		2121
694	wantarray ? @res : $res[0]	2122	wantarray ? @res : $res[0]
695	}	2123	}
696		2124
		2125	=item cf::register_script_function $function => $cb
		2126
		2127	Register a function that can be called from within map/npc scripts. The
		2128	function should be reasonably secure and should be put into a package name
		2129	like the extension.
		2130
		2131	Example: register a function that gets called whenever a map script calls
		2132	C<rent::overview>, as used by the C<rent> extension.
		2133
		2134	cf::register_script_function "rent::overview" => sub {
		2135	...
		2136	};
		2137
		2138	=cut
		2139
697	sub register_script_function {	2140	sub register_script_function {
698	my ($fun, $cb) = @_;	2141	my ($fun, $cb) = @_;
699		2142
700	no strict 'refs';	2143	no strict 'refs';
701	*{"safe::$fun"} = $safe_hole->wrap ($cb);	2144	*{"safe::$fun"} = $safe_hole->wrap ($cb);
702	}	2145	}
703		2146
		2147	=back
		2148
		2149	=cut
		2150
		2151	#############################################################################
		2152
		2153	=head2 EXTENSION DATABASE SUPPORT
		2154
		2155	Crossfire maintains a very simple database for extension use. It can
		2156	currently store anything that can be serialised using Storable, which
		2157	excludes objects.
		2158
		2159	The parameter C<$family> should best start with the name of the extension
		2160	using it, it should be unique.
		2161
		2162	=over 4
		2163
		2164	=item $hashref = cf::db_get $family
		2165
		2166	Return a hashref for use by the extension C<$family>, which can be
		2167	modified. After modifications, you have to call C<cf::db_dirty> or
		2168	C<cf::db_sync>.
		2169
		2170	=item $value = cf::db_get $family => $key
		2171
		2172	Returns a single value from the database
		2173
		2174	=item cf::db_put $family => $hashref
		2175
		2176	Stores the given family hashref into the database. Updates are delayed, if
		2177	you want the data to be synced to disk immediately, use C<cf::db_sync>.
		2178
		2179	=item cf::db_put $family => $key => $value
		2180
		2181	Stores the given C<$value> in the family hash. Updates are delayed, if you
		2182	want the data to be synced to disk immediately, use C<cf::db_sync>.
		2183
		2184	=item cf::db_dirty
		2185
		2186	Marks the database as dirty, to be updated at a later time.
		2187
		2188	=item cf::db_sync
		2189
		2190	Immediately write the database to disk I<if it is dirty>.
		2191
		2192	=cut
		2193
		2194	our $DB;
		2195
		2196	{
		2197	my $path = cf::localdir . "/database.pst";
		2198
		2199	sub db_load() {
		2200	$DB = stat $path ? Storable::retrieve $path : { };
		2201	}
		2202
		2203	my $pid;
		2204
		2205	sub db_save() {
		2206	waitpid $pid, 0 if $pid;
		2207	if (0 == ($pid = fork)) {
		2208	$DB->{_meta}{version} = 1;
		2209	Storable::nstore $DB, "$path~";
		2210	rename "$path~", $path;
		2211	cf::_exit 0 if defined $pid;
		2212	}
		2213	}
		2214
		2215	my $dirty;
		2216
		2217	sub db_sync() {
		2218	db_save if $dirty;
		2219	undef $dirty;
		2220	}
		2221
		2222	my $idle = Event->idle (min => $TICK * 2.8, max => 10, repeat => 0, data => WF_AUTOCANCEL, cb => sub {
		2223	db_sync;
		2224	});
		2225
		2226	sub db_dirty() {
		2227	$dirty = 1;
		2228	$idle->start;
		2229	}
		2230
		2231	sub db_get($;$) {
		2232	@_ >= 2
		2233	? $DB->{$_[0]}{$_[1]}
		2234	: ($DB->{$_[0]} ||= { })
		2235	}
		2236
		2237	sub db_put($$;$) {
		2238	if (@_ >= 3) {
		2239	$DB->{$_[0]}{$_[1]} = $_[2];
		2240	} else {
		2241	$DB->{$_[0]} = $_[1];
		2242	}
		2243	db_dirty;
		2244	}
		2245
		2246	cf::global->attach (
		2247	prio => 10000,
		2248	on_cleanup => sub {
		2249	db_sync;
		2250	},
		2251	);
		2252	}
		2253
704	#############################################################################	2254	#############################################################################
705	# the server's main()	2255	# the server's main()
706		2256
		2257	sub cfg_load {
		2258	open my $fh, "<:utf8", cf::confdir . "/config"
		2259	or return;
		2260
		2261	local $/;
		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	}
		2276	}
		2277
707	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
		2285	cfg_load;
		2286	db_load;
		2287	load_extensions;
708	Event::loop;	2288	Event::loop;
709	}	2289	}
710		2290
711	#############################################################################	2291	#############################################################################
712	# initialisation	2292	# initialisation and cleanup
		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
		2336	sub reload() {
		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	}
		2342
		2343	warn "reloading...";
		2344
		2345	my $guard = freeze_mainloop;
		2346	cf::emergency_save;
		2347
		2348	eval {
		2349	# if anything goes wrong in here, we should simply crash as we already saved
		2350
		2351	# cancel 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 = ();
		2359
		2360	# unload all extensions
		2361	for (@exts) {
		2362	warn "unloading <$_>";
		2363	unload_extension $_;
		2364	}
		2365
		2366	# unload all modules loaded from $LIBDIR
		2367	while (my ($k, $v) = each %INC) {
		2368	next unless $v =~ /^\Q$LIBDIR\E\/.*\.pm$/;
		2369
		2370	warn "removing <$k>";
		2371	delete $INC{$k};
		2372
		2373	$k =~ s/\.pm$//;
		2374	$k =~ s/\//::/g;
		2375
		2376	if (my $cb = $k->can ("unload_module")) {
		2377	$cb->();
		2378	}
		2379
		2380	Symbol::delete_package $k;
		2381	}
		2382
		2383	# sync database to disk
		2384	cf::db_sync;
		2385	IO::AIO::flush;
		2386
		2387	# get rid of safe::, as good as possible
		2388	Symbol::delete_package "safe::$_"
		2389	for qw(cf::attachable cf::object cf::object::player cf::client cf::player cf::map cf::party cf::region);
		2390
		2391	# remove register_script_function callbacks
		2392	# TODO
		2393
		2394	# unload cf.pm "a bit"
		2395	delete $INC{"cf.pm"};
		2396
		2397	# don't, removes xs symbols, too,
		2398	# and global variables created in xs
		2399	#Symbol::delete_package __PACKAGE__;
		2400
		2401	# reload cf.pm
		2402	warn "reloading cf.pm";
		2403	require cf;
		2404	cf::_connect_to_perl; # nominally unnecessary, but cannot hurt
		2405
		2406	# load config and database again
		2407	cf::cfg_load;
		2408	cf::db_load;
		2409
		2410	# load extensions
		2411	warn "load extensions";
		2412	cf::load_extensions;
		2413
		2414	# reattach attachments to objects
		2415	warn "reattach";
		2416	_global_reattach;
		2417	reattach $_ for values %MAP;
		2418	};
		2419
		2420	if ($@) {
		2421	warn $@;
		2422	warn "error while reloading, exiting.";
		2423	exit 1;
		2424	}
		2425
		2426	warn "reloaded successfully";
		2427	};
		2428
		2429	#############################################################################
		2430
		2431	unless ($LINK_MAP) {
		2432	$LINK_MAP = cf::map::new;
		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;
		2470	}
713		2471
714	register "<global>", __PACKAGE__;	2472	register "<global>", __PACKAGE__;
715		2473
		2474	register_command "reload" => sub {
		2475	my ($who, $arg) = @_;
		2476
		2477	if ($who->flag (FLAG_WIZ)) {
		2478	$who->message ("start of reload.");
		2479	reload;
		2480	$who->message ("end of reload.");
		2481	}
		2482	};
		2483
716	unshift @INC, $LIBDIR;	2484	unshift @INC, $LIBDIR;
717		2485
718	load_extensions;
719
720	$TICK_WATCHER = Event->timer (	2486	$TICK_WATCHER = Event->timer (
		2487	reentrant => 0,
721	prio => 1,	2488	prio => 0,
722	at => $NEXT_TICK || 1,	2489	at => $NEXT_TICK || $TICK,
		2490	data => WF_AUTOCANCEL,
723	cb => sub {	2491	cb => sub {
724	cf::server_tick; # one server iteration	2492	cf::server_tick; # one server iteration
725		2493	$RUNTIME += $TICK;
726	my $NOW = Event::time;
727	$NEXT_TICK += $TICK;	2494	$NEXT_TICK += $TICK;
728		2495
		2496	$WAIT_FOR_TICK->broadcast;
		2497	$WAIT_FOR_TICK_ONE->send if $WAIT_FOR_TICK_ONE->awaited;
		2498
729	# if we are delayed by four ticks, skip them all	2499	# if we are delayed by four ticks or more, skip them all
730	$NEXT_TICK = $NOW if $NOW >= $NEXT_TICK + $TICK * 4;	2500	$NEXT_TICK = Event::time if Event::time >= $NEXT_TICK + $TICK * 4;
731		2501
732	$TICK_WATCHER->at ($NEXT_TICK);	2502	$TICK_WATCHER->at ($NEXT_TICK);
733	$TICK_WATCHER->start;	2503	$TICK_WATCHER->start;
734	},	2504	},
735	);	2505	);
736		2506
		2507	IO::AIO::max_poll_time $TICK * 0.2;
		2508
		2509	Event->io (
		2510	fd => IO::AIO::poll_fileno,
		2511	poll => 'r',
		2512	prio => 5,
		2513	data => WF_AUTOCANCEL,
		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 }
		2530
737	1	2531	1
738		2532

Diff Legend

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