Skip to content

Latest commit

 

History

History
34 lines (23 loc) · 3.58 KB

bots-tool.md

File metadata and controls

34 lines (23 loc) · 3.58 KB
Raw

Bots Tool

Bots%20Tool%2037951f1030da4cc09e6480c1b554bdd1/Screen_Shot_2021-07-16_at_00.17.20.png

How to use:

  1. Enter the explorer at any position
  2. Open browser console
  3. Call a Bots Tool method:

  • A. clientDebug.InstantiateBotsAtCoords({amount: number, xCoord: number, yCoord: number, areaWidth: number, areaDepth: number}): Instantiate bots in an area positioned at the base position of the parcel for which coords where provided

    • Example A: clientDebug.InstantiateBotsAtCoords({amount: 10}) will instantiate 10 bots in the user's current parcel with a default spawning area of 16x16 as default values apply when some parameters are not provided.
    • Example B: clientDebug.InstantiateBotsAtCoords({ amount: 100, xCoord: 91.2, yCoord: 151.2, areaWidth: 36, areaDepth: 50 }) will instantiate 100 bots in a 36x50 area positioned at world coords 91.2, 151.2

  • B. clientDebug.RemoveBot(botId: string): removes an instantiated bot. Every bot has its ID as its avatar name.

  • C. clientDebug.ClearBots(): removes all the instantiated bots.

  • D. clientDebug.StartBotsRandomizedMovement({ populationNormalizedPercentage: number, waypointsUpdateTime: number, xCoord: number, yCoord: number, areaWidth: number, areaDepth: number }) : starts randomized movement on a % of the population. For the selected population, waypoints are randomized for each bot, inside the provided area at the provided coords. Waypoints are re-randomized at the update time defined.

    • Example: clientDebug.StartBotsRandomizedMovement({ populationNormalizedPercentage: 0.5, waypointsUpdateTime: 5, xCoord: 91.2, yCoord: 151.2, areaWidth: 36, areaDepth: 50 }) will apply randomized movement on 50% of the population, the randomized waypoints will be in a 36x50 area positioned at world coords 91.2, 151.2, and the waypoints will be re-randomized every 5 seconds
    • Example A: clientDebug.StartBotsRandomizedMovement({ populationNormalizedPercentage: 1, waypointsUpdateTime: 1}) will apply randomized movement on 100% of the population, the randomized waypoints will be in a 16x16 area in the user’s current parcel and the waypoints will be re-randomized every 1 seconds, as default values apply when some parameters are not provided.
    • Example B: clientDebug.StartBotsRandomizedMovement({ populationNormalizedPercentage: 0.5, waypointsUpdateTime: 5, xCoord: 91.2, yCoord: 151.2, areaWidth: 36, areaDepth: 50 }) will apply randomized movement on 50% of the population, the randomized waypoints will be in a 36x50 area positioned at world coords 91.2, 151.2, and the waypoints will be re-randomized every 5 seconds

  • E. clientDebug.StopBotsMovement() : stops bots randomized movement

Note: The first batch of bots takes a bit more because it fetches the catalogue of wearables.

Note: When a config parameter is missing on a method call, default values are used

An example case would be:

  1. enter ZONE at 91,151 (we deployed a stadium scene to test with bots)
  2. open browser console
  3. run clientDebug.InstantiateBotsAtCoords({ amount: 100, xCoord: 91.2, yCoord: 151.2, areaWidth: 36, areaDepth: 50 }) to instantiate 100 bots inside the stadium. It may take a little while to load as the bots collections and wearables are being randomized and loaded.

Interesting data on the original implementation of this tool and its original usage can be found in the following blogpost wrote at that time: https://decentraland.org/blog/project-updates/100-avatars-in-a-browser-tab/