사전 준비
CatBridge가 작동하려면 아래 3가지가 모두 설치되어 있어야 합니다.
- ArcDPS — 게임 데이터를 수집하는 DPS 미터 (설치 가이드)
- ArcDPS Unofficial Extras — ArcDPS가 제공하지 않는 추가 정보(스쿼드, 채팅 등)를 추출
- arcdps_catbridge.dll — Unofficial Extras의 데이터를 CatBridge 앱에 전달하는 브릿지
이 세 개가 모두 같은 폴더에 있어야 합니다.
설치 방법
1단계: CatBridge 다운로드
CatBridge 공식 사이트에서 최신 버전을 받습니다.
2단계: 길드워2 폴더에 압축 해제
다운로드한 파일의 압축을 길드워2 설치 폴더(Gw2-64.exe가 있는 곳)에 풀어넣습니다.
압축을 풀면 아래 파일들이 나옵니다:
| 파일 | 역할 | 설치 위치 |
|---|---|---|
catbridge.exe |
CatBridge 메인 프로그램 | GW2 폴더 |
CatBridgeAudio.dll |
오디오 캡처 (냥비스용) | GW2 폴더 (exe와 같은 곳) |
WebRtcVad.dll |
음성 활동 감지 | GW2 폴더 (exe와 같은 곳) |
arcdps_catbridge.dll |
ArcDPS 브릿지 — 게임 데이터를 CatBridge에 전달 | GW2 폴더 (ArcDPS와 같은 곳) |
같은 폴더에 이미 d3d11.dll(ArcDPS)과
arcdps_unofficial_extras.dll이 있어야 합니다.
3단계: 게임 실행 → CatBridge 실행
- 길드워2를 실행합니다
catbridge.exe를 실행합니다- CatBridge 설정창에서 ArcDPS=연결됨이 표시되면 정상 작동입니다
실행 조건
- 길드워2의 화면 모드를 전체화면 창모드(Windowed Fullscreen) 또는 창모드(Windowed)로 설정해야 합니다
- 전체화면(Exclusive Fullscreen)에서는 오버레이가 표시되지 않습니다
- ArcDPS와 Unofficial Extras가 정상 작동 중이어야 합니다
API 및 번역 엔진 설정 — 무료로 시작하고 필요하면 연결
CatBridge는 API 키 없이도 M, C, P, Google 같은 무료 번역 엔진으로 바로 사용할 수 있습니다. 다만 스토리와 채팅을 더 자연스럽게 번역하거나, 냥카이브·냥비스 같은 AI 기능을 쓰려면 API 키를 추가로 등록하는 것이 좋습니다.
① 무료 번역 엔진
돈을 쓰지 않으려면 M, C, P, Google 중에서 선택하면 됩니다. 무료 엔진 중에서는 M 엔진을 먼저 추천하지만, 언어 조합이나 상황에 따라 다른 엔진이 더 잘 맞을 수도 있습니다. 무료 엔진은 기계번역이라 스토리 번역의 페르소나 사전이나 채팅 문맥 처리에는 한계가 있습니다.
② Groq API 키 (음성인식·냥비스 권장)
Groq API는 번역 품질 때문에 추천하는 키가 아니라, 하루 1,000회 무료 사용량 안에서 음성인식과 냥비스 기능을 쓰기 위해 먼저 발급해두는 것을 권장하는 키입니다. Google 계정으로 로그인하고 API 키 생성 버튼을 누르면 금방 만들 수 있습니다.
③ OpenRouter 또는 Gemini API 키 (AI 번역)
스토리와 채팅 번역 품질을 끌어올리고 싶다면 AI 번역 엔진을 연결하세요. 현재 가성비 추천은 OpenRouter Gemma4 26B (Cloudflare)입니다. Gemini보다 비용은 훨씬 낮고, 품질은 비슷하며, 속도도 빠른 편입니다. 비용보다 편의성과 안정성을 우선한다면 Gemini Flash Lite를 선택하면 됩니다.
④ 길드워2 API 키 (캐릭터 정보 참고)
길드워2 공식 계정 API 키입니다. 계정의 캐릭터, 장비, 업적 등 공개 정보를 읽을 수 있는 키로, CatBridge에 입력해두면 번역과 냥카이브 챗봇이 플레이어의 캐릭터 정보를 참고해서 응답합니다. 예를 들어 사용 중인 직업·종족에 맞는 표현을 쓰거나, 플레이어의 진행 상황을 고려한 답변을 주는 식입니다.
※ Gemini도 여전히 가장 편하고 안정적인 선택입니다. 비용보다 편의성을 우선한다면 Gemini를 쓰면 됩니다.
폰트 커스터마이징
원하는 글꼴을 사용하려면 폰트 파일 이름을 catfont.ttf로 변경한 뒤
catbridge.exe가 있는 폴더에 넣으면 됩니다.
알려진 제한사항
- 공개 베타 버전이므로 예기치 못한 버그가 있을 수 있습니다
- 게임 종료 또는 크래시 후 다시 접속하면, 파티/스쿼드에 재참여하지 않으면 채팅 번역이 제대로 작동하지 않을 수 있습니다. 이 경우 파티/스쿼드에서 나갔다가 다시 참여하세요.
- 파티/스쿼드 채팅만 번역 지원 (일반 채팅, 길드 채팅, 귓속말은 미지원)
자주 묻는 질문 (FAQ)
해결 방법: 게임 설정에서 프레임 제너레이션 옵션을 끄거나, NVIDIA 제어판 / AMD 소프트웨어에서 길드워2에 한해 끄세요.
해결 방법: 길드워2 설정 → 그래픽 → 화면 모드를 전체화면 창모드(Windowed Fullscreen) 또는 창모드(Windowed)로 변경하세요.
일반적으로 전체화면 창모드가 가장 무난합니다.
주의 — 애드온 매니저 사용자: Nexus나 GW2-UOAOM 같은 애드온 매니저를 쓰는 경우, 길드워2 기본 폴더(Gw2-64.exe 옆)의
d3d11.dll은 ArcDPS가 아니라
애드온 매니저 본체입니다. ArcDPS는 매니저에 의해 별도 서브 폴더
(예: addons/arcdps/)에 체인로드 방식으로 설치됩니다.
이 경우 arcdps_unofficial_extras.dll과 arcdps_catbridge.dll도
그 실제 ArcDPS 폴더에 넣어야 하며, 기본 폴더에 넣으면 작동하지 않습니다.
해결 방법:
- 애드온 매니저에서 ArcDPS가 실제로 어느 폴더에 설치되어 있는지 확인합니다
- 그 폴더 안에
arcdps_unofficial_extras.dll을 복사해 넣습니다 - 같은 폴더에
arcdps_catbridge.dll도 복사해 넣습니다 - 게임 재시작 후 CatBridge 설정창에서 ArcDPS = 연결됨인지 확인합니다