Better Ping Display [Fabric] — Minecraft Java Edition 1.15.2 - 1.21.11+

기본 Minecraft 인터페이스는 플레이어의 연결 지연 시간을 네트워크 목록 메뉴(TAB 키)에서 다섯 개의 수직 막대로 이루어진 그래픽 아이콘으로 표시합니다. 이러한 방식은 연결 안정성에 대한 정확한 정보를 제공하지 못하는데, 동일한 아이콘이 80밀리초의 지연 시간에도, 140밀리초의 지연 시간에도 해당할 수 있기 때문입니다. 경쟁 플레이, PvP 전투, 또는 대규모 게임 서버를 관리할 때 정확한 핑 수치는 매우 중요합니다. Better Ping Display [Fabric] 모드는 추상적인 그래픽 막대를 밀리초 단위의 정확한 지연 시간 수치로 플레이어 목록 메뉴에 직접 대체하여 이 문제를 해결합니다.

기술적 작동 원리 및 표준 지연 시간 렌더링의 한계

핑 정보를 전달하기 위해 Minecraft 서버는 플레이어 목록 갱신 패킷을 전송합니다(최신 버전의 게임에서는 ClientboundPlayerInfoUpdatePacket 패킷이 이를 담당합니다). 패킷의 각 항목에는 밀리초로 표현된 정수형 지연 시간(latency) 매개변수가 포함됩니다. 게임의 클라이언트 부분은 이 데이터를 수신하여 PlayerInfo 객체(초기 버전에서는 NetworkPlayerInfo로 알려진)의 속성으로 메모리에 저장합니다.

화면에 플레이어 목록을 렌더링할 때, 바닐라 인터페이스 클래스 PlayerListHud(또는 Yarn 매핑의 PlayerTabOverlay)는 연결된 모든 사용자를 순회하며 지연 시간 수준을 판정합니다. 아이콘 표시는 내부 메서드 renderLatencyIcon(또는 renderPingIcon)이 담당합니다. 이 메서드는 정수 밀리초 값을 고정된 임계값과 비교합니다:

·        0보다 작은 값은 연결 없음 아이콘(빨간색 X 표시)을 표시합니다.

·        150밀리초 미만의 값은 최대 다섯 개의 막대에 해당합니다.

·        150에서 299밀리초 범위는 네 개의 막대를 표시합니다.

·        300에서 599밀리초 범위는 세 개의 막대를 표시합니다.

·        600에서 999밀리초 범위는 두 개의 막대를 표시합니다.

·        1000밀리초부터의 지연 시간은 한 개의 막대를 표시합니다.

이렇게 정확한 수치 값은 화면에 출력되기 직전에 버려지고, 그 대신 텍스처 파일 icons.png에서 해당 스프라이트가 그려집니다.

Better Ping Display는 Mixin 시스템을 사용하여 이 과정에 변경을 가합니다. 주입 클래스는 각 플레이어의 행이 그려지는 순간 PlayerListHud의 동작을 수정합니다. 이 모드는 그래픽 막대를 그리는 호출을 가로채어 그 실행을 차단합니다(또는 구성에 따라 병렬로 실행합니다). 그 대신 PlayerInfo 객체를 통해 정확한 latency 값을 얻는 호출이 실행됩니다. 그런 다음 모드는 이 숫자를 클라이언트의 텍스트 렌더러 Font에 전달하며, 렌더러는 구성된 스타일과 인터페이스 요소의 배치를 고려하여 화면에 문자를 동적으로 그립니다.

주요 기능: 숫자 표시, 색상 척도 및 그래픽 막대

이 모드는 다음과 같은 기능을 통해 네트워크 통계 인터페이스의 정보성을 확장합니다:

·        실시간 숫자 지표: 밀리초 단위의 정확한 지연 시간 값을 표시합니다. 플레이어는 커서를 올리거나 채팅에 진단 명령어를 입력할 필요 없이 각 참가자의 실제 연결 상태를 확인할 수 있습니다.

·        자동 색상 표시: 모드는 기본적으로 연결 품질에 따라 핑 텍스트의 색을 지정합니다. 낮은 지연 시간(100밀리초 미만)은 녹색으로 강조되고, 중간 지연 시간(100에서 299밀리초)은 노란색 또는 주황색을 띠며, 높은 지연 시간(300밀리초 이상)은 빨간색으로 칠해집니다. 이를 통해 불안정한 연결 상태의 플레이어를 즉시 발견할 수 있습니다.

·        결합 표시 모드: 사용자는 숫자 값과 원래의 바닐라 핑 막대를 동시에 표시하도록 설정할 수 있습니다. 이 경우 텍스트는 그래픽 아이콘의 왼쪽에 그려지며, Minecraft의 익숙한 시각적 스타일을 유지합니다.

·        클라이언트 아키텍처: 이 모드는 순수하게 클라이언트 측에서 작동합니다. 서버에 설치할 필요가 없으며 서버에 추가 요청을 보내지 않습니다. 모드는 Minecraft 서버가 기본적으로 연결된 모든 클라이언트에게 전송하는 트래픽 정보만 읽습니다. 덕분에 Better Ping Display는 공식 Realms 서버와 모드 지원이 없는 공개 서버를 포함한 모든 서버에서 작동합니다.

설정, 호환성 및 생태계

표시 매개변수의 구성은 게임을 처음 실행한 후 config 디렉터리에 자동으로 생성되는 betterpingdisplay.json 파일을 편집하여 수행합니다. 파일에는 다음 설정이 포함되어 있습니다:

·        autoColorPingText – 논리 플래그(true/false). 값이 true인 경우 핑 색상이 연결 속도에 따라 녹색에서 빨간색으로 자동으로 변경됩니다. false로 지정하면 색상이 정적이 되며 다음 매개변수에 의해 결정됩니다.

·        pingTextColor – 16진수 색상 코드(예: 밝은 회색의 경우 #A0A0A0)를 설정하기 위한 텍스트 필드. 이 색상은 자동 색상 표시가 비활성화된 경우에만 사용됩니다.

·        renderPingBars – 숫자 지표 옆에 표준 바닐라 지연 시간 막대의 렌더링을 제어하는 논리 플래그.

·        pingTextFormatString – 텍스트 형식 문자열. 기본값은 %dms로 설정되어 있으며, 여기서 %d 기호는 렌더링 시 현재 지연 시간의 밀리초 숫자로 대체되는 필수 기술 표식입니다.

모드 버전 1.2.0 이상에서는 게임 메뉴에서 직접 설정을 위한 그래픽 인터페이스 지원이 추가되었습니다. 모드 목록에서 시각적 구성 메뉴에 접근하려면 두 개의 추가 보조 구성 요소를 설치해야 합니다: YetAnotherConfigLib(YACL) 라이브러리와 Mod Menu 모드입니다. 이들이 있으면 게임에 Better Ping Display 매개변수를 변경하기 위한 스위치와 슬라이더가 있는 편리한 창이 나타납니다.

이 모드는 대부분의 클라이언트 최적화 도구(Sodium, Lithium, FerriteCore 등)와 그래픽 향상 도구(Iris Shaders)와 호환됩니다. 플레이어 목록용 사용자 정의 플러그인이 있는 서버에서 플레이할 때 충돌을 일으키지 않는데, 이는 네트워크 패킷 구조에 영향을 주지 않고 클라이언트의 로컬 렌더링 단계만 변경하기 때문입니다.

결론

Better Ping Display [Fabric]는 Minecraft의 기본 플레이어 목록의 중대한 단점을 바로잡는 컴팩트하고 효율적인 클라이언트 모드입니다. Numeral Ping이나 Ping Display와 같은 유사한 솔루션과 달리, 이 모드는 게임 내에서 직접 매개변수를 조정할 수 있도록 YACL 라이브러리와의 간단한 통합을 제공하며 바닐라 지연 시간 아이콘을 유지할 수 있게 합니다. 주요 제한 사항은 숫자의 갱신 빈도가 서버 자체의 설정에 의존한다는 점입니다(기본적으로 Minecraft 서버는 몇 초에 한 번씩 핑 통계 갱신을 전송하므로, 지연 시간의 순간적인 변동은 즉시 표시되지 않습니다). 이 모드는 네트워크 모드 플레이어와 시스템에 불필요한 부하 없이 네트워크 매개변수를 명확하게 제어해야 하는 서버 관리자에게 이상적입니다.