Minecraft Servers HQ

Minecraft 플러그인 floodgate

floodgate와 확인된 서버에 대한 정보

SpigotPaperModerationCrossplayBedrockAdminUtilityGeyserProxyAuthenticationDeveloper API

🔌 Floodgate 소개

Floodgate는 Geyser용 보조 Minecraft 플러그인으로, Bedrock Edition 플레이어가 Java Edition 서버에 Java 계정 없이 참가할 수 있게 해줍니다. Bedrock 클라이언트가 online-mode Java 서버에서 유효한 플레이어처럼 보이도록 Floodgate가 필요로 하는 인증 및 계정 연결 기능을 제공합니다.

🎯 목적

Floodgate의 핵심 목적은 Bedrock과 Java 버전의 인증 차이를 연결하는 것입니다. Bedrock (Xbox/Microsoft) ID를 검증하고, 이를 Java 호환 플레이어 항목에 매핑하며, 로컬 및 전역 계정 연결을 지원해 Floodgate를 사용하는 서버들에서 Bedrock 플레이어의 ID를 일관되게 인식할 수 있도록 합니다. ()

⚙️ 기능

  • Bedrock 계정 인증 및 Java 플레이어 계정으로의 매핑. ()
  • 플레이어를 위한 로컬 계정 연결 및 연결 해제 명령어. ()
  • Java whitelist와 별도로 Floodgate(Bedrock) 플레이어를 관리하는 whitelist 명령어. ()
  • 다른 플러그인이 Floodgate가 관리하는 Bedrock 플레이어를 감지하고 상호작용할 수 있게 해주는 플러그인 API. ()

🧩 대상

Floodgate는 Bedrock 플레이어가 Java 서버에 참가할 수 있도록 Geyser를 운영하는 서버 소유자와 네트워크 관리자, 그리고 Bedrock ID를 위한 견고한 인증/연결 솔루션이 필요한 사람을 위한 것입니다.

🏗️ 사용 예시

  • 모바일과 콘솔의 Bedrock 플레이어가 기존 Java SMP 또는 Survival 서버에 참여할 수 있게 하면서, 플레이어 계정은 분리되고 추적 가능하게 유지합니다.
  • 플레이어의 Bedrock ID를 Java 계정에 연결해, 해당 사용자에 대해 플러그인과 권한이 일관되게 작동하도록 합니다.

⌨️ 명령어

CommandDescriptionPermissionAccess
/fwhitelistFloodgate용 whitelist 명령어(Bedrock 플레이어 whitelist 관리).floodgate.command.whitelist관리자
/linkaccountBedrock 계정을 로컬 Java 계정에 연결합니다(로컬 연결).floodgate.command.linkaccount플레이어
/unlinkaccountBedrock 계정의 로컬 Java 계정 연결을 해제합니다.floodgate.command.unlinkaccount플레이어

(명령어와 권한 노드는 Floodgate의 공식 문서에서 가져왔습니다.) ()

🔐 권한

PermissionDescriptionDefault
floodgate.command.whitelistFloodgate의 whitelist 명령어를 실행하는 데 필요한 권한입니다.지정되지 않음
floodgate.command.linkaccount로컬 계정을 연결하는 데 필요한 권한입니다.지정되지 않음
floodgate.command.unlinkaccount로컬 계정 연결을 해제하는 데 필요한 권한입니다.지정되지 않음

⚙️ 설치

📥 설정

  • 서버 유형에 맞는 적절한 Floodgate 빌드를 다운로드하고, .jar 파일을 서버의 plugins/ 디렉터리에 넣으세요(해당하는 경우 Fabric/NeoForge용 mod를 설치하세요).
  • 서버를 다시 시작한 뒤 콘솔을 확인해 Floodgate가 로드되었는지 확인하세요.
  • Geyser를 사용하는 경우, Geyser가 Bedrock 인증을 Floodgate에 위임하도록 설정을 auth-type: floodgate로 업데이트하세요. ()

📦 의존성

  • Floodgate는 Bedrock-to-Java 브리지를 위해 Geyser와 함께 사용하도록 설계되었습니다. 설치 안내와 권장 설정은 공식 Floodgate/Geyser 문서에 설명되어 있습니다. ()

🧠 기술 참고

  • Floodgate는 서버 소프트웨어용 플러그인과 Fabric/NeoForge용 mod 모두로 배포됩니다. 지원되는 서버 유형에는 Spigot(및 Paper 같은 포크), BungeeCord, Velocity, 그리고 Fabric/NeoForge 빌드가 포함됩니다. ()
  • Floodgate는 다른 플러그인이 Floodgate 플레이어 정보를 조회하고 Bedrock 전용 이벤트에 응답할 수 있는 API를 제공합니다. ()

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

Geyser를 사용해 Bedrock 플레이어가 Java 서버에 참가하도록 한다면, Floodgate는 Bedrock ID와 계정 연결을 처리하는 구성 요소입니다. 덕분에 해당 플레이어들은 Java 측 플러그인과 서버 시스템에서 인식되고 사용할 수 있게 됩니다.

floodgate 플러그인 서버

플러그인 floodgate 페이지에는 모니터링에서 이 플러그인을 확인한 서버, 사용 중인 플랫폼과 버전이 표시됩니다.

플러그인은 명령어, 경제, 보호, 접근 권한, 미니게임, 연동 및 기타 메커니즘을 추가할 수 있습니다. floodgate의 실제 역할은 서버별 설정에 따라 다릅니다.

데이터는 서버의 기술 응답에서 자동으로 생성됩니다. 서버가 플러그인 목록을 비공개로 설정한 경우, floodgate을 사용하더라도 이 섹션에 표시되지 않을 수 있습니다.

floodgate을 사용하는 서버 목록을 통해 프로젝트를 비교하거나, 지원 버전을 확인하거나, 공개 서버에서의 플러그인 사용 사례를 찾을 수 있습니다.