CachyOS (Arch Linux) 환경 Lutris 와우(WoW) 완벽 트러블슈팅 가이드

본 문서는 CachyOS 환경에서 Lutris로 블리자드 배틀넷 및 월드 오브 워크래프트(World of Warcraft)를 구동할 때 발생하는 런처 프리즈, Wayland 포커스 유실, 한글 입력 충돌 문제의 원인과 실전 해결책을 정리한 가이드입니다.

1. 배틀넷 ‘업데이트’ 클릭 시 게이지 멈춤(무반응) 현상

문제 현상

배틀넷에서 와우 ‘업데이트’ 또는 ‘설치’ 버튼을 눌렀으나, 다운로드 속도나 프로그레스 바가 전혀 올라가지 않고 0%에서 꼼짝하지 않음.

기술적 원인

• 배틀넷 클라이언트의 다운로드 엔진인 Agent.exe 및 공유 컴포넌트(bts)가 백그라운드에서 자체 업데이트/파일 검증을 진행 중인 상태입니다.
• 패치 엔진이 자체 업데이트를 수행하는 동안에는 클라이언트가 게임 업데이트 요청을 무시하고 대기 큐에 보류합니다 (Duplicate POST /update/wow).
• UI 상에는 아무런 로딩 표시가 뜨지 않아 멈춘 것처럼 보이지만, 실제로는 정상 동작 중입니다.

대처 방법

• 절대 배틀넷이나 와인 프로세스를 강제 종료하지 말고 그대로 대기합니다. (강제 종료 시 처음부터 다시 다운로드하게 됨)
• 터미널에서 백그라운드 엔진이 정상 동작 중인지 실시간 로그로 확인합니다:

# 최신 AgentUpdate 로그 확인 (실시간 진행률 확인)
tail -f ~/Games/battlenet/drive_c/ProgramData/Battle.net/Agent/Agent.*/Logs/AgentUpdate-*.log

agent Update Progress - 1.0000 및 bts Update Progress - 1.0000이 완료되면 자동으로 와우 다운로드 게이지가 올라가기 시작합니다.

2. KDE Wayland 포커스 유실 버그 (뒤쪽 창에 글 써짐)

문제 현상

배틀넷이나 와우 창이 화면 최상단에 보이고 검색창/채팅창에 마우스 커서도 가지만, 키보드로 글을 타이핑하면 뒤쪽에 켜져 있는 터미널이나 웹 브라우저 등 다른 창에 글이 써짐.

기술적 원인

1. Proton/UMU의 Xwayland 플래그 버그: Steam Proton을 러너로 쓸 때, 배틀넷 메인 창의 X11 힌트가 Client accepts input or input focus: False로 선언됩니다.
2. KWin 창 활성화 가로채기 방지(FSP) 충돌: UMU로 실행되는 비스팀 게임들은 모두 공통적으로 wmclass=steam_app_default로 인식됩니다. 기존에 등록된 다른 게임(예: 엔드필드 등)의 창 규칙에서 fsplevel=4 (가로채기 방지 극대화)가 강제되어 있을 경우, KWin 컴포지터가 배틀넷 창을 클릭해도 키보드 포커스(WM_TAKE_FOCUS)를 넘겨주지 않고 이전 창에 키보드를 묶어둡니다.

해결 방법: KWin 창 규칙(Window Rules) 강제 등록

KWin이 마우스 클릭 시 무조건 배틀넷과 와우 창으로 키보드 포커스를 강제 이양하도록 규칙을 설정합니다.

# 1. 고유 UUID 생성 후 배틀넷 및 와우 전용 포커스 규칙 생성
WOW_UUID=$(cat /proc/sys/kernel/random/uuid)
kwriteconfig6 --file ~/.config/kwinrulesrc --group "$WOW_UUID" --key Description "Battle.net & WoW Focus Fix"
kwriteconfig6 --file ~/.config/kwinrulesrc --group "$WOW_UUID" --key wmclass "steam_app_default"
kwriteconfig6 --file ~/.config/kwinrulesrc --group "$WOW_UUID" --key wmclassmatch 1
kwriteconfig6 --file ~/.config/kwinrulesrc --group "$WOW_UUID" --key title "Battle.net"
kwriteconfig6 --file ~/.config/kwinrulesrc --group "$WOW_UUID" --key titlematch 2
kwriteconfig6 --file ~/.config/kwinrulesrc --group "$WOW_UUID" --key acceptfocus true
kwriteconfig6 --file ~/.config/kwinrulesrc --group "$WOW_UUID" --key acceptfocusrule 2
kwriteconfig6 --file ~/.config/kwinrulesrc --group "$WOW_UUID" --key fsplevel 0
kwriteconfig6 --file ~/.config/kwinrulesrc --group "$WOW_UUID" --key fsplevelrule 2

# 2. 규칙 우선순위를 최상위(1순위)로 배치
CURRENT_RULES=$(kreadconfig6 --file ~/.config/kwinrulesrc --group General --key rules)
kwriteconfig6 --file ~/.config/kwinrulesrc --group General --key rules "$WOW_UUID,$CURRENT_RULES"

# 3. KWin 무중단 리로드 (세션 로그아웃 방지)
qdbus6 org.kde.KWin /KWin reconfigure

3. Fcitx5 한글 입력 및 플로팅 조합창 최적화

문제 1: 한/영 전환 키를 눌러도 영어만 써지는 현상

• 원인: Lutris 기본 배틀넷 설치 스크립트에 CJK 입력기 충돌 방지를 위해 XMODIFIERS: '@im=none', GTK_IM_MODULE: simple 등이 강제 지정되어 있어 Fcitx5가 차단됨.
• 해결: ~/.local/share/lutris/games/battlenet-*.yml 파일의 system.env 섹션에서 해당 항목을 삭제하고 XMODIFIERS: '@im=fcitx' 로 변경.

문제 2: 한글이 플로팅(팝업) 창에 모였다가 한 글자 완성 후 넘어가는 현상

[키보드 입력: 'ㄱ', 'ㅏ'] ➔ [화면 구석 플로팅 창: '가'] ➔ [음절 완성 시 게임 창으로 전송]

• 원인: Windows 프로그램은 자체 IME API를 사용하므로, Linux Wine 환경에서는 30년 된 구형 프로토콜인 XIM(X Input Method)을 거치게 됩니다. 게임 엔진이 텍스트 커서 위치와 조합 상태를 그리는 기능(On-the-spot 인라인 입력)을 지원하지 않아, Fcitx5가 임시 플로팅 창을 띄워 자모음을 조합한 후 완성된 글자(Commit)만 게임으로 보내는 구조적 한계입니다.
• 타국(일본/중국) 사례: 일본(파판14, 와우)과 중국 유저들도 100% 동일한 현상을 겪고 있습니다. 특히 일본어/중국어는 한자 변환 후보를 골라야 하므로 플로팅 창을 반드시 켜두어야 하는 불편이 있습니다.
• 한국어 환경 최선의 세팅: 한국어는 한자 변환을 고를 필요가 없으므로, Fcitx5 설정에서 거슬리는 ‘플로팅 사전편집 창’ 자체를 화면에서 숨기는 것이 가장 이상적입니다. 깜빡임 없이 타이핑하는 족족 게임 채팅창에 매끄럽게 글자가 찍혀 들어가 일반 윈도우 체감과 거의 동일해집니다.

4. 핵심 점검 명령어 치트시트