Minecraft 플러그인 AzLink

🔌 AzLink 소개

AzLink는 게임 서버 또는 프록시를 Azuriom 웹사이트와 연결하는 Minecraft 플러그인입니다. 서버 런타임과 Azuriom 사이트 사이에 브리지를 제공하여 계정 관련 데이터, 상점 및 투표 연동을 동기화하고, 플러그인과 메시지에서 사용할 수 있도록 서버 측 플레이스홀더를 제공합니다.

🎯 목적

이 플러그인의 주된 목적은 웹사이트와 서버를 연결하는 것입니다. Azuriom 웹사이트와 하나 이상의 Minecraft 서버 백엔드 또는 프록시 간에 플레이어 계정과 사이트 기반 기능(상점 구매, 투표 보상, 보상 지급)을 일관되게 유지하도록 돕습니다. Azuriom 웹사이트를 운영하면서 게임 내 연동을 위한 지원되고 유지보수되는 연결 도구가 필요한 서버 소유자를 위해 만들어졌습니다.

⚙️ 기능

• 계정 관리와 인증 흐름을 위한 서버↔웹사이트 연결.
• Azuriom 상점 및 투표 확장 기능과의 연동 지점(설정에서 활성화 가능).
• Bukkit 기반 플랫폼에서의 PlaceholderAPI 지원(플레이어의 웹사이트 재화와 상점/투표 관련 플레이스홀더 등을 등록).
• 하나의 .jar로 여러 지원 서버 플랫폼에서 동작함(아주 오래된 서버용 레거시 빌드 포함).
• 설정 기반 동작(설정 파일로 플레이스홀더와 연동 옵션을 제어).

🧩 대상

• Azuriom 웹사이트를 운영하며 게임 내 상점, 투표 또는 계정 동기화가 필요한 서버 소유자.
• 프록시(Bungee/Velocity)를 사용하는 네트워크나 Bukkit 계열 서버의 단일 서버 구성.
• 사이트 데이터를 기반으로 채워지는 PlaceholderAPI용 플레이스홀더를 원하는 관리자.

🏗️ 사용 예시

• PlaceholderAPI를 통해 플레이어의 Azuriom 웹사이트 잔액을 채팅이나 스코어보드에 표시.
• Azuriom 상점에서 구매가 이루어지면 게임 내 아이템이나 등급을 자동 지급.
• 사이트 투표 플러그인이 투표를 기록하면 서버에서 투표 보상을 지급.

⚙️ 설치

📥 설정

• 플랫폼에 맞는 공식 AzLink 플러그인 JAR를 다운로드해 서버의 plugins/ 디렉터리(또는 해당 플랫폼의 대응 위치)에 넣습니다.
• 플러그인을 로드하기 위해 서버를 재시작합니다.
• 서버 콘솔의 시작 메시지를 확인해 AzLink가 정상적으로 초기화되었는지 검증합니다.

📦 의존성

• PlaceholderAPI — Bukkit 기반 서버에서 플레이스홀더 등록용으로 지원되며 선택 사항입니다.
• 연동이 동작하려면 Azuriom 웹사이트 인스턴스가 필요합니다(플러그인은 사이트와 통신합니다).

🧾 설정

• AzLink는 설정 파일을 생성하고 사용하며, 상점 및 투표 플레이스홀더 같은 기능을 켜거나 끄고 Azuriom 웹사이트 연결 정보를 입력할 수 있습니다.
• Bukkit 계열 서버에서는 상점 및 투표 기능의 플레이스홀더 등록을 설정에서 토글할 수 있습니다.

🧠 기술 참고

• 지원되는 서버 플랫폼에는 Bukkit 계열 서버(Bukkit, Spigot, Paper, Folia)와 여러 프록시/대체 서버 플랫폼(BungeeCord, Velocity, Sponge)이 포함됩니다. 모드 환경용으로 Fabric/Forge/NeoForge 로더 포트도 있습니다.
• 이 플러그인은 오픈 소스이며 MIT 라이선스로 배포됩니다.
• 공식 릴리스와 변경 로그는 Azuriom 프로젝트가 게시하며 AzLink 저장소에서 관리합니다.

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

Azuriom 웹사이트를 운영하고 있으며, 사이트 기반 기능(상점, 투표, 계정 데이터, 플레이스홀더)을 게임 안에 반영할 수 있는 유지보수되는 연결 도구가 필요하다면 AzLink는 별도 커스텀 개발 없이 이러한 시스템을 통합하는 설정 가능한 멀티플랫폼 브리지를 제공합니다.