Blue Protocol: Star Resonance (BPSR) Real-time Packet-Sniffing Translator
관련 링크: Resonance Lab | LLM Model
Resonance Stream은 블루 프로토콜 게임 서버의 네트워크 패킷을 스니핑하여 대화 내용을 추출하고 번역합니다. 이를 통해 UI 에 채팅 내용을 그대로 가져올 수 있으며, 닉네임 검색, 대화 내용 검색, 키워드 알림 등의 다양한 기능을 제공합니다. 또한 번역이 필요한 일본어 채팅의 경우에는 AI 모델을 탑재하여 실시간 번역을 제공합니다. 일본어 번역은 실제 게임에서 사용하는 용어로 번역하기 위해 게임 내 채팅 데이터로 파인튜닝을 진행합니다. 프로젝트 링크
- 채팅 서버 패킷 스니핑: Raw Socket 을 이용하여 블루 프로토콜 게임 서버에서 보낸 채팅을 가져옵니다.
- AI 번역 엔진: 실제 일본어 채팅 데이터로 파인튜닝된 TranslateGemma-4B 모델을 사용하여 실제 게임에서 사용되는 용어로 번역됩니다.
- 닉네임 번역: 일본어 닉네임의 읽는 방법을 닉네임 옆에 괄호를 열어 추가합니다.
- 다양한 디바이스 지원: 사용자 하드웨어 사양에 맞게 CPU / GPU 모드, GPU Off Load Tier (Low, Middle, High, Very High) 로 설정이 가능하며, Vulkan 을 사용하여 제조사에 관계 없이 GPU를 사용할 수 있습니다.
- 다양한 UI 기능: 게임 내의 채팅 기능이 제공하지 못하는 다양한 기능을 제공합니다. (채팅 검색, 닉네임 필터, 채팅 키워드 알림)
- 관리자 권한: 패킷 감지를 위해 프로그램 실행 시 관리자 권한이 반드시 필요합니다.
- 네트워크 방화벽 설정: 이 프로그램은 패킷 감지를 위해 네트워크 방화벽 설정이 필요합니다. 최초 실행 시 방화벽에 대한 경고를 알려주며, 동의하지 않을 시 앱 기능 사용이 제한됩니다. 생성된 방화벽 규칙은 프로그램 종료 시 제거됩니다.
- 최신 [Release] 섹션에서
resonance-stream.exe파일을 다운로드합니다. resonance-stream.exe를 관리자 권한으로 실행합니다.
Resonance Stream의 변역 기능을 사용할 경우, 번역을 위해 약 2.3GB의 데이터를 사용합니다. 프로그램을 삭제하실 때 다음 사항을 확인해 주세요.
- 앱 데이터 폴더 확인: 프로그램의 설정 창 맨 밑의 App Data 폴더 열기 버튼을 눌러 프로그램 추가 설치 파일 폴더를 엽니다.
- 데이터 삭제: 폴더 내의 모든 설치 파일을 제거합니다.
- 수동 확인 (선택 사항):
%APPDATA%\com.enjay.bpsr.resonance-stream폴더를 직접 삭제하시면 됩니다.
- 프로그램 최초 실행 시 최초설정 창이 나오며, 번역 사용 여부, CPU/GPU 모드 설정을 할 수 있습니다. 이 설정은 프로그램 실행 후 설정에서 바꿀 수 있습니다.
- 게임(블루 프로토콜)을 실행하고 서버에 접속하면 자동으로 패킷 감지가 시작됩니다.
- 만약 게임을 실행하였는데도 게임의 채팅 데이터를 받아오지 못하는 경우에는 프로그램 맨 위 타이틀바에서 초록색의
SNIFFER ON이 되었는지 확인해주세요. 빨간색인 경우, 클릭하면 실패 복구 솔루션을 실행합니다. - 번역 기능을 켠 경우,
번역 ON이 되었는지 확인해주세요.
- v0.4.0 에 추가된 기능으로 방화벽 설정 및 네트워크 어댑터의 문제를 손쉽게 해결할 수 있는 기능이 추가되었습니다.
- UI 개선: 사용자 사전 수정 및 자동싱크, 탭 전환 단축키, 안 읽은 메시지 개수 표시, 메시지 박스 가독성 향상
- 에러 상황 재시도 로직 추가: 패킷 스니핑 실패 시 네트워크 어댑터를 자동으로 찾는 기능 추가
- 번역 모델 변경: 더 나은 번역 품질을 위해 TranslateGemma 모델로 변경
- 방화벽 경고 추가: 최초 실행 시 방화벽 경고 문구 추가
- 업데이트 감지: 해당 앱의 최신 버전을 감지하여 사용자가 쉽게 업데이트 하는 기능 추가
- 번역 엔진 변경: 기존의 파이썬 라이브러리 번역에서 파이썬 의존성을 제거하고 번역 엔진으로 Vulkan 드라이버를 지원하는 llama-server 를 사용하여 모든 종류의 GPU 에서 번역 기능을 GPU 로 사용할 수 있도록 변경하였습니다.
- 번역 모델 변경: CTranslate2 의 NLLB-200 모델에서 파인튜닝 된 Qwen3-4B 모델로 변경하여 게임 내의 일본어 채팅을 자연스러운 한국어로 번역할 수 있게 합니다.
- 패킷 분석 의존성 제거: WinDivert 에서 Raw Socket 으로 변경하여 의존성 파일이나 추가 설치 파일 없이 단일 실행 파일로 프로그램을 실행할 수 있도록 합니다.
- 닉네임 관리: 일본어로 된 닉네임의 읽는 방법을 로마자로 추가하고 닉네임을 캐싱하여 닉네임이 채팅에 나오는 경우 번역되지 않도록 합니다.
- 디버그 시스템: 네트워크 드라이버 빛 번역 기능 동작 확인을 위한 시스템 로그(Debug Mode)를 지원합니다.
- Enjay (kdkyoung@gmail.com)