WC LOL 내전 수집기 1.3.0 beta

사용 방법
1. ZIP 압축을 풀고 WC-LOL-Recorder.exe를 실행하세요.
2. 프로그램의 '로그인'을 누르면 브라우저가 열립니다. Google 또는 Discord로 로그인하세요.
3. 브라우저와 프로그램의 확인 번호가 같은지 보고 '이 계정으로 프로그램 연결'을 누르세요. 자동으로 연결됩니다.
4. 실행하면 자동 감지가 켜집니다. 사용자 설정 게임을 감지하면 참가/관전 상태와 함께 기록합니다.
5. 일반/랭크/종류 미확인 게임은 자동 기록하지 않습니다. 종료 후 자동 업로드됩니다.
6. 사이트의 내전 기록에서 타임라인을 확인하세요. 기록은 기본 비공개입니다. 경기 상세에서 공개를 선택하면 다른 사람도 조회·다운로드할 수 있습니다.
7. 자동 감지가 안 되면 'PC 연결 · 설정'의 '롤 경로 선택'으로 LeagueClient.exe가 있는 폴더를 지정하세요.
8. '감지 끄고 저장'으로 멈출 수 있습니다. 수동 기록은 게임 종류와 관계없이 기록합니다.

프로그램 화면
- 사용자 설정 게임이 시작되기 전에는 '사용자 설정 게임을 기다리고 있어요'로 표시합니다.
- 자동 기록: 감지 상태, 경기 시간, 참가/관전 역할, 수집한 상태와 주요 사건 수를 보여줍니다.
- PC 연결 · 설정: 로그인/로그아웃, 리플레이 자동 저장, 롤 설치 경로를 설정합니다.
- 활동 내역: 저장/업로드 내역과 오류를 확인하고 '업로드 다시 시도'를 누를 수 있습니다.
- 왼쪽 아래 '웹에서 내 기록 보기'는 웹사이트의 개인 기록 목록을 엽니다.
- 창 크기 조절, 최대화, 키보드 Tab 이동과 Windows 화면 배율을 지원합니다.
- 기존 버전을 종료한 뒤 새 실행 파일을 여세요. 기존 연결과 로컬 기록은 유지됩니다.

파일과 복구
- 저장 폴더: %LOCALAPPDATA%\WC-LOL-Recorder ('기록 폴더 열기' 버튼)
- .wcr.json.gz: 업로드/백업용 기록. 사이트에서 파일로 직접 올릴 수도 있습니다.
- active.jsonl: 진행 중인 기록. 비정상 종료 후 프로그램을 다시 실행하면 복구합니다.
- 게임 연결이 60초 이상 사라지면 부분 기록으로 저장합니다. 누락된 시간을 채워 넣지 않습니다.
- 로그인 정보는 Windows 사용자 계정으로 암호화해 저장합니다. 30일 뒤 만료되면 프로그램에서 다시 로그인하세요.
- 계정당 수집기 연결 1개를 사용합니다. 새로 연결하면 이전 연결은 해제됩니다.
- 로그인 전에 저장을 마친 파일은 웹사이트에서 직접 올려주세요. 다른 계정의 대기 기록은 자동 업로드하지 않습니다.
- 웹사이트를 닫아도 프로그램이 켜져 있으면 업로드합니다. 공용 PC에서는 업로드 후 프로그램에서 로그아웃하세요.
- 업로드 실패 시 파일을 보관하고 1분마다 재시도합니다. 업로드 성공 후에도 파일은 남습니다.
- 종료 버튼으로 중지하면 진행 중인 경기는 부분 기록으로 저장됩니다.
- 보관 한도는 계정당 50경기입니다. 사이트에서 백업 후 삭제할 수 있습니다.

롤 리플레이 자동 다운로드
- 프로그램이 자동 감지한 내전은 경기 종료 후 롤에 .rofl 다운로드를 요청합니다.
- 롤 클라이언트와 수집기를 켜두세요. 일반/랭크, 수동 기록은 자동 다운로드 대상이 아닙니다.
- 이미 다운로드한 파일은 재사용하며, 완료한 파일을 기록 폴더의 replays 하위 폴더에도 보관합니다.
- PC 연결 · 설정에서 자동 저장을 켜고 끌 수 있습니다. 상태와 오류는 활동 내역에도 표시합니다.
- 실패하면 다시 시도하며, 24시간이 지나면 롤 대전 기록에서 직접 확인하도록 안내합니다.
- .rofl 파일은 PC에 자동 보관합니다. 웹 경기 상세에서 직접 첨부할 수 있으며, 기록을 공개하면 다른 사람도 다운로드할 수 있습니다. 자동 업로드 대상은 통계 기록입니다.
- 패치가 바뀌면 리플레이 재생이 만료될 수 있습니다. 롤에서 제공하지 않는 파일은 만들 수 없습니다.

웹에서 롤 다시보기
- 기존 버전을 종료하고 이 프로그램을 한 번 실행하면 웹 다시보기 버튼과 연결됩니다.
- 실행 파일은 계속 사용할 폴더에 보관하세요. 이동했다면 해당 위치에서 다시 실행해주세요.
- 롤 클라이언트에 로그인한 뒤, 웹 내전 기록 상세의 '롤에서 다시보기'를 누르세요.
- 브라우저의 프로그램 열기를 허용하면 수집기가 롤 폴더에 파일을 저장하고 재생을 요청합니다.
- 수집기가 꺼져 있으면 자동으로 열리고, 이미 실행 중이면 '롤 다시보기' 화면에서 이어집니다.
- 게임 중이거나 패치가 다르면 재생하지 않고 안내합니다. 첫 실행은 브라우저에서 허용이 필요할 수 있습니다.
- 실패하면 수집기의 '다시 시도'를 누르세요. 연결이 만료됐다면 웹 버튼을 다시 눌러주세요.
- 동일한 로컬 파일은 재사용합니다. 파일이 다르면 기존 파일을 .wc-backup-이 붙은 이름으로 보존합니다.
- 현재 Windows 사용자에게만 실행 링크를 등록하며, Windows 자동 시작에는 등록하지 않습니다.

수집하는 정보
- 2초 간격 선수별 CS/KDA/시야 점수/레벨/사망 상태/아이템, 경기 시간
- 참가자 Riot ID, 챔피언, 팀, 포지션, 제공되는 룬/소환사 주문
- 킬, 주요 오브젝트, 건물 파괴 등 API가 반환하는 이벤트와 발생 시간
- 제공되는 경우 실행 PC 플레이어의 현재 골드/능력치/스킬 레벨
- 관전처럼 activePlayer가 없는 응답도 처리하지만 실제 관전 동작은 패치별 확인이 필요합니다.
- 관전/리플레이를 뒤로 탐색하면 시간을 섞지 않고 기록을 분리합니다. 리플레이는 수동 모드를 사용하세요.

제한
- 전체 선수의 누적 골드, 상세 딜량, 좌표를 제공하지 않는 기본 Live Client API를 사용합니다.
- 실제 내전/관전 경기에서의 검증은 아직 필요합니다. 이 버전은 API 예시와 모의 경기로 검증했습니다.
- 게임 종류 자동 감지는 LCU의 gameflow 정보를 읽습니다. 클라이언트 API 변경 시 수정이 필요할 수 있습니다.
- LCU 종료 통계, 화면 OCR, 리플레이 해석 기능은 이 버전에 포함하지 않습니다.
- 게임 파일 수정, 메모리 읽기, 관리자 권한, Riot API 키가 필요하지 않습니다.
- Windows 10/11의 .NET Framework 4.8 / WPF 기반이며 별도 런타임 설치 없이 실행합니다.
- 배포 파일은 코드 서명이 없는 초기 버전입니다. Windows에서 게시자를 확인하지 못할 수 있습니다.

소스: https://github.com/KIM-DONGJU/wc-lol-next/tree/main/desktop/recorder

WC LOL is not endorsed by Riot Games and does not reflect the views or opinions of Riot Games
or anyone officially involved in producing or managing Riot Games properties. Riot Games and
all associated properties are trademarks or registered trademarks of Riot Games, Inc.
