PCampBot

From OpenSimulator

(Difference between revisions)
Jump to: navigation, search
m (Removed 'Template:' prefix from template includings and/or changed external-link into internal-link)
(Update pCampbot instructions for working executable in current opensim master code.)
Line 1: Line 1:
__NOTOC__
 
 
{{Quicklinks}}
 
{{Quicklinks}}
 +
 +
== Instruction for current OpenSimulator development code ==
 +
pCampBot has changed considerably in OpenSim development code.  Here is the current usage statement that you'll get if you execute pCampBot.exe.
 +
 +
<pre>
 +
usage: pCampBot <-loginuri loginuri> [OPTIONS]
 +
Spawns a set of bots to test an OpenSim region
 +
 +
  -l, -loginuri      loginuri for sim to log into (required)
 +
  -n, -botcount      number of bots to start (default: 1)
 +
  -firstname        first name for the bots
 +
  -lastname          lastname for the bots.  Each lastname will have _<bot-number> appended, e.g. Ima Bot_0
 +
  -password          password for the bots
 +
  -b, behaviours    behaviours for bots.  Comma separated, e.g. p,g.  Default is p
 +
    current options are:
 +
      p (physics)
 +
      g (grab)
 +
      t (teleport)
 +
  -wear              set appearance folder to load from (default: no)
 +
  -h, -help          show this message
 +
</pre>
 +
 +
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 OpenSim and Robust.  Type help on this prompt to see further commands.
 +
 +
At the moment, pCampbot.exe spews a lot of libomv related logging.  This is annoying but it won't affect operation of pCampbot.exe.  There are currently problems with bot appearance.
 +
 +
== Old instructions ==
 +
These relate to OpenSimulator 0.7.2 and earlier but pCampBot may not have been operational for a couple of releases.
 +
 
<br />
 
<br />
  

Revision as of 17:26, 25 January 2012

Instruction for current OpenSimulator development code

pCampBot has changed considerably in OpenSim development code. Here is the current usage statement that you'll get if you execute pCampBot.exe.

usage: pCampBot <-loginuri loginuri> [OPTIONS]
Spawns a set of bots to test an OpenSim region

  -l, -loginuri      loginuri for sim to log into (required)
  -n, -botcount      number of bots to start (default: 1)
  -firstname         first name for the bots
  -lastname          lastname for the bots.  Each lastname will have _<bot-number> appended, e.g. Ima Bot_0
  -password          password for the bots
  -b, behaviours     behaviours for bots.  Comma separated, e.g. p,g.  Default is p
    current options are:
       p (physics)
       g (grab)
       t (teleport)
  -wear              set appearance folder to load from (default: no)
  -h, -help          show this message

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 OpenSim and Robust. Type help on this prompt to see further commands.

At the moment, pCampbot.exe spews a lot of libomv related logging. This is annoying but it won't affect operation of pCampbot.exe. There are currently problems with bot appearance.

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

Personal tools
General
About This Wiki