한눈에 선택
| Backend | 필요한 것 | 비용 | 장점 | 주의 |
|---|---|---|---|---|
| Player2 | Player2 app | 무료 model/일일 credit·유료 credit | 가장 쉬운 direct integration | 자체 Joule·정책 |
| OpenRouter | OpenRouter API key | 별도 종량제/BYOK | cloud model 선택 폭 | 개인 구독 이전 안 됨 |
| Ollama | local model·RAM/VRAM | 외부 과금 없음 | privacy·통제 | 속도·한글 품질·hardware |
| KoboldCpp | GGUF model·RAM/VRAM | 외부 과금 없음 | 단일 local runtime | context·offload tuning |
AI Influence Workshop 공식 설명은 네 backend 모두를 명시합니다.[18]
Player2
AI Influence가 직접 지원하고 공식 Workshop이 Quick Start를 제공합니다. Player2는 Claude/ChatGPT/Grok 개인 구독을 가져오는 서비스가 아니라 자체 AI API와 Joule 사용량 체계입니다.[48] 6.0.2의 내장 image·TTS·STT도 Player2 경로이므로 별도 미디어 지원표를 함께 확인하세요.
공식 app 설치·실행
player2.game에서 설치하고 background에서 실행합니다.[16]
AI Influence MCM
AI Backend: Player2
URL: http://127.0.0.1:4315
API Key: 비워 둠모든 기능 backend 확인
Dialogue뿐 아니라 Dynamic Events·Diplomacy가 별도 backend field를 제공하면 각각 Player2로 맞춥니다.
Connection test
성공 후 새 test campaign에서 NPC 한 명과 대화합니다. 첫 대화는 background 생성 때문에 더 느릴 수 있습니다.[3]
app 연결과 무료 model은 사용할 수 있어도 frontier model·음성 등에 credit이 들 수 있습니다. 현재 model·Joule 정책은 Player2 app에서 다시 확인하세요.
OpenRouter
여러 provider model을 하나의 API로 선택합니다. OpenRouter 계정·API key·credit이 별도로 필요하며 ChatGPT Plus, Claude Pro, SuperGrok, Gemini app 구독은 OpenRouter 잔액이 아닙니다.[47]
계정과 key 준비
OpenRouter 공식 dashboard에서 key를 만들고 사용할 금액만 충전합니다. per-key limit 기능이 보이면 낮게 설정합니다.
model ID 복사
OpenRouter model page의 정확한 ID를 복사합니다. 표시 이름을 임의로 추측하지 않습니다.
MCM 설정
AI Influence 6.0.2의 실제 MCM에서 OpenRouter backend, API key, model ID를 넣습니다. field 이름과 기본 URL은 mod 내 TECHNICAL_GUIDE_EN.md를 우선합니다.
작은 model로 test
Dialogue만 켜고 10~20회 호출의 실제 잔액 차감·latency·한글 품질을 확인한 뒤 Diplomacy/Events를 켭니다.
OpenRouter key는 AI Influence local config에만 저장합니다. screenshot과 crash log를 공유할 때도 [REDACTED] 처리합니다.
Ollama
공식 installer와 local model을 사용하며 cloud account/API 과금이 없습니다.[45] 같은 Ollama 형식을 Claude/Gemini bridge도 모방하므로, 실제 local model과 bridge를 동시에 port 11434에 띄우지 않습니다.
Ollama 설치
공식 download에서 설치합니다.
model 선택·다운로드
내 RAM/VRAM에 맞는 instruct model을 고릅니다. 처음에는 작은 quantization으로 응답 속도부터 확인합니다.
server 확인
ollama list
Invoke-RestMethod http://127.0.0.1:11434/api/tagsMCM 설정
AI Provider: Ollama
Ollama API URL: http://127.0.0.1:11434
Ollama Model: ollama list에 표시된 정확한 이름선택 기준
- model file + context KV cache가 RAM/VRAM에 들어가야 합니다.
- 한국어 roleplay, JSON/action 지시 준수, 긴 world prompt를 각각 시험합니다.
- 응답이 느리면 context·model size를 줄이고 Dynamic Events·Diplomacy를 따로 켭니다.
KoboldCpp
KoboldCpp는 GGUF model을 CPU/GPU offload로 실행하는 공개소스 local runtime입니다.[46] AI Influence가 전용 backend로 명시하지만 정확한 MCM field와 port는 실행한 KoboldCpp UI와 mod 내 guide를 대조합니다.
- 공식 GitHub release/source에서 OS에 맞는 runtime을 준비합니다.
- 신뢰할 수 있는 배포처에서 GGUF instruct model을 받습니다.
- context length와 GPU layers를 보수적으로 설정해 server를 시작합니다.
- UI에 표시된 localhost URL을 AI Influence의 KoboldCpp backend에 넣습니다.
- 짧은 prompt → 긴 NPC 대화 → diplomacy prompt 순으로 memory와 JSON 준수를 시험합니다.
실행 binary뿐 아니라 model repository·license·hash를 확인합니다. model card가 없거나 출처가 불명확한 file은 받지 않습니다.
GameMaster
AI Influence와 OpenAI-compatible backend 사이에서 world lore·rules·memory를 골라 보내 token과 prompt noise를 줄이는 공개소스 proxy입니다.[14]
filter/index
- 처음에는 GameMaster 없이 backend 자체를 검증합니다.
- EXE release 대신 source의
start.bat경로만 이 가이드에서 다룹니다. Save & Reindex DB후 server를 재시작해야 수정한 prompt file이 반영됩니다.- main·selector가 각각 추가 호출을 만들 수 있으므로 사용량을 확인합니다.
- GameMaster도
127.0.0.1에만 bind합니다.
데이터는 어디로 가나
| 경로 | 게임 밖으로 나가는 데이터 | credential 위치 |
|---|---|---|
| Player2 | prompt·NPC/world context → Player2/provider | Player2 app |
| OpenRouter | prompt → OpenRouter → 선택 provider | AI Influence local config |
| Ollama/KoboldCpp | 기본적으로 localhost 안 | cloud credential 없음 |
| CLI subscription bridge | prompt → 공식 Claude/OpenAI/xAI/Google service | CLI/proxy OAuth cache |
| Vertex AI bridge | prompt → Google Cloud Vertex AI | ADC/Cloud credential |
민감한 개인정보를 NPC 대화·world file에 넣지 않고, backend와 provider의 data retention/학습 설정을 사용 전에 확인합니다.