October 29, 2019

Tool Guide – Random Startup Entities

Latest Version: 0

The BestiSDK Random Startup Entities tool is a powerful artistic tool to enable scene creators to have an element of randomness in the layout of the scene. It randomly selects one object (or a group of objects) from a list of objects, and enables it, while disabling the rest. Essentially, it lets you make multiple layouts of a scene, and then load one of them at random. This can be used to make a scene slightly different from visit-to-visit, or it could completely change the entire layout of the scene if used extensively.

Video Overview

How to use

  1. Drag and Drop the BestiSDK_Random_Startup_Entities tool onto an empty game object
  2. Specify how many different random choices there are in the Object Sets array.
  3. Drag and drop your different object sets into the blank fields.

IMPORTANT THINGS ABOUT GAMEOBJECTS: 

Do not put the game object containing the Master Asset as an entry in the Object Sets array. The Master Asset script is an important part of the scene, and can not be disabled.

Do not put the game object containing the Random Startup Entitites tool, or any object that is a parent to this tool, in the Object Sets array. If this tool disables itself, it will crash the startup program that sets up your scene.

Do not put an object marked as “Static” and “Contributes to Global GI” into the Object Sets array. Disabling a GI contributing object will cause weird lighting glitches.

 

Section Information

Options

The options section contains 4 parts

  • The Object Sets array
  • The Make Random Selection button
  • The Hide All Sets button
  • The Show All Sets button

The Object Sets array is where you specify the pool of potential objects that will be enabled or disabled. In the picture I have 4 objects, so at random when this scene starts, only ONE of these objects will be enabled. In my case I set up each object with multiple children, so the change is more dramatic as all children of a gameobject are hidden/enabled by this. I could put entire scene setups in here, and the scene itself would be completely different at random. Each “Element” in this list is one possibility, and you can have as many possibilities as you like.

The Make Random Selection button essentially does what Besti does at startup: randomly selects one object out of Object Sets to enable, and disables the rest. This is a good way to test your setup before compiling it into a scene.

The Hide All Sets button hides all of the objects in the Object Sets array. Use this if you want to hide all of the objects. This does not affect what Besti does when your scene is started, and is just for your use in the editor.

The Show All Sets button enables all of the objects in the Object Sets array. Use this if you want to see all of the objects. This does not affect what Besti does when your scene is started, and is just for your use in the editor.