PCampBot
From OpenSimulator
(→Instruction for current OpenSimulator development code) |
(→Instruction for current OpenSimulator development code) |
||
| Line 2: | Line 2: | ||
== Instruction for current OpenSimulator development code == | == Instruction for current OpenSimulator development code == | ||
| − | pCampBot has changed considerably in OpenSimulator development code. Here is the current usage statement that you'll get if you execute pCampBot.exe. | + | pCampBot has changed considerably in OpenSimulator development code. Here is the current usage statement that you'll get if you execute pCampBot.exe as of OpenSimulator 0.7.6. |
<pre> | <pre> | ||
usage: pCampBot <-loginuri loginuri> [OPTIONS] | usage: pCampBot <-loginuri loginuri> [OPTIONS] | ||
| − | Spawns a set of bots to test an | + | Spawns a set of bots to test an OpenSim region |
| − | -l, -loginuri loginuri for | + | -l, -loginuri loginuri for grid/standalone (required) |
| − | - | + | -s, -start start location for bots (optional). Can be "last", "home" or a specific location with or without co-ords (e.g. "region1" or "region2/50/30/90" |
| − | -firstname first name for the bots | + | -firstname first name for the bots (required) |
| − | -lastname lastname for the bots. Each lastname will have _<bot-number> appended, e.g. Ima Bot_0 | + | -lastname lastname for the bots (required). Each lastname will have _<bot-number> appended, e.g. Ima Bot_0 |
| − | -password password for the bots | + | -password password for the bots (required) |
| − | -b, behaviours behaviours for bots. Comma separated, e.g. p,g. Default is p | + | -n, -botcount number of bots to start (default: 1) (optional) |
| + | -f, -from starting number for login bot names, e.g. 25 will login Ima Bot_25, Ima Bot_26, etc. (default: 0) (optional) | ||
| + | -c, -connect connect all bots at startup (optional) | ||
| + | -b, behaviours behaviours for bots. Comma separated, e.g. p,g. Default is p (required) | ||
current options are: | current options are: | ||
| − | p (physics) | + | p (physics - bots constantly move and jump around) |
| − | g (grab) | + | g (grab - bots randomly click prims whether set clickable or not) |
| − | t (teleport) | + | n (none - bots do nothing) |
| − | -wear | + | t (teleport - bots regularly teleport between regions on the grid) |
| − | -h, -help show this message | + | -wear folder from which to load appearance data, "no" if there is no such folder (default: no) (optional) |
| + | -h, -help show this message. | ||
</pre> | </pre> | ||
Revision as of 12:21, 31 October 2013
Instruction for current OpenSimulator development code
pCampBot has changed considerably in OpenSimulator development code. Here is the current usage statement that you'll get if you execute pCampBot.exe as of OpenSimulator 0.7.6.
usage: pCampBot <-loginuri loginuri> [OPTIONS]
Spawns a set of bots to test an OpenSim region
-l, -loginuri loginuri for grid/standalone (required)
-s, -start start location for bots (optional). Can be "last", "home" or a specific location with or without co-ords (e.g. "region1" or "region2/50/30/90"
-firstname first name for the bots (required)
-lastname lastname for the bots (required). Each lastname will have _<bot-number> appended, e.g. Ima Bot_0
-password password for the bots (required)
-n, -botcount number of bots to start (default: 1) (optional)
-f, -from starting number for login bot names, e.g. 25 will login Ima Bot_25, Ima Bot_26, etc. (default: 0) (optional)
-c, -connect connect all bots at startup (optional)
-b, behaviours behaviours for bots. Comma separated, e.g. p,g. Default is p (required)
current options are:
p (physics - bots constantly move and jump around)
g (grab - bots randomly click prims whether set clickable or not)
n (none - bots do nothing)
t (teleport - bots regularly teleport between regions on the grid)
-wear folder from which to load appearance data, "no" if there is no such folder (default: no) (optional)
-h, -help show this message.
You must have already created all the necessary bot accounts in the simulator before using pCampbot. It does not create these accounts on the fly.
The -wear option almost certainly doesn't work. The others are operational.
On using this facility you'll get a console command line similar to the one in OpenSimulator and Robust. Type help on this prompt to see further commands.
There are currently problems with bot appearance and this option may not work properly.
Old instructions
These relate to OpenSimulator 0.7.2 and earlier but pCampBot may not have been operational for a couple of releases.
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)
From the README.txt included with the source
