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.60 by root, Thu Aug 31 06:23:19 2006 UTC vs.
Revision 1.92 by root, Thu Dec 21 06:42:28 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
16_reload_1; 21sub WF_AUTOCANCEL () { 1 } # automatically cancel this watcher on reload
17 22
18our %COMMAND = (); 23our %COMMAND = ();
24our %COMMAND_TIME = ();
25our %EXTCMD = ();
26
27_init_vars;
28
19our @EVENT; 29our @EVENT;
20our %PROP_TYPE; 30our $LIBDIR = datadir . "/ext";
21our %PROP_IDX;
22our $LIBDIR = maps_directory "perl";
23 31
24our $TICK = MAX_TIME * 1e-6; 32our $TICK = MAX_TIME * 1e-6;
25our $TICK_WATCHER; 33our $TICK_WATCHER;
26our $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
27 67
28BEGIN { 68BEGIN {
29 *CORE::GLOBAL::warn = sub { 69 *CORE::GLOBAL::warn = sub {
30 my $msg = join "", @_; 70 my $msg = join "", @_;
31 $msg .= "\n" 71 $msg .= "\n"
34 print STDERR "cfperl: $msg"; 74 print STDERR "cfperl: $msg";
35 LOG llevError, "cfperl: $msg"; 75 LOG llevError, "cfperl: $msg";
36 }; 76 };
37} 77}
38 78
39my %ignore_set = (MAP_PROP_PATH => 1); # I hate the plug-in api. Deeply!
40
41# generate property mutators
42sub prop_gen {
43 my ($prefix, $class) = @_;
44
45 no strict 'refs';
46
47 for my $prop (keys %PROP_TYPE) {
48 $prop =~ /^\Q$prefix\E_(.*$)/ or next;
49 my $sub = lc $1;
50
51 my $type = $PROP_TYPE{$prop};
52 my $idx = $PROP_IDX {$prop};
53
54 *{"$class\::get_$sub"} = *{"$class\::$sub"} = sub {
55 $_[0]->get_property ($type, $idx)
56 };
57
58 *{"$class\::set_$sub"} = sub {
59 $_[0]->set_property ($type, $idx, $_[1]);
60 } unless $ignore_set{$prop};
61 }
62}
63
64# auto-generate most of the API
65
66prop_gen OBJECT_PROP => "cf::object";
67# CFAPI_OBJECT_ANIMATION?
68prop_gen PLAYER_PROP => "cf::object::player";
69
70prop_gen MAP_PROP => "cf::map";
71prop_gen ARCH_PROP => "cf::arch";
72
73@safe::cf::object::player::ISA = @cf::object::player::ISA = 'cf::object'; 79@safe::cf::object::player::ISA = @cf::object::player::ISA = 'cf::object';
74 80
75# 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
76# within the Safe compartment. 82# within the Safe compartment.
77for my $pkg (qw(cf::object cf::object::player cf::player cf::map cf::party cf::region cf::arch cf::living)) { 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)) {
78 no strict 'refs'; 89 no strict 'refs';
79 @{"safe::$pkg\::wrap::ISA"} = @{"$pkg\::wrap::ISA"} = $pkg; 90 @{"safe::$pkg\::wrap::ISA"} = @{"$pkg\::wrap::ISA"} = $pkg;
80} 91}
81 92
82$Event::DIED = sub { 93$Event::DIED = sub {
84}; 95};
85 96
86my %ext_pkg; 97my %ext_pkg;
87my @exts; 98my @exts;
88my @hook; 99my @hook;
89my %command;
90my %extcmd;
91 100
92############################################################################# 101=head2 UTILITY FUNCTIONS
93# utility functions 102
103=over 4
104
105=cut
94 106
95use 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
96 114
97sub from_json($) { 115sub from_json($) {
98 $JSON::Syck::ImplicitUnicode = 1; # work around JSON::Syck bugs 116 $JSON::Syck::ImplicitUnicode = 1; # work around JSON::Syck bugs
99 JSON::Syck::Load $_[0] 117 JSON::Syck::Load $_[0]
100} 118}
101 119
120=item $json = cf::to_json $ref
121
122Converts a perl data structure into its JSON representation.
123
124=cut
125
102sub to_json($) { 126sub to_json($) {
103 $JSON::Syck::ImplicitUnicode = 0; # work around JSON::Syck bugs 127 $JSON::Syck::ImplicitUnicode = 0; # work around JSON::Syck bugs
104 JSON::Syck::Dump $_[0] 128 JSON::Syck::Dump $_[0]
105} 129}
106 130
131=back
132
133=cut
134
107############################################################################# 135#############################################################################
108# "new" plug-in system
109 136
110=head3 EVENTS AND OBJECT ATTACHMENTS 137=head2 EVENTS AND OBJECT ATTACHMENTS
111 138
112=over 4 139=over 4
113 140
114=item $object->attach ($attachment, key => $value...) 141=item $object->attach ($attachment, key => $value...)
115 142
125 152
126=item $map->attach ($attachment, key => $value...) 153=item $map->attach ($attachment, key => $value...)
127 154
128=item $map->detach ($attachment) 155=item $map->detach ($attachment)
129 156
157Attach/detach a pre-registered attachment to a client.
158
159=item $client->attach ($attachment, key => $value...)
160
161=item $client->detach ($attachment)
162
130Attach/detach a pre-registered attachment to a map. 163Attach/detach a pre-registered attachment to a map.
131 164
132=item $bool = $object->attached ($name) 165=item $bool = $object->attached ($name)
133 166
134=item $bool = $player->attached ($name) 167=item $bool = $player->attached ($name)
168
169=item $bool = $client->attached ($name)
135 170
136=item $bool = $map->attached ($name) 171=item $bool = $map->attached ($name)
137 172
138Checks wether the named attachment is currently attached to the object. 173Checks wether the named attachment is currently attached to the object.
139 174
186 221
187=item cf::attach_to_players ... 222=item cf::attach_to_players ...
188 223
189Attach handlers to all players. 224Attach handlers to all players.
190 225
226=item cf::attach_to_clients ...
227
228Attach handlers to all players.
229
191=item cf::attach_to_maps ... 230=item cf::attach_to_maps ...
192 231
193Attach handlers to all maps. 232Attach handlers to all maps.
194 233
195=item cf:register_attachment $name, ... 234=item cf:register_attachment $name, ...
211 250
212# the following variables are defined in .xs and must not be re-created 251# the following variables are defined in .xs and must not be re-created
213our @CB_GLOBAL = (); # registry for all global events 252our @CB_GLOBAL = (); # registry for all global events
214our @CB_OBJECT = (); # all objects (should not be used except in emergency) 253our @CB_OBJECT = (); # all objects (should not be used except in emergency)
215our @CB_PLAYER = (); 254our @CB_PLAYER = ();
255our @CB_CLIENT = ();
216our @CB_TYPE = (); # registry for type (cf-object class) based events 256our @CB_TYPE = (); # registry for type (cf-object class) based events
217our @CB_MAP = (); 257our @CB_MAP = ();
218 258
219my %attachment; 259my %attachment;
220 260
303 $res 343 $res
304} 344}
305 345
306*cf::object::attach = 346*cf::object::attach =
307*cf::player::attach = 347*cf::player::attach =
348*cf::client::attach =
308*cf::map::attach = sub { 349*cf::map::attach = sub {
309 my ($obj, $name, %arg) = @_; 350 my ($obj, $name, %arg) = @_;
310 351
311 _attach_attachment $obj, $name, %arg; 352 _attach_attachment $obj, $name, %arg;
312}; 353};
313 354
314# all those should be optimised 355# all those should be optimised
315*cf::object::detach = 356*cf::object::detach =
316*cf::player::detach = 357*cf::player::detach =
358*cf::client::detach =
317*cf::map::detach = sub { 359*cf::map::detach = sub {
318 my ($obj, $name) = @_; 360 my ($obj, $name) = @_;
319 361
320 delete $obj->{_attachment}{$name}; 362 delete $obj->{_attachment}{$name};
321 reattach ($obj); 363 reattach ($obj);
322}; 364};
323 365
324*cf::object::attached = 366*cf::object::attached =
325*cf::player::attached = 367*cf::player::attached =
368*cf::client::attached =
326*cf::map::attached = sub { 369*cf::map::attached = sub {
327 my ($obj, $name) = @_; 370 my ($obj, $name) = @_;
328 371
329 exists $obj->{_attachment}{$name} 372 exists $obj->{_attachment}{$name}
330}; 373};
346 389
347sub attach_to_players { 390sub attach_to_players {
348 _attach @CB_PLAYER, KLASS_PLAYER, @_ 391 _attach @CB_PLAYER, KLASS_PLAYER, @_
349} 392}
350 393
394sub attach_to_clients {
395 _attach @CB_CLIENT, KLASS_CLIENT, @_
396}
397
351sub attach_to_maps { 398sub attach_to_maps {
352 _attach @CB_MAP, KLASS_MAP, @_ 399 _attach @CB_MAP, KLASS_MAP, @_
353} 400}
354 401
355sub register_attachment { 402sub register_attachment {
360 407
361sub register_player_attachment { 408sub register_player_attachment {
362 my $name = shift; 409 my $name = shift;
363 410
364 $attachment{$name} = [[KLASS_PLAYER, @_]]; 411 $attachment{$name} = [[KLASS_PLAYER, @_]];
412}
413
414sub register_client_attachment {
415 my $name = shift;
416
417 $attachment{$name} = [[KLASS_CLIENT, @_]];
365} 418}
366 419
367sub register_map_attachment { 420sub register_map_attachment {
368 my $name = shift; 421 my $name = shift;
369 422
389 for (@$callbacks) { 442 for (@$callbacks) {
390 eval { &{$_->[1]} }; 443 eval { &{$_->[1]} };
391 444
392 if ($@) { 445 if ($@) {
393 warn "$@"; 446 warn "$@";
394 warn "... while processing $EVENT[$event][0] event, skipping processing altogether.\n"; 447 warn "... while processing $EVENT[$event][0](@_) event, skipping processing altogether.\n";
395 override; 448 override;
396 } 449 }
397 450
398 return 1 if $override; 451 return 1 if $override;
399 } 452 }
404=item $bool = cf::invoke EVENT_GLOBAL_XXX, ... 457=item $bool = cf::invoke EVENT_GLOBAL_XXX, ...
405 458
406=item $bool = $object->invoke (EVENT_OBJECT_XXX, ...) 459=item $bool = $object->invoke (EVENT_OBJECT_XXX, ...)
407 460
408=item $bool = $player->invoke (EVENT_PLAYER_XXX, ...) 461=item $bool = $player->invoke (EVENT_PLAYER_XXX, ...)
462
463=item $bool = $client->invoke (EVENT_CLIENT_XXX, ...)
409 464
410=item $bool = $map->invoke (EVENT_MAP_XXX, ...) 465=item $bool = $map->invoke (EVENT_MAP_XXX, ...)
411 466
412Generate a global/object/player/map-specific event with the given arguments. 467Generate a global/object/player/map-specific event with the given arguments.
413 468
415removed in future versions), and there is no public API to access override 470removed in future versions), and there is no public API to access override
416results (if you must, access C<@cf::invoke_results> directly). 471results (if you must, access C<@cf::invoke_results> directly).
417 472
418=back 473=back
419 474
420=head2 methods valid for all pointers 475=cut
476
477#############################################################################
478
479=head2 METHODS VALID FOR ALL CORE OBJECTS
421 480
422=over 4 481=over 4
423 482
424=item $object->valid 483=item $object->valid, $player->valid, $client->valid, $map->valid
425
426=item $player->valid
427
428=item $map->valid
429 484
430Just because you have a perl object does not mean that the corresponding 485Just because you have a perl object does not mean that the corresponding
431C-level object still exists. If you try to access an object that has no 486C-level object still exists. If you try to access an object that has no
432valid C counterpart anymore you get an exception at runtime. This method 487valid C counterpart anymore you get an exception at runtime. This method
433can be used to test for existence of the C object part without causing an 488can be used to test for existence of the C object part without causing an
437 492
438=cut 493=cut
439 494
440*cf::object::valid = 495*cf::object::valid =
441*cf::player::valid = 496*cf::player::valid =
497*cf::client::valid =
442*cf::map::valid = \&cf::_valid; 498*cf::map::valid = \&cf::_valid;
443 499
444############################################################################# 500#############################################################################
445# object support 501# object support
446 502
506 unlink $filename; 562 unlink $filename;
507 unlink "$filename.pst"; 563 unlink "$filename.pst";
508 } 564 }
509} 565}
510 566
567sub object_freezer_as_string {
568 my ($rdata, $objs) = @_;
569
570 use Data::Dumper;
571
572 $$rdata . Dumper $objs
573}
574
511sub object_thawer_load { 575sub object_thawer_load {
512 my ($filename) = @_; 576 my ($filename) = @_;
513 577
578 local $/;
579
580 my $av;
581
582 #TODO: use sysread etc.
583 if (open my $data, "<:raw:perlio", $filename) {
584 $data = <$data>;
514 open my $fh, "<:raw:perlio", "$filename.pst" 585 if (open my $pst, "<:raw:perlio", "$filename.pst") {
515 or return; 586 $av = eval { (Storable::thaw <$pst>)->{objs} };
587 }
588 return ($data, $av);
589 }
516 590
517 eval { local $/; (Storable::thaw <$fh>)->{objs} } 591 ()
518} 592}
519 593
520attach_to_objects 594attach_to_objects
521 prio => -1000000, 595 prio => -1000000,
522 on_clone => sub { 596 on_clone => sub {
530 if exists $src->{_attachment}; 604 if exists $src->{_attachment};
531 }, 605 },
532; 606;
533 607
534############################################################################# 608#############################################################################
535# old plug-in events 609# command handling &c
536 610
537sub inject_event { 611=item cf::register_command $name => \&callback($ob,$args);
538 my $extension = shift;
539 my $event_code = shift;
540 612
541 my $cb = $hook[$event_code]{$extension} 613Register a callback for execution when the client sends the user command
542 or return; 614$name.
543 615
544 &$cb 616=cut
545}
546
547sub inject_global_event {
548 my $event = shift;
549
550 my $cb = $hook[$event]
551 or return;
552
553 List::Util::max map &$_, values %$cb
554}
555
556sub inject_command {
557 my ($name, $obj, $params) = @_;
558
559 for my $cmd (@{ $command{$name} }) {
560 $cmd->[1]->($obj, $params);
561 }
562
563 -1
564}
565 617
566sub register_command { 618sub register_command {
567 my ($name, $time, $cb) = @_; 619 my ($name, $cb) = @_;
568 620
569 my $caller = caller; 621 my $caller = caller;
570 #warn "registering command '$name/$time' to '$caller'"; 622 #warn "registering command '$name/$time' to '$caller'";
571 623
572 push @{ $command{$name} }, [$time, $cb, $caller]; 624 push @{ $COMMAND{$name} }, [$caller, $cb];
573 $COMMAND{"$name\000"} = List::Util::max map $_->[0], @{ $command{$name} };
574} 625}
626
627=item cf::register_extcmd $name => \&callback($pl,$packet);
628
629Register a callbackf ro execution when the client sends an extcmd packet.
630
631If the callback returns something, it is sent back as if reply was being
632called.
633
634=cut
575 635
576sub register_extcmd { 636sub register_extcmd {
577 my ($name, $cb) = @_; 637 my ($name, $cb) = @_;
578 638
579 my $caller = caller; 639 my $caller = caller;
580 #warn "registering extcmd '$name' to '$caller'"; 640 #warn "registering extcmd '$name' to '$caller'";
581 641
582 $extcmd{$name} = [$cb, $caller]; 642 $EXTCMD{$name} = [$cb, $caller];
583} 643}
644
645attach_to_players
646 on_command => sub {
647 my ($pl, $name, $params) = @_;
648
649 my $cb = $COMMAND{$name}
650 or return;
651
652 for my $cmd (@$cb) {
653 $cmd->[1]->($pl->ob, $params);
654 }
655
656 cf::override;
657 },
658 on_extcmd => sub {
659 my ($pl, $buf) = @_;
660
661 my $msg = eval { from_json $buf };
662
663 if (ref $msg) {
664 if (my $cb = $EXTCMD{$msg->{msgtype}}) {
665 if (my %reply = $cb->[0]->($pl, $msg)) {
666 $pl->ext_reply ($msg->{msgid}, %reply);
667 }
668 }
669 } else {
670 warn "player " . ($pl->ob->name) . " sent unparseable ext message: <$buf>\n";
671 }
672
673 cf::override;
674 },
675;
584 676
585sub register { 677sub register {
586 my ($base, $pkg) = @_; 678 my ($base, $pkg) = @_;
587 679
588 #TODO 680 #TODO
607 . "#line 1 \"$path\"\n{\n" 699 . "#line 1 \"$path\"\n{\n"
608 . (do { local $/; <$fh> }) 700 . (do { local $/; <$fh> })
609 . "\n};\n1"; 701 . "\n};\n1";
610 702
611 eval $source 703 eval $source
612 or die "$path: $@"; 704 or die $@ ? "$path: $@\n"
705 : "extension disabled.\n";
613 706
614 push @exts, $pkg; 707 push @exts, $pkg;
615 $ext_pkg{$base} = $pkg; 708 $ext_pkg{$base} = $pkg;
616 709
617# no strict 'refs'; 710# no strict 'refs';
630# for my $idx (0 .. $#PLUGIN_EVENT) { 723# for my $idx (0 .. $#PLUGIN_EVENT) {
631# delete $hook[$idx]{$pkg}; 724# delete $hook[$idx]{$pkg};
632# } 725# }
633 726
634 # remove commands 727 # remove commands
635 for my $name (keys %command) { 728 for my $name (keys %COMMAND) {
636 my @cb = grep $_->[2] ne $pkg, @{ $command{$name} }; 729 my @cb = grep $_->[0] ne $pkg, @{ $COMMAND{$name} };
637 730
638 if (@cb) { 731 if (@cb) {
639 $command{$name} = \@cb; 732 $COMMAND{$name} = \@cb;
640 $COMMAND{"$name\000"} = List::Util::max map $_->[0], @cb;
641 } else { 733 } else {
642 delete $command{$name};
643 delete $COMMAND{"$name\000"}; 734 delete $COMMAND{$name};
644 } 735 }
645 } 736 }
646 737
647 # remove extcmds 738 # remove extcmds
648 for my $name (grep $extcmd{$_}[1] eq $pkg, keys %extcmd) { 739 for my $name (grep $EXTCMD{$_}[1] eq $pkg, keys %EXTCMD) {
649 delete $extcmd{$name}; 740 delete $EXTCMD{$name};
650 } 741 }
651 742
652 if (my $cb = $pkg->can ("unload")) { 743 if (my $cb = $pkg->can ("unload")) {
653 eval { 744 eval {
654 $cb->($pkg); 745 $cb->($pkg);
658 749
659 Symbol::delete_package $pkg; 750 Symbol::delete_package $pkg;
660} 751}
661 752
662sub load_extensions { 753sub load_extensions {
663 my $LIBDIR = maps_directory "perl";
664
665 for my $ext (<$LIBDIR/*.ext>) { 754 for my $ext (<$LIBDIR/*.ext>) {
666 next unless -r $ext; 755 next unless -r $ext;
667 eval { 756 eval {
668 load_extension $ext; 757 load_extension $ext;
669 1 758 1
670 } or warn "$ext not loaded: $@"; 759 } or warn "$ext not loaded: $@";
671 } 760 }
672} 761}
673 762
674sub _perl_reload(&) {
675 my ($msg) = @_;
676
677 $msg->("reloading...");
678
679 eval {
680 # 1. cancel all watchers
681 $_->cancel for Event::all_watchers;
682
683 # 2. unload all extensions
684 for (@exts) {
685 $msg->("unloading <$_>");
686 unload_extension $_;
687 }
688
689 # 3. unload all modules loaded from $LIBDIR
690 while (my ($k, $v) = each %INC) {
691 next unless $v =~ /^\Q$LIBDIR\E\/.*\.pm$/;
692
693 $msg->("removing <$k>");
694 delete $INC{$k};
695
696 $k =~ s/\.pm$//;
697 $k =~ s/\//::/g;
698
699 if (my $cb = $k->can ("unload_module")) {
700 $cb->();
701 }
702
703 Symbol::delete_package $k;
704 }
705
706 # 4. get rid of safe::, as good as possible
707 Symbol::delete_package "safe::$_"
708 for qw(cf::object cf::object::player cf::player cf::map cf::party cf::region);
709
710 # 5. remove register_script_function callbacks
711 # TODO
712
713 # 6. unload cf.pm "a bit"
714 delete $INC{"cf.pm"};
715
716 # don't, removes xs symbols, too,
717 # and global variables created in xs
718 #Symbol::delete_package __PACKAGE__;
719
720 # 7. reload cf.pm
721 $msg->("reloading cf.pm");
722 require cf;
723 };
724 $msg->($@) if $@;
725
726 $msg->("reloaded");
727};
728
729sub perl_reload() {
730 _perl_reload {
731 warn $_[0];
732 print "$_[0]\n";
733 };
734}
735
736register_command "perl-reload", 0, sub {
737 my ($who, $arg) = @_;
738
739 if ($who->flag (FLAG_WIZ)) {
740 _perl_reload {
741 warn $_[0];
742 $who->message ($_[0]);
743 };
744 }
745};
746
747#############################################################################
748# extcmd framework, basically convert ext <msg>
749# into pkg::->on_extcmd_arg1 (...) while shortcutting a few
750
751attach_to_players
752 on_extcmd => sub {
753 my ($pl, $buf) = @_;
754
755 my $msg = eval { from_json $buf };
756
757 if (ref $msg) {
758 if (my $cb = $extcmd{$msg->{msgtype}}) {
759 if (my %reply = $cb->[0]->($pl, $msg)) {
760 $pl->ext_reply ($msg->{msgid}, %reply);
761 }
762 }
763 } else {
764 warn "player " . ($pl->ob->name) . " sent unparseable ext message: <$buf>\n";
765 }
766
767 cf::override;
768 },
769;
770
771############################################################################# 763#############################################################################
772# load/save/clean perl data associated with a map 764# load/save/clean perl data associated with a map
773 765
774*cf::mapsupport::on_clean = sub { 766*cf::mapsupport::on_clean = sub {
775 my ($map) = @_; 767 my ($map) = @_;
803 } 795 }
804 }, 796 },
805; 797;
806 798
807############################################################################# 799#############################################################################
808# core extensions - in perl 800
801=head2 CORE EXTENSIONS
802
803Functions and methods that extend core crossfire objects.
804
805=over 4
809 806
810=item cf::player::exists $login 807=item cf::player::exists $login
811 808
812Returns true when the given account exists. 809Returns true when the given account exists.
813 810
816sub cf::player::exists($) { 813sub cf::player::exists($) {
817 cf::player::find $_[0] 814 cf::player::find $_[0]
818 or -f sprintf "%s/%s/%s/%s.pl", cf::localdir, cf::playerdir, ($_[0]) x 2; 815 or -f sprintf "%s/%s/%s/%s.pl", cf::localdir, cf::playerdir, ($_[0]) x 2;
819} 816}
820 817
821=item $player->reply ($npc, $msg[, $flags]) 818=item $player_object->reply ($npc, $msg[, $flags])
822 819
823Sends a message to the player, as if the npc C<$npc> replied. C<$npc> 820Sends a message to the player, as if the npc C<$npc> replied. C<$npc>
824can be C<undef>. Does the right thing when the player is currently in a 821can be C<undef>. Does the right thing when the player is currently in a
825dialogue with the given NPC character. 822dialogue with the given NPC character.
826 823
853 $msg{msgid} = $id; 850 $msg{msgid} = $id;
854 851
855 $self->send ("ext " . to_json \%msg); 852 $self->send ("ext " . to_json \%msg);
856} 853}
857 854
855=item $player_object->may ("access")
856
857Returns wether the given player is authorized to access resource "access"
858(e.g. "command_wizcast").
859
860=cut
861
862sub cf::object::player::may {
863 my ($self, $access) = @_;
864
865 $self->flag (cf::FLAG_WIZ) ||
866 (ref $cf::CFG{"may_$access"}
867 ? scalar grep $self->name eq $_, @{$cf::CFG{"may_$access"}}
868 : $cf::CFG{"may_$access"})
869}
870
871=cut
872
858############################################################################# 873#############################################################################
859# map scripting support 874
875=head2 SAFE SCRIPTING
876
877Functions that provide a safe environment to compile and execute
878snippets of perl code without them endangering the safety of the server
879itself. Looping constructs, I/O operators and other built-in functionality
880is not available in the safe scripting environment, and the number of
881functions and methods that can be called is greatly reduced.
882
883=cut
860 884
861our $safe = new Safe "safe"; 885our $safe = new Safe "safe";
862our $safe_hole = new Safe::Hole; 886our $safe_hole = new Safe::Hole;
863 887
864$SIG{FPE} = 'IGNORE'; 888$SIG{FPE} = 'IGNORE';
865 889
866$safe->permit_only (Opcode::opset qw(:base_core :base_mem :base_orig :base_math sort time)); 890$safe->permit_only (Opcode::opset qw(:base_core :base_mem :base_orig :base_math sort time));
867 891
868# here we export the classes and methods available to script code 892# here we export the classes and methods available to script code
869 893
894=pod
895
896The following fucntions and emthods are available within a safe environment:
897
898 cf::object contr pay_amount pay_player map
899 cf::object::player player
900 cf::player peaceful
901 cf::map trigger
902
903=cut
904
870for ( 905for (
871 ["cf::object" => qw(contr pay_amount pay_player)], 906 ["cf::object" => qw(contr pay_amount pay_player map)],
872 ["cf::object::player" => qw(player)], 907 ["cf::object::player" => qw(player)],
873 ["cf::player" => qw(peaceful)], 908 ["cf::player" => qw(peaceful)],
909 ["cf::map" => qw(trigger)],
874) { 910) {
875 no strict 'refs'; 911 no strict 'refs';
876 my ($pkg, @funs) = @$_; 912 my ($pkg, @funs) = @$_;
877 *{"safe::$pkg\::$_"} = $safe_hole->wrap (\&{"$pkg\::$_"}) 913 *{"safe::$pkg\::$_"} = $safe_hole->wrap (\&{"$pkg\::$_"})
878 for @funs; 914 for @funs;
879} 915}
916
917=over 4
918
919=item @retval = safe_eval $code, [var => value, ...]
920
921Compiled and executes the given perl code snippet. additional var/value
922pairs result in temporary local (my) scalar variables of the given name
923that are available in the code snippet. Example:
924
925 my $five = safe_eval '$first + $second', first => 1, second => 4;
926
927=cut
880 928
881sub safe_eval($;@) { 929sub safe_eval($;@) {
882 my ($code, %vars) = @_; 930 my ($code, %vars) = @_;
883 931
884 my $qcode = $code; 932 my $qcode = $code;
907 } 955 }
908 956
909 wantarray ? @res : $res[0] 957 wantarray ? @res : $res[0]
910} 958}
911 959
960=item cf::register_script_function $function => $cb
961
962Register a function that can be called from within map/npc scripts. The
963function should be reasonably secure and should be put into a package name
964like the extension.
965
966Example: register a function that gets called whenever a map script calls
967C<rent::overview>, as used by the C<rent> extension.
968
969 cf::register_script_function "rent::overview" => sub {
970 ...
971 };
972
973=cut
974
912sub register_script_function { 975sub register_script_function {
913 my ($fun, $cb) = @_; 976 my ($fun, $cb) = @_;
914 977
915 no strict 'refs'; 978 no strict 'refs';
916 *{"safe::$fun"} = $safe_hole->wrap ($cb); 979 *{"safe::$fun"} = $safe_hole->wrap ($cb);
917} 980}
918 981
982=back
983
984=cut
985
986#############################################################################
987
988=head2 EXTENSION DATABASE SUPPORT
989
990Crossfire maintains a very simple database for extension use. It can
991currently store anything that can be serialised using Storable, which
992excludes objects.
993
994The parameter C<$family> should best start with the name of the extension
995using it, it should be unique.
996
997=over 4
998
999=item $hashref = cf::db_get $family
1000
1001Return a hashref for use by the extension C<$family>, which can be
1002modified. After modifications, you have to call C<cf::db_dirty> or
1003C<cf::db_sync>.
1004
1005=item $value = cf::db_get $family => $key
1006
1007Returns a single value from the database
1008
1009=item cf::db_put $family => $hashref
1010
1011Stores the given family hashref into the database. Updates are delayed, if
1012you want the data to be synced to disk immediately, use C<cf::db_sync>.
1013
1014=item cf::db_put $family => $key => $value
1015
1016Stores the given C<$value> in the family hash. Updates are delayed, if you
1017want the data to be synced to disk immediately, use C<cf::db_sync>.
1018
1019=item cf::db_dirty
1020
1021Marks the database as dirty, to be updated at a later time.
1022
1023=item cf::db_sync
1024
1025Immediately write the database to disk I<if it is dirty>.
1026
1027=cut
1028
1029our $DB;
1030
1031{
1032 my $path = cf::localdir . "/database.pst";
1033
1034 sub db_load() {
1035 warn "loading database $path\n";#d# remove later
1036 $DB = stat $path ? Storable::retrieve $path : { };
1037 }
1038
1039 my $pid;
1040
1041 sub db_save() {
1042 warn "saving database $path\n";#d# remove later
1043 waitpid $pid, 0 if $pid;
1044 if (0 == ($pid = fork)) {
1045 $DB->{_meta}{version} = 1;
1046 Storable::nstore $DB, "$path~";
1047 rename "$path~", $path;
1048 cf::_exit 0 if defined $pid;
1049 }
1050 }
1051
1052 my $dirty;
1053
1054 sub db_sync() {
1055 db_save if $dirty;
1056 undef $dirty;
1057 }
1058
1059 my $idle = Event->idle (min => $TICK * 2.8, max => 10, repeat => 0, data => WF_AUTOCANCEL, cb => sub {
1060 db_sync;
1061 });
1062
1063 sub db_dirty() {
1064 $dirty = 1;
1065 $idle->start;
1066 }
1067
1068 sub db_get($;$) {
1069 @_ >= 2
1070 ? $DB->{$_[0]}{$_[1]}
1071 : ($DB->{$_[0]} ||= { })
1072 }
1073
1074 sub db_put($$;$) {
1075 if (@_ >= 3) {
1076 $DB->{$_[0]}{$_[1]} = $_[2];
1077 } else {
1078 $DB->{$_[0]} = $_[1];
1079 }
1080 db_dirty;
1081 }
1082
1083 attach_global
1084 prio => 10000,
1085 on_cleanup => sub {
1086 db_sync;
1087 },
1088 ;
1089}
1090
919############################################################################# 1091#############################################################################
920# the server's main() 1092# the server's main()
921 1093
1094sub cfg_load {
1095 open my $fh, "<:utf8", cf::confdir . "/config"
1096 or return;
1097
1098 local $/;
1099 *CFG = YAML::Syck::Load <$fh>;
1100}
1101
922sub main { 1102sub main {
1103 cfg_load;
1104 db_load;
1105 load_extensions;
923 Event::loop; 1106 Event::loop;
924} 1107}
925 1108
926############################################################################# 1109#############################################################################
927# initialisation 1110# initialisation
928 1111
1112sub _perl_reload(&) {
1113 my ($msg) = @_;
1114
1115 $msg->("reloading...");
1116
1117 eval {
1118 # cancel all watchers
1119 for (Event::all_watchers) {
1120 $_->cancel if $_->data & WF_AUTOCANCEL;
1121 }
1122
1123 # unload all extensions
1124 for (@exts) {
1125 $msg->("unloading <$_>");
1126 unload_extension $_;
1127 }
1128
1129 # unload all modules loaded from $LIBDIR
1130 while (my ($k, $v) = each %INC) {
1131 next unless $v =~ /^\Q$LIBDIR\E\/.*\.pm$/;
1132
1133 $msg->("removing <$k>");
1134 delete $INC{$k};
1135
1136 $k =~ s/\.pm$//;
1137 $k =~ s/\//::/g;
1138
1139 if (my $cb = $k->can ("unload_module")) {
1140 $cb->();
1141 }
1142
1143 Symbol::delete_package $k;
1144 }
1145
1146 # sync database to disk
1147 cf::db_sync;
1148
1149 # get rid of safe::, as good as possible
1150 Symbol::delete_package "safe::$_"
1151 for qw(cf::object cf::object::player cf::player cf::map cf::party cf::region);
1152
1153 # remove register_script_function callbacks
1154 # TODO
1155
1156 # unload cf.pm "a bit"
1157 delete $INC{"cf.pm"};
1158
1159 # don't, removes xs symbols, too,
1160 # and global variables created in xs
1161 #Symbol::delete_package __PACKAGE__;
1162
1163 # reload cf.pm
1164 $msg->("reloading cf.pm");
1165 require cf;
1166
1167 # load config and database again
1168 cf::cfg_load;
1169 cf::db_load;
1170
1171 # load extensions
1172 $msg->("load extensions");
1173 cf::load_extensions;
1174
1175 # reattach attachments to objects
1176 $msg->("reattach");
1177 _global_reattach;
1178 };
1179 $msg->($@) if $@;
1180
1181 $msg->("reloaded");
1182};
1183
1184sub perl_reload() {
1185 _perl_reload {
1186 warn $_[0];
1187 print "$_[0]\n";
1188 };
1189}
1190
929register "<global>", __PACKAGE__; 1191register "<global>", __PACKAGE__;
930 1192
1193register_command "perl-reload" => sub {
1194 my ($who, $arg) = @_;
1195
1196 if ($who->flag (FLAG_WIZ)) {
1197 _perl_reload {
1198 warn $_[0];
1199 $who->message ($_[0]);
1200 };
1201 }
1202};
1203
931unshift @INC, $LIBDIR; 1204unshift @INC, $LIBDIR;
932 1205
933load_extensions;
934
935$TICK_WATCHER = Event->timer ( 1206$TICK_WATCHER = Event->timer (
936 prio => 1, 1207 prio => 0,
937 at => $NEXT_TICK || 1, 1208 at => $NEXT_TICK || 1,
1209 data => WF_AUTOCANCEL,
938 cb => sub { 1210 cb => sub {
939 cf::server_tick; # one server iteration 1211 cf::server_tick; # one server iteration
940 1212
941 my $NOW = Event::time; 1213 my $NOW = Event::time;
942 $NEXT_TICK += $TICK; 1214 $NEXT_TICK += $TICK;
943 1215
944 # if we are delayed by four ticks, skip them all 1216 # if we are delayed by four ticks or more, skip them all
945 $NEXT_TICK = $NOW if $NOW >= $NEXT_TICK + $TICK * 4; 1217 $NEXT_TICK = $NOW if $NOW >= $NEXT_TICK + $TICK * 4;
946 1218
947 $TICK_WATCHER->at ($NEXT_TICK); 1219 $TICK_WATCHER->at ($NEXT_TICK);
948 $TICK_WATCHER->start; 1220 $TICK_WATCHER->start;
949 }, 1221 },
950); 1222);
951 1223
952_reload_2; 1224IO::AIO::max_poll_time $TICK * 0.2;
1225
1226Event->io (fd => IO::AIO::poll_fileno,
1227 poll => 'r',
1228 prio => 5,
1229 data => WF_AUTOCANCEL,
1230 cb => \&IO::AIO::poll_cb);
953 1231
9541 12321
955 1233

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines