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.44 by root, Sat Aug 26 08:44:06 2006 UTC vs.
Revision 1.76 by root, Mon Oct 2 15:28:36 2006 UTC

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

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines