Action On Speak (Power Type)

Runs an entity action when the holder starts talking into voice chat and another when they stop, and can also run a bi-entity action on everyone who can hear them.

Type ID: birdsong:action_on_speak (alias apoli:action_on_speak)

note

This power comes from Birdsong and needs Simple Voice Chat on the server.

Fields

Field	Type	Default	Description
`entity_action`	Entity Action Type	optional	Runs once when the holder starts speaking.
`entity_action_stop`	Entity Action Type	optional	Runs once when the holder stops speaking, after about 0.4 seconds of silence.
`bientity_action`	Bi-entity Action Type	optional	Runs once for each listener when the holder starts speaking. The holder is the actor and the listener is the target.
`bientity_action_stop`	Bi-entity Action Type	optional	Runs once for each listener when the holder stops speaking.
`bientity_condition`	Bi-entity Condition Type	optional	Only listeners who pass it get the bi-entity actions, with the holder as the actor and the listener as the target.

Who counts as a listener

A listener is any other player in the same dimension who could hear the holder over proximity chat at that moment: within the holder's speaking range as birdsong:modify_speaking_range and their own apoli:modify_hearing_range leave it, whispering included, and with voice chat switched on and connected. Group chat doesn't count.

The entity actions still run once, on the holder, whether anyone is listening or not.

Examples

{
  "type": "birdsong:action_on_speak",
  "entity_action": {
    "type": "apoli:grant_power",
    "power": "example:talking_glow",
    "source": "example:speaking"
  },
  "entity_action_stop": {
    "type": "apoli:revoke_power",
    "power": "example:talking_glow",
    "source": "example:speaking"
  }
}

This power makes the holder glow while they talk, by granting a glow power when they start and revoking it when they stop.

{
  "type": "birdsong:action_on_speak",
  "condition": {
    "type": "apoli:and",
    "conditions": [
      { "type": "birdsong:voice_loudness", "comparison": ">=", "compare_to": 70 },
      { "type": "birdsong:voice_listeners", "range": 8.0 }
    ]
  },
  "entity_action": {
    "type": "apoli:area_of_effect",
    "radius": 6.0,
    "bientity_action": { "type": "apoli:damage", "amount": 4.0 }
  }
}

This shockwave only goes off when the holder shouts, and only when somebody is close enough to hear.

{
  "type": "birdsong:action_on_speak",
  "bientity_condition": {
    "type": "apoli:same_team"
  },
  "bientity_action": {
    "type": "apoli:target_action",
    "action": {
      "type": "apoli:apply_effect",
      "effect": {
        "effect": "minecraft:glowing",
        "duration": 600,
        "amplifier": 0
      }
    }
  },
  "bientity_action_stop": {
    "type": "apoli:target_action",
    "action": {
      "type": "apoli:clear_effect",
      "effect": "minecraft:glowing"
    }
  }
}

Everyone on the holder's team who can hear them glows while they talk.