Profiles

Profiles

A profile consists of two things: a group definition and a set of actions. When a profile is run, it searches for groups matching the profile's group definition and then performs the profile's actions on those groups of entities.

A profile is written in the form

profile-name:
  group:
    {group definition - see wiki page for 'Groups'}
  actions:
    - action1
    - action2
    ...

See Groups to learn how to write a group definition and Actions to learn a list of actions and what they do.

Examples

Example 1

The following profile will ensure there are no more than 20 monsters all within 5 blocks of each other, such as in an experience grinder.

trim-monsters:
  group:
    types:
      - "category:monster"
    count: 21
    distance: 5
  actions:
    - kill

Example 2

The following profile will remove the awareness and disable collisions of groups of 20 chickens and/or rabbits all within 1 block of each other.

nerf-dense-chicken-rabbit-farms:
  group:
    types:
      - chicken
      - rabbit
    count: 20
    distance: 1
  actions:
    - remove-awareness