Sueta

HotKeyManager

20260618

PRESS F, Q, L, SHIFT + F, SHIFT + Q, SHIFT + L, SHIFT + 1 ~ 9 COMMAND BIND!

·Plugin

플러그인 이름 - HotkeyManager

Plugin Name - HotkeyManager

개요 (Overview)
HotkeyManager는 마인크래프트의 Q, F, L 등의 기본 키를 감지하여
원하는 명령어를 실행하게 할 수 있는 커스텀 단축키 설정 플러그인입니다.
Shift + Q, Shift + L, Shift + 1~9 등 조합 키도 완벽하게 지원됩니다.

HotkeyManager is a custom hotkey manager plugin for Minecraft servers.
It detects default keys like Q, F, L and allows you to assign commands to them.
Combination keys like Shift + Q, Shift + L, and Shift + 1~9 are also fully supported.

주요 기능 (Features)

  • ✅ Q, F, L, Shift + Q, Shift + F, Shift + L, Shift + 1~9 감지

  • ✅ config.yml에서 명령어 및 실행 주체 설정 가능 (player, op, console)

  • ✅ L과 Shift + L 키 중복 방지를 위한 쿨타임 적용

  • ✅ 손 바꾸기(F) 및 아이템 버리기(Q) 기본 동작 완전 차단

  • ✅ ProtocolLib 기반 고정밀 키 감지

  • ✅ 서버 성능을 고려한 최적화 구조


  • ✅ Detect Q, F, L, Shift + Q, Shift + F, Shift + L, and Shift + 1~9

  • ✅ Fully configurable commands and executor (player, op, console) via config.yml

  • ✅ Cooldown system prevents L from triggering after Shift + L

  • ✅ Prevents default behavior (e.g. drop item with Q, swap hand with F)

  • ✅ Accurate key detection using ProtocolLib

  • ✅ Optimized for performance and scalability

⚙️ 설정 예시 (Example config.yml)

hotkeys:
  Q:
    enabled: true
    command: "say Q pressed by %player%"
    executor: "player"
  SHIFT_Q:
    enabled: true
    command: "say Shift + Q pressed"
    executor: "player"
  F:
    enabled: true
    command: "say F key"
    executor: "player"
  SHIFT_F:
    enabled: true
    command: "say Shift + F key"
    executor: "player"
  SHIFT_1:
    enabled: true
    command: "say Shift + 1 key"
    executor: "console"
  SHIFT_2:
    enabled: true
    command: "say Shift + 2 key"
    executor: "console"
  SHIFT_3:
    enabled: true
    command: "say Shift + 3 key"
    executor: "console"
  SHIFT_4:
    enabled: true
    command: "say Shift + 4 key"
    executor: "console"
  SHIFT_5:
    enabled: true
    command: "say Shift + 5 key"
    executor: "console"
  SHIFT_6:
    enabled: true
    command: "say Shift + 6 key"
    executor: "console"
  SHIFT_7:
    enabled: true
    command: "say Shift + 7 key"
    executor: "console"
  SHIFT_8:
    enabled: true
    command: "say Shift + 8 key"
    executor: "console"
  SHIFT_9:
    enabled: true
    command: "say Shift + 9 key"
    executor: "console"
  L:
    enabled: true
    command: "say L key"
    executor: "op"
  SHIFT_L:
    enabled: true
    command: "say Shift + L key"
    executor: "op"

%player% 는 플레이어 이름으로 자동 치환됩니다.

%player% will be automatically replaced with the player’s name.

️ 설치 방법 (Installation)

  1. plugins/ 폴더에 HotkeyManager.jar를 넣습니다.

  2. ProtocolLib (필수) 플러그인을 함께 설치하세요.

  3. 서버를 실행하고 /hotkeyreload 명령어로 설정을 반영합니다.

  4. plugins/HotkeyManager/config.yml에서 키와 명령어를 자유롭게 설정하세요.
  1. Place HotkeyManager.jar into your plugins/ folder.

  2. Install ProtocolLib (required).

  3. Start the server and use /hotkeyreload to apply your settings.

  4. Edit config.yml to assign commands to specific key inputs.

명령어 (Commands)
명령어 (Command) 설명 (Description) 권한 (Permission)
/hotkeyreload 설정 파일을 다시 불러옵니다. hotkeymanager.reload
필요 플러그인 (Required Plugin)

  • ✅ ProtocolLib (필수 / Required)

참고 사항 (Notes)

  • 클라이언트에서 Q, F, L 키가 기본값 이어야 정상 동작합니다.

  • SHIFT + L을 누르면 L은 0.5초 동안 무시됩니다.

  • Paper / Purpur 서버에서도 안정적으로 작동합니다.

  • Client keybindings (Q, F, L) must be set to default for proper detection.

  • Pressing SHIFT + L will block the L command for 0.5 seconds.

  • Fully compatible with Paper and Purpur servers.

리뷰 꼭 써라 두번 써라 세번 써라

PLEASE REVIEW

Similar projects

Plugin →