MCPcopy Index your code
hub / github.com/WJZ-P/TFT-Hextech-Helper

github.com/WJZ-P/TFT-Hextech-Helper @v1.6.0

Chat with this repo
repository ↗ · DeepWiki ↗ · release v1.6.0 ↗ · + Follow
1,128 symbols 3,243 edges 103 files 497 documented · 44%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

TFT-Hextech-Helper —— 云顶之弈挂机小助手

Contributors   Forks   Stargazers   Issues   MIT License

Logo

TFT Hextech Helper

<a href="https://github.com/WJZ-P/TFT-Hextech-Helper">查看Demo</a>
·
<a href="https://github.com/WJZ-P/TFT-Hextech-Helper/issues">报告Bug</a>
·
<a href="https://github.com/WJZ-P/TFT-Hextech-Helper/issues">提出新特性</a>

深蓝雨

"尽握在手沉重的花束名誉 沾着泥土的指尖始终 怯于靠近 那脸庞遥不可及"

目录

项目简介

TFT Hextech Helper 是一款基于 Electron + React + TypeScript 开发的云顶之弈自动下棋助手。它可以帮助你在云顶之弈(包括S16英雄联盟传奇、S4.5瑞兽闹新春、发条鸟的试炼)中自动进行对局，解放你的双手，让你可以边挂机边做其他事情。（当然挂机的时候你就不能玩电脑了，因为软件会使用你的鼠标！）

软件截图

⚠️ 注意事项

  • 必须以管理员身份运行，否则无法正常控制游戏
  • 游戏语言必须设置为简体中文，否则软件无法正确识别棋子
  • 推荐使用默认棋盘皮肤，已针对默认棋盘优化，能加快棋子识别速度
  • 支持Windows & MacOS
  • 暂不支持外服。

功能特性

  • 🎮 自动下棋 - 智能识别游戏状态，自动购买英雄、整理阵容
  • 🎯 阵容推荐 - 内置多套热门阵容配置，一键选择
  • ⌨️ 快捷键控制 - F1 开启/关闭挂机，F2 本局结束后停止
  • 🎨 现代化界面 - 美观的 UI 设计，超级酷
  • 📊 实时日志 - 查看详细的运行日志，了解程序状态

使用教程

1. 下载并安装

从 Release 页面下载最新版本： - 安装版 (.exe setup) - 不推荐，走正常软件安装流程，会留注册表 - 便携版 (.zip) - 推荐，解压即用，无需安装

或点击右侧高速下载：TFT-Hextech-Helper-1.0.0-win.zip

2. 启动软件

⚠️ 重要：本软件需要以管理员身份运行才能正常工作！目前只支持Windows系统运行。

软件截图

3. 连接游戏客户端

启动英雄联盟客户端，软件会自动检测并连接。如果出现打开了客户端却显示未连接的情况，请检查是否使用管理员模式启动软件！

4. 开始挂机

  1. 选择你想要的阵容配置
  2. 点击"开始挂机"按钮或按 F1 快捷键
  3. 程序会自动开始匹配并进行对局

快捷键说明

快捷键 功能
F1 开启/关闭挂机
F2 本局结束后自动停止

获取更新

前往 Release 页面

交流渠道

软件截图

技术栈

  • 前端框架: React 18 + TypeScript
  • 桌面框架: Electron 32
  • 构建工具: electron-vite
  • UI 组件: MUI (Material-UI) + styled-components
  • 图像识别: OpenCV.js + Tesseract.js
  • 自动化: nut-js (鼠标键盘控制)

版权说明

本项目采用 CC BY-NC-ND 4.0 协议，这意味着：

  • ✅ 可以下载、使用、分享（需注明出处）
  • ❌ 禁止商业使用
  • ❌ 禁止二次开发/修改后发布

详情请参阅 LICENSE

鸣谢

  • 感谢所有为这个项目提供建议和反馈的朋友们

重要声明

本项目仅供学习交流使用，禁止用于任何商业用途！使用本软件产生的任何后果由用户自行承担。(｡•́︿•̀｡)

📝 To Do List

  • [x] 基础挂机功能

  • [x] 阵容配置系统

  • [x] 快捷键支持

  • [x] 更多阵容配置

  • [x] 支持自定义阵容

  • [x] 对局显示人机信息

  • [ ] 战绩统计

如果您喜欢本项目，请给我点个⭐吧(๑>◡<๑)！

⭐ Star 历史

Stargazers over time

另一条时间线

Ekko & Jinx

"但至少在这里，他们在一起。"

Extension points exported contracts — how you extend this code

IState (Interface)
(no doc) [12 implementers]
src-backend/states/IState.ts
ToastOptions (Interface)
Toast 配置选项
src-backend/utils/ToastBridge.ts
LineupMatchResult (Interface)
* 阵容匹配结果
src-backend/services/StrategyService.ts
TemplateLoadConfig (Interface)
* 模板加载配置
src-backend/tft/recognition/TemplateLoader.ts
ChampionSlot (Interface)
* 自定义阵容中单个格子的数据结构 * name: 棋子中文名 * equips: 该棋子携带的装备名称数组（最多 3 个）
src/components/pages/LineupsPage.tsx
PlayerInfo (Interface)
玩家信息接口
src/overlay/OverlayApp.tsx
GameStageResult (Interface)
(no doc)
src-backend/TFTProtocol.ts
ChampionConfig (Interface)
(no doc)
src-backend/lineup/LineupTypes.ts

Core symbols most depended-on inside this repo

info
called by 303
src-backend/utils/Logger.ts
warn
called by 164
src-backend/utils/Logger.ts
error
called by 162
src-backend/utils/Logger.ts
debug
called by 93
src-backend/utils/Logger.ts
log
called by 76
src-backend/utils/Logger.ts
log
called by 72
out/main/index.js
sleep
called by 70
src-backend/utils/HelperTools.ts
callback
called by 69
out/main/index.js

Shape

Method 551
Function 427
Class 74
Interface 56
Enum 20

Languages

TypeScript100%

Modules by API surface

out/main/index.js339 symbols
src-backend/services/StrategyService.ts97 symbols
src-backend/services/GameStateManager.ts66 symbols
src-backend/TftOperator.ts51 symbols
src-backend/tft/recognition/TemplateLoader.ts43 symbols
src/components/pages/LineupsPage.tsx39 symbols
src-backend/lcu/LCUManager.ts36 symbols
src-backend/TFTInfo/SeasonRegistry.ts24 symbols
src-backend/services/HexService.ts18 symbols
src/components/pages/SettingsPage.tsx16 symbols
src-backend/utils/GameConfigHelper.ts16 symbols
src-backend/services/GameStageMonitor.ts16 symbols

For agents

$ claude mcp add TFT-Hextech-Helper \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact