[MZ] Phileas_GameHotKeys

Название плагина: Phileas's Game Hot Keys

Автор: Phileas

Версия: 1.1.2 для MZ

Дата выхода:
1.0.0 - 18.07.2023
1.0.1 - 24.08.2023
1.1.0 - 19.01.2024
1.1.1 - 21.01.2024
1.1.2 - 29.01.2024

Описание плагина:
Плагин назначает общие события и переключатели клавишам клавиатуры, геймпада и мыши.

У плагина 2 параметра: Common Events и Switches. Они отличаются только одним полем: в Common Events задаётся номер общего события, а в Switches - переключатель. Остальные поля общие:
- Device type - устройство, нажатия на которое нужно отслеживать.
- Key name - строковый идентификатор кнопки.
- Key number - числовой идентификатор кнопки.

Начиная с версии 1.1.0, в Общих событиях можно включить блокировку. Если она включена, то повторно стриггерить событие можно будет только после того, как оно завершит выполнение.

Плагин предоставляет одну команду:
- Контроллер - позволяет включить и отключить горячие клавиши.

Сначала плагин ищет Key name в стандартных словарях движка. Если вы их не переопределяли, то они выглядят так:

keyBoard:
9: "tab", // tab
13: "ok", // enter
16: "shift", // shift
17: "control", // control
18: "control", // alt
27: "escape", // escape
32: "ok", // space
33: "pageup", // pageup
34: "pagedown", // pagedown
37: "left", // left arrow
38: "up", // up arrow
39: "right", // right arrow
40: "down", // down arrow
45: "escape", // insert
81: "pageup", // Q
87: "pagedown", // W
88: "escape", // X
90: "ok", // Z
96: "escape", // numpad 0
98: "down", // numpad 2
100: "left", // numpad 4
102: "right", // numpad 6
104: "up", // numpad 8
120: "debug" // F9
gamepad:
0: "ok", // A
1: "cancel", // B
2: "shift", // X
3: "menu", // Y
4: "pageup", // LB
5: "pagedown", // RB
12: "up", // D-pad up
13: "down", // D-pad down
14: "left", // D-pad left
15: "right" // D-pad right
mouse:
0: "left"
1: "middle"
2: "right"

Если плагин не нашёл Key name, то он берёт значение Key number.

Если во время игры произошло нажатие на клавиатуру, геймпад или мышь, плагин проверяет, не назначено ли на клавишу общее событие или переключатель. Если назначено общее событие, оно исполняется. Не рекомендуется указывать параллельное или автоматическое событие. Если назначен переключатель, его значение меняется на противоположное.

Как это выглядит:


Код
Все мои плагины

Лицензия
MIT, вся ответственность на пользователе.

Совместимость:
Если будут проблемы - пишите мне.

Boosty

Классный плагин. Вот это точно полезно даже для меня в новом проекте.

Обновление 1.0.1

Исправлен баг геймпада.

Обновление 1.1.0!

Теперь опционально можно включить блокировку общего события. Если она включена, то повторно стриггерить событие можно будет только после того, как оно завершит выполнение.

Также добавил локализацию на русский.

Обновление 1.1.1!

Добавил команду, которая включает и отключает плагин (то есть, горячие клавиши).
Может быть полезно во время кат-сцен.

Обновил до 1.1.2

Теперь общие события задаются через меню общих событий.
Также исправил баг локализации.