Core Utility Help

$housekeeper

The housekeeper is an object that can help keep other objects where they belong. New MOOs may want to add their own user interface for the housekeeper; here is some information that may be helpful.

To indicate what objects should be cleaned:

:add_cleanup(object[, requestor[, where]])

Ask the housekeeper to clean 'object' for 'requestor' to 'where'.

Requestor defaults to 'player'.

Where defaults to object.location.

:remove_cleanup(what[, requestor])

Remove 'what' from the cleanup list at 'requestor's request.

Will remove it only if 'requestor' made the original request and owns

the object or the destination.

To actually get the housekeeper to clean stuff up:

:cleanup([insist])

Clean up player's objects. Argument is 'up' or 'up!' for manually

requested cleanups. 'up!' means to clean things even if it's against

the housekeeper's better judgement.

:replace(object[, insist])

Clean up the indicated object. 'insist' is as in :cleanup.

:continuous()

Starts the housekeeper cleaning continuously, killing any previous

continuous task. This should be called only when starting up a new MOO,

or if something has gone wrong, as normally it will just keep going

without any help.

:litterbug()

Clean up all the places in housekeeper.public_places by getting rid of

all contents not in their .residents lists. This is called by

:continuous, so it doesn't need to be called directly.

To find out what's being cleaned to where for whom:

:cleanup_list([whom])

Show 'player' the personal cleanup list for 'whom', or the housekeeper's

complete list if no argument is given.

:clean_status()

Show 'player' a brief summary of eir personal cleanup list.