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

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines