ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/deliantra/server/lib/cf.pm
(Generate patch)

Comparing deliantra/server/lib/cf.pm (file contents):
Revision 1.46 by root, Sun Aug 27 16:15:12 2006 UTC vs.
Revision 1.90 by root, Sat Dec 16 04:22:13 2006 UTC

5use Storable; 5use Storable;
6use Opcode; 6use Opcode;
7use Safe; 7use Safe;
8use Safe::Hole; 8use Safe::Hole;
9 9
10use IO::AIO ();
11use YAML::Syck ();
10use Time::HiRes; 12use Time::HiRes;
11use Event; 13use Event;
12$Event::Eval = 1; # no idea why this is required, but it is 14$Event::Eval = 1; # no idea why this is required, but it is
13 15
16# work around bug in YAML::Syck - bad news for perl6, will it be as broken wrt. unicode?
17$YAML::Syck::ImplicitUnicode = 1;
18
14use strict; 19use strict;
15 20
21sub WF_AUTOCANCEL () { 1 } # automatically cancel this watcher on reload
22
16our %COMMAND = (); 23our %COMMAND = ();
24our %COMMAND_TIME = ();
25our %EXTCMD = ();
26
27_init_vars;
28
17our @EVENT; 29our @EVENT;
18our %PROP_TYPE; 30our $LIBDIR = datadir . "/ext";
19our %PROP_IDX;
20our $LIBDIR = maps_directory "perl";
21 31
22our $TICK = MAX_TIME * 1e-6; 32our $TICK = MAX_TIME * 1e-6;
23our $TICK_WATCHER; 33our $TICK_WATCHER;
24our $NEXT_TICK; 34our $NEXT_TICK;
35
36our %CFG;
37
38our $UPTIME; $UPTIME ||= time;
39
40#############################################################################
41
42=head2 GLOBAL VARIABLES
43
44=over 4
45
46=item $cf::UPTIME
47
48The timestamp of the server start (so not actually an uptime).
49
50=item $cf::LIBDIR
51
52The perl library directory, where extensions and cf-specific modules can
53be found. It will be added to C<@INC> automatically.
54
55=item $cf::TICK
56
57The interval between server ticks, in seconds.
58
59=item %cf::CFG
60
61Configuration for the server, loaded from C</etc/crossfire/config>, or
62from wherever your confdir points to.
63
64=back
65
66=cut
25 67
26BEGIN { 68BEGIN {
27 *CORE::GLOBAL::warn = sub { 69 *CORE::GLOBAL::warn = sub {
28 my $msg = join "", @_; 70 my $msg = join "", @_;
29 $msg .= "\n" 71 $msg .= "\n"
32 print STDERR "cfperl: $msg"; 74 print STDERR "cfperl: $msg";
33 LOG llevError, "cfperl: $msg"; 75 LOG llevError, "cfperl: $msg";
34 }; 76 };
35} 77}
36 78
37my %ignore_set = (MAP_PROP_PATH => 1); # I hate the plug-in api. Deeply!
38
39# generate property mutators
40sub prop_gen {
41 my ($prefix, $class) = @_;
42
43 no strict 'refs';
44
45 for my $prop (keys %PROP_TYPE) {
46 $prop =~ /^\Q$prefix\E_(.*$)/ or next;
47 my $sub = lc $1;
48
49 my $type = $PROP_TYPE{$prop};
50 my $idx = $PROP_IDX {$prop};
51
52 *{"$class\::get_$sub"} = *{"$class\::$sub"} = sub {
53 $_[0]->get_property ($type, $idx)
54 };
55
56 *{"$class\::set_$sub"} = sub {
57 $_[0]->set_property ($type, $idx, $_[1]);
58 } unless $ignore_set{$prop};
59 }
60}
61
62# auto-generate most of the API
63
64prop_gen OBJECT_PROP => "cf::object";
65# CFAPI_OBJECT_ANIMATION?
66prop_gen PLAYER_PROP => "cf::object::player";
67
68prop_gen MAP_PROP => "cf::map";
69prop_gen ARCH_PROP => "cf::arch";
70
71@safe::cf::object::player::ISA = @cf::object::player::ISA = 'cf::object'; 79@safe::cf::object::player::ISA = @cf::object::player::ISA = 'cf::object';
72 80
73# we bless all objects into (empty) derived classes to force a method lookup 81# we bless all objects into (empty) derived classes to force a method lookup
74# within the Safe compartment. 82# within the Safe compartment.
75for my $pkg (qw(cf::object cf::object::player cf::player cf::map cf::party cf::region cf::arch)) { 83for my $pkg (qw(
84 cf::object cf::object::player
85 cf::client cf::player
86 cf::arch cf::living
87 cf::map cf::party cf::region
88)) {
76 no strict 'refs'; 89 no strict 'refs';
77 @{"safe::$pkg\::wrap::ISA"} = @{"$pkg\::wrap::ISA"} = $pkg; 90 @{"safe::$pkg\::wrap::ISA"} = @{"$pkg\::wrap::ISA"} = $pkg;
78} 91}
79 92
80$Event::DIED = sub { 93$Event::DIED = sub {
82}; 95};
83 96
84my %ext_pkg; 97my %ext_pkg;
85my @exts; 98my @exts;
86my @hook; 99my @hook;
87my %command;
88my %extcmd;
89 100
90############################################################################# 101=head2 UTILITY FUNCTIONS
91# utility functions 102
103=over 4
104
105=cut
92 106
93use JSON::Syck (); # TODO# replace by JSON::PC once working 107use JSON::Syck (); # TODO# replace by JSON::PC once working
108
109=item $ref = cf::from_json $json
110
111Converts a JSON string into the corresponding perl data structure.
112
113=cut
94 114
95sub from_json($) { 115sub from_json($) {
96 $JSON::Syck::ImplicitUnicode = 1; # work around JSON::Syck bugs 116 $JSON::Syck::ImplicitUnicode = 1; # work around JSON::Syck bugs
97 JSON::Syck::Load $_[0] 117 JSON::Syck::Load $_[0]
98} 118}
99 119
120=item $json = cf::to_json $ref
121
122Converts a perl data structure into its JSON representation.
123
124=cut
125
100sub to_json($) { 126sub to_json($) {
101 $JSON::Syck::ImplicitUnicode = 0; # work around JSON::Syck bugs 127 $JSON::Syck::ImplicitUnicode = 0; # work around JSON::Syck bugs
102 JSON::Syck::Dump $_[0] 128 JSON::Syck::Dump $_[0]
103} 129}
104 130
131=back
132
133=cut
134
105############################################################################# 135#############################################################################
106# "new" plug-in system
107 136
137=head2 EVENTS AND OBJECT ATTACHMENTS
138
139=over 4
140
141=item $object->attach ($attachment, key => $value...)
142
108=item $object->attach ($attachment, ...) 143=item $object->detach ($attachment)
109 144
110Attach a pre-registered attachment to an object. 145Attach/detach a pre-registered attachment to an object.
111 146
147=item $player->attach ($attachment, key => $value...)
148
112=item $player->attach ($attachment, ...) 149=item $player->detach ($attachment)
113 150
114Attach a pre-registered attachment to a player. 151Attach/detach a pre-registered attachment to a player.
115 152
116=item $map->attach ($attachment, ...) # not yet persistent 153=item $map->attach ($attachment, key => $value...)
117 154
155=item $map->detach ($attachment)
156
118Attach a pre-registered attachment to a map. 157Attach/detach a pre-registered attachment to a map.
158
159=item $bool = $object->attached ($name)
160
161=item $bool = $player->attached ($name)
162
163=item $bool = $map->attached ($name)
164
165Checks wether the named attachment is currently attached to the object.
119 166
120=item cf::attach_global ... 167=item cf::attach_global ...
121 168
122Attach handlers for global events. 169Attach handlers for global events.
123 170
150package and register them. Only handlers for eevents supported by the 197package and register them. Only handlers for eevents supported by the
151object/class are recognised. 198object/class are recognised.
152 199
153=back 200=back
154 201
155=item cf::attach_to_type $object_type, ... 202=item cf::attach_to_type $object_type, $subtype, ...
156 203
157Attach handlers for a specific object type (e.g. TRANSPORT). 204Attach handlers for a specific object type (e.g. TRANSPORT) and
205subtype. If C<$subtype> is zero or undef, matches all objects of the given
206type.
158 207
159=item cf::attach_to_objects ... 208=item cf::attach_to_objects ...
160 209
161Attach handlers to all objects. Do not use this except for debugging or 210Attach handlers to all objects. Do not use this except for debugging or
162very rare events, as handlers are (obviously) called for I<all> objects in 211very rare events, as handlers are (obviously) called for I<all> objects in
169=item cf::attach_to_maps ... 218=item cf::attach_to_maps ...
170 219
171Attach handlers to all maps. 220Attach handlers to all maps.
172 221
173=item cf:register_attachment $name, ... 222=item cf:register_attachment $name, ...
223
224Register an attachment by name through which objects can refer to this
225attachment.
226
227=item cf:register_player_attachment $name, ...
228
229Register an attachment by name through which players can refer to this
230attachment.
231
232=item cf:register_map_attachment $name, ...
233
234Register an attachment by name through which maps can refer to this
235attachment.
174 236
175=cut 237=cut
176 238
177# the following variables are defined in .xs and must not be re-created 239# the following variables are defined in .xs and must not be re-created
178our @CB_GLOBAL = (); # registry for all global events 240our @CB_GLOBAL = (); # registry for all global events
241 303
242 \%undo 304 \%undo
243} 305}
244 306
245sub _attach_attachment { 307sub _attach_attachment {
246 my ($klass, $obj, $name, @args) = q_; 308 my ($obj, $name, %arg) = @_;
309
310 return if exists $obj->{_attachment}{$name};
247 311
248 my $res; 312 my $res;
249 313
250 if (my $attach = $attachment{$name}) { 314 if (my $attach = $attachment{$name}) {
251 my $registry = $obj->registry; 315 my $registry = $obj->registry;
252 316
317 for (@$attach) {
318 my ($klass, @attach) = @$_;
253 $res = _attach @$registry, $klass, @$attach; 319 $res = _attach @$registry, $klass, @attach;
254
255 if (my $cb = delete $registry->[EVENT_OBJECT_INSTANTIATE]) {
256 for (@$cb) {
257 eval { $_->[1]->($obj, @args); };
258 if ($@) {
259 warn "$@";
260 warn "... while processing '$name' instantiate with args <@args>.\n";
261 }
262 } 320 }
263 } 321
322 $obj->{$name} = \%arg;
264 } else { 323 } else {
265 warn "object uses attachment '$name' that is not available, postponing.\n"; 324 warn "object uses attachment '$name' that is not available, postponing.\n";
266 } 325 }
267 326
268 push @{$obj->{_attachment}}, $name; 327 $obj->{_attachment}{$name} = undef;
269 328
270 $res->{attachment} = $name; 329 $res->{attachment} = $name;
271 $res 330 $res
272} 331}
273 332
274sub cf::object::attach { 333*cf::object::attach =
334*cf::player::attach =
335*cf::map::attach = sub {
275 my ($obj, $name, @args) = @_; 336 my ($obj, $name, %arg) = @_;
276 337
277 _attach_attachment KLASS_OBJECT, $obj, $name, @args; 338 _attach_attachment $obj, $name, %arg;
278} 339};
279 340
341# all those should be optimised
342*cf::object::detach =
280sub cf::player::attach { 343*cf::player::detach =
344*cf::map::detach = sub {
281 my ($obj, $name, @args) = @_; 345 my ($obj, $name) = @_;
282 346
283 _attach_attachment KLASS_PLAYER, $obj, $name, @args; 347 delete $obj->{_attachment}{$name};
284} 348 reattach ($obj);
349};
285 350
286sub cf::map::attach { 351*cf::object::attached =
352*cf::player::attached =
353*cf::map::attached = sub {
287 my ($obj, $name, @args) = @_; 354 my ($obj, $name) = @_;
288 355
289 _attach_attachment KLASS_MAP, $obj, $name, @args; 356 exists $obj->{_attachment}{$name}
290} 357};
291 358
292sub attach_global { 359sub attach_global {
293 _attach @CB_GLOBAL, KLASS_GLOBAL, @_ 360 _attach @CB_GLOBAL, KLASS_GLOBAL, @_
294} 361}
295 362
296sub attach_to_type { 363sub attach_to_type {
297 my $type = shift; 364 my $type = shift;
365 my $subtype = shift;
298 366
299 _attach @{$CB_TYPE[$type]}, KLASS_OBJECT, @_ 367 _attach @{$CB_TYPE[$type + $subtype * NUM_SUBTYPES]}, KLASS_OBJECT, @_
300} 368}
301 369
302sub attach_to_objects { 370sub attach_to_objects {
303 _attach @CB_OBJECT, KLASS_OBJECT, @_ 371 _attach @CB_OBJECT, KLASS_OBJECT, @_
304} 372}
312} 380}
313 381
314sub register_attachment { 382sub register_attachment {
315 my $name = shift; 383 my $name = shift;
316 384
385 $attachment{$name} = [[KLASS_OBJECT, @_]];
386}
387
388sub register_player_attachment {
389 my $name = shift;
390
391 $attachment{$name} = [[KLASS_PLAYER, @_]];
392}
393
394sub register_map_attachment {
395 my $name = shift;
396
317 $attachment{$name} = [@_]; 397 $attachment{$name} = [[KLASS_MAP, @_]];
318} 398}
319 399
320our $override; 400our $override;
321our @invoke_results = (); # referenced from .xs code. TODO: play tricks with reify and mortals? 401our @invoke_results = (); # referenced from .xs code. TODO: play tricks with reify and mortals?
322 402
336 for (@$callbacks) { 416 for (@$callbacks) {
337 eval { &{$_->[1]} }; 417 eval { &{$_->[1]} };
338 418
339 if ($@) { 419 if ($@) {
340 warn "$@"; 420 warn "$@";
341 warn "... while processing $EVENT[$event][0] event, skipping processing altogether.\n"; 421 warn "... while processing $EVENT[$event][0](@_) event, skipping processing altogether.\n";
342 override; 422 override;
343 } 423 }
344 424
345 return 1 if $override; 425 return 1 if $override;
346 } 426 }
347 427
348 0 428 0
349} 429}
430
431=item $bool = cf::invoke EVENT_GLOBAL_XXX, ...
432
433=item $bool = $object->invoke (EVENT_OBJECT_XXX, ...)
434
435=item $bool = $player->invoke (EVENT_PLAYER_XXX, ...)
436
437=item $bool = $map->invoke (EVENT_MAP_XXX, ...)
438
439Generate a global/object/player/map-specific event with the given arguments.
440
441This API is preliminary (most likely, the EVENT_KLASS_xxx prefix will be
442removed in future versions), and there is no public API to access override
443results (if you must, access C<@cf::invoke_results> directly).
444
445=back
446
447=cut
448
449#############################################################################
450
451=head2 METHODS VALID FOR ALL CORE OBJECTS
452
453=over 4
454
455=item $object->valid, $player->valid, $map->valid
456
457Just because you have a perl object does not mean that the corresponding
458C-level object still exists. If you try to access an object that has no
459valid C counterpart anymore you get an exception at runtime. This method
460can be used to test for existence of the C object part without causing an
461exception.
462
463=back
464
465=cut
466
467*cf::object::valid =
468*cf::player::valid =
469*cf::map::valid = \&cf::_valid;
350 470
351############################################################################# 471#############################################################################
352# object support 472# object support
353 473
354sub instantiate { 474sub instantiate {
356 476
357 $data = from_json $data; 477 $data = from_json $data;
358 478
359 for (@$data) { 479 for (@$data) {
360 my ($name, $args) = @$_; 480 my ($name, $args) = @$_;
361 attach $obj, $name, @{$args || [] }; 481
482 $obj->attach ($name, %{$args || {} });
362 } 483 }
363} 484}
364 485
365# basically do the same as instantiate, without calling instantiate 486# basically do the same as instantiate, without calling instantiate
366sub reattach { 487sub reattach {
367 warn "reattach<@_>\n";#d#
368 my ($obj) = @_; 488 my ($obj) = @_;
369 my $registry = $obj->registry; 489 my $registry = $obj->registry;
370 490
491 @$registry = ();
492
493 delete $obj->{_attachment} unless scalar keys %{ $obj->{_attachment} || {} };
494
371 for my $name (@{ $obj->{_attachment} }) { 495 for my $name (keys %{ $obj->{_attachment} || {} }) {
372 if (my $attach = $attachment{$name}) { 496 if (my $attach = $attachment{$name}) {
497 for (@$attach) {
498 my ($klass, @attach) = @$_;
373 _attach @$registry, KLASS_OBJECT, @$attach; 499 _attach @$registry, $klass, @attach;
500 }
374 } else { 501 } else {
375 warn "object uses attachment '$name' that is not available, postponing.\n"; 502 warn "object uses attachment '$name' that is not available, postponing.\n";
376 } 503 }
377 } 504 }
378
379 warn "reattach<@_, $_>\n";
380} 505}
381 506
382sub object_freezer_save { 507sub object_freezer_save {
383 my ($filename, $objs) = @_; 508 my ($filename, $rdata, $objs) = @_;
384 warn "freeze $filename\n";#d#
385 use Data::Dumper; print Dumper $objs;
386 509
387 $filename .= ".pst"; 510 if (length $$rdata) {
511 warn sprintf "saving %s (%d,%d)\n",
512 $filename, length $$rdata, scalar @$objs;
388 513
389 if (@$objs) {
390 open my $fh, ">:raw", "$filename~"; 514 if (open my $fh, ">:raw", "$filename~") {
391 chmod $fh, SAVE_MODE; 515 chmod SAVE_MODE, $fh;
516 syswrite $fh, $$rdata;
517 close $fh;
518
519 if (@$objs && open my $fh, ">:raw", "$filename.pst~") {
520 chmod SAVE_MODE, $fh;
392 syswrite $fh, Storable::nfreeze { version => 1, objs => $objs }; 521 syswrite $fh, Storable::nfreeze { version => 1, objs => $objs };
393 close $fh; 522 close $fh;
523 rename "$filename.pst~", "$filename.pst";
524 } else {
525 unlink "$filename.pst";
526 }
527
394 rename "$filename~", $filename; 528 rename "$filename~", $filename;
529 } else {
530 warn "FATAL: $filename~: $!\n";
531 }
395 } else { 532 } else {
396 unlink $filename; 533 unlink $filename;
534 unlink "$filename.pst";
397 } 535 }
536}
537
538sub object_freezer_as_string {
539 my ($rdata, $objs) = @_;
540
541 use Data::Dumper;
542
543 $$rdata . Dumper $objs
398} 544}
399 545
400sub object_thawer_load { 546sub object_thawer_load {
401 my ($filename) = @_; 547 my ($filename) = @_;
402 548
403 warn "thaw $filename\n";#d# 549 local $/;
404 550
551 my $av;
552
553 #TODO: use sysread etc.
554 if (open my $data, "<:raw:perlio", $filename) {
555 $data = <$data>;
405 open my $fh, "<:raw:perlio", "$filename.pst" 556 if (open my $pst, "<:raw:perlio", "$filename.pst") {
406 or return; 557 $av = eval { (Storable::thaw <$pst>)->{objs} };
558 }
559 return ($data, $av);
560 }
407 561
408 eval { local $/; (Storable::thaw <$fh>)->{objs} } 562 ()
409} 563}
410 564
411attach_to_objects 565attach_to_objects
412 prio => -1000000, 566 prio => -1000000,
413 on_clone => sub { 567 on_clone => sub {
414 my ($src, $dst) = @_; 568 my ($src, $dst) = @_;
415 569
416 @{$dst->registry} = @{$src->registry}; 570 @{$dst->registry} = @{$src->registry};
417 warn "registry clone ", join ":", @{$src->registry};#d#
418 571
419 %$dst = %$src; 572 %$dst = %$src;
420 573
421 $dst->{_attachment} = [@{ $src->{_attachment} }] 574 %{$dst->{_attachment}} = %{$src->{_attachment}}
422 if exists $src->{_attachment}; 575 if exists $src->{_attachment};
423
424 warn "clone<@_>\n";#d#
425 }, 576 },
426; 577;
427 578
428############################################################################# 579#############################################################################
429# old plug-in events 580# command handling &c
430 581
431sub inject_event { 582=item cf::register_command $name => \&callback($ob,$args);
432 my $extension = shift;
433 my $event_code = shift;
434 583
435 my $cb = $hook[$event_code]{$extension} 584Register a callback for execution when the client sends the user command
436 or return; 585$name.
437 586
438 &$cb 587=cut
439}
440
441sub inject_global_event {
442 my $event = shift;
443
444 my $cb = $hook[$event]
445 or return;
446
447 List::Util::max map &$_, values %$cb
448}
449
450sub inject_command {
451 my ($name, $obj, $params) = @_;
452
453 for my $cmd (@{ $command{$name} }) {
454 $cmd->[1]->($obj, $params);
455 }
456
457 -1
458}
459 588
460sub register_command { 589sub register_command {
461 my ($name, $time, $cb) = @_; 590 my ($name, $cb) = @_;
462 591
463 my $caller = caller; 592 my $caller = caller;
464 #warn "registering command '$name/$time' to '$caller'"; 593 #warn "registering command '$name/$time' to '$caller'";
465 594
466 push @{ $command{$name} }, [$time, $cb, $caller]; 595 push @{ $COMMAND{$name} }, [$caller, $cb];
467 $COMMAND{"$name\000"} = List::Util::max map $_->[0], @{ $command{$name} };
468} 596}
597
598=item cf::register_extcmd $name => \&callback($pl,$packet);
599
600Register a callbackf ro execution when the client sends an extcmd packet.
601
602If the callback returns something, it is sent back as if reply was being
603called.
604
605=cut
469 606
470sub register_extcmd { 607sub register_extcmd {
471 my ($name, $cb) = @_; 608 my ($name, $cb) = @_;
472 609
473 my $caller = caller; 610 my $caller = caller;
474 #warn "registering extcmd '$name' to '$caller'"; 611 #warn "registering extcmd '$name' to '$caller'";
475 612
476 $extcmd{$name} = [$cb, $caller]; 613 $EXTCMD{$name} = [$cb, $caller];
477} 614}
615
616attach_to_players
617 on_command => sub {
618 my ($pl, $name, $params) = @_;
619
620 my $cb = $COMMAND{$name}
621 or return;
622
623 for my $cmd (@$cb) {
624 $cmd->[1]->($pl->ob, $params);
625 }
626
627 cf::override;
628 },
629 on_extcmd => sub {
630 my ($pl, $buf) = @_;
631
632 my $msg = eval { from_json $buf };
633
634 if (ref $msg) {
635 if (my $cb = $EXTCMD{$msg->{msgtype}}) {
636 if (my %reply = $cb->[0]->($pl, $msg)) {
637 $pl->ext_reply ($msg->{msgid}, %reply);
638 }
639 }
640 } else {
641 warn "player " . ($pl->ob->name) . " sent unparseable ext message: <$buf>\n";
642 }
643
644 cf::override;
645 },
646;
478 647
479sub register { 648sub register {
480 my ($base, $pkg) = @_; 649 my ($base, $pkg) = @_;
481 650
482 #TODO 651 #TODO
501 . "#line 1 \"$path\"\n{\n" 670 . "#line 1 \"$path\"\n{\n"
502 . (do { local $/; <$fh> }) 671 . (do { local $/; <$fh> })
503 . "\n};\n1"; 672 . "\n};\n1";
504 673
505 eval $source 674 eval $source
506 or die "$path: $@"; 675 or die $@ ? "$path: $@\n"
676 : "extension disabled.\n";
507 677
508 push @exts, $pkg; 678 push @exts, $pkg;
509 $ext_pkg{$base} = $pkg; 679 $ext_pkg{$base} = $pkg;
510 680
511# no strict 'refs'; 681# no strict 'refs';
524# for my $idx (0 .. $#PLUGIN_EVENT) { 694# for my $idx (0 .. $#PLUGIN_EVENT) {
525# delete $hook[$idx]{$pkg}; 695# delete $hook[$idx]{$pkg};
526# } 696# }
527 697
528 # remove commands 698 # remove commands
529 for my $name (keys %command) { 699 for my $name (keys %COMMAND) {
530 my @cb = grep $_->[2] ne $pkg, @{ $command{$name} }; 700 my @cb = grep $_->[0] ne $pkg, @{ $COMMAND{$name} };
531 701
532 if (@cb) { 702 if (@cb) {
533 $command{$name} = \@cb; 703 $COMMAND{$name} = \@cb;
534 $COMMAND{"$name\000"} = List::Util::max map $_->[0], @cb;
535 } else { 704 } else {
536 delete $command{$name};
537 delete $COMMAND{"$name\000"}; 705 delete $COMMAND{$name};
538 } 706 }
539 } 707 }
540 708
541 # remove extcmds 709 # remove extcmds
542 for my $name (grep $extcmd{$_}[1] eq $pkg, keys %extcmd) { 710 for my $name (grep $EXTCMD{$_}[1] eq $pkg, keys %EXTCMD) {
543 delete $extcmd{$name}; 711 delete $EXTCMD{$name};
544 } 712 }
545 713
546 if (my $cb = $pkg->can ("unload")) { 714 if (my $cb = $pkg->can ("unload")) {
547 eval { 715 eval {
548 $cb->($pkg); 716 $cb->($pkg);
552 720
553 Symbol::delete_package $pkg; 721 Symbol::delete_package $pkg;
554} 722}
555 723
556sub load_extensions { 724sub load_extensions {
557 my $LIBDIR = maps_directory "perl";
558
559 for my $ext (<$LIBDIR/*.ext>) { 725 for my $ext (<$LIBDIR/*.ext>) {
560 next unless -r $ext; 726 next unless -r $ext;
561 eval { 727 eval {
562 load_extension $ext; 728 load_extension $ext;
563 1 729 1
564 } or warn "$ext not loaded: $@"; 730 } or warn "$ext not loaded: $@";
565 } 731 }
566} 732}
567 733
568sub _perl_reload(&) {
569 my ($msg) = @_;
570
571 $msg->("reloading...");
572
573 eval {
574 # 1. cancel all watchers
575 $_->cancel for Event::all_watchers;
576
577 # 2. unload all extensions
578 for (@exts) {
579 $msg->("unloading <$_>");
580 unload_extension $_;
581 }
582
583 # 3. unload all modules loaded from $LIBDIR
584 while (my ($k, $v) = each %INC) {
585 next unless $v =~ /^\Q$LIBDIR\E\/.*\.pm$/;
586
587 $msg->("removing <$k>");
588 delete $INC{$k};
589
590 $k =~ s/\.pm$//;
591 $k =~ s/\//::/g;
592
593 if (my $cb = $k->can ("unload_module")) {
594 $cb->();
595 }
596
597 Symbol::delete_package $k;
598 }
599
600 # 4. get rid of safe::, as good as possible
601 Symbol::delete_package "safe::$_"
602 for qw(cf::object cf::object::player cf::player cf::map cf::party cf::region);
603
604 # 5. remove register_script_function callbacks
605 # TODO
606
607 # 6. unload cf.pm "a bit"
608 delete $INC{"cf.pm"};
609
610 # don't, removes xs symbols, too,
611 # and global variables created in xs
612 #Symbol::delete_package __PACKAGE__;
613
614 # 7. reload cf.pm
615 $msg->("reloading cf.pm");
616 require cf;
617 };
618 $msg->($@) if $@;
619
620 $msg->("reloaded");
621};
622
623sub perl_reload() {
624 _perl_reload {
625 warn $_[0];
626 print "$_[0]\n";
627 };
628}
629
630register_command "perl-reload", 0, sub {
631 my ($who, $arg) = @_;
632
633 if ($who->flag (FLAG_WIZ)) {
634 _perl_reload {
635 warn $_[0];
636 $who->message ($_[0]);
637 };
638 }
639};
640
641#############################################################################
642# extcmd framework, basically convert ext <msg>
643# into pkg::->on_extcmd_arg1 (...) while shortcutting a few
644
645attach_to_players
646 on_extcmd => sub {
647 my ($pl, $buf) = @_;
648
649 my $msg = eval { from_json $buf };
650
651 if (ref $msg) {
652 if (my $cb = $extcmd{$msg->{msgtype}}) {
653 if (my %reply = $cb->[0]->($pl, $msg)) {
654 $pl->ext_reply ($msg->{msgid}, %reply);
655 }
656 }
657 } else {
658 warn "player " . ($pl->ob->name) . " sent unparseable ext message: <$buf>\n";
659 }
660
661 cf::override;
662 },
663;
664
665############################################################################# 734#############################################################################
666# load/save/clean perl data associated with a map 735# load/save/clean perl data associated with a map
667 736
668*cf::mapsupport::on_clean = sub { 737*cf::mapsupport::on_clean = sub {
669 my ($map) = @_; 738 my ($map) = @_;
670 739
671 my $path = $map->tmpname; 740 my $path = $map->tmpname;
672 defined $path or return; 741 defined $path or return;
673 742
674 unlink "$path.cfperl";
675 unlink "$path.pst"; 743 unlink "$path.pst";
676}; 744};
677 745
678*cf::mapsupport::on_swapin =
679*cf::mapsupport::on_load = sub {
680 my ($map) = @_;
681
682 my $path = $map->tmpname;
683 $path = $map->path unless defined $path;
684
685 open my $fh, "<:raw", "$path.cfperl"
686 or return; # no perl data
687
688 my $data = Storable::thaw do { local $/; <$fh> };
689
690 $data->{version} <= 1
691 or return; # too new
692
693 $map->_set_obs ($data->{obs});
694};
695
696attach_to_maps prio => -10000, package => cf::mapsupport::; 746attach_to_maps prio => -10000, package => cf::mapsupport::;
697 747
698############################################################################# 748#############################################################################
699# load/save perl data associated with player->ob objects 749# load/save perl data associated with player->ob objects
700 750
701sub all_objects(@) { 751sub all_objects(@) {
702 @_, map all_objects ($_->inv), @_ 752 @_, map all_objects ($_->inv), @_
703} 753}
704 754
755# TODO: compatibility cruft, remove when no longer needed
705attach_to_players 756attach_to_players
706 on_load => sub { 757 on_load => sub {
707 my ($pl, $path) = @_; 758 my ($pl, $path) = @_;
708 759
709 for my $o (all_objects $pl->ob) { 760 for my $o (all_objects $pl->ob) {
715 } 766 }
716 }, 767 },
717; 768;
718 769
719############################################################################# 770#############################################################################
720# core extensions - in perl 771
772=head2 CORE EXTENSIONS
773
774Functions and methods that extend core crossfire objects.
775
776=over 4
721 777
722=item cf::player::exists $login 778=item cf::player::exists $login
723 779
724Returns true when the given account exists. 780Returns true when the given account exists.
725 781
728sub cf::player::exists($) { 784sub cf::player::exists($) {
729 cf::player::find $_[0] 785 cf::player::find $_[0]
730 or -f sprintf "%s/%s/%s/%s.pl", cf::localdir, cf::playerdir, ($_[0]) x 2; 786 or -f sprintf "%s/%s/%s/%s.pl", cf::localdir, cf::playerdir, ($_[0]) x 2;
731} 787}
732 788
733=item $player->reply ($npc, $msg[, $flags]) 789=item $player_object->reply ($npc, $msg[, $flags])
734 790
735Sends a message to the player, as if the npc C<$npc> replied. C<$npc> 791Sends a message to the player, as if the npc C<$npc> replied. C<$npc>
736can be C<undef>. Does the right thing when the player is currently in a 792can be C<undef>. Does the right thing when the player is currently in a
737dialogue with the given NPC character. 793dialogue with the given NPC character.
738 794
765 $msg{msgid} = $id; 821 $msg{msgid} = $id;
766 822
767 $self->send ("ext " . to_json \%msg); 823 $self->send ("ext " . to_json \%msg);
768} 824}
769 825
826=item $player_object->may ("access")
827
828Returns wether the given player is authorized to access resource "access"
829(e.g. "command_wizcast").
830
831=cut
832
833sub cf::object::player::may {
834 my ($self, $access) = @_;
835
836 $self->flag (cf::FLAG_WIZ) ||
837 (ref $cf::CFG{"may_$access"}
838 ? scalar grep $self->name eq $_, @{$cf::CFG{"may_$access"}}
839 : $cf::CFG{"may_$access"})
840}
841
842=cut
843
770############################################################################# 844#############################################################################
771# map scripting support 845
846=head2 SAFE SCRIPTING
847
848Functions that provide a safe environment to compile and execute
849snippets of perl code without them endangering the safety of the server
850itself. Looping constructs, I/O operators and other built-in functionality
851is not available in the safe scripting environment, and the number of
852functions and methods that can be called is greatly reduced.
853
854=cut
772 855
773our $safe = new Safe "safe"; 856our $safe = new Safe "safe";
774our $safe_hole = new Safe::Hole; 857our $safe_hole = new Safe::Hole;
775 858
776$SIG{FPE} = 'IGNORE'; 859$SIG{FPE} = 'IGNORE';
777 860
778$safe->permit_only (Opcode::opset qw(:base_core :base_mem :base_orig :base_math sort time)); 861$safe->permit_only (Opcode::opset qw(:base_core :base_mem :base_orig :base_math sort time));
779 862
780# here we export the classes and methods available to script code 863# here we export the classes and methods available to script code
864
865=pod
866
867The following fucntions and emthods are available within a safe environment:
868
869 cf::object contr pay_amount pay_player
870 cf::object::player player
871 cf::player peaceful
872
873=cut
781 874
782for ( 875for (
783 ["cf::object" => qw(contr pay_amount pay_player)], 876 ["cf::object" => qw(contr pay_amount pay_player)],
784 ["cf::object::player" => qw(player)], 877 ["cf::object::player" => qw(player)],
785 ["cf::player" => qw(peaceful)], 878 ["cf::player" => qw(peaceful)],
788 my ($pkg, @funs) = @$_; 881 my ($pkg, @funs) = @$_;
789 *{"safe::$pkg\::$_"} = $safe_hole->wrap (\&{"$pkg\::$_"}) 882 *{"safe::$pkg\::$_"} = $safe_hole->wrap (\&{"$pkg\::$_"})
790 for @funs; 883 for @funs;
791} 884}
792 885
886=over 4
887
888=item @retval = safe_eval $code, [var => value, ...]
889
890Compiled and executes the given perl code snippet. additional var/value
891pairs result in temporary local (my) scalar variables of the given name
892that are available in the code snippet. Example:
893
894 my $five = safe_eval '$first + $second', first => 1, second => 4;
895
896=cut
897
793sub safe_eval($;@) { 898sub safe_eval($;@) {
794 my ($code, %vars) = @_; 899 my ($code, %vars) = @_;
795 900
796 my $qcode = $code; 901 my $qcode = $code;
797 $qcode =~ s/"/‟/g; # not allowed in #line filenames 902 $qcode =~ s/"/‟/g; # not allowed in #line filenames
819 } 924 }
820 925
821 wantarray ? @res : $res[0] 926 wantarray ? @res : $res[0]
822} 927}
823 928
929=item cf::register_script_function $function => $cb
930
931Register a function that can be called from within map/npc scripts. The
932function should be reasonably secure and should be put into a package name
933like the extension.
934
935Example: register a function that gets called whenever a map script calls
936C<rent::overview>, as used by the C<rent> extension.
937
938 cf::register_script_function "rent::overview" => sub {
939 ...
940 };
941
942=cut
943
824sub register_script_function { 944sub register_script_function {
825 my ($fun, $cb) = @_; 945 my ($fun, $cb) = @_;
826 946
827 no strict 'refs'; 947 no strict 'refs';
828 *{"safe::$fun"} = $safe_hole->wrap ($cb); 948 *{"safe::$fun"} = $safe_hole->wrap ($cb);
829} 949}
830 950
951=back
952
953=cut
954
955#############################################################################
956
957=head2 EXTENSION DATABASE SUPPORT
958
959Crossfire maintains a very simple database for extension use. It can
960currently store anything that can be serialised using Storable, which
961excludes objects.
962
963The parameter C<$family> should best start with the name of the extension
964using it, it should be unique.
965
966=over 4
967
968=item $hashref = cf::db_get $family
969
970Return a hashref for use by the extension C<$family>, which can be
971modified. After modifications, you have to call C<cf::db_dirty> or
972C<cf::db_sync>.
973
974=item $value = cf::db_get $family => $key
975
976Returns a single value from the database
977
978=item cf::db_put $family => $hashref
979
980Stores the given family hashref into the database. Updates are delayed, if
981you want the data to be synced to disk immediately, use C<cf::db_sync>.
982
983=item cf::db_put $family => $key => $value
984
985Stores the given C<$value> in the family hash. Updates are delayed, if you
986want the data to be synced to disk immediately, use C<cf::db_sync>.
987
988=item cf::db_dirty
989
990Marks the database as dirty, to be updated at a later time.
991
992=item cf::db_sync
993
994Immediately write the database to disk I<if it is dirty>.
995
996=cut
997
998our $DB;
999
1000{
1001 my $path = cf::localdir . "/database.pst";
1002
1003 sub db_load() {
1004 warn "loading database $path\n";#d# remove later
1005 $DB = stat $path ? Storable::retrieve $path : { };
1006 }
1007
1008 my $pid;
1009
1010 sub db_save() {
1011 warn "saving database $path\n";#d# remove later
1012 waitpid $pid, 0 if $pid;
1013 if (0 == ($pid = fork)) {
1014 $DB->{_meta}{version} = 1;
1015 Storable::nstore $DB, "$path~";
1016 rename "$path~", $path;
1017 cf::_exit 0 if defined $pid;
1018 }
1019 }
1020
1021 my $dirty;
1022
1023 sub db_sync() {
1024 db_save if $dirty;
1025 undef $dirty;
1026 }
1027
1028 my $idle = Event->idle (min => $TICK * 2.8, max => 10, repeat => 0, data => WF_AUTOCANCEL, cb => sub {
1029 db_sync;
1030 });
1031
1032 sub db_dirty() {
1033 $dirty = 1;
1034 $idle->start;
1035 }
1036
1037 sub db_get($;$) {
1038 @_ >= 2
1039 ? $DB->{$_[0]}{$_[1]}
1040 : ($DB->{$_[0]} ||= { })
1041 }
1042
1043 sub db_put($$;$) {
1044 if (@_ >= 3) {
1045 $DB->{$_[0]}{$_[1]} = $_[2];
1046 } else {
1047 $DB->{$_[0]} = $_[1];
1048 }
1049 db_dirty;
1050 }
1051
1052 attach_global
1053 prio => 10000,
1054 on_cleanup => sub {
1055 db_sync;
1056 },
1057 ;
1058}
1059
831############################################################################# 1060#############################################################################
832# the server's main() 1061# the server's main()
833 1062
1063sub cfg_load {
1064 open my $fh, "<:utf8", cf::confdir . "/config"
1065 or return;
1066
1067 local $/;
1068 *CFG = YAML::Syck::Load <$fh>;
1069}
1070
834sub main { 1071sub main {
1072 cfg_load;
1073 db_load;
1074 load_extensions;
835 Event::loop; 1075 Event::loop;
836} 1076}
837 1077
838############################################################################# 1078#############################################################################
839# initialisation 1079# initialisation
840 1080
1081sub _perl_reload(&) {
1082 my ($msg) = @_;
1083
1084 $msg->("reloading...");
1085
1086 eval {
1087 # cancel all watchers
1088 for (Event::all_watchers) {
1089 $_->cancel if $_->data & WF_AUTOCANCEL;
1090 }
1091
1092 # unload all extensions
1093 for (@exts) {
1094 $msg->("unloading <$_>");
1095 unload_extension $_;
1096 }
1097
1098 # unload all modules loaded from $LIBDIR
1099 while (my ($k, $v) = each %INC) {
1100 next unless $v =~ /^\Q$LIBDIR\E\/.*\.pm$/;
1101
1102 $msg->("removing <$k>");
1103 delete $INC{$k};
1104
1105 $k =~ s/\.pm$//;
1106 $k =~ s/\//::/g;
1107
1108 if (my $cb = $k->can ("unload_module")) {
1109 $cb->();
1110 }
1111
1112 Symbol::delete_package $k;
1113 }
1114
1115 # sync database to disk
1116 cf::db_sync;
1117
1118 # get rid of safe::, as good as possible
1119 Symbol::delete_package "safe::$_"
1120 for qw(cf::object cf::object::player cf::player cf::map cf::party cf::region);
1121
1122 # remove register_script_function callbacks
1123 # TODO
1124
1125 # unload cf.pm "a bit"
1126 delete $INC{"cf.pm"};
1127
1128 # don't, removes xs symbols, too,
1129 # and global variables created in xs
1130 #Symbol::delete_package __PACKAGE__;
1131
1132 # reload cf.pm
1133 $msg->("reloading cf.pm");
1134 require cf;
1135
1136 # load config and database again
1137 cf::cfg_load;
1138 cf::db_load;
1139
1140 # load extensions
1141 $msg->("load extensions");
1142 cf::load_extensions;
1143
1144 # reattach attachments to objects
1145 $msg->("reattach");
1146 _global_reattach;
1147 };
1148 $msg->($@) if $@;
1149
1150 $msg->("reloaded");
1151};
1152
1153sub perl_reload() {
1154 _perl_reload {
1155 warn $_[0];
1156 print "$_[0]\n";
1157 };
1158}
1159
841register "<global>", __PACKAGE__; 1160register "<global>", __PACKAGE__;
842 1161
1162register_command "perl-reload" => sub {
1163 my ($who, $arg) = @_;
1164
1165 if ($who->flag (FLAG_WIZ)) {
1166 _perl_reload {
1167 warn $_[0];
1168 $who->message ($_[0]);
1169 };
1170 }
1171};
1172
843unshift @INC, $LIBDIR; 1173unshift @INC, $LIBDIR;
844 1174
845load_extensions;
846
847$TICK_WATCHER = Event->timer ( 1175$TICK_WATCHER = Event->timer (
848 prio => 1, 1176 prio => 0,
849 at => $NEXT_TICK || 1, 1177 at => $NEXT_TICK || 1,
1178 data => WF_AUTOCANCEL,
850 cb => sub { 1179 cb => sub {
851 cf::server_tick; # one server iteration 1180 cf::server_tick; # one server iteration
852 1181
853 my $NOW = Event::time; 1182 my $NOW = Event::time;
854 $NEXT_TICK += $TICK; 1183 $NEXT_TICK += $TICK;
855 1184
856 # if we are delayed by four ticks, skip them all 1185 # if we are delayed by four ticks or more, skip them all
857 $NEXT_TICK = $NOW if $NOW >= $NEXT_TICK + $TICK * 4; 1186 $NEXT_TICK = $NOW if $NOW >= $NEXT_TICK + $TICK * 4;
858 1187
859 $TICK_WATCHER->at ($NEXT_TICK); 1188 $TICK_WATCHER->at ($NEXT_TICK);
860 $TICK_WATCHER->start; 1189 $TICK_WATCHER->start;
861 }, 1190 },
862); 1191);
863 1192
1193IO::AIO::max_poll_time $TICK * 0.2;
1194
1195Event->io (fd => IO::AIO::poll_fileno,
1196 poll => 'r',
1197 prio => 5,
1198 data => WF_AUTOCANCEL,
1199 cb => \&IO::AIO::poll_cb);
1200
8641 12011
865 1202

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines