Installation & Setup

설치와 설정

Copy a few files into your GW2 folder. The setup usually takes less than two minutes.

파일 몇 개를 길드워2 폴더에 넣으면 끝. 2분이면 됩니다.

Prerequisites

사전 준비

CatBridge needs three things already in place before it can run:

CatBridge를 쓰려면 아래 3가지가 먼저 깔려 있어야 합니다.

  1. ArcDPS — the DPS meter that hooks into the game client
  2. ArcDPS Unofficial Extras — an ArcDPS plugin that exposes squad and chat data
  3. arcdps_catbridge.dll — the bridge plugin that pipes data from Unofficial Extras to CatBridge (bundled with CatBridge)
  1. ArcDPS — 게임 데이터를 수집하는 DPS 미터
  2. ArcDPS Unofficial Extras — ArcDPS가 제공하지 않는 추가 정보(스쿼드, 채팅 등)를 추출
  3. arcdps_catbridge.dll — Unofficial Extras의 데이터를 CatBridge 앱에 전달하는 브릿지 (CatBridge에 포함됨)

All three must be in the same folder.

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

ArcDPS & Unofficial Extras are required (download them yourself)

CatBridge does not bundle ArcDPS or Unofficial Extras. Grab them from the official sources below — both are free.

ArcDPS와 Unofficial Extras는 직접 받아야 합니다

CatBridge에는 ArcDPS와 Unofficial Extras가 포함되어 있지 않습니다. 아래 공식 다운로드 페이지에서 직접 받으세요. 둘 다 무료입니다.

Download these three files

아래 3개 파일을 모두 받으세요

All three are downloads. Click each card to open its official page. You need all three before CatBridge can do anything.

세 개 전부 다운로드입니다. 각 카드를 클릭하면 공식 다운로드 페이지로 이동합니다. 세 파일 모두 없으면 CatBridge가 작동하지 않습니다.

Addon manager users: check your ArcDPS location

If you use Nexus or GW2-UOAOM, ArcDPS may be installed in a subfolder (e.g. addons/arcdps/) instead of next to Gw2-64.exe. The d3d11.dll in your root GW2 folder might be the addon manager itself, not ArcDPS. Place Unofficial Extras and arcdps_catbridge.dll wherever ArcDPS actually lives.

Nexus 등 애드온 매니저 사용자 주의

Nexus나 GW2-UOAOM 같은 애드온 매니저를 사용하면 ArcDPS가 기본 위치(Gw2-64.exe 옆)가 아닌 다른 폴더에 설치될 수 있습니다. Unofficial Extras와 arcdps_catbridge.dll을 반드시 ArcDPS가 실제로 설치된 폴더에 넣어야 합니다. 잘못된 위치에 넣으면 CatBridge가 작동하지 않습니다.

Important install check

Use the ArcDPS About tab to find the real folder

If you use Nexus or another addon manager, do not guess from the GW2 folder. Launch the game, open ArcDPS options with Alt + Shift + T, then open the last About / Info tab. Check that ArcDPS is up to date there, then look at the folder path shown at the top of the tab. That path is the folder ArcDPS is actually running from, and that is the correct install location.

Put both arcdps_unofficial_extras.dll and arcdps_catbridge.dll in that same folder. This still works even if Unofficial Extras was not loaded yet, or if you accidentally installed it somewhere else first. Most failed installs happen because the DLLs were placed in the visible GW2 folder while ArcDPS was actually running from an addon-manager subfolder.

After moving the files, fully restart Guild Wars 2 and open the ArcDPS About / Info tab again. A correct install shows both arcdps_unofficial_extras.dll and arcdps_catbridge.dll as loaded there. If either one is missing, it is still in the wrong folder.

중요 설치 확인

실제 ArcDPS 폴더는 About / 정보 탭에서 확인하세요

Nexus 같은 애드온 매니저를 쓴다면 GW2 폴더만 보고 추측하면 안 됩니다. 게임 안에서 Alt + Shift + T로 ArcDPS 옵션을 열고, 맨 마지막 About / 정보 탭을 확인하세요. 여기에서 ArcDPS가 최신 버전인지 확인하고, 탭 맨 위에 표시되는 폴더 경로를 보세요. 그 경로가 ArcDPS가 실제로 실행 중인 폴더이고, 바로 그 폴더가 정답입니다.

그 폴더 안에 arcdps_unofficial_extras.dllarcdps_catbridge.dll을 둘 다 넣으면 됩니다. Unofficial Extras가 아직 로드되지 않았거나, 엉뚱한 폴더에 설치된 상태여도 기준은 항상 Info 탭 맨 위에 나오는 ArcDPS 폴더입니다. 설치는 했는데 채팅/NPC 대사가 안 잡히는 경우 대부분이 이 위치를 잘못 잡아서 생깁니다.

파일을 옮긴 뒤에는 길드워2를 완전히 종료했다가 다시 실행하세요. 다시 ArcDPS의 About / 정보 탭을 열었을 때 arcdps_unofficial_extras.dllarcdps_catbridge.dll 두 파일이 로드된 것으로 보여야 정상 설치입니다. 둘 중 하나라도 보이지 않으면 아직 폴더 위치가 잘못된 것입니다.

Step-by-Step Installation

설치 방법

1. Download CatBridge

1단계: CatBridge 다운로드

Grab the latest release from the download link.

CatBridge 다운로드에서 최신 버전을 받습니다.

2. Put the files in the right places

2단계: 파일을 맞는 위치에 넣기

Keep the CatBridge app files together, usually in the folder that contains Gw2-64.exe. Put arcdps_catbridge.dll in the actual ArcDPS folder shown in the ArcDPS About / Info tab.

CatBridge 앱 파일은 보통 Gw2-64.exe가 있는 폴더에 함께 둡니다. arcdps_catbridge.dll은 ArcDPS의 About / 정보 탭에 표시된 실제 ArcDPS 폴더에 넣으세요.

FilePurposeLocation
catbridge.exeMain applicationGW2 folder
CatBridgeAudio.dllAudio capture for Discord voice translation and voice featuresSame as exe
WebRtcVad.dllVoice activity detectionSame as exe
arcdps_catbridge.dllBridge — pipes game data to CatBridgeActual ArcDPS folder
파일역할설치 위치
catbridge.exeCatBridge 메인 프로그램GW2 폴더
CatBridgeAudio.dll오디오 캡처 (디스코드 음성 통역 및 음성 기능)GW2 폴더 (exe와 같은 곳)
WebRtcVad.dll음성 활동 감지GW2 폴더 (exe와 같은 곳)
arcdps_catbridge.dllArcDPS 브릿지 — 게임 데이터를 CatBridge에 전달실제 ArcDPS 폴더

Before testing CatBridge, use the ArcDPS About / Info tab to confirm arcdps_unofficial_extras.dll and arcdps_catbridge.dll are loaded from the ArcDPS folder.

CatBridge를 테스트하기 전에 ArcDPS의 About / 정보 탭에서 arcdps_unofficial_extras.dllarcdps_catbridge.dll이 ArcDPS 폴더에서 로드됐는지 확인하세요.

3. Restart the game, verify ArcDPS, then launch CatBridge

3단계: 게임 재실행 → ArcDPS 확인 → CatBridge 실행

  1. Fully close Guild Wars 2, then start it again
  2. Open ArcDPS with Alt + Shift + T
  3. In the last About / Info tab, confirm ArcDPS is current and both CatBridge DLLs are loaded
  4. Run catbridge.exe
  1. 길드워2를 완전히 종료했다가 다시 실행합니다
  2. Alt + Shift + T로 ArcDPS 옵션을 엽니다
  3. 맨 마지막 About / 정보 탭에서 ArcDPS가 최신인지, CatBridge 관련 DLL 두 개가 로드됐는지 확인합니다
  4. catbridge.exe를 실행합니다

Runtime Requirements

실행 조건

API & Engine Setup

API 및 번역 엔진 설정

CatBridge works without paid API keys. Start with the free engines, add Groq for speech recognition, then add OpenRouter or Gemini when you want AI translation.

CatBridge는 유료 API 키 없이도 작동합니다. 무료 엔진으로 시작하고, 음성인식이나 더 좋은 AI 번역이 필요해질 때 Groq, OpenRouter, Gemini를 추가하면 됩니다.

1. Start with the free engines

1. 무료 엔진으로 먼저 시작

M, B, C, P, and Google are all completely free. M is the usual first recommendation, but languages and situations vary, so try the other free engines if they feel better. Machine translation does not use the persona dictionary, and short, complex chat lines often sound more awkward than AI translation.

M, B, C, P, Google 다섯 가지는 모두 완전 무료입니다. 보통은 M엔진을 먼저 추천하지만, 언어나 상황에 따라 다른 무료 엔진이 더 잘 맞을 수도 있습니다. 기계번역에는 페르소나 사전이 적용되지 않고 짧고 복잡한 채팅 문장은 AI 번역보다 어색한 경우가 많습니다.

2. Create a Groq API key

2. Groq API 키 만들기

Groq is worth setting up first. The key takes about ten seconds to create and enables free speech recognition for Discord voice translation and Voice to Chat. Its translation model is included as a preset, but it is not the recommended translation-quality choice.

Groq는 먼저 만들어두는 것을 추천합니다. 키 발급은 10초 정도면 끝나고, 디스코드 음성 통역과 Voice to Chat의 무료 음성인식 기능을 사용할 수 있습니다. 번역 프리셋도 들어 있지만 번역 품질 추천용은 아닙니다.

3. Add an AI engine when you want stronger translation

3. 더 좋은 번역이 필요하면 AI 엔진 추가

For paid AI translation, CatBridge supports engines such as OpenRouter and Gemini. Add the key for the provider you want to use, then select the engine in CatBridge settings.

유료 AI 번역은 OpenRouter나 Gemini 같은 엔진을 골라 쓸 수 있습니다. 사용할 제공자의 키를 등록한 뒤 CatBridge 설정에서 원하는 엔진을 선택하면 됩니다.

4. Use Gemini for the easiest top-quality setup

4. 가장 편한 최고 품질은 Gemini

Gemini is still the easiest high-quality option. If you do not mind paying more and want the most stable setup, create a Gemini key and use that instead.

Gemini는 여전히 가장 편하고 안정적인 최고 품질 옵션입니다. 비용이 조금 더 나와도 가장 쉬운 세팅을 원한다면 Gemini를 쓰면 됩니다.

→ API & engine setup guide

→ API와 번역 엔진 설정 가이드

Guild Wars 2 API Key (character context)

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

The official GW2 account API key. When provided, CatBridge can reference your characters, gear, and progress to give more relevant translations and chatbot answers. Completely free.

길드워2 공식 계정 API 키입니다. 캐릭터, 장비, 업적 정보를 읽는 키로, 넣어두면 AI 번역과 냥카이브 답변에서 캐릭터 정보를 참고할 수 있습니다.

Recommended setup

Free engine: try M first, then switch if B, C, P, or Google fits your language better. Speech recognition: Groq. AI translation: choose OpenRouter, Gemini, or another engine that fits your setup. GW2 API is optional and completely free.

추천 세팅

무료 엔진은 M부터 테스트하고, 언어에 따라 B, C, P, Google이 더 잘 맞으면 바꾸면 됩니다. 음성인식은 Groq. AI 번역은 OpenRouter, Gemini 등 원하는 엔진을 고르면 됩니다. GW2 API는 선택 사항이고 완전 무료입니다.

Custom Fonts

폰트 커스터마이징

To use a custom font in the overlay, rename your .ttf file to catfont.ttf and place it next to catbridge.exe.

원하는 글꼴을 쓰려면 폰트 파일명을 catfont.ttf로 바꾸고 catbridge.exe 옆에 넣으면 됩니다.

Known Limitations

알려진 제한사항

FAQ

자주 묻는 질문 (FAQ)

Black screen on launch?

NVIDIA DLSS Frame Generation or AMD FSR 3 Frame Generation conflicts with all GW2 overlay addons (ArcDPS, Blish HUD, CatBridge). Disable frame generation in your game settings or GPU control panel.

게임을 켜자마자 검은 화면이 나오고 진행이 안 돼요

NVIDIA DLSS 프레임 제너레이션 또는 AMD FSR 3 프레임 제너레이션이 켜져 있는 경우입니다. 프레임 제너레이터는 길드워2의 모든 오버레이 애드온(ArcDPS, Blish HUD, CatBridge 등)과 충돌해서 검은 화면을 일으킵니다. 게임 설정에서 프레임 제너레이션 옵션을 끄거나, NVIDIA 제어판 / AMD 소프트웨어에서 길드워2에 한해 끄세요.

Overlay not showing?

Switch your display mode from Exclusive Fullscreen to Windowed Fullscreen in the GW2 graphics settings.

게임은 잘 실행되는데 CatBridge 오버레이 창이 안 떠요

길드워2의 화면 모드가 독점 전체화면(Exclusive Fullscreen)으로 설정되어 있으면 오버레이가 표시되지 않습니다. 길드워2 설정 → 그래픽 → 화면 모드를 전체화면 창모드(Windowed Fullscreen) 또는 창모드(Windowed)로 변경하세요.

Overlay shows but nothing is translated?

arcdps_catbridge.dll is probably not in the right folder. It must be alongside ArcDPS (d3d11.dll) and Unofficial Extras. If you use an addon manager, open ArcDPS with Alt + Shift + T, check the last About / Info tab, and move the DLLs into the ArcDPS folder shown there.

오버레이 창은 뜨는데 번역이 안 돼요 (채팅/NPC 대사가 안 잡힘)

arcdps_catbridge.dll이 ArcDPS가 실제로 설치된 폴더에 있지 않은 경우입니다. CatBridge는 ArcDPS → Unofficial Extras → arcdps_catbridge.dll 순서로 데이터를 받기 때문에, 이 세 개가 모두 같은 폴더에 있어야 작동합니다. 애드온 매니저를 사용하는 경우 Alt + Shift + T로 ArcDPS를 열고, 맨 마지막 About / 정보 탭에 표시되는 ArcDPS 폴더에 DLL을 넣으세요.