Help: $wiz_utils | Mongoose

Showing help on '$wiz_utils'

wizard utilities ($wiz_utils #24)

Wizard Utilities

The following functions are substitutes for various server builtins.
Anytime one feel tempted to use one of the expressions on the right,
use the corresponding one on the left instead. This will take care
of various things that the server (for whatever reason) does not handle.

:set_programmer(object) object.programmer = 1;
chparent object to $prog
send mail to $prog_log

:set_player(object[,nochown]) set_player_flag(object,1);
set player flag,
add name/aliases to $player_db,
and maybe do a self chown.

:unset_player(object[,newowner]) set_player_flag(object,0);
unset player flag,
remove name/aliases from $player_db
chown to newowner if given

:set_owner(object, newowner) object.owner = newowner;
change ownership on object
change ownership on all +c properties
juggle .ownership_quotas

:set_property_owner(object, property, newowner[, suspend-ok])
change owner on a given property
if this is a -c property, we change the owner on all descendants
for which this is also a -c property.
Polite protest if property is +c and newowner != object.owner.

:set_property_flags(object, property, flags[, suspend-ok])
change the permissions on a given property and propagate these to
*all descendants*. property ownership is changed on descendants
where necessary.

:set_programmer(victim[,mail from]) => 1 or error.
:set_player(victim[,nochown]) => 1 or error
:set_owner(object,newowner[,suspendok]) does object.owner=newowner, taking care of c properties as well. This should be used anyplace one is contemplating doing object.owner=newowner, since the latter leaves ownership of c properties unchanged. (--Rog thinks this is a server bug).
:set_property_owner(object,prop,newowner[,suspendok]) changes the ownership of object.prop to newowner. If the property is !c, changes the ownership on all of the descendents as well. Otherwise, we just chown the property on the object itself and give a warning if newowner!=object.owner (--Rog thinks this is a server bug that one is able to do this at all...).
:unset_player(victim[,newowner]) => 1 or error
:set_property_flags(object,prop,flags[,suspendok]) changes the permissions on object.prop to flags. Unlike a mere set_property_info, this changes the flags on all descendant objects as well. We also change the ownership on the descendent properties where necessary.
:_set_property_flags - _set_property_flags(object, pname, {owner, flags} or something+"c", suspendok)
:random_password - Generate a random password of length args[1].
:queued_tasks(player) => list of queued tasks for that player.
:isnewt - Return 1 if args[1] is a newted player.
:connected_wizards() => list of currently connected wizards and players mentioned in .public_identity properties as being wizard counterparts.
:all_wizards_advertised() => list of all wizards who have set .advertised true and players mentioned their .public_identity properties as being wizard counterparts
:rename_all_instances(object,oldname,newname)
:missed_help(query, result) => none
:show_netwho_listing(tell,player_list)
:show_netwho_from_listing(tell,site)
:check_player_request(name [,email [,connection]])
:make_player - create a player named NAME with email address ADDRESS; return {object, password}.
:send_new_player_mail(preface, name, address, character#, password)
:do_register - do_register(name, email_address [,comments])
:do_new_password - do_new_password(who, [password])
:set_owner(object,newowner[,suspendok]) does object.owner=newowner, taking care of c properties as well. This should be used anyplace one is contemplating doing object.owner=newowner, since the latter leaves ownership of c properties unchanged. (--Rog thinks this is a server bug).
:grant_object(what, towhom);
:connection_hash - connection_hash(forwhom, host [,seed])
:newt_player(who [ , commentary] [, temporary])
:unset_programmer(victim[,reason[,start time,duration]]) => 1 or error.
:is_wizard(who) => whether `who' is a wizard or is the .public_identity of some wizard.
:check_prog_restricted - Checks to see if args[1] is restricted from programmer either permanently or temporarily.
:random_wizard - Put all your wizards in $wiz_utils.wizards.
:core_ref - this isn't E_MOO's verb probably, but it does the job (at least on recent LambdaCore MOOs)
:find_redundant_props(propname) -> list of {obj, value}
:clear_redundant_props(propname, ?objects) -> stats map
:clear_all_redundant_props(?dry_run) -> stats

Also from $generic_utils: 1 documented verb. help $generic_utils