CPSLimiter

CPS(초당 클릭 수)를 제한하고 임계값 초과 시 디버프를 부여하는 마인크래프트 플러그인입니다.

개요

CPSLimiter는 PVP 서버에서 오토클릭 등의 부정행위를 방지하기 위해 플레이어의 CPS를 감지하고, 설정된 임계값을 초과할 경우 디버프 효과를 적용합니다.

주요 기능

• 실시간 CPS 감지 및 모니터링
• 임계값 초과 시 커스텀 디버프 효과 적용
• 채팅/타이틀 알림 시스템
• 위반 기록 로깅
• 레이트레이싱을 통한 정확한 타겟 감지

요구사항

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

설치 방법

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

명령어

명령어	설명	권한
/cpslimiter help	도움말 표시	cpslimiter.command
/cpslimiter reload	설정 파일 리로드	cpslimiter.admin
/cpslimiter status	현재 플러그인 상태 확인	cpslimiter.admin
/cpslimiter check [플레이어]	플레이어의 현재 CPS 확인	cpslimiter.check

명령어 별칭: /cps, /cpsl

권한

권한	설명	기본값
cpslimiter.*	모든 권한	OP
cpslimiter.command	기본 명령어 사용	모든 플레이어
cpslimiter.admin	관리자 명령어 (reload, status)	OP
cpslimiter.check	CPS 확인 명령어	OP
cpslimiter.bypass	CPS 제한 면제	OP

설정

config.yml

settings:
  cps-threshold: 15        # CPS 임계값 (일반 플레이어: 8-12)
  debuff-cooldown: 1000    # 디버프 쿨다운 (밀리초)
  debug: false             # 디버그 모드
  target-mode: "PLAYER_ONLY"  # 타겟 감지 모드 (PLAYER_ONLY / LIVING_ENTITY)

notification:
  chat:
    enabled: true          # 채팅 경고 활성화
  title:
    enabled: true          # 타이틀 경고 활성화
    fade-in: 10            # 페이드인 (틱)
    stay: 40               # 표시 시간 (틱)
    fade-out: 10           # 페이드아웃 (틱)

logging:
  enabled: true            # 위반 로깅 활성화
  file: "violations.log"   # 로그 파일명

디버프 효과 설정

다양한 포션 효과를 디버프로 설정할 수 있습니다:

• SLOWNESS - 이동 속도 감소
• WEAKNESS - 공격력 감소
• MINING_FATIGUE - 채굴/공격 속도 감소
• BLINDNESS - 시야 감소
• NAUSEA - 화면 흔들림
• HUNGER - 배고픔 증가
• POISON - 독 (치명타 아님)
• WITHER - 위더 효과
• DARKNESS - 어둠 효과 (1.19+)

각 디버프 효과는 개별적으로 활성화/비활성화하고, 레벨과 지속시간을 조절할 수 있습니다.

작동 방식

1. 플레이어가 좌클릭(팔 휘두르기)을 할 때마다 클릭이 기록됩니다.
2. 레이트레이싱을 통해 플레이어가 다른 엔티티를 대상으로 하는지 확인합니다.
3. 1초 동안의 클릭 수(CPS)를 계산합니다.
4. CPS가 임계값을 초과하면:
   • 설정된 디버프 효과가 적용됩니다
   • 채팅/타이틀 경고가 표시됩니다
   • 위반 내역이 로그에 기록됩니다

빌드 방법

./gradlew build

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

라이선스

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

개발자

• Minex (mx-minex)
• GitHub: https://github.com/mx-minex