Minecraft 플러그인 Tebex

🔌 Tebex 소개

Tebex는 실행 중인 서버를 Tebex 웹스토어에 연결해 온라인 구매가 게임 안에서 자동으로 지급되도록 하는 Minecraft 플러그인입니다. 공식 Tebex Plugin API를 구현하며, 지원되는 서버 플랫폼에서 스토어 구매(아이템, 랭크, 명령어, 구독)를 서버 측에서 처리할 수 있게 해줍니다.

🎯 목적

Tebex의 핵심 목적은 Tebex 웹스토어에서 생성된 구매의 지급을 자동화하는 것입니다. 서버 소유자는 이 플러그인을 사용해 게임 서버를 스토어에 연결하고, 구매가 처리되면 설정된 서버 명령어를 실행하며, 플레이어에게 구매 링크와 스토어 관련 정보를 게임 안에서 제공합니다.

⚙️ 기능

• 자동 주문 처리: 플러그인이 Tebex를 주기적으로 확인하고, 플레이어가 온라인일 때 설정된 서버 명령어를 실행해 구매를 지급합니다.
• 비밀 키를 통한 스토어 연결: 서버 측 비밀 키 명령어를 사용해 서버를 스토어에 연결할 수 있습니다.
• checkout 및 스토어 정보용 게임 내 명령어로 결제 링크를 만들거나 스토어 데이터를 볼 수 있습니다.
• 링크 전송, 강제 확인, 패키지 데이터 새로고침, 디버그 로깅 활성화를 위한 관리자 및 디버그 명령어.
• 일반적인 서버 플랫폼용 공식 빌드를 통한 다중 플랫폼 지원.

🧩 대상

• Tebex 웹스토어를 통해 아이템, 랭크 또는 구독을 판매하는 서버 소유자.
• Bukkit/Spigot/Paper 및 기타 지원되는 플랫폼에서 온라인 구매의 자동 처리가 필요한 관리자.
• 웹스토어와 게임 서버 사이에 유지 관리되는 공식 연동을 원하는 네트워크.

🏗️ 사용 예시

• 어떤 서버가 Tebex 스토어에서 꾸미기 아이템을 판매하고, 플러그인이 플레이어가 다음에 접속할 때 아이템을 자동으로 지급합니다.
• 관리자가 게임 내 명령어로 후원자에게 결제 링크를 생성해 플레이어에게 보냅니다.
• 스토어 구매가 명령어를 실행해 플레이어를 권한 그룹에 추가하거나 임시 구독을 부여합니다.

⌨️ 명령어

🔐 권한

모든 명령어는 문서에 명시된 정확한 명령어 이름과 일치하는 권한 노드를 사용합니다. 기본값은 공식 문서에 명시되어 있지 않습니다.

⚙️ 설치

📥 설정

• 서버 플랫폼용 공식 플러그인 빌드를 다운로드합니다.
• 플러그인 JAR을 서버의 plugins/ 디렉터리(지원되는 모드 플랫폼의 경우 mods/)에 넣습니다.
• 서버를 재시작하고 콘솔에서 플러그인이 로드되었는지 확인합니다.
• 서버 관리자로서 비밀 키 명령어를 실행해 서버를 스토어에 연결합니다.

📦 의존성

• 공식 설치 안내에는 런타임 의존성이 문서화되어 있지 않습니다. 프로젝트를 빌드하려면 Java 개발 환경이 필요합니다.

🧠 기술 메모

• 공식 빌드는 여러 서버 플랫폼용으로 제공되며, 프로젝트는 Tebex 팀이 유지 관리합니다.
• 플러그인은 Tebex 서비스를 주기적으로 확인하고 설정된 서버 명령어를 실행해 서버 플랫폼에서 구매를 처리합니다.
• 저장소와 공식 빌드는 GPL-3.0 라이선스를 따릅니다.

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

Tebex 웹스토어를 운영하면서 아이템, 랭크 또는 명령어 구매를 신뢰할 수 있는 공식 서버 측 처리로 처리해야 한다면, Tebex 플러그인은 서버를 스토어에 연결하고 맞춤 스크립트 없이 지급을 자동화하는 통합과 게임 내 도구를 제공합니다.