🗣️Configure a Behavior

By default, a character has no behavior and never interacts on your server.

CharacterWeaver allows you to create behaviors that are triggered automatically when certain events are called. For example, a message sent by a user or a new member who joins your server.

Creating behavior

To create a new behavior, you must use the command: /behavior create <behavior-name> <event-type>

behavior-name is never visible and only serves as an identifier. The identifier will be used when you change it, so choose something short like "auto-response".

event-type is the event type that triggers the behavior when called. You can find the list of available events here.

Adding an action to a behavior

To create a new action in a behavior, you must use the command: /behavior action create <behavior-name> <action-name> <action-type>

behavior-name is the name of the behavior specified when it was created.

action-name is never visible and only serves as an identifier. The identifier will be used when you change it, so choose something short like "send-response".

action-type is the type of action that will be triggered, you can find the list here.

To find out how to configure each setting, visit the associated event documentation. You can find the list here.

Editing an action

To edit an action in a behavior, you can click on the "Configure Action" button or simply use the command: /behavior action edit <behavior-name> <action-name>

behavior-name is the name of the behavior specified when it was created.

action-name is the name of the action specified when it was created.

Add behavior to a character and test it

To add a behavior to a character, you must use the command: /character behavior add <character> <behavior-name>

Adding a filter to a behavior

To create a new filter in a behavior, you must use the command: /behavior filter create <behavior-name> <filter-name> <filter-type>

behavior-name is the name of the behavior specified when it was created.

filter-name is never visible and only serves as an identifier. The identifier will be used when you change it, so choose something short like "contained".

filter-type is the type of filter that will be triggered, you can find the list here.

Editing a filter

To edit a new filter in a behavior, you can click on the "Configure Filter" button or simply use the command: /behavior filter edit <behavior-name> <filter-name>

behavior-name is the name of the behavior specified when it was created.

filter-name is the name of the action specified when it was created.

To understand how placeholders work, refer to this page.