KnockbackScroll

넉백 저항 효과를 부여하는 주문서 아이템 플러그인입니다.

개요

KnockbackScroll은 플레이어가 우클릭으로 사용할 수 있는 넉백 저항 주문서를 제공합니다. 주문서를 사용하면 일정 시간 동안 공격이나 폭발로 인한 넉백을 무효화합니다.

주요 기능

• 두 가지 주문서 타입 (1회용 / 다회용)
• Bukkit Attributes를 사용한 안정적인 넉백 무효화
• 커스터마이즈 가능한 효과 지속시간 및 쿨다운
• 사운드 및 시각 효과

요구사항

• Minecraft 버전: 1.20 이상
• 서버: Spigot / Paper
• Java: 17 이상

설치 방법

1. Releases에서 최신 버전의 JAR 파일을 다운로드합니다.
2. 서버의 plugins 폴더에 JAR 파일을 넣습니다.
3. 서버를 재시작합니다.
4. plugins/KnockbackScroll/config.yml에서 설정을 커스터마이즈합니다.

명령어

명령어	설명	권한
/넉백저항주문서 생성 <타입>	주문서 아이템 지급	knockbackscroll.create
/넉백저항주문서 지정 <타입>	손에 든 아이템을 주문서로 변환	knockbackscroll.create
/넉백저항주문서 리로드	설정 파일 리로드	knockbackscroll.reload
/넉백저항주문서 도움말	도움말 표시	-

명령어 별칭: /kbscroll, /넉백주문서

주문서 타입

• 1회용 또는 single - 1회 사용 후 소멸
• 다회용 또는 unlimited - 무제한 사용 가능

권한

권한	설명	기본값
knockbackscroll.*	모든 권한	OP
knockbackscroll.command	명령어 사용	OP
knockbackscroll.create	주문서 생성/변환	OP
knockbackscroll.reload	설정 리로드	OP
knockbackscroll.use	주문서 사용	모든 플레이어

설정

config.yml

settings:
  cooldown: 60              # 쿨다운 시간 (초)
  duration: 10              # 효과 지속 시간 (초)

item:
  single-use:
    display-name: "&6&l[1회용] &e넉백저항 주문서"
    lore:
      - "&7우클릭으로 사용"
      - "&7{duration}초 동안 넉백을 무효화합니다"
      - "&c1회용"
      - "&8쿨다운: {cooldown}초"

  unlimited:
    display-name: "&5&l[다회용] &d넉백저항 주문서"
    lore:
      - "&7우클릭으로 사용"
      - "&7{duration}초 동안 넉백을 무효화합니다"
      - "&a무제한 사용"
      - "&8쿨다운: {cooldown}초"

sounds:
  activate:
    type: BLOCK_ENCHANTMENT_TABLE_USE
    volume: 1.0
    pitch: 1.0

플레이스홀더

설정 파일에서 사용 가능한 플레이스홀더:

• {duration} - 효과 지속 시간
• {cooldown} - 쿨다운 시간
• {remaining} - 남은 쿨다운/효과 시간

사용 방법

1. 관리자가 /넉백저항주문서 생성 1회용 명령어로 주문서를 생성합니다.
2. 플레이어에게 주문서를 지급합니다.
3. 플레이어는 주문서를 손에 들고 우클릭하여 사용합니다.
4. 효과가 활성화되면 설정된 시간 동안 넉백이 무효화됩니다.
5. 쿨다운이 끝나면 다시 사용할 수 있습니다.

기술적 세부사항

• GENERIC_KNOCKBACK_RESISTANCE Attribute를 사용하여 100% 넉백 저항을 적용합니다.
• 폭발 넉백도 별도로 처리하여 완벽한 넉백 무효화를 보장합니다.
• 플레이어 퇴장 시 자동으로 데이터가 정리됩니다.
• 서버 재시작 시 쿨다운과 효과가 초기화됩니다.

빌드 방법

./gradlew build

빌드된 JAR 파일은 build/libs/ 폴더에 생성됩니다.

라이선스

이 프로젝트는 GNU General Public License v3.0 하에 배포됩니다.

개발자

• Minex (Junseo5)