TAB — Minecraft Java Edition 1.7.10 – 1.21.11+

Minecraft의 기본 플레이어 목록(TAB 메뉴)은 사용자의 머리와 닉네임만을 단순한 알파벳 순서로 표시합니다. 바닐라 클라이언트는 목록의 머리글이나 바닥글 사용자 지정, 동적 사이드 패널(Scoreboard) 또는 진행 표시줄(BossBar) 생성을, 게임 틱에 부하를 주는 복잡한 명령 블록 체인을 사용하지 않고는 지원하지 않습니다. 그 밖에도 기본 도구로는 플레이어를 게임 내 등급이나 접근 권한에 따라 정렬할 수 없어 관리가 복잡해집니다. TAB 플러그인은 정보 표시 인터페이스를 완전히 재구성하기 위한 비동기 도구를 제공하여 이러한 과제를 해결합니다. 모듈식 아키텍처 덕분에 비활성 기능은 코드에서 완전히 꺼지며 서버의 연산 자원을 소비하지 않습니다.

TAB 목록에서 플레이어의 우선순위 정렬

플러그인의 핵심 기능 중 하나는 목록에서 플레이어를 특정 계층 구조에 따라 분배할 수 있다는 점입니다. TAB은 scoreboard teams(게임 점수 팀)를 사용하여 정렬을 관리합니다. 플러그인은 게임 내에 숨겨진 팀을 자동으로 생성하고 거기에 플레이어를 추가하여 Minecraft 클라이언트가 그들을 원하는 순서로 렌더링하도록 강제합니다.

우선순위를 결정하기 위해 구성에서 sorting-types 매개변수가 사용됩니다. 플러그인은 조건을 위에서 아래로 평가합니다. 두 플레이어가 첫 번째 기준에서 동일한 우선순위를 가지면 다음 기준으로 넘어갑니다.

지원되는 정렬 유형

플러그인 구성 파일 설정

첫 실행 후 plugins/TAB/ 폴더에 구성 파일 구조가 생성됩니다:

·        config.yml — 기본 파일(스크린샷 참조). 개별 모듈의 활성화를 관리합니다(예를 들어 머리 위 접두사 및 정렬을 위한 scoreboard-teams, 목록의 색상을 위한 tablist-name-formatting, 문구를 위한 header-footer). 전역 사이드 패널과 보스바도 여기에서 설정됩니다.

·        animations.yml — 순환 텍스트 효과를 기술하기 위한 것입니다. 애니메이션은 프레임 갱신의 시간 간격(밀리초 단위)과 텍스트 문자열 목록으로 정의됩니다. 생성한 애니메이션은 placeholder %animation:이름%을 통해 다른 어떤 구성에서도 출력할 수 있습니다.

·        groups.yml — LuckPerms 그룹 또는 개인 닉네임의 접두사 및 접미사 표시 형식을 저장합니다.

·        advanced-config.yml — PlaceholderAPI placeholder의 갱신 간격 설정(데이터베이스에 대한 과도한 요청을 방지하기 위함), RedisBungee와의 호환성 매개변수, 디버그 플래그를 포함합니다.

파일 animations.yml에서 애니메이션을 생성하는 예시:

관리 명령어 및 접근 권한

모든 관리 작업은 서버 터미널을 통해 또는 해당 권한을 가진 플레이어가 게임 내에서 직접 수행합니다:

·        /tab reload — 서버를 재시작하지 않고 디스크에서 모든 구성 파일을 다시 불러옵니다.

·        /tab dump — 구성 상태, 플랫폼 버전, 설치된 placeholder 및 활성 오류에 대한 보고서를 생성하고, 진단을 위한 웹 패널 링크를 제공합니다. 이 명령어는 기존 도구 /tab debug를 대체했습니다.

·        /tab cpu — 프로세서 부하에 대한 상세 통계를 출력합니다. 플러그인의 각 모듈이 패킷을 처리하는 시간의 백분율 비율을 보여주어 랙의 원인을 찾는 데 도움을 줍니다.

·        /tab parse <플레이어> <placeholder> — 지정된 사용자에 대해 특정 PlaceholderAPI 변수의 출력을 검사하여 통합 설정이 올바른지 확인할 수 있게 합니다.

·        /tab scoreboard [on/off] — 플레이어를 위한 통계 사이드 패널의 표시를 강제로 켜거나 끕니다.

·        /btab — Velocity 또는 BungeeCord 프록시 서버용 명령어 버전입니다(네트워크에 연결된 모든 서버 간 탭을 전역으로 관리하는 데 사용됩니다).

6.0.2 버전의 아키텍처 특성 및 최적화

플러그인은 높은 부하에서의 높은 성능을 지향합니다. 6.0.2 버전에서는 중요한 최적화가 도입되었습니다:

·        팀 패킷 필터링(Scoreboard Teams): 이전에는 팀 갱신이 예외 없이 연결된 모든 플레이어에게 전송되어 트래픽 양이 사용자 수에 제곱으로 의존하게 만들었습니다. 이제 갱신은 자신의 TAB 목록에서 대상 플레이어를 직접 보고 있는 플레이어에게만 전송됩니다. 대규모 서버에서는 이것이 이름 처리 스레드의 부하를 80% 줄여 줍니다.

·        Vanilla 및 Modded 버전으로의 분리: Fabric과 NeoForge가 Java 25로 전환하면서 호환성 문제가 발생했습니다. Paper의 플러그인 Remapper는 1.20.5 - 1.21.4 버전에 대해 Java 23까지의 코드만 지원합니다. 이 충돌을 해결하기 위해 플러그인은 두 가지 형태로 제공됩니다:

·        TAB v6.0.2 - Fabric, NeoForge.jar (모드 및 Java 25 기반 최신 서버용 전체 빌드).

·        TAB v6.0.2 - Vanilla.jar (모드 의존성이 없는 특수 빌드, Paper 1.20.5 - 1.21.4와 호환).

·        Folia와의 호환성: TAB은 Folia의 다중 스레드 지역 아키텍처를 완전히 지원하며, 정보 수집과 placeholder %tps% 및 %mspt% 갱신을 위해 비동기 스케줄러를 사용하여 지역 동기화를 깨뜨리지 않습니다.

결론

TAB(tab-was-taken)은 Minecraft 서버 인터페이스 디자인의 업계 표준입니다. 사이드 패널, 보스바, 접두사를 위한 여러 개의 개별 플러그인을 대체하여 이를 최적화된 단일 비동기 서비스로 통합합니다. 가장 큰 제약은 자체 scoreboard teams를 생성하려는 다른 플러그인(예: 머리 위 사용자 지정 닉네임용 일부 플러그인이나 채팅 플러그인)과의 충돌로, 이는 정렬을 망가뜨릴 수 있습니다. 또한 Minecraft 26.1 버전에는 belowname 텍스트가 모든 엔티티(갑옷 거치대, 몹)에 보이게 만드는 Mojang 버그가 있어, 바로 이 기능을 사용하기 문제가 되게 합니다. TAB은 로컬 바닐라 프로젝트부터 대규모 BungeeCord/Velocity 네트워크에 이르기까지 모든 유형의 서버에 권장됩니다.