BileTools - 테스트 플러그인을 더 빠르게

서버를 재시작하지 않고 플러그인을 다시 로드합니다.

BileTools는 플러그인 폴더에 새로운 빌드가 들어오면 테스트 서버에서 플러그인을 즉시 다시 로드합니다. 의존하는 플러그인들은 올바른 순서로 다시 로드되며, 실패한 로드는 이전 버전으로 되돌립니다. 또한 Velocity에서 실행되며 다른 개발 서버로 빌드를 푸시할 수 있습니다.

BileTools는 런타임에 플러그인을 로드, 언로드 및 삭제합니다. 개발 용도로만 사용하는 것이 좋습니다.

자동 핫 리로드

감시자

• 변경된 jar는 파일 변경이 멈추면 다시 로드됩니다.

• 새로운 jar는 누락된 의존성 jar와 함께 로드됩니다.

• 삭제된 jar는 3초 후 언로드됩니다.

• 재구성된 jars는 함께 다시 로드되며, 의존성 먼저.

• 새로운 BileTools jar는 BileTools 자체를 업데이트합니다.

잘못된 로드 없음

• SHA-256 체크가 jar가 실제로 변경되었음을 확인합니다.

• 반쯤 작성된 jars는 완전할 때까지 건너뜁니다.

• 자동 로드 실패는 해당 플러그인을 수동으로 다시 로드할 때까지 일시 중지합니다.

• 무시 및 허용 목록은 자동으로 로드되는 것을 제한합니다.

더 안전한 로드 및 롤백

제거 전 체크

• 누락된 의존성, 사이클 및 이름 충돌은 언로드 전에 로드를 중지합니다.

• 작업, 리스너 및 명령이 정리됩니다.

• 플레이어는 새 명령 목록을 받습니다.

• 플러그인이 활성화되는 동안 오류는 실패한 로드로 간주됩니다.

• 플러그인은 작업을 마치거나 로드를 거부할 수 있습니다.

복구

• 실패한 교체는 전체 그룹의 이전 버전을 다시 로드합니다.

• 실행하는 모든 버전은 아카이브됩니다.

• /bile install은 이전 버전을 복원합니다.

프록시 및 원격 배포

Velocity 프록시

• 재구성된 프록시 플러그인은 그 의존성과 함께 다시 로드됩니다.

• 같은 체크 및 복구가 적용됩니다.

원격 배포

• 당신의 메인 서버는 나열한 개발 서버에 다시 로드된 jar를 푸시합니다.

• 각 서버는 첫 시작 시 자신의 키를 생성합니다.

• 양측은 신뢰하는 키와만 통신합니다.

• jar는 암호화된 TLS를 통해 전송됩니다.

• 선택적 IP 목록은 연결할 수 있는 대상을 제한합니다.

원격 배포는 기본적으로 꺼져 있습니다.

시작하기

1. BileTools jar를 plugins/에 당신의 개발 서버 또는 Velocity 프록시에 넣고 한 번 시작하세요.

2. 당신의 빌드 출력을 plugins/에 포인팅하고 다시 빌드하세요.

3. 콘솔에서 로드를 지켜보세요.

명령 및 권한

명령

별칭: /bile, /bi 및 /b는 /biletools

/bile reload <plugin>               플러그인 및 의존성을 다시 로드합니다.
/bile load <plugin>                plugins/에서 jar를 로드합니다.
/bile unload <plugin>               플러그인 및 의존성을 언로드합니다.
/bile inspect <plugin>               다시 로드할 수 있는지 확인합니다.
/bile library plugin=<name>          아카이브된 버전을 나열합니다.
/bile install <plugin> version=<v>   아카이브된 버전을 복원합니다.
/bile config                          설정 편집기를 엽니다.
/biletools debug dump                 진단 보고서를 업로드합니다.

권한

권한              기본값  허용
bile.use           op       플러그인 관리 및 jar 삭제
biletools.config   op       설정 편집기 및 서버 언어
biletools.debug    op       진단 보고서

호환성 및 한계

실행 가능: Paper, Purpur, Leaf, Folia, Canvas, Spigot, Velocity

Minecraft: 1.20.1에서 26.3까지 Java 17 이상에서 실행됩니다. 26.x 서버는 Java 25가 필요합니다.

• 플랫폼 Paper, Purpur 및 Leaf가 주요 대상입니다. Velocity는 3.4 이상이 필요합니다. Folia 및 Canvas에서는 플러그인이 자신의 지역 작업을 정리해야 합니다. Spigot은 심볼릭 링크를 생성할 수 있는 권한이 필요합니다.

• 통합 플러그인은 VolmLib의 ReloadAware 인터페이스를 통해 로드와 함께 작동할 수 있습니다.

• 언어 영어와 17개의 번역이 있으며, 각 플레이어나 전체 서버에 대해 사용할 수 있습니다. 프록시는 영어만 지원합니다.

• 네트워크 라이브러리와 선택한 번역을 다운로드합니다. 업데이트를 위해 GitHub를 확인합니다. 디버그 보고서는 mclo.gs에 업로드됩니다. upload=false를 추가하지 않으면 됩니다. 배포를 받을 때만 포트 9876에서 수신합니다.

• 한계 정적 상태, 개인 스레드 및 패킷 훅은 플러그인 자체의 정리가 필요합니다. 복구는 데이터나 월드 변경을 되돌릴 수 없습니다. Paper에서는 paper-plugin.yml이 있는 새로운 jar가 재시작이 필요합니다. BileTools는 Velocity에서 스스로를 다시 로드할 수 없습니다.

질문, 제안 및 버그 보고는 Discord 또는 GitHub에서 환영합니다.

소스 코드 • 문서 • Discord