backEject, new version

Xelagot topics

Eject (old version, valid up to X1 version 2.9999956)

Related topic Topic: Caretaker.

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:

  1. verbally, using the eject command, see Xelagot verbal commands: Click, Eject...
  2. manually, using the eject option on the presence list
  3. manually, using the search option on the presence list
  4. automatically, using a list of citizen numbers and names loaded from a text file
Ejection is not garanteed. The world server implements it, not the bot.
On the main screen that has the chat window, select the Presence list if it isn't visible.

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.

With an ordinary text-processor, make a text file with a meaningful name. Use Notepad or another ASCII text editor: WordPad and Word will try and save the file in their own format, which the bot cannot use. The file must have the following header (just on any line will do, usually the first one is best):
where myworld stands for the name of the world where the ejections must take place.

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:
#Sunny Freak, permanently
#for repeatedly trashing
#second warning
998764= 1999 09 12 0:0
#i m p y
976555= 5
"Pleurus"= 5
will eject Sunny Freak (234567) any time he attemps to come in and is detected by the bot, for a period of one week (maximum given); Alone (998764) till September 12th midnight (12 am); i m p y (976555) and tourist "Pleurus" for 5 minutes every time they attempt entry - use this option when you wish to be able to reverse your decision at short notice). Notice the use of the # symbol to add a comment.

backEject, new version