BUPA Chat

BUPA Chat는 기본 FiveM 채팅을 대체하는 프리미엄 드롭인(drop-in) 리소스입니다. 완벽한 테마 설정이 가능한 React 인터페이스를 제공하며 표준 chat 리소스를 대체하므로, 게임 채팅과 이미 연동된 모든 스크립트가 마이그레이션 없이 그대로 작동합니다.

BUPA Chat은 단순한 단일 입력창 대신, 플레이어에게 채팅 카테고리(명령어, OOC, 관리자, 직업/조직 채널, 귓말)가 포함된 탭 방식의 입력창, 이모지 피커, 실시간 명령어 추천, 플레이어 머리 위에 렌더링되는 /me 및 /do 스타일 이모트, 선택 사항인 플레이어 ID / 이름 뱃지, Discord 로깅, 그리고 런타임에 전환할 수 있는 플레이어별 언어를 제공합니다.

주요 기능

• 채팅 카테고리 / 탭 — 기본 command 탭과 완전히 설정 가능한 카테고리(OOC 글로벌, OOC 로컬(근접), 관리자, 경찰/EMS 직업 채널, 조직 채널, 그리고 직접 정의하는 커스텀 카테고리)를 제공합니다. 각 카테고리는 고유한 색상, 태그, 권한 및 메시지 규칙을 가집니다.
• 귓속말 — 발신자와 수신자에게 각각 다른 스타일이 적용되는 /pm(및 /dm) 기능.
• 이모트 — 기본 제공되는 /me, /do, /dice, /rps는 펠드의 머리 위 텍스트로 표시되며 옵션을 통해 채팅에도 출력할 수 있습니다. 애니메이션, 거리 제한, 커스텀 매개변수를 사용하여 자신만의 이모트를 추가하세요.
• 이모지 피커 — 검색 가능한 단축키를 지원하는 사용자 정의 가능하고 카테고리화된 이모지 패널(스마일, 제스처, 심볼, 오브젝트).
• 명령어 추천 — 플레이어가 ACE 권한을 가진 등록된 명령어와 표준 chat:addSuggestion(s) API를 통해 전달하는 모든 내용을 자동으로 채워줍니다.
• 플레이어 신원 뱃지 — 카테고리별 이름, 서버 ID, 직업(라벨/등급), Discord 역할 태그(선택 사항), 마스크 착용 시 이름 숨김 처리 및 머리 위 근접 ID 표시 기능 지원.
• Discord 연동 — 채팅/이모트/PM 메시지의 웹훅 로깅, 그리고 Discord 메시지를 게임 내 채팅으로 중계하는 Discord → 인게임 채널 브리지(선택 사항).
• 다국어 지원 — ox_lib 로케일을 통한 번역으로, 전역, 리소스별, 또는 세션별 실시간 선택이 가능합니다.
• 테마 설정 가능한 React UI — 가시성 모드(활성화 시 표시 / 항상 표시 / 숨김), 타이핑 사운드, 바깥쪽 클릭 시 닫기, 그리고 설정 가능한 열기/가시성 키.

프레임워크

BUPA Chat은 QB-Core용으로 제작되었으며 qb-core 종속성으로 나열되어 있습니다. 공용 프레임워크 브리지는 런타임에 Qbox(qbx_core) 및 ESX(es_extended)도 자동으로 감지하며, bupa-chat:framework 콘바어(convar)를 통해 프레임워크를 강제 지정하거나 비활성화할 수 있습니다.

이 리소스는 표준 chat 리소스를 제공(provide 'chat')하므로 애드온이 아닌 FiveM 기본 채팅의 완전한 대체품입니다.

종속성

종속성	용도
ox_lib	로케일, 키인드, 알림, 콜백 및 UI 헬퍼. @ox_lib/init.lua 및 ox_lib 'locale'을 통해 로드됩니다.
qb-core	프레임워크 코어 (플레이어 데이터, 직업, 조직). 필수 종속성으로 지정되어 있습니다.
assetpacks	dependency '/assetpacks'로 선언됨 — 패키징된 UI 자산에 필요합니다.