Events/exchange roles

The exchange_roles event is called whenever someone swaps roles (usually due to an exchange totem).

Event callback

 * prevent_default has no effect for this event
 * : The event object
 * : The IRC connection
 * : Reference to the src.settings module
 * : Person that triggered the exchange
 * : Person that is being exchanged with
 * : actor's role
 * : nick's role

Event data
The actor_messages and nick_messages data keys are initialized to an empty list. Adding strings to this will cause those strings to be sent to the actor or nick respectively after they are informed that their role has been swapped. It is preferable to make use of these lists as opposed to directly calling yourself, as the event is run before the players are informed that their roles have swapped.