League Akari 完整上手指南:用一套 LCU API 工具把英雄联盟客户端的重复操作全部交给自动化
【免费下载链接】League-ToolkitAn all-in-one toolkit for LeagueClient. Gathering power 🚀.项目地址: https://gitcode.com/gh_mirrors/le/League-Toolkit
开场:一个排位夜的真实片段
周五晚上十点,小陈结束加班打开英雄联盟。客户端刚登录,他就开始了一连串的机械动作——点匹配、等队列、抢着点接受、在 30 秒选人倒计时里飞快翻战绩、手滑选错英雄、进游戏忘记发大乱斗阵容提示、结束后又纠结要不要给队友点赞。一晚上五局下来,他发现自己真正"打游戏"的时间没多少,其余全耗在了这些琐事上。
如果你也有同感,那么 League Akari 就是为你准备的:这是一款基于 Riot 官方 LCU(League Client Update)接口开发的英雄联盟客户端工具箱,能把上述大部分重复操作自动化,同时把战绩查询、选人辅助、游戏内快捷消息等能力集中到同一个界面里。下面这份 League Akari 使用教程,会从零开始带你把它装好、配好,并串起一整局游戏的真实流程。
项目速览:它是什么、能解决什么问题
League Akari 的定位很直接——一个"All-in-one"的英雄联盟客户端工具箱,项目自述为An all-in-one toolkit for LeagueClient. Gathering power 🚀。它不修改游戏文件、不注入内存,只与客户端通过官方 LCU API 通信,属于非侵入式设计;运行不需要管理员权限(以管理员身份运行可以解锁额外功能),并支持除腾讯服务器外的大部分 Riot 服务器。
它能替你处理的事情大致分四类:
- 对局流程自动化:自动接受匹配、自动重开、自动重新匹配、自动处理邀请、自动点赞、自动发送大乱斗队伍侧提示。
- 选人阶段辅助:按位置配置英雄优先级,自动禁用、自动选人,甚至自动锁定(策略可调)。
- 情报与数据:在选人和加载界面快速查看队友、对手的历史战绩与常用英雄。
- 游戏内快捷消息:内置打野路线、开黑队友信息、段位展示等预设文案,一键发送到游戏内聊天。
技术层面它基于 Electron + Vue 3 + TypeScript 构建,主进程按"shard"模块化组织,例如src/main/shards/auto-gameflow/负责对局流程、src/main/shards/auto-select/负责选人逻辑、src/main/shards/in-game-send/负责游戏内消息,感兴趣的话可以直接翻源码对照着玩。
三步完成环境准备与安装
如果你想直接体验成品,用官方发布的安装包即可;想从源码跑起来,或者打算参与开发,跟着下面三步走。
第一步:克隆仓库并安装依赖
git clone https://gitcode.com/gh_mirrors/le/League-Toolkit cd League-Toolkit yarn install项目使用 Yarn 管理依赖(仓库根目录有yarn.lock),包管理器版本建议对齐package.json中声明的yarn@4。
第二步:启动开发模式
yarn dev这会以开发模式拉起 Electron 窗口,并开启调试端口,适合边改代码边看效果。只想预览打包产物,也可以改用yarn start。
第三步:构建可分发版本
yarn build:win在 Windows 上执行这条命令,会先做类型检查和构建,再通过 electron-builder 产出安装包;macOS 对应yarn build:mac。构建配置见仓库根目录的electron-builder.yml。
首次启动:完成三处必要设置
程序第一次跑起来,你不需要填写任何账号密码——League Akari 是本地工具,通过检测本机正在运行的英雄联盟客户端来建立连接。启动后建议按下面顺序过一遍:
- 确认客户端已登录:先登录英雄联盟客户端,再启动 League Akari,它会自动发现客户端并建立 LCU 连接。如果没连上,检查防火墙是否放行,或重启两边程序。
- 打开"自动化"设置页:在
src/renderer/src-main-window/views/中可以看到界面按automation(自动化)、ongoing-game(对局中)、toolkit(工具箱)等分区组织,对应左侧导航。先把"自动接受对局""自动重开"这类开关打开,延迟建议设 3~5 秒,给自己留反应空间。 - 设定语言与偏好:多语言文案位于
src/shared/i18n/(含 zh-CN 与 en),界面里可直接切换;主题、通知方式等按个人喜好调整即可。
小提示:想验证自动化是否生效,最稳妥的办法是先开一局自定义或人机,观察"自动接受"和"自动选人"是否按预期执行,再投入排位。
实战演练:从开黑到结算的一整天
这一节我们跟着一位叫阿岚的玩家,看他用 League Akari 打完一个完整游戏日,你会看到每个功能在真实流程中出现在哪个环节。
19:00 组队开黑——邀请与匹配交给程序
阿岚和两个朋友在客户端组好队,准备开始匹配。他在自动化设置里打开了"自动处理邀请"和"自动重新匹配",并设置了最短开赛人数为 3、等待邀请中的好友。这样即使有人去倒水、切出去回消息,队列也不会因为少点了一次而卡住。相关配置项可以在src/main/shards/auto-gameflow/state.ts的AutoGameflowSettings中逐条查看,比如autoAcceptDelaySeconds、autoMatchmakingMinimumMembers。
19:30 匹配成功——自动接受与自动重开
匹配成功弹窗出现时,程序在设置的延迟后自动点击接受。如果这局有人没进来导致对局重开,它还能按策略自动再次进入队列,选项里有"固定等待时长"和"按预计时长"两种重开策略(对应AutoMatchmakingStrategy),阿岚选了"按预计时长",省心又不会频繁空转。
19:35 选人阶段——战绩情报与自动选人
进入选人,右侧面板实时列出所有玩家的近期战绩、常用英雄和段位信息,阿岚一眼看出对面中单最近在练新英雄,果断按计划禁用。他事先在"自动选择"里为每个位置配了英雄优先级列表,并把策略设为"先展示再锁定",延迟 3 秒——系统先亮出推荐英雄让他确认,3 秒后自动锁定,既快又不至于完全失去控制。相关策略枚举just-show、show-and-lock-in、lock-in-immediately定义在src/main/shards/auto-select/setting-schemas.ts。
20:00 进入游戏——对局中数据面板与快捷消息
加载进游戏后,对局中面板(src/main/shards/ongoing-game/)会同步展示双方阵容、召唤师技能、补刀与击杀变化。阿岚这局玩的是打野,他用了内置预设一键把"打野路线"发送到聊天框,告诉队友自己前期的刷野计划;预设代码在src/main/shards/in-game-send/presets/里,除了jungle.ts(打野路线),还有premade.ts(开黑队友)和rating.ts(段位展示),也可以自己改文案。
21:00 大乱斗——自动发队伍阵营提示
换到大乱斗,阿岚启用了"自动发送队伍侧提示"。开局时程序自动在聊天里发出一条信息,告知队友本局处于红色方还是蓝色方、出生在右上还是左下——这就是下图展示的功能界面,省去了每次开局手打字的麻烦。
21:40 赛后结算——自动点赞与快速再来一局
对局结束,程序按"优先给组队好友点赞"的策略自动送出荣誉点赞(对应AutoHonorStrategy中的prefer-lobby-member),随后自动返回房间并重新进入队列。阿岚只需要在点赞界面确认一眼,其余时间都在和队友复盘刚才那波团战。
三种配置风格:让工具更懂你的习惯
每个人的玩法不同,League Akari 的模块化设置也允许你按习惯取舍:
| 配置风格 | 推荐人群 | 建议开关组合 | 预期效果 |
|---|---|---|---|
| 轻度体验型 | 偶尔上线、求省心的休闲玩家 | 只开自动接受 + 自动点赞,其余保持默认关闭 | 少改动、低风险,先感受自动化带来的轻松 |
| 效率优先型 | 连续开黑、多账号轮换的常驻玩家 | 自动接受、自动重开、自动邀请处理、大乱斗阵营提示全开,选人延迟设 3~5 秒 | 每局节省几十秒机械操作,连续游戏时节奏不断档 |
| 深度定制型 | 想打磨选人策略与内容的进阶玩家 | 按位置配英雄优先级与禁用列表、使用"直接锁定"策略、自定义游戏内消息预设 | 选人更贴战术,消息文案完全符合自己习惯 |
对多数人来说,"效率优先型"是性价比最高的起点;等熟悉了每一项的作用,再逐步往深度定制方向调。
疑难速查:五个高频问题一览
| 现象 | 最可能的原因 | 最简处理步骤 |
|---|---|---|
| 提示无法连接客户端 | 客户端未启动或未登录 | 先登录客户端再启动工具;仍不行就重启两边程序 |
| 自动接受没生效 | 功能未开启或延迟过长 | 到自动化设置页确认开关,并把延迟调到 3~5 秒 |
| 自动选人没反应 | 优先级列表为空或含无效英雄 | 检查配置里是否填入了有效英雄 ID,并确认当前模式支持自动选人 |
| 战绩数据看着偏旧 | 本地缓存或加载时序问题 | 在对局面板点手动刷新,或重启工具清缓存 |
| 权限相关的功能用不了 | 未以管理员身份运行 | 右键以管理员身份运行,可解锁额外功能 |
生态与共建:从使用者到贡献者
League Akari 是开源项目,欢迎任何程度的参与:
- 反馈问题:遇到 bug 或有功能建议,最直接的方式是去项目的 Issue 区描述现象与复现步骤;项目 README 里也维护了 QQ 群与 Telegram 群,群内会不定期分享带新功能的测试版本。
- 提交代码:仓库按
src/main/shards/组织各功能模块,新功能通常对应新增一个 shard 目录。想从简单开始,可以先看src/main/shards/下现有模块的测试文件(如*.test.ts),了解约定后再提 PR。 - 值得期待的方向:从代码结构看,项目正持续增强对局中数据面板(
ongoing-game下已有analysis-controller、match-history-loader等模块)和自动化流程的精细度;如果你常玩 ARAM 或开黑,未来大概率能等到更多针对性的小功能。
回到那个排位夜
回到文章开头的小陈——如果他在周五晚上就已经装好 League Akari,那五局游戏的流程会是这样:匹配靠自动接受,选人靠优先级列表,进游戏靠预设消息,赛后靠自动点赞与重新匹配,他真正要做的只剩思考怎么打。现在轮到你了:克隆仓库、跑起yarn dev,或直接下载安装包体验,然后从打开"自动接受"这个最小的开关开始,把本该属于游戏的注意力拿回来。
【免费下载链接】League-ToolkitAn all-in-one toolkit for LeagueClient. Gathering power 🚀.项目地址: https://gitcode.com/gh_mirrors/le/League-Toolkit
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考