문제 해결 · AI Influence 가이드

가장 빠른 진단 순서

최소 mod 구성

Harmony, ButterLib, UIExtenderEx, MCM v5, AI Influence만 켭니다.

새 test campaign

기존 save 대신 새 campaign에서 MCM 표시와 NPC 대화를 확인합니다.

Player2로 baseline

Player2 127.0.0.1:4315로 AI Influence 자체를 먼저 검증합니다.

원하는 bridge 추가

local endpoint의 /api/tags 또는 /v1/models를 독립 확인한 뒤 MCM에 연결합니다.

동반 mod 하나씩 추가

각 단계마다 대화·전투·외교·save/load를 다시 시험합니다.

게임이 실행되지 않거나 MCM이 없음

증상	확인	조치
Launcher 빨간 경고	필수 4개 누락·version	Workshop Required Items에서 전부 구독, download 완료
MCM 메뉴 없음	MCM/UIExtenderEx/ButterLib load order	library를 Native/AI Influence보다 위로
시작 직후 crash	game 1.4.6과 mod tag, 중복 module	다른 branch용 mod 비활성화, Steam/Nexus 중복 제거
한국어 메뉴 일부 영어	번역판 지원 version	본체 6.x 대응 번역인지 확인

Workshop의 현재 AI Influence tag는 1.4.6입니다.[18] 게임이 1.4.7/1.4.8 또는 1.2.x total conversion이면 이 표기보다 추측을 우선하지 않습니다.

Steam/Nexus 중복 또는 잘못된 업데이트

전형적인 징후

Launcher에 AI Influence가 두 개 보이거나 module path가 둘임
MCM 설정이 저장되지 않거나 오래된 option이 남음
업데이트 후 type/method not found 계열 exception
한글화·prompt files가 되돌아감

덮어쓰기보다 한 배포처만 유지

한국 커뮤니티에도 기존 folder 위에 새판을 덮은 뒤 실행되지 않은 사례가 있습니다.[42] 다만 파일 삭제는 backup과 정확한 경로 확인 후 수행하세요. Workshop판을 쓸 때는 Nexus판을, Nexus판을 쓸 때는 Workshop 구독을 정리합니다.

Player2 연결 실패

Player2 app이 실행 중인지 확인합니다.
browser에서 http://127.0.0.1:4315 또는 app status 화면을 확인합니다.
MCM의 backend를 Player2, URL을 http://127.0.0.1:4315, API key를 공란으로 둡니다.
Dynamic Events·Diplomacy가 별도 backend field를 제공한다면 각각 Player2로 맞춥니다.
VPN·보안 제품이 localhost를 막는지 확인하되 Internet firewall exception을 열지는 않습니다.

응답 준비 전 버튼을 다시 누르지 않기

카페 사용자 가이드에는 준비 완료 전에 응답을 재시도하면 이전 대사가 나오거나 대사를 놓치는 사례가 있습니다. 첫 NPC는 background 생성 때문에 더 오래 걸릴 수 있습니다.[3]

이미지·TTS·음성 입력 문제

증상	원인 후보	조치
장면 이미지 없음	기능 off, 일반 Talk 선택	Dialogue Scene Images를 켜고 Talk (with scene image) 사용
402	Player2 Joules 부족	app balance 확인; 계정 회전 금지
403	image content filter	우회하지 말고 prompt·장면 설명 완화
TTS 무음	toggle, output device, voice, 언어	한 NPC·짧은 한국어 한 문장으로 분리 시험
STT 실패	microphone permission·device	Windows 권한·input device 확인
개인 구독 proxy image만 성공	OpenAI형/Player2 route 불일치	직접 호환 아님; Player2로 baseline

이미지와 TTS를 동시에 켜지 말고 text → TTS → scene image → automatic world image 순으로 하나씩 추가하세요. protocol 표와 한국어 voice 주의사항은 이미지·음성 페이지를 확인합니다.

Ollama 형식 bridge 연결 실패

1. port listener

Get-NetTCPConnection -State Listen |
  Where-Object LocalPort -eq 11434 |
  Format-Table LocalAddress,LocalPort,OwningProcess

127.0.0.1:11434가 있어야 합니다. 아무것도 없으면 bridge가 시작되지 않은 것입니다. 0.0.0.0이면 보안상 종료합니다.

2. Ollama tags endpoint

Invoke-RestMethod http://127.0.0.1:11434/api/tags

JSON model 목록이 돌아와야 합니다. 실패하면 게임이 아니라 bridge 문제입니다.

3. MCM 값

Provider: Ollama
URL: http://127.0.0.1:11434
Model: bridge가 /api/tags로 반환한 정확한 이름

provider별 흔한 원인

Claude: CLI 로그인 만료, claude PATH, Node version, 긴 prompt의 Windows 인자 한계.
Gemini CLI: OAuth 만료, global GEMINI.md, 모든 tool deny policy, preview model 폐기.
Vertex Python: ADC 없음, 잘못된 Cloud project, Vertex API 비활성, billing/quota, preview model/region 변경.
CLIProxyAPI: /v1/models가 model을 반환하지 않음, local API key 불일치, OAuth cache 만료.

429, quota, 30초 이상 지연

증상	원인 후보	조치
429/rate limit	5시간·주간·일일 quota	중단 후 reset까지 대기, 작은 model
첫 응답만 느림	CLI cold start·NPC background 생성	정상 가능, 두 번째 대화와 비교
항상 30초+	Opus/Pro, 긴 world, 병렬 요청	Haiku/Flash, context 축소, event off
전투 중 폭증	Battle Shout ambient/NPC/병사 수	ambient off, 응답자 0~1, world off
비용 급증	OpenRouter/Vertex 종량제	spend limit·budget, request log 수량 확인

한도 회피를 위해 account를 순환하거나 자동 재로그인하지 않습니다. 이는 계정 위험을 키우고 원인 진단도 어렵게 만듭니다.

대화로 합의했는데 실제 외교가 안 바뀜

LLM의 자연어 응답과 Bannerlord action 실행은 별개입니다. 카페에는 평화에 동의했다는 대화가 나왔지만 게임의 전쟁 상태는 유지된 사례가 있습니다.[43]

협상 상대가 실제 권한을 가진 왕/통치자인지 확인합니다.
AI Diplomacy와 action rules가 활성화됐는지 확인합니다.
Dynamic Events·Diplomacy backend도 연결 성공인지 봅니다.
다른 diplomacy/AI overhaul을 끄고 재현합니다.
외교 피로·협상 cycle 때문에 즉시 반영이 아닌지 change notes/guide를 확인합니다.
대화 문구가 아니라 왕국 화면의 실제 전쟁·평화 상태로 성공을 판정합니다.

왕국들이 지나치게 수동적

Workshop 사용자 댓글에도 AI Diplomacy 사용 시 공격성이 낮아졌다는 경험담이 있지만 공식 원인으로 확정되지 않았습니다. aggression/world prompt를 과격하게 바꾸기 전에 vanilla 외교와 다른 overhaul의 중첩, war fatigue, MCM default를 최소 save에서 비교하세요.

Save·memory·업데이트 문제

AI Influence는 BETA이며 change notes에 character/campaign data 손상 수정이 포함돼 있습니다.[44]
업데이트 전 save를 별도 slot에 보관합니다.
world.txt·JSON·language·campaign prompts를 Workshop folder 밖에 backup합니다.
구형 ChatSyncAuto/Event Editor는 6.0 RAG·snapshot 구조 지원을 확인하기 전 사용하지 않습니다.
동료가 무한 regrouping, party가 정지하면 다른 party AI/enlistment mod를 끄고 test save에서 재현합니다.

자동 복구보다 설치 전 save

AI 외교·관계·기억이 이미 campaign에 반영된 뒤 모드를 빼는 경우 안전한 rollback이 보장되지 않습니다. 가장 신뢰할 수 있는 복구점은 모드 설치 전 save입니다.

좋은 bug report 만들기

Bannerlord 정확한 version/branch
AI Influence version과 Steam/Nexus 중 어느 쪽인지
전체 mod 목록과 load order
backend·model·local URL—API key/token은 [REDACTED]
새 campaign에서도 재현되는지
재현 순서: 누구와 어디서 어떤 입력 후 무엇이 발생했는지
ButterLib crash report·AI Influence log
prompt/대화에 개인정보가 없는지 검토

공유 전에 반드시 지우기

Authorization header, OAuth token, API key, service-account JSON, Windows 사용자명과 개인 경로, 실제 account email을 log·screenshot에서 삭제하세요.