server-icon.png: 정확한 요구사항과 아무도 사용하지 않는 관리 API
64x64, PNG, 서버 루트에 위치해야 합니다. 이 세 가지 중 하나라도 틀리면 아이콘이 조용히 나타나지 않습니다. 콘솔 화면 스크래핑을 대체한 JSON-RPC 관리 API도 소개합니다.
서버 아이콘은 마인크래프트에서 가장 관용 없는 작은 기능입니다. 왜냐하면 모든 실패 모드가 동일하게 보이기 때문입니다. 아이콘이 없고, 오류도 없습니다.
세 가지 필수 요구사항
- 정확히 64×64 픽셀. 63도, 128도 안 됩니다. 서버는 크기를 조정하지 않습니다.
- PNG 형식. JPG를 이름만 바꾼 것이 아니라 실제 PNG여야 합니다.
- 서버 루트에
server-icon.png로 명명 —server.properties옆에 있어야 하며, 월드 폴더 안에 있으면 안 됩니다.
이 중 하나라도 틀리면 서버는 정상적으로 시작되지만 기본 아이콘을 표시합니다. 기본 로깅 수준에서는 아무것도 기록되지 않습니다.
아이콘 표시를 방해하는 다른 요인들
- 인터레이스 PNG. 일부 편집기는 기본적으로 인터레이스 방식으로 저장합니다. 마인크래프트 리더는 이를 거부합니다. 비인터레이스 방식으로 다시 내보내세요.
- 16비트 색상 깊이. 채널당 8비트로 저장하세요.
- 색상 프로필. 내장된 ICC 프로필이 가끔 파서를 방해합니다. 내보낼 때 메타데이터를 제거하세요.
- 투명도도 괜찮습니다. 서버 목록에 올바르게 렌더링됩니다.
클라이언트가 캐시합니다
클라이언트가 한 번 서버를 보면 아이콘을 캐시합니다. 서버 측에서 변경해도 기존 항목은 업데이트되지 않습니다. 플레이어는 서버를 제거하고 다시 추가하거나 캐시가 만료될 때까지 기다려야 합니다. 자신의 클라이언트에서 아이콘 변경을 테스트하면 작동했음에도 불구하고 작동하지 않았다고 착각할 수 있습니다.
관리 API
최신 서버 버전은 JSON-RPC 관리 인터페이스를 노출합니다. 이는 콘솔 출력을 파싱하거나 플러그인을 붙이는 것을 대체하는 공식적인 방법입니다.
server.properties에서 활성화하세요:
management-server-enabled=true
management-server-host=localhost
management-server-port=25585그런 다음 해당 포트를 통해 JSON-RPC로 통신합니다:
{ "jsonrpc": "2.0", "id": 1, "method": "minecraft:players" }메서드는 플레이어 목록, 서버 상태, 허용 목록 및 금지 목록, 게임 규칙, 설정, 그리고 저장/중지 쌍을 다룹니다. 각 메서드는 정규식으로 처리해야 하는 텍스트 줄 대신 구조화된 JSON을 반환합니다.
로컬호스트에 바인딩
기본값은 localhost이며 그대로 유지해야 합니다. 이 인터페이스는 인터넷에 노출되도록 의도된 것이 아닙니다. 여기에 접근하는 모든 것은 서버를 중지시킬 수 있습니다. 원격 액세스가 필요한 경우 SSH 터널이나 인증이 있는 리버스 프록시를 통해 노출해야 하며, 호스트를 0.0.0.0으로 변경해서는 절대 안 됩니다.
왜 중요한가
대시보드, 디스코드 봇, 가동 시간 모니터는 역사적으로 콘솔 로그를 읽거나 RCON을 사용하여 작동했지만, 둘 다 취약합니다. 유형화된 API는 로그 줄의 형식이 변경되어도 플레이어 수 위젯이 고장 나지 않음을 의미합니다.
모든 이미지를 규격에 맞는 server-icon.png으로 변환하고 서버 아이콘 및 API 도구에서 JSON-RPC 메서드를 살펴보세요.