주요 기능

• 도네이션 금액 기반 킬 목표 자동 계산
• OBS 브라우저 소스 오버레이 연동
• 치지직 & 아프리카TV 도네이션 API 지원
• 파티 도네이션 합산 처리
• 커스텀 킬당 금액 설정
• 실시간 진행률 표시
• 다양한 오버레이 테마 지원

KillKagi란?

KillKagi는 스트리머가 게임 방송 중 도네이션 금액에 따라 킬 목표를 자동으로 계산하고 OBS 오버레이로 표시해주는 오픈소스 툴입니다.

예를 들어 “1,000원당 킬 1개”로 설정하면, 시청자들이 도네이션을 보낼 때마다 킬 목표가 자동으로 업데이트되어 OBS 화면에 표시됩니다.

설치 방법

요구사항

Node.js 18 이상
OBS Studio 28 이상 (브라우저 소스 플러그인 포함)
치지직 또는 아프리카TV 계정

빠른 시작

# 저장소 클론
git clone https://github.com/koreastreamer/killkagi.git
cd killkagi

# 의존성 설치
npm install

# 환경 변수 설정
cp .env.example .env
# .env 파일에서 API 키 설정

# 서버 시작
npm start

OBS 설정

OBS Studio를 실행합니다.
소스 추가 → 브라우저 선택
URL에 http://localhost:3000/overlay 입력
너비: 800, 높이: 200 설정
확인 클릭

환경 변수 설정

# 치지직 API
CHZZK_CHANNEL_ID=your_channel_id
CHZZK_ACCESS_TOKEN=your_access_token

# 아프리카TV API (선택사항)
AFREECA_BJ_ID=your_bj_id
AFREECA_ACCESS_TOKEN=your_access_token

# 킬 설정
KILL_PER_AMOUNT=1000    # 킬 1개당 도네이션 금액 (원)
SERVER_PORT=3000

사용법

기본 사용

서버를 시작하면 자동으로 도네이션을 감지하고 킬 카운터를 업데이트합니다.

도네이션 5,000원 → 킬 목표 +5개
파티 도네이션 합산 → 자동 처리

오버레이 커스터마이징

/public/themes/ 폴더에서 CSS를 수정하여 오버레이 디자인을 변경할 수 있습니다.

/* 예시: 오버레이 색상 변경 */
.kill-counter {
  color: #FF3333;
  font-family: 'JetBrains Mono', monospace;
  font-size: 2rem;
}

API 엔드포인트

엔드포인트	메서드	설명
`/overlay`	GET	OBS 오버레이 페이지
`/api/status`	GET	현재 킬 카운터 상태
`/api/reset`	POST	카운터 초기화
`/api/config`	GET/PUT	설정 조회/변경

라이선스

MIT License — 자유롭게 사용, 수정, 배포 가능합니다.

KillKagi