Prevent Key Press (Power Type)

Stops the key presses of the player with the power from reaching the game while the power is active. Without a keys list that means the whole keyboard and mouse: no movement, attacking, using items, inventory, hotbar, or Apoli and Origins ability keys. With a list, only those keys stop working and everything else works as usual.

Type ID: apoli:prevent_key_press

Fields

Escape and the debug keys are never blocked, because the game doesn't read them through keybinds, so a blocked player can always open the pause menu.

What it covers

The block applies to the keybind itself, so it reaches everything Apoli does with keys:

• Vanilla controls: movement, jump, sneak, sprint, attack, use, drop, swap hands, hotbar slots, inventory and chat.
• Data-driven keybinds from data/<namespace>/keybinds/*.json, including the ten Origins active power keys. Blocking key.origins.primary_active disables exactly that ability and nothing else.
• Every power driven by keys: apoli:action_on_key_press, apoli:toggle, apoli:fire_projectile, apoli:inventory and apoli:action_on_key_sequence.
• apoli:key_pressed reads a blocked key as not held, so conditions built on it turn false instead of sticking.
• The server refuses a blocked key even if a client sends the press anyway, so a modified client can't get around it.

Add a condition to the power and the block follows it. That is how a timed stun works, without granting or revoking anything.

Examples

A total lockout while a resource is above zero, for a stun:

{
  "type": "apoli:prevent_key_press",
  "condition": {
    "type": "apoli:resource",
    "resource": "example:stun_timer",
    "comparison": ">",
    "compare_to": 0
  }
}

Silence only the origin's abilities, leaving the player free to move and fight:

{
  "type": "apoli:prevent_key_press",
  "keys": [
    "key.origins.primary_active",
    "key.origins.secondary_active",
    "key.origins.ternary_active"
  ]
}

Bind a player's legs without taking their hands:

{
  "type": "apoli:prevent_key_press",
  "keys": ["key.forward", "key.back", "key.left", "key.right", "key.jump", "key.sprint"]
}

Paralysis that someone else can still steer. The player can't press anything, but apoli:force_key_pressed still works because affect_forced is off:

{
  "type": "apoli:prevent_key_press",
  "affect_forced": false,
  "unpress": true
}