Repository navigation
Releases
Releases · PFLcoolme/cs2-external
v1.1.0 · 控制面板主题与构建更新
v1.0.0 · 直接内存引擎 + 内核级输入 + 深色双栏面板
这是闭源前最后一个公开版本
自 v0.9.0 起本项目转入闭源开发。v1.0.0 是该公告之后唯一放出的完整版本,已公开的源码、文档与历史版本保持不动,后续功能与偏移适配不再在此仓库发布。详见置顶公告 #1。
新增功能
- 直接内存引擎(
MemoryEngine):独立 2 ms 工作线程,按配置把五组功能写进游戏进程——加速、真子弹追踪、飞天、身体旋转、真无后坐力。与Features(输入合成)完全解耦:一个鼠标事件都不发,准星、相机角、玩家输入都不动,改的只是 pawn 上的网络字段。默认全关;偏移未配置时静默跳过并在AppState::memoryMissing里计数,不猜测 schema 布局。退出功能或 Panic 时把改写过的字段写回进入前的值。- 加速:
m_flVelocityModifier倍率 + 放大 movement services 的m_flMaxspeed。 - 真子弹追踪内存锁:每 1 ms 把
m_angEyeAngles+m_angStashedShootAngles锁到最近敌人头部;「视角不动」回写v_angle,「命中优先」连v_angle一起锁(相机跟随目标,服务器才按锁定方向结算)。支持队伍过滤、最大距离、300 ms 锁定时长。 - 飞天:
m_vecVelocity与m_vecAbsVelocity的垂直分量。 - 身体旋转:
m_angRotation+m_angAbsRotation;「视角不动」默认不写渲染旋转。 - 真无后坐力:punch base / 角速度 / 相机视觉 punch 三处清零。
- 弹着点收成一点:安全模式只清
m_flFlinchStack与m_flLastShakeTime;散布预测组仅在关闭安全模式时清,避免本地预测与服务器分叉。
- 加速:
- 内核级输入(
core/UInput):常驻/dev/uinput虚拟鼠标。CS2 走 SDL raw input 时完全忽略 XTest 事件,uinput 设备会被当成真实硬件枚举并消费。设备在进程存活期间常驻(SDL 需要若干秒枚举热插拔设备)。/dev/uinput打不开时回退 XTest。 - 深色双栏面板:品牌区 + 搜索框 + 分类侧栏,页头 + 卡片行表。搜索只过滤当前页;扳机页补齐子弹追踪、后坐力抵消与两个缺失参数入口。
修复与改进
- 偏移生成器输出 44 个实机偏移,全部
maybe_any可选——缺任何一项都不影响程序启动。 Config::save保留磁盘上的未知字段,避免旧二进制在新版本上保存时抹掉新偏移。LogPath统一日志路径,构建过程不再覆盖运行配置。XInitThreads修复双 Xlib 连接问题。- 新增
tests/test_config.cpp、tests/test_math.cpp,核心层无游戏语义、可单测。 - 新增
tools/cs2_probe_features.py(哨兵判定HELD/OVERWRITTEN)与tools/cs2_probe_accuracy.py(散布字段纯读)。
资产
cs2_lite— Linux x86_64 可执行文件(Qt6 叠加层,Release 构建,已 strip)default.json— 默认配置,放到可执行文件同目录并改名为config.json
sha256 cs2_lite 7c7acbb750638387654febadb84e67039bf0faaff75a73fa33971214104161aa
sha256 default.json b45ddcc470f23e896ee78dceada6c228e3209b77a20d597abd7974225dc43f18运行要求
/proc/<pid>/mem:采集链路只需O_RDONLY;「内存」页五组功能需要O_RDWR(通常 root)。- Yama 拦截时需
kernel.yama.ptrace_scope=0或sudo。 /dev/uinput可写,否则自瞄 / 扳机回退 XTest。- 不注入、不附加调试器、不绕过反作弊。偏移随游戏版本变化,需自行填入当前版本实测值。
验证
cmake --build build -j— Release(-O3 -DNDEBUG)构建,0 warning / 0 errorctest --test-dir build— 1/1 passed(0.06 s)ldd cs2_lite— 依赖零缺失;strip 后 481 KB- 开发期实机已验证:深层字段写入可被哨兵读到
OVERWRITTEN、锁角生效 - 未验证:五组内存功能的实战效果(加速手感、弹道、飞天速率、旋转稳定性、连发落点),需实战确认
已知限制
- 「内存」页功能全部默认关闭,且必须自填当前版本偏移;偏移为 0 时功能静默不动作。
- 弹着点收成一点在安全模式下不保证完全一致——只清两个字段是有意取舍,避免触发服务器端分叉检测。
- 项目仅用于本地单机研究。
v0.9.0 · 官网 + 命中统计 + 自检 + 准星信息
新增功能
- 准星目标信息:准星指向敌人时,在准星右下角显示
82 hp · 12 m,颜色沿用敌我语义色,残血(≤30)转红。数据来自已有的Snapshot::crosshairIndex,不需要新偏移。 - 启动自检:日志页逐项列出进程、模块基址、9 个关键偏移与 2 个运行时指针。运行时指针专门用来区分「配置里没写偏移」和「偏移非零但读到 0(已随版本失效)」这两种失败。
- 命中统计:状态行扩展为「采集 / 方框 / 队友 / 距离 / 命中 / 伤害」。掉血检测与「伤害浮字」解耦,关掉浮字也照样累计;另记录击杀次数。
- 全局热键可配置:F8(显示/隐藏面板)与 F9(一键静默)从硬编码改为配置项,日志页顶部可录制改键,设为「不限」即为禁用。
- 官网:新增
web/纯静态单页站,已部署到 https://cs2.xn--rhyr4ib67a.top/ 。README 顶部加了官网链接与徽章。
修复与改进
Offsets.h默认entityChunkStride从0x78(120) 改为 112,与config/default.json对齐——原值实测扫不到任何健康实体。Patterns.h补注释:三条空特征码是「完全依赖 offsets.json」的有意设计,不是缺陷。- 面板行表最小高度 400 → 430,透视页 17 行仍在一屏内。
config/offsets.json的dwLocalPlayerPawn更新为当前版本实测值。
资产
cs2_lite— Linux x86_64 可执行文件(Qt6 叠加层,只读/proc/<pid>/mem)default.json— 默认配置,放到可执行文件同目录并改名为config.json
验证
cmake --build build -j0 warning / 0 error;ctest100% passed- 面板截图确认:日志页快捷键(F8 / F9)、13 项自检全部
OK、透视页「准星信息」行可见 - 未验证:准星信息的游戏内读数、命中统计的非零数值、改键后热键是否立即生效——均需实战确认
已知限制
- 命中统计从进程启动累计,没有「本局重置」入口
- F8 / F9 若设成同一个键会同时触发显隐与静默
- 自检只检查「是否可读」,不校验读到的值是否合理
web/未接入 CI,官网改动没有自动校验
v0.8.0 · 参数防抖 + F9 Panic + HUD 位置 + 偏移热更新
变更
新增功能
- F9 Panic 键:一键隐藏叠加层并停止全部输入合成(自瞄 / 追踪 / 静默 / 扳机 / 后坐力),再按一次恢复。比 F8 只收面板更彻底,用于应急。
- HUD 位置可选:雷达与敌人列表不再写死,各自支持底部居中 / 左上 / 右上 / 左下 / 右下五档。雷达在四角时留 24 px 边距,顶部额外让出 88 px 避开自身 HUD。
- 偏移热更新:
config.json或config/offsets.json的修改时间变化会触发重新导入,换偏移不再需要重启进程。只有核心偏移真的变化时才重走模块基址与特征码解析。
修复与改进
- 参数防抖保存:所有勾选框 / 数值框 / 下拉框改动后 400 ms 自动落盘,不再需要收起参数区或手动点保存。回填控件期间屏蔽,避免热重载自我循环。
- iOS 开关命中修复:
ToggleSwitch重写hitButton,整块 34 px 轨道都可点击。此前沿用 style 里 13 px 指示器的判定范围,点轨道边缘无效。
资产
cs2_lite— Linux x86_64 可执行文件(Qt6 叠加层,只读/proc/<pid>/mem)default.json— 默认配置,放到可执行文件同目录并改名为config.json
验证
cmake --build build -j0 warning / 0 error;ctest100% passed- 防抖保存:改开关后
config.json在 400 ms 内自动更新(实测) - 位置下拉:面板截图确认五个选项齐全
config.json热重载:外部改动后程序存活且不重复写盘- 未验证:F9 的实际静默效果、四角摆位的游戏内观感、
offsets.json触发的重载(该文件属主为 root,测试环境无法制造 mtime 变化)
已知限制
- F8 / F9 目前硬编码,尚未做成可配置键位
- 偏移热更新只在本进程内生效,不会回写
config.json sameOffsets是字段白名单,新增核心偏移需同步补进比较
v0.7.0 · 高度差 + 雷达距离圈 + F8 显隐 + 目标锁定
变更
新增功能
- 高度差指示:对比目标与自己的 z 轴差值,超过 0.6 m 时在方框顶部外侧画
▲(楼上)/▼(楼下)并附米数。Inferno、Nuke 这类多层图不用再靠方框位置猜楼层。 - 雷达距离圈:雷达半径三等分,加三圈淡色同心圆与对应米数刻度,圆点远近一眼可判。
- F8 显隐面板:按 F8 直接收/放控制面板,不必 Alt+Tab 切出游戏。走
XQueryKeymap全局按键状态,不需要窗口焦点。 - 目标锁定:自瞄锁定当前目标,直到它死亡或离开 FOV 才重新选人,避免两个敌人贴身时准星来回跳。面板自瞄参数区可开关。
改进
- 面板行表最小高度 330 → 400:透视页加到 16 行后,「屏外指示 / 敌人列表 / 高度差」会被挤进滚动区,现在一屏可见。
资产
cs2_lite— Linux x86_64 可执行文件(Qt6 叠加层,只读/proc/<pid>/mem)default.json— 默认配置,放到可执行文件同目录并改名为config.json
验证
cmake --build build -j0 warning / 0 error;ctest100% passed- F8 显隐实测:面板显示 → 按 F8 消失 → 再按恢复
- 面板截图确认「高度差」「屏外指示」「敌人列表」「锁定目标」均已就位
- 未验证:高度差三角、雷达距离圈、目标锁定的游戏内实际观感,需要实战确认
已知取舍
- 目标锁定优先于策略:开启后即使策略为「血量最低」,也会持续打第一个锁上的目标
- F8 目前硬编码,尚未做成可配置键位
v0.6.1 · 键位绑定改完立即落盘
修复
- 键位绑定改完立即落盘:之前只有「收起参数区」和点底部「应用并保存」两条写盘路径。改完键位直接进游戏测试时,
config.json仍是旧值,表现为「设了『不限』却依然要开镜 + 开火两键」。现在 5 个键位(开镜 / 开火 / 追踪 / 静默 / 扳机)任一变更都会立刻保存并生效。
资产
cs2_lite— Linux x86_64 可执行文件(Qt6 叠加层,只读/proc/<pid>/mem)default.json— 默认配置,放到可执行文件同目录并改名为config.json
验证
cmake --build build -j0 warning / 0 error- 现象复现与修复:修复前
config.json中scopeKey仍为3,改为0后Features的门控条件scopeHeld恒真,按住左键即进入自瞄 - 其余参数(平滑 / 范围 / 灵敏度等)仍需收起参数区或点「应用并保存」才会写盘
v0.6.0 · 键盘热键 + 实时统计 + 敌人列表
变更
新增功能
- 键盘热键:触发键不再局限于鼠标 Button1~5。面板上点一下按键框,再按任意键(含鼠标中/右键)即可绑定,
Esc取消。键盘走XQueryKeymap轮询而非XGrabKey,不抢键,游戏侧输入照常接收。 - 实时统计行:面板状态栏下新增「采集 N · 方框 N · 队友 N · 距离 N」,用于区分「视野内没敌人」和「有敌人但被过滤/投影失败」。
- 屏外指示距离:屏幕边缘的方位箭头内侧补上米数。
- 敌人列表:右侧按距离排序的紧凑列表,最多 10 行,显示距离与血量,颜色区分敌我。远处方框只有几像素时靠它补信息。
改进
- 诊断日志轮转:
/tmp/wv_lite.log超过 2 MB 自动截断(累计写满 64 KB 检查一次),长期挂机不再撑满/tmp。 - 数学层归位:
viewYaw/screenDirection从Overlay.cpp的匿名命名空间移入src/core/Math.h,Overlay 只保留绘制。
测试
- 接入
ctest:tests/test_math.cpp覆盖worldToScreen/viewYaw/screenDirection,tests/test_config.cpp覆盖默认值与 JSON 往返。-DCS2_LITE_BUILD_TESTS=OFF可关闭。
资产
cs2_lite— Linux x86_64 可执行文件(Qt6 叠加层,只读/proc/<pid>/mem)default.json— 默认配置,放到可执行文件同目录并改名为config.json
验证
cmake --build build -j0 warning / 0 errorctest --output-on-failure:100% tests passed out of 1- 键盘录制实测:点击后按
F可绑定并回显 - 实时统计行截图确认零值分支「采集 0 · 当前视野内没有实体」
- 未验证:敌人列表与屏外箭头的游戏内观感(验证时游戏窗口不在前台,叠加层未绘制)
v0.5.0 · 左侧分类面板 + 白色毛玻璃 + 雷达旋转/屏外指示
变更
界面
- 左侧分类列表:顶部横排标签改为左侧竖排导航(透视 / 自瞄 / 扳机 / 日志),面板宽度 440 → 540。
- iOS 形制开关:方框勾选改为 34×18 轨道 + 14 px 圆形滑块,140 ms
OutCubic缓动,22 个开关全部切换。 - 白色毛玻璃底板:半透明近白玻璃 + 噪点 + 圆角描边。有合成器时走 ARGB 实时合成(背景跟随画面变化),无合成器退回「全屏快照 + 降采样模糊」。
- 参数改为行内下拉:右键弹独立窗口改为点击行右侧「参数 ▸」就地展开,收起时自动落盘。
功能
- 雷达随视角旋转:从视图矩阵左上 3×3 推导相机 yaw,玩家点按「前方朝上」映射,圆周顶部标注朝向;先做旋转行长度≈1 的正交性自检,布局不符时自动退回固定北向。
- 屏外指示:视野外敌人在屏幕边缘显示方位箭头,相机后方目标取反映射,颜色沿用语义色,透明度按距离衰减。
资产
cs2_lite— Linux x86_64 可执行文件(Qt6 叠加层,只读/proc/<pid>/mem)default.json— 默认配置,放到可执行文件同目录并改名为config.json
验证
cmake --build build -j80 warning / 0 error- 实机
WV_DEBUG=1:[tick] valid=1 players=5 drawn=5 localTeam=3、[yaw] finite=1 value=-2.269 - 面板:
/tmp/n1c.png确认左侧分类、iOS 开关、白色玻璃、「屏外指示」行;/tmp/s3c.png确认参数行内展开 - 未验证:雷达旋转方向与屏外箭头方位的实际手感,需对局内确认;若方向相反,对调
rel的符号即可
v0.4.0 · 启动自动刷新偏移 + 后坐力链路修正
变更
- 启动自动刷新偏移:每次启动自动执行
tools/cs2_linux_offsets.py,生成后落盘到可执行文件目录的config/offsets.json,游戏更新后无需手动跑生成器。- 生成失败 / 超时 / python3 缺失时只写
/tmp/wv_lite.log并沿用现有偏移,不阻塞启动。 WV_SKIP_OFFSETS=1可跳过本次生成。
- 生成失败 / 超时 / python3 缺失时只写
- 后坐力链路修正:本版本 schema 已无
m_aimPunchAngle/m_aimPunchCache,改为实测的两级跳
C_CSPlayerPawn.m_pAimPunchServices(0x1520) →CCSPlayer_AimPunchServices.m_predictableBaseAngle(0x50)。 - 生成器采集字段同步,
config/default.json键名对齐(m_pAimPunchServices)。
资产
cs2_lite— Linux x86_64 可执行文件(Qt6 叠加层,只读/proc/<pid>/mem)default.json— 默认配置,放到可执行文件同目录并改名为config.json,同级config/offsets.json由启动自动生成
验证
cmake --build build -j80 warning- Xvfb 1280x800x24 启动验证:
[offsets] 已刷新偏移/WV_SKIP_OFFSETS=1跳过分支均通过 - 生成器实测:
m_pAimPunchServices = 5408 (0x1520)、m_predictableBaseAngle = 80 (0x50),耗时 0.587 s
v0.3.0 · 面板重构与 ESP 增强
本次更新
面板
- 改为左侧类别导航(透视 / 自瞄 / 扳机)+ 右侧分类页,只显示当前分类的设置项
- 极简黑白双色,背板完全透明,仅靠 1px 线与灰阶分层;宽度收敛到 440px
- 选中项与主按钮反白,输入框透明描边,支持无边框拖拽、首屏居中
透视
- 新增血量数值显示、2D 雷达(固定北向,底部居中,半径可调 5–300 m)
- 遮挡目标改用虚线绘制,区别可见目标
自瞄
- 新增目标策略:屏幕最近 / 血量最低 / 世界最近
- 开镜 + 开火双条件触发,并向叠加层发布瞄准门控状态
使用
chmod +x cs2_lite
mv default.json config.json
./cs2_lite需要系统已安装 Qt6 与 X11 运行库;无合成器(picom / kwin / mutter)时透明通道不生效。