# sword-macro-ai

카카오톡 **검키우기** 게임 자동화 매크로

## 왜 이 매크로인가?

일반적인 매크로는 단순히 클릭을 반복합니다.
**sword-macro-ai**는 다릅니다.

| | 일반 매크로 | sword-macro-ai |
|--|------------|----------------|
| 강화 방식 | 무작정 클릭 반복 | 빅데이터 기반 최적 타이밍 분석 |
| 판매 전략 | 고정 레벨에서 판매 | 레벨별 기대 수익 계산 후 최적 시점 판매 |
| 역배 대결 | 랜덤 상대 선택 | 레벨 차이별 승률·보상 데이터 분석 |
| 리스크 관리 | 없음 | 파산 확률, 최대 손실폭 실시간 계산 |
| 데이터 활용 | 없음 | 커뮤니티 전체 통계 기반 의사결정 |

수천 건의 실제 플레이 데이터를 분석하여 **강화 확률, 판매 적정가, 역배 기대값**을 실시간으로 계산합니다. 감이 아닌 데이터로 플레이합니다.

## 다운로드

### [최신 버전 다운로드](../../releases/latest)

| 플랫폼 | 파일 | 설치 |
|--------|------|------|
| macOS | `SwordMacro-macOS.zip` | 압축 해제 → 실행 |
| Windows | `SwordMacro-Windows.zip` | 압축 해제 → exe 실행 |

<details>
<summary>설치 가이드</summary>

**macOS**
1. 압축 해제
2. 첫 실행: 우클릭 → 열기 (개발자 확인 우회)
3. 시스템 설정 → 개인정보 보호 → **접근성** 권한 허용
4. 시스템 설정 → 개인정보 보호 → **화면 기록** 권한 허용

**Windows**
1. 압축 해제 → exe 실행
2. Defender 경고: 추가 정보 → 실행
3. 한국어 OCR 필요: 설정 → 시간 및 언어 → 언어 → 한국어 추가

</details>

## 사용법

1. 카카오톡에서 검키우기 채팅방 열기
2. 매크로 실행 → 모드 선택
3. 카카오톡 **메시지 입력칸 '메시지 입력'**에 마우스 올리기 → 3초 후 좌표 자동 저장
4. 매크로 자동 시작

## 모드 소개

### ⚔️ 강화 목표 달성

원하는 강화 레벨을 설정하면 자동으로 강화합니다.

- 목표 레벨(+1 ~ +20)을 선택하면 자동으로 달성
- 골드 부족 시 자동으로 파밍 후 재시도
- 고강(+9 이상)에서는 자동으로 속도 조절하여 안정적 강화

### 🎁 특수 아이템 뽑기

특수 아이템이 나올 때까지 자동으로 파밍합니다.

- 특수 아이템 발견 시 자동 알림 및 정지
- 원하면 특수 아이템을 목표 레벨까지 자동 강화
- 일반 아이템은 자동 처리하여 골드 확보

### 💰 골드 채굴 (돈벌기)

**파밍 → 강화 → 판매** 사이클을 자동으로 무한 반복합니다.

- 설정한 목표 레벨까지 강화 후 자동 판매
- 빅데이터 분석 기반으로 **가장 수익률이 높은 판매 시점**을 적용
- 특수 아이템 발견 시 자동 보관
- 실시간으로 획득 골드, 사이클 수, 성공률 표시

### ⚡ 자동 배틀 (역배)

나보다 높은 레벨의 상대와 자동으로 대결합니다.

- 레벨 차이(1~3단계) 설정 가능
- **레벨 차이별 승률과 보상 데이터를 분석**하여 최적의 상대 선택
- 하루 10회 제한 자동 관리

### 📊 내 프로필 분석

내 검 상태를 데이터로 분석합니다. 실행하면 다음 정보를 한눈에 확인할 수 있습니다.

| 분석 항목 | 설명 |
|-----------|------|
| 내 검 정보 | 현재 검 이름, 강화 레벨, 보유 골드, 배틀 전적 |
| 예상 판매가 | 현재 레벨 기준 최소/평균/최대 판매 가격 |
| 강화 확률표 | 현재 레벨부터 +20까지 성공/유지/파괴 확률 |
| 목표 달성 확률 | 원하는 레벨까지 도달할 확률과 예상 시도 횟수 |
| 역배 분석 | 레벨 차이별 기대 수익과 추천 전략 |

## 조작법

| 키 | 기능 |
|----|------|
| F8 | 일시정지 |
| F9 | 재시작 |

## 설정

매크로 실행 후 **옵션 설정** 메뉴에서 변경할 수 있습니다.

| 항목 | 기본값 | 설명 |
|------|--------|------|
| 감속 시작 레벨 | +9 | 이 레벨부터 강화 속도를 늦춰 안정성 확보 |
| 중간 속도 | 2.5초 | +5~+8 강화 시 대기 시간 |
| 고강 속도 | 3.5초 | +9 이상 강화 시 대기 시간 |
| 좌표 고정 | OFF | 저장된 클릭 좌표를 재사용 |
| 골드 채굴 목표 | +10 | 골드 채굴 시 판매 전 강화 목표 레벨 |
| 역배 레벨 차이 | 1 | 배틀 상대와의 레벨 차이 (1~3) |

설정은 자동으로 `sword_config.json`에 저장됩니다.

## 데이터 수집 안내

이 매크로는 서비스 개선을 위해 **익명화된 사용 통계**를 수집합니다.

**수집하는 것**
- 강화 시도/성공/실패/파괴 횟수
- 배틀 횟수 및 승패
- 파밍/판매 통계
- 앱 버전, OS 종류

**절대 수집하지 않는 것**
- 개인 식별 정보 (IP, 계정명 등)
- 카카오톡 대화 내용
- 화면 캡처 이미지
- 키보드/마우스 입력 원본

모든 통신은 HTTPS로 암호화되며, 세션 ID는 SHA-256 해시로 익명화됩니다. 수집된 데이터는 강화 확률, 판매가, 역배 보상 등의 **커뮤니티 통계에만 사용**됩니다.

## License

MIT