aboutsummaryrefslogtreecommitdiffstatshomepage
path: root/OpenSim/Tools/pCampBot/README.txt
blob: 7ecbde1ba97dfc8302125f3e0d6859f069b4712b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
This is the PhysicsCamperbot libslBot tester.

This is designed to be run in standalone mode with authorize accounts
turned off as a way to stress test the simulator.  It creates <N>
clients that log in, randomly jump/walk around, and say excuses from
the BOFH.

*** WARNING ***
Using this bot on a public grid could get you banned permanently, so
just say No! to griefing!

----- Setup -----
Linux: To build, in the main opensim directory, run:
  ./runprebuild.sh
  nant

Windows: Run the prebuild.bat in the main opensim directory and then
open the created solution and compile it.

pCampBot.exe will end up in the regular opensim/bin folder

----- Running the bot -----

windows: pCampBot.exe -botcount <N> -loginuri <URI>
*nix: mono pCampBot.exe -botcount <N> -loginuri <URI>

The names it produces are random by default, however, you can specify
either a firstname or a lastname in the command line also.

ex: pCampBot.exe -botcount <N> -loginuri <URI> -lastname <lastname>

If you specify both a firstname *and* a lastname, you'll likely run
into trouble unless you're only running a single bot.  In that case,
there's also a password option.

pCampBot.exe -botcount 1 -loginuri http://somegrid.com:8002 -firstname SomeDude -lastname SomeDude -password GobbleDeGook

----- Commands -----

The bot has console commands:
  help       - lists the console commands and what they do
  shutdown   - gracefully shuts down the bots
  quit       - forcefully shuts things down leaving stuff unclean
  addbots N  - adds N number of random bots. (replace 'N' with a number)