모든 모드와 플러그인

서버 플러그인 · 서버 API 연결

Bridge

RCON이나 원격 콘솔 없이 허용된 타입 안전 서버 작업과 이벤트를 HTTP, WebSocket, JWT로 연결하는 Paper 플러그인입니다.

주요 기능

작업 허용 목록
각 웹 백엔드가 등록된 작업 이름과 구조화된 payload만 호출하도록 범위를 제한합니다.
독립 자격 증명
클라이언트별 토큰, 작업·이벤트 범위, rate limit와 동시성 한도를 분리합니다.
실시간 이벤트
선택적 WebSocket 엔드포인트가 sequence, 재전송 범위와 backpressure를 적용한 이벤트를 제공합니다.
확장 API
다른 서버 플러그인이 Java API로 작업과 타입 이벤트를 등록할 수 있습니다.

설치

  1. 소스를 Java 25로 빌드해 Bridge JAR과 필요한 bridge-api 산출물을 만듭니다.

  2. Bridge JAR을 Paper 서버의 plugins 디렉터리에 넣고 한 번 시작해 config.yml을 생성합니다.

  3. 웹 백엔드마다 32바이트 이상의 별도 토큰 파일과 최소 작업 허용 목록을 구성합니다.

호환성과 범위

요구 사항

  • Paper 26.2
  • Java 25
  • 외부 백엔드 연결 시 reverse proxy 또는 사설망
  • 클라이언트 설치 불필요

지원 경계

  • 임의 콘솔 명령을 실행하는 작업은 제공하지 않습니다.
  • 기본 listener는 loopback에만 바인딩됩니다.
  • Folia를 지원하지 않습니다.

프로젝트 링크