플러그인 이름 - 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)
%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