Minecraft 플러그인 AntiSpam

🔌 AntiSpam 소개

AntiSpam은 채팅 활동을 모니터링하고, 반복되거나 유사한 메시지, 도배, 차단된 단어, 기타 원치 않는 채팅 행동을 감지하여 서버 채팅을 깨끗하게 유지하는 데 도움이 되는 Minecraft 플러그인입니다. 모듈식 구조로 되어 있어 기능을 켜거나 끌 수 있으며, 로컬 저장소(SQLite)와 대규모 환경 및 웹 연동을 위한 MySQL 지원을 모두 제공합니다.

🎯 목적

AntiSpam은 스팸, 문자 반복, 빠른 메시지 도배, 블랙리스트 단어 등 채팅 악용을 자동으로 감지하고 처리해야 하는 서버 관리자와 모더레이션 팀을 위해 설계되었습니다. 또한 신고를 수집하고 제재 기록을 검토할 수 있는 도구도 제공합니다.

⚙️ 기능

• 반복되거나 매우 유사한 메시지 감지.
• 도배 방지(메시지 전송 속도 제한 및 과도한 문자 반복 검사).
• 완전히 설정 가능한 차단 단어 블랙리스트.
• 설정 가능한 트리거와 제재용 사용자 지정 명령어를 갖춘 자동 제재 시스템.
• 작업 추적과 조회를 위한 고유한 제재 ID.
• 스태프 검토를 위해 최근 메시지를 저장하는 스마트 채팅 신고 시스템.
• 제재, 로그, 신고를 확인할 수 있는 선택적 웹 패널 연동(MySQL 필요).
• 다국어 지원(영어, 체코어, 독일어) 및 설정 가능한 메시지.
• 알림용 Discord 웹훅 지원.

🧩 대상

• 자동 채팅 모더레이션을 원하는 Survival / SMP 서버.
• 스팸과 광고가 문제인 활발한 커뮤니티의 공개 서버.
• 채팅 제재와 신고 내역을 웹에서 확인하고 싶은 서버.

🏗️ 사용 예시

• 플레이어가 차단된 단어를 여러 번 반복한 뒤 자동으로 뮤트하거나 제재 명령어를 실행.
• 스태프가 플러그인으로 생성된 신고를 열어 맥락 확인을 위해 저장된 최근 채팅을 확인.
• 관리자가 고유 ID로 제재 기록을 검색해 조치를 확인하거나 되돌림.

⌨️ 명령어

참고: 위에는 공식 프로젝트 소스에서 확인된 명령어만 나열되어 있습니다.

🔐 권한

⚙️ 설치

📥 설정

• 공식 플러그인 JAR을 다운로드해 서버의 plugins/ 디렉터리에 넣습니다.
• 서버를 재시작하고 콘솔 로그에서 플러그인이 로드되었는지 확인합니다.
• 웹 패널 기능을 사용하려면 MySQL 데이터베이스를 설정하고 플러그인 설정에서 웹 연동을 활성화합니다.

📦 의존성

• 필요한 외부 플러그인 의존성은 문서화되어 있지 않습니다. MySQL은 웹 패널에만 필요하며, SQLite는 기본 제공됩니다.

🧾 설정

• 플러그인은 설정을 위해 config.yml을 사용합니다(기능 토글, 제한, 지연, 제재, 데이터베이스 설정).
• 언어 파일이 제공되며 수정할 수 있습니다.

🧠 기술 메모

• 저장소: 단일 서버용 내장 SQLite; 웹 패널에는 MySQL이 지원되며 필요합니다.
• 모듈식 설계: 개별 보호 기능(spam, flood, blocked words, reports, web panel, Discord webhooks)을 켜거나 끌 수 있습니다.
• 기록된 각 작업마다 고유한 제재 ID가 생성되어 검색과 감사에 도움이 됩니다.

🤝 이 플러그인이 유용한 경우

기록 가능한 제재와 로그 및 신고에 대한 선택적 웹 접근이 있는 자동화된 설정형 채팅 모더레이션이 필요하다면, AntiSpam은 MySQL 기반 데이터와 원격 웹 인터페이스가 필요한 소규모 서버와 대규모 네트워크 모두에 적합한 모듈식 시스템을 제공합니다.