Minecraft 플러그인 SimpleTpa

🔌 SimpleTPA 소개

SimpleTPA는 서버를 위한 간단한 텔레포트 요청(TPA) 시스템을 제공하는 Minecraft 플러그인입니다. 플레이어가 다른 플레이어에게 텔레포트 요청을 보내고, 들어온 요청을 수락하거나 거절하고, 보낸 요청을 취소하며, 토글로 들어오는 요청을 차단할 수 있게 해줍니다. 이 플러그인은 게임 내 텔레포트 요청과 서버 측 설정을 위한 작고 설정 가능한 워크플로에 중점을 둡니다.

🎯 목적

SimpleTPA는 멀티플레이어 서버에서 흔히 필요한 플레이어 간 제어된 텔레포트를 해결합니다. 쿨다운과 대기 중인 요청 1개 규칙으로 스팸을 방지하고, 텔레포트 전 워밍업/지연을 지원하며, 서버 관리자가 타임아웃, 소리, 로그 동작을 설정할 수 있게 합니다.

⚙️ 기능

• /tpa를 통한 플레이어 간 텔레포트 요청과 /tpahere를 통한 역방향 요청.
• 요청 수락, 거절, 취소 기능(/tpaccept, /tpdeny, /tpacancel).
• /tpatoggle로 요청 수신 켜기/끄기.
• 설정 가능한 요청 타임아웃(기본값 60초).
• 스팸을 줄이기 위한 요청 전송 간 쿨다운 설정 가능.
• 액션바 카운트다운이 있는 텔레포트 워밍업/지연과 이동 또는 피해 시 취소.
• 플레이어당 대기 중인 요청은 하나만 허용하여 중복 요청 방지.
• 요청, 수락, 거절, 성공적인 텔레포트에 대한 소리 효과를 사용자 지정 가능.
• 메시지의 전체 색상 코드 지원과 관리자용 상세 로그 옵션.

🧩 대상

• 가벼운 TPA 시스템을 원하는 소규모 및 중규모 Survival/SMP 서버.
• 더 큰 텔레포트 모음보다 최소한의 설정 가능한 텔레포트 요청 동작을 선호하는 서버.
• 쿨다운, 워밍업, 로깅을 서버별로 설정하고 싶은 관리자.

🏗️ 사용 예시

• 플레이어가 /tpa로 친구에게 텔레포트를 요청하고, 친구가 /tpaccept로 수락하면 플러그인이 텔레포트 전에 설정된 워밍업을 적용합니다.
• 서버 스태프는 이벤트나 모더레이션 작업 중 무작위 텔레포트 요청을 막기 위해 스태프에게 /tpatoggle을 활성화합니다.
• 관리자는 플레이어가 텔레포트 요청을 스팸하지 못하도록 쿨다운을 설정합니다.

⌨️ 명령어

🔐 권한

⚙️ 설치

📥 설정

• 플러그인의 공식 리소스 페이지에서 JAR 파일을 다운로드합니다.
• 다운로드한 .jar 파일을 Spigot 서버의 plugins/ 디렉터리에 넣습니다.
• 서버를 재시작하고 콘솔에서 플러그인 로드 메시지를 확인합니다.

📦 의존성

• 필수 의존성은 문서화되어 있지 않습니다.

🧾 설정

• 이 플러그인은 설정 파일을 사용합니다(플러그인 리소스에는 config.yml로 표시됨). 주요 버전 간 업그레이드 시에는 새 기본 키가 적용되도록 재시작 전에 기존 config.yml을 삭제하는 것을 권장합니다.
• 제공되는 설정 옵션에는 요청 타임아웃, 쿨다운, 텔레포트 워밍업, 이동/피해 취소, 소리 설정, 메시지 색상 코드, 로깅 옵션이 포함됩니다.

🧠 기술 메모

• 지원이 확인된 Minecraft 버전(플러그인 리소스에 표시됨): 1.19, 1.20, 1.20.6, 1.21.
• 확인된 플랫폼: Spigot.
• 이 플러그인은 서버 측에서 타임아웃, 쿨다운, 워밍업 메커니즘을 구현하며 만료된 요청을 자동으로 정리합니다.

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

SimpleTPA는 전체 텔레포트/홈 기능 모음을 추가하지 않고도 집중적이고 설정 가능한 텔레포트 요청 시스템이 필요할 때 유용합니다. 간단한 /tpa 흐름, 스팸 방지를 위한 쿨다운, 더 안전한 텔레포트를 위한 워밍업 동작을 원하는 서버에 잘 맞습니다.