기초 환경 설정
LeaguePrank은 LCU API를 활용해 리그 오브 레전드 게임 내의 등급, 전적, 프로필 이미지 등을 임의로 변경할 수 있는 개발자용 유틸리티입니다. 이 도구는 C++ 기반으로 작성되었으며, Qt 5.12 이상 프레임워크와 CefView 컴포넌트를 통해 웹 기반 인터페이스를 통합하고, JavaScript로 동작 로직을 제어합니다.

사전 준비 사항
- Git: 소스 코드를 다운로드하기 위해 설치 필요
- 빌드 툴체인: Windows 사용자는 Visual Studio 2019 이상, Linux/macOS는 GCC 또는 Clang 필요
- Qt SDK: Qt 5.12 이상 버전 설치 (QMake 포함)
- CefView 런타임: cef_binary_90.6.7 이상 사용 권장
팁: Qt 설치 시 Qt WebEngine 항목을 선택하면 후속 구성 문제를 줄일 수 있습니다. Linux 사용자는 다음 명령어로 기본 의존성 설치 가능:
sudo apt install qt5-default libcef-dev
주요 문제 해결
- Qt 버전 불일치:
QtGui version mismatch오류 발생 시, 5.15 LTS 버전으로 업데이트하세요. - CefView 누락: 프로젝트의
Releases섹션에서 사전 컴파일된cef_lib패키지를 다운로드하여/usr/local/cefview(Linux) 또는C:\cefview(Windows)에 추출하세요.
소스코드 가져오기 및 빌드 절차
1. 저장소 복제
git clone https://gitcode.com/gh_mirrors/le/LeaguePrank
2. 디렉터리 구조 요약
LeaguePrank/: 메인 소스 코드 및 .pro 파일 포함view/: HTML/CSS/JS 웹 리소스, 특히js/LCUconnect.js가 클라이언트 통신 핵심QCefView/: CefView 통합 코드 및 렌더링 관리
3. 빌드 단계
1단계: 빌드 파일 생성
qmake LeaguePrank/LeaguePrank.pro -o build/
실패 원인 체크:
QCefView not found:git submodule update --init실행하여 서브모듈 추가qmake version mismatch:qmake --version확인 후 올바른 경로 사용 여부 점검
2단계: 컴파일 실행
cd build && make -j4 # Linux/macOS
# Windows: build/LeaguePrank.sln 열고 'Release' 모드로 빌드
3단계: 실행
빌드 완료 후 실행 파일은 build/release/ 폴더에 위치합니다:
./LeaguePrank # Linux
# Windows: LeaguePrank.exe 더블클릭

보안 및 사용 주의사항
- 계정 위험: 이 도구는 게임 메모리에서 정보를 읽어 표시만 변경하며, 파일 직접 수정은 하지 않지만, 반칙 시스템에 의해 오진 감지될 수 있음
- 보안 조치: 다른 보조 프로그램은 모두 종료하고, 정식 랭크 모드가 아닌 훈련모드에서 테스트 권장
- 사용 목적: 상업적 목적이나 공식 대회에서의 부정행위 금지
- 업데이트 대응: 리그 오브 레전드 업데이트 후에는 도구 호환성 업데이트 이후 사용
- 이상 발생 시: 계정 문제가 생기면 즉시 사용 중단하고 시스템 점검
기능 확장 및 창의적 활용법
- 개인화 스킨 표시:
view/css/style.min.css내.champion-skin스타일 수정으로 맞춤형 캐릭터 스킨 카드 표현 - 데이터 가짜 설정:
view/js/sitebasic.js의mockData()함수 수정으로 임의의 전적 데이터 삽입 - 시간 기반 자동 전환: Windows 작업 스케줄러 또는 Linux Cron을 활용해 특정 시간대마다 등급 표시 변경
개발자용 확장 가능성
Methods.h의setCustomRank()함수 호출로 외부 애플리케이션에서 제어 가능LCUconnect.js의onConnect()이벤트 수정으로 사용자 정의 데이터 동기화 구현
학습 자료: GitHub Wiki의 docs/LCU_protocol.md 문서를 참고하여 LCU API 통신 방식을 이해하세요.
이 가이드를 따라 완료하면, 리그 오브 레전드 개인 정보 변조 도구의 설치부터 실행까지 모든 과정을 성공적으로 수행할 수 있습니다. 기술의 재미는 탐구에 있지만, 항상 게임 규칙의 범위 내에서 사용하는 것을 기억하세요. 건강한 게임 환경을 유지하는 데 함께 노력합시다.
프로젝트 다운로드 링크: LeaguePrank 공식 저장소