Creator Behaviors

Creator Agents

With "creator" agents you can create agents that create other agents. For example, by accessing published behaviors, we can very easily generate common agent placements. These behaviors can be found in the lower left corner; search for and then click on them to add them to your simulation:

• Create Grids (@hash/create-grids/create_grids.js): copy an agent to every unit within the topology bounds
• Create Scatters (@hash/create-scatters/create_scatters.js): copy an agent to random locations within the topology bounds
• Create Stacks (@hash/create-stacks/create_stacks.js): copy an agent multiple times to the same location

Take a look at how we can use published behaviors in the following example, where [rabbits forage for food and reproduce](https://hash.ai/@hash/rabbits-grass-weeds, while grass and weeds grow around them:

There's a singly agent that has a set of behaviors that will reference the "templates" we attached as properties on the creator agent.

Create Grids looks at the agent templates in the "grid_templates" array, in this case the "ground". We're copying it to fill the space defined in the bounds of our "topology" field inglobals.json:

Next, Create Scatters distributes the "rabbits" across the environment. Each one is placed in a random location within the bounds specified in the topology.

Now we want to make a few adjustments to the agents we've generated which requires a bit more logic. Luckily for us, HASH behaviors are composable. Create Grids and Create Scatters have created "agent" objects in our creator and filled them. We access those agents by using the "template_name" as a key:

Here we've randomly assigned the color of our "ground" agents, and given each of the "rabbits" a random starting amount of energy.

Our creator then runs two more published behaviors. Create Agents (@hash/create-agents/create_agents.js) sends messages to the engine to generate every agent in the "agents" object, and Remove Self (@hash/remove-self/remove_self.js) gets rid of the "creator" agent, since it's finished all it needs to do. Again, these behaviors can be found in the lower left sidebar.

state.addMessage("hash", "create_agent", {
  ...agent_details,
});

If you'd like to explore another simple example that uses these published behaviors, take a look at the Wildfires or Rock, Paper, Scissors simulations.