LeaguePrank 英雄联盟个性化工具使用指南

项目价值卡片 📌

LeaguePrank 是一款基于 LCU API 的英雄联盟客户端个性化工具，采用 C++ Qt/Cef 框架开发，通过合法调用 Riot 官方接口实现五大核心功能：在线状态伪装（支持离线/手机在线等特殊状态）、头像自定义显示、房间信息伪造、段位显示修改以及生涯背景替换。工具完全开源免费（GPL-3.0 许可证），无需修改游戏文件，兼容官方客户端所有版本，让玩家在遵守用户协议的前提下实现个性化展示需求。

核心优势

• 安全合规 🔒：仅调用官方 LCU API，不读写游戏内存或修改客户端文件
• 双向显示 🎭：部分功能（如段位边框）支持好友可见，实现社交展示效果
• 轻量架构 🚀：Qt + CEF 混合框架，启动速度快且资源占用低
• 永久生效 ⏳：生涯背景等设置保存在服务器端，无需重复配置

核心功能解析 🔍

1. 在线状态自定义

问题：默认客户端仅支持在线/离开/忙碌状态切换，无法满足隐私保护需求
方案：通过修改 LCU API 中的 /lol-chat/v1/me 端点实现状态扩展
验证：好友列表显示修改后的状态（如"手机在线"）

💡 实操示例：

1. 在左侧功能列表选择「状态」选项
2. 从下拉菜单选择目标状态（支持离线/手机在线等5种状态）
3. 系统自动推送状态更新至服务器

⚠️ 常见问题：「游戏中」状态可能因客户端校验失败而无法生效，建议优先测试其他状态

2. 段位显示修改

问题：希望向好友展示自定义段位信息，但不想通过排位赛获取
方案：修改召唤师资料中的段位元数据
验证：好友查看你的个人资料时显示设定段位

💡 实操示例：

1. 选择「段位显示」功能模块
2. 依次设置段位等级（如"最强王者"）、排位类型（如"单排/双排"）和段位细分（如"I"）
3. 配置实时生效，无需重启客户端

🔧 技术原理：
通过 LCUconnect.js 中的 tierChanger 函数修改以下字段：

obj.lol.rankedLeagueTier = tier;      // 段位等级
obj.lol.rankedLeagueDivision = level; // 段位细分（IV-Ⅰ）
obj.lol.rankedLeagueQueue = mode;     // 排位类型

快速上手流程 🚀

环境准备

1. 前置条件：已安装英雄联盟官方客户端（V10.18+）
2. 工具获取：

   git clone https://gitcode.com/gh_mirrors/le/LeaguePrank
   

3. 启动顺序：先启动英雄联盟客户端，再运行 LeaguePrank 程序

首次使用向导

1. 程序启动后自动检测客户端连接状态（显示加载动画）
2. 连接成功后进入主界面，左侧为功能导航区，右侧为配置面板
3. 推荐优先配置「生涯背景」功能（永久生效且视觉效果显著）

关键功能速通

功能名称	操作路径	生效范围
生涯背景	功能列表 > 生涯背景 > 选择英雄/皮肤	永久生效，他人可见
房间伪造	功能列表 > 房间伪造 > 添加玩家 > 选择模式	临时生效，会话期间有效
头像修改	功能列表 > 头像显示 > 输入ID > 预览 > 应用	临时生效，重启客户端重置

深度配置指南 ⚙️

高级参数说明

程序核心配置通过 sitebasic.js 实现，关键参数包括：

参数名	取值范围	说明
clashEvent.queueId	400-900	房间模式ID，400对应匹配模式
headId	1-9999	头像资源ID，可通过LCU API获取完整列表
backgroundSkinId	10000+	皮肤资源ID，格式为"英雄ID+皮肤序号"

功能冲突解决方案

1. 状态与房间冲突：同时启用「在线状态伪装」和「房间伪造」时，优先显示房间状态
2. 段位显示异常：若设置后未立即生效，可通过「刷新显示」按钮强制同步配置
3. 客户端版本兼容：LCU API变更可能导致功能失效，可通过以下命令检查接口状态：

   // 在浏览器控制台执行
   fetch('/lol-chat/v1/me').then(r=>r.json()).then(console.log)
   

自定义资源扩展

高级用户可通过替换 view/img/ 目录下的图片文件实现界面定制：

• 开发者头像：Mario.jpg_64x64.jpg（64x64像素）
• 背景素材：建议使用1920x1080像素JPG图片，需修改CSS对应路径

附录 📚

开发团队信息

• Mario：Qt/CEF框架搭建，负责底层通信
• ButterCookies：前端交互设计，LCU API对接

许可证信息

本项目采用 GPL-3.0 许可证（完整文本见 LICENSE），引用的第三方组件包括：

• UIKIT（MIT许可证）
• Chromium Embedded Framework（BSD许可证）
• Qt 5.15.0（GPLv3许可证）

常见问题排查

1. 客户端连接失败：检查游戏进程是否正常运行，或重启客户端后重试
2. 功能无响应：按 F12 打开开发者工具查看控制台错误信息
3. 配置丢失：程序配置保存在内存中，关闭后重置，建议重要设置截图保存

免责声明：本工具仅用于学习交流，请勿用于商业用途或违反游戏用户协议的行为。使用过程中如遇账号问题，开发者不承担相关责任。