If a bot, any bot, is logged in with a citizen number that has Eject rights, the bot will have those rights too. It is the citizen number itself that must have eject rights, not the citizen: the citizen him/herself could be using someone else's privileges, the bot can't share those privileges. This is also valid for any rights, including Caretaker capabilities.
A xelagot implements eject rights in four ways:
To use the eject option, highlight the image of the avatar to be ejected, right click on it to bring up a pop-up menu, highlight the name of the person, then select eject. Fill in the amount of minutes required, and press accept. If the ejection target has escaped from view of the bot, it can still be ejected if it is in the world: just activate the option in the pop-up menu show absent to produce the icons of people who have recently left the bot's perception field, and proceed as above.
To use the search function, right click on the Presence list and select search. This brings up a selector. Chose what you want to search, fill in the data (for names, a few letters is enough), and press search. On the result list, select the name of the person. At the bottom right of the selector you can press eject. Fill in the minutes required and press accept.
On the next lines you should put the citizen numbers or (version 2.999973) names of the targets, one on each line, followed on the same line by an equal sign (there must be no spaces before or after the number). To eject all tourists, use an empty tourist name "" followed by an equal sign. Then you indicate the time period of the ban. There are three possible formats for this. In these examples I will use my citizen number.
You may not put multiple entries for the same citizen, this would produce unsuspected results.
Save this text file, and load it for one bot. Do do so, select menu Bot | Eject List | Load, and use the file selector to find and load the file. You may undo this operation by selecting the menu Bot | Eject List | Disable. If you need to modify the file, you may do so and reload it while the bot is running.
From the moment the file is loaded, it will be active in the world it is indicated to work, provided that automatic citizen identification is turned on if you use citizen numbers. Check that the check-box Identify Citizens in menu World | Preferences is checkmarked. |
As a rule, make sure only one bot is applying this file in a given area of your world, typically a distance between bots of 600m should be kept. Otherwise, both bots will be ejecting the same person. You may, of course, allow the areas to overlap for maximum efficiency.
If the bot succeds in ejecting the target, this will be for no more than a full week at a time.
If the bot is saving a log to file, ejections will also be logged, as well as whispered to the owner if he/she is present.
Example of a file that would work on mars, ejecting the listed citizens:
EjectWorld=mars #Sunny Freak, permanently #for repeatedly trashing 234567=* #Alone #second warning 998764= 1999 09 12 0:0 #i m p y 976555= 5 #"Pleurus" "Pleurus"= 5 |