CatBridge 설치와 설정

CatBridge Installation & Setup

한 줄 요약

CatBridge를 설치하려면 ArcDPS와 Unofficial Extras가 먼저 필요합니다. 압축을 풀고, 브릿지 DLL을 ArcDPS 옆에 넣으면 됩니다.

사전 준비

CatBridge가 작동하려면 아래 3가지가 모두 설치되어 있어야 합니다.

  1. ArcDPS — 게임 데이터를 수집하는 DPS 미터 (설치 가이드)
  2. ArcDPS Unofficial Extras — ArcDPS가 제공하지 않는 추가 정보(스쿼드, 채팅 등)를 추출
  3. arcdps_catbridge.dll — Unofficial Extras의 데이터를 CatBridge 앱에 전달하는 브릿지

이 세 개가 모두 같은 폴더에 있어야 합니다.

Nexus 등 애드온 매니저 사용자 주의
Nexus나 GW2-UOAOM 같은 애드온 매니저를 사용하면 ArcDPS가 기본 위치(Gw2-64.exe 옆)가 아닌 다른 폴더에 설치될 수 있습니다. Unofficial Extras와 arcdps_catbridge.dll을 반드시 ArcDPS가 실제로 설치된 폴더에 넣어야 합니다. 잘못된 위치에 넣으면 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 실행

  1. 길드워2를 실행합니다
  2. catbridge.exe를 실행합니다
  3. CatBridge 설정창에서 ArcDPS=연결됨이 표시되면 정상 작동입니다

실행 조건

  • 길드워2의 화면 모드를 전체화면 창모드(Windowed Fullscreen) 또는 창모드(Windowed)로 설정해야 합니다
  • 전체화면(Exclusive Fullscreen)에서는 오버레이가 표시되지 않습니다
  • ArcDPS와 Unofficial Extras가 정상 작동 중이어야 합니다

API 키 설정 — 번역 품질을 높이는 핵심 단계

CatBridge 설치 후 설정 화면에서 두 가지 API 키를 입력할 수 있습니다. 하나는 번역 엔진용 Gemini API 키이고, 다른 하나는 길드워2 공식 API 키입니다. 둘 다 필수는 아니지만, 입력해두면 번역 품질과 AI 답변의 정확도가 크게 올라갑니다.

CatBridge API 키 설정 화면
CatBridge 설정 화면의 API 키 입력란 — GW2 API와 Gemini API를 각각 입력합니다

① Gemini API 키 (번역 엔진)

Google AI Studio에서 발급받는 Gemini API 키입니다. 입력하면 구글 기계 번역 대신 Gemini 엔진이 작동하며, 페르소나 사전이 적용된 고품질 번역을 받을 수 있습니다. 냥카이브 챗봇과 냥비스는 Gemini API가 있어야만 작동합니다.

→ 제미나이 API 키 발급과 등록 방법

② 길드워2 API 키 (캐릭터 정보 참고)

길드워2 공식 계정 API 키입니다. 계정의 캐릭터, 장비, 업적 등 공개 정보를 읽을 수 있는 키로, CatBridge에 입력해두면 번역과 냥카이브 챗봇이 플레이어의 캐릭터 정보를 참고해서 응답합니다. 예를 들어 사용 중인 직업·종족에 맞는 표현을 쓰거나, 플레이어의 진행 상황을 고려한 답변을 주는 식입니다.

→ 길드워2 API 키 발급하는 방법

두 키 모두 무료이거나 매우 저렴합니다
길드워2 API 키는 완전 무료이고, Gemini API도 번역 기능만 사용할 경우 라이트하게 쓰면 한 달에 천 원도 안 됩니다. 두 키를 모두 넣어두면 CatBridge가 제공하는 기능을 온전히 활용할 수 있습니다.

※ 냥비스(디스코드 음성 요약)를 함께 쓰거나 프리미엄 엔진을 체크하면 Gemini API 비용이 올라갑니다.

폰트 커스터마이징

원하는 글꼴을 사용하려면 폰트 파일 이름을 catfont.ttf로 변경한 뒤 catbridge.exe가 있는 폴더에 넣으면 됩니다.

알려진 제한사항

  • 현재 베타 0.95 버전으로, 예기치 못한 버그가 있을 수 있습니다
  • 게임 종료 또는 크래시 후 다시 접속하면, 파티/스쿼드에 재참여하지 않으면 채팅 번역이 제대로 작동하지 않을 수 있습니다. 이 경우 파티/스쿼드에서 나갔다가 다시 참여하세요.
  • 파티/스쿼드 채팅만 번역 지원 (일반 채팅, 길드 채팅, 귓속말은 미지원)

자주 묻는 질문 (FAQ)

❓ 게임을 켜자마자 검은 화면이 나오고 진행이 안 돼요
NVIDIA DLSS 프레임 제너레이션 또는 AMD FSR 3 프레임 제너레이션이 켜져 있는 경우입니다. 프레임 제너레이터는 길드워2의 모든 오버레이 애드온(ArcDPS, Blish HUD, CatBridge 등)과 충돌해서 검은 화면을 일으킵니다.

해결 방법: 게임 설정에서 프레임 제너레이션 옵션을 끄거나, NVIDIA 제어판 / AMD 소프트웨어에서 길드워2에 한해 끄세요.
❓ 게임은 잘 실행되는데 CatBridge 오버레이 창이 안 떠요
길드워2의 화면 모드가 독점 전체화면(Exclusive Fullscreen)으로 설정되어 있으면 오버레이가 표시되지 않습니다.

해결 방법: 길드워2 설정 → 그래픽 → 화면 모드를 전체화면 창모드(Windowed Fullscreen) 또는 창모드(Windowed)로 변경하세요.
일반적으로 전체화면 창모드가 가장 무난합니다.
❓ 오버레이 창은 뜨는데 번역이 안 돼요 (채팅·NPC 대사가 안 잡힘)
arcdps_catbridge.dll이 ArcDPS가 실제로 설치된 폴더에 있지 않은 경우입니다. CatBridge는 ArcDPS → Unofficial Extras → arcdps_catbridge.dll 순서로 데이터를 받기 때문에, 이 세 개가 모두 같은 폴더에 있어야 작동합니다.

주의 — 애드온 매니저 사용자: Nexus나 GW2-UOAOM 같은 애드온 매니저를 쓰는 경우, 길드워2 기본 폴더(Gw2-64.exe 옆)의 d3d11.dll은 ArcDPS가 아니라 애드온 매니저 본체입니다. ArcDPS는 매니저에 의해 별도 서브 폴더 (예: addons/arcdps/)에 체인로드 방식으로 설치됩니다. 이 경우 arcdps_unofficial_extras.dll과 arcdps_catbridge.dll도 그 실제 ArcDPS 폴더에 넣어야 하며, 기본 폴더에 넣으면 작동하지 않습니다.

해결 방법:
  1. 애드온 매니저에서 ArcDPS가 실제로 어느 폴더에 설치되어 있는지 확인합니다
  2. 그 폴더 안에 arcdps_unofficial_extras.dll을 복사해 넣습니다
  3. 같은 폴더에 arcdps_catbridge.dll도 복사해 넣습니다
  4. 게임 재시작 후 CatBridge 설정창에서 ArcDPS = 연결됨인지 확인합니다

다음으로 읽으면 좋은 글

제미나이 API 설정 방법 고품질 번역과 AI 기능을 활성화하려면
NPC 스토리 번역 페르소나 사전으로 로컬라이즈 수준의 번역