Each world has one or more caretakers. Caretaker bots are bots that log into the universe and world with the citizen number of a caretaker. They have all the caretaker privileges and, as bots, can do more than the caretaker him/herself.
Xelagots have a few facilities for caretakers. Most of them are found in the menu World | World attributes. Other facilities, like pushing URLs, teleporting someone (AW 3.0 caretakers and ejectors) etc, can be implemented through the user interface, verbal commands or action script statements.
The world attributes mangement can be reached at menu World | World attributes. It has several tabs.
- tab Features
Lists all common world attributes, similar to what the AW browser shows.
Attributes can be set here and using action script statements. Note the following:
if you move the mouse on the homepage caption, to the left of the input box, you can view it in your borwser
then input box for the Welcome Message has a pop-up menu (right click on the box) with two extra items: New Line to add a line break, and Tab to add a tab character
to bring up colour selectors, double-click on the colour panel
- tab Lights and Fog
New 3.0 facilities for positioning and colouring the world light sources and fog. These require a world server build 23 or higher. To view the effects of lights and fog, the users must have a new 3.0 browser.
Attributes can be set here and using action script statements.
The world has two light sources and fog:
- A directional light source, comparable to the sun or moon. It is at an infinite distance of the observer, somewhere in the sky. It casts parallel rays of light of a certain colour. The colour can be changed at the Directional Light Colour frame: double click on the coloured rectangle to activate the picker. The position of the light source can be changed at the Directional Light Vector frame. Click on edit to change the azimuth and elevation of the light source. The azimuth is the NWSE position of the source: if you look straight at it, it is the compass angle you face (in degrees), counting from the North westwards (range from 0 to 359.9). The elevation is the angle (in degrees) above the horizon, negative numbers will put the source below the horizon - it will still shine through the ground (range 90.0 to -90.0). Active Worlds uses a vectorial XYZ notation, difficult to use by mortals. The azimuth + elevation notation is fully equivalent and more intuitive.
- An ambient light source. This is indirect light, shining from all directions. The brighter it is, the less contrast you get: it softens the effect of the direct light source. You can change its colour at the Ambient Light Colour frame by clicking on the coloured rectangle.
- Fog. Fog has colour, distance and depth. The colour is determined by the background colour: yes, the traditional one on the Features tab, which is duplicated here. Change the colour at the Backdrop and Fog Colour frame. In the Fog frame: the distance fog starts is called Minimum and must be input in whole metres, the difference between the Maximum and Minimum distance determines the depth of the fog effect. Active Worlds recommends removing the backdrop image when using fog, except for special subtle effects.
- tab Rights
List of rights, similar to the AW browser.
Rights can be set here and using action script statements.
- tab File
Allows managing world attributes files in a format understood by the scripting language. You can select attributes by checkmarking them, load the checkmarked attributes from the World, Editor of from file. You can also load a whole file even if the attributes are not checkmarked. Checkmarked attributes can be sent to the Editor or saved to file. You can also save to file all attributes, whether checkmarked or not. Only attributes which can be edited are used.
These files can be used at present with the world schedule script.
- tab Ejections
New 3.0 facility, requires a world server build 23 or higher, but does not require a new browser.
Ejections are remembered by the world software in a database. To query the world ejection database, hit "Query" (the button caption changes to "Stop") and wait until the button caption shows the word "Query" again. You can change the time mode from VRT to Local time with radio buttons. To view a record, click on it on the list: this will bring the data to the Edit ejection section (which is disabled at this stage).
You can edit a record: modify the expiration time of the ejection, or remove the record from the database. You can also add a new IP to be blocked by the world server. While you edit, you may not change the Time mode, so select it before you start editing.
See also Topic: Ejections for how to eject.
- To modify the expiration time, select the record on the list, hit Edit and edit the expiration field. It must contain the year, month number (January is 1, December is 12), day, hour, minute, second. You may use spaces or commas as separators, or any of the usual date and time separators between the numbers. If you wish the ejection never to end, write 'never' instead of a date and time. You can also modify the comment line. Then hit Block IP and Yes. Wait for the data to be sent and processed by the world server: if the operation succeeds, the database list will be refreshed automatically.
- To remove a record from the database, select a record on the list, hit Edit and then Release IP. Wait until the database list refreshes.
- To add an IP to the world database, select any record (or none), hit Edit. Then edit all fields to match your requirements and hit Block IP.
- If you hit Edit but do not wish to modify anything, you can hit Cancel to disable editing.
- tab Varia
Miscellaneous data about the universe server, world server and the capabilities of the bot.
Besides using the World Atributes interface, you can access some caretaker commands by right clicking on the image of an avatar in the Presence screen. Three caretaker facilities will pop up on the menu, next to the name of the avatar: send url, warp and teleport.
- send url enables the caretaker to send a url to the AW browser used by the avatar, if the avatar's web browser is enabled.
- warp and teleport are AW 3.0 commands. They can only be used in worlds build 23 or greater. They are not always effective: whether they work or not depends on the receiving party (AW browser or bot). They are supposed to warp smoothly or teleport instantly an avatar, but the implementation is left over to the AW browser or bot receiving the order. Old AW browsers and bots do not recognise this feature, only 3.0 AW browsers and bots will respond.
- individual rights can be managed from this pop-up menu.
Verbal commands for send url, warp and teleport are explained in the Verbal Commands section on Click etc....
ACTION SCRIPT AND WRITETOBOT
Action script statements for caretakers can be found in World Attributes and rights, WriteToBot statements and Say etc. (There are yet no WriteToBot commands for Warping and Teleporting persons).