一个用于 Linux 上《THE FINALS》的外部覆盖层。
它从独立进程读取游戏内存,在其上方绘制一个透明的、可点击穿透的窗口,并提供瞄准辅助和扳机机器人。没有任何内容被注入游戏,也从不写回任何数据;该工具只读取内存并移动鼠标,仅此而已。
在 Linux 上从零构建:本仓库中的每一个游戏偏移量都是通过观察运行中的进程推导出来的,而非从公开的 SDK 转储中复制。
https://github.com/user-attachments/assets/858e94f2-762b-4c26-877f-fb490e66e42b
third_party/ 中;无需安装Arch / CachyOS
sudo pacman -S --needed base-devel cmake raylib libx11 libxext
Ubuntu 24.04+ / Debian 13+
sudo apt install build-essential cmake libraylib-dev libx11-dev libxext-dev
pkg-config --modversion raylib # must be 5.0 or newer
较旧的发行版打包的 raylib 版本过旧,无法用于构建;如果 pkg-config 报告的版本低于 5.0,请从源码构建。
REQUIREMENTS.md 涵盖了其余内容:从源码构建 raylib、模块所需的内核头文件、Secure Boot、ptrace_scope,以及如何验证配置是否正常工作。
CachyOS kernel 7.1.2-3-cachyos, built with clang 22.1.6
KDE Plasma 6.7.2 Wayland session, overlay running through XWayland
raylib 6.0 CMake 4.3.4, GCC 16.1.1
Intel UHD + RTX 4060 game under Proton, Windowed
其中有两部分值得特别说明,因为它们属于棘手的情况:
这是开发机器,因此它是唯一实际验证过的配置。其他发行版、桌面环境和 GCC 构建的内核预期可以工作,但尚未测试。
chmod +x build.sh run.sh # a zip download drops the executable bit
./build.sh # configure and build
./build.sh clean # from a fresh build directory
二进制文件会生成到 build/TheFinals。
CMake 会在其缓存中保存绝对源路径,因此一旦构建目录被移动或重命名,它就会失效。build.sh 会检测到这一点并自行重新配置,所以移动项目这件事你无需操心。
kmod/ 会构建一个小型模块,使该工具在系统上安静得多。它完全是可选的:没有它一切仍然可以工作,只是会使用下文提到的用户态回退方案。
access_process_vm() 进行,因此 ptrace_scope 不适用。该工具不需要 sudo,无需附加到游戏进程,也不必为了整个系统而放宽 yama。/proc/bus/input/devices 中,任何有心查看的程序都能发现。有了该模块,就完全不存在额外的设备。cd kmod && make
sudo insmod suite_kmod.ko
模块必须使用与其所加载内核相同的编译器构建。Makefile 会从内核自身的配置中读取该信息并自行设置工具链,因此无论内核使用 GCC 还是 clang,直接运行 make 都是正确的:
kernel 7.1.2-3-cachyos
toolchain clang (LLVM=1)
如果它猜错了,可以用 make LLVM=0 或 make LLVM=1 覆盖。如果缺少内核头文件,它会提示这一点,并打印适用于你的发行版的安装命令。
启用 Secure Boot 时,未签名的模块将无法加载:请对其进行签名、禁用 Secure Boot,或者直接跳过该模块。
请在启动工具之前加载它;后端只在启动时选择一次。
在菜单或日志中确认当前生效的是哪个后端:
[mem] kernel backend: /dev/suite_kmod
[vmouse] kernel injection into the real pointer
使用 sudo rmmod suite_kmod 卸载。
首先将游戏设置为窗口模式。 在全屏模式下,游戏完全独占显示器,任何内容都无法绘制在其上方,因此叠加层虽然运行正常,却仍然不可见。
叠加层会找到游戏窗口并匹配其位置和大小,并在运行过程中持续重新检查,因此当你移动或调整窗口大小时它会跟随窗口,并适应任何分辨率。
./run.sh # finds the game PID by itself
./run.sh 12345 # or give it one
./run.sh -q # quiet: a few status lines only, no update check
你可以在任何时候启动它,包括在菜单中。它会在比赛开始或结束时重新解析其对象,因此无需在回合之间重启。
启动时它还会向 GitHub 查询是否有更新的版本发布,如果有,它会说明并提供链接。它从不下载或更改任何内容,而且该工具不会等待答复。
| 按键 | 操作 |
|---|---|
INSERT | 切换设置菜单。打开时,覆盖层接收鼠标点击;关闭时,点击会穿透到游戏。 |
HOME | 切换瞄准辅助。 |
PAGE DOWN | 在 vis.log 中标记时刻,用于记录看起来错误的可见性判定。 |
End | 退出,覆盖层获得焦点。终端中的 Ctrl-C 也可以。 |
设置在菜单中编辑,并在停止更改几秒后写入 settings.cfg,退出时也会写入,因此崩溃或被杀掉不会造成任何损失。该文件是整体替换而非原地重写,之前的内容会保留一次为 settings.cfg.bak。
方框、骨架、名称、生命条、距离和连线。小队颜色区分队伍,一个主不透明度滑块控制所有绘制内容。
骨架由网格自身的骨骼层级构成,因此它跟随动画,而不是从胶囊体近似。
轮廓以小队颜色描绘每个玩家自身的轮廓,因此伸出的手臂、蹲下或倾斜都会如实显示,而方框只能显示某人的高度。当网格的顶点可读取时,它来自游戏渲染的网格,在实时骨架上摆好姿势;否则来自沿骨骼铺设的管道,并按该玩家自身的体型比例调整。其宽度以及填充身体的颜色量在 ESP 选项卡中其旁边设置。
观战者被排除在外。游戏将他们与玩家一起列出,但他们没有生命值,因此在其上绘制方框会显示 0 HP,而且游戏从不绘制他们,所以没有什么可看或可击中。ESP 选项卡中的一个开关仍会显示他们。声呐和屏幕外标记从不显示他们,瞄准辅助和扳机机器人也会忽略他们,除非在瞄准选项卡中另有指示。
任何在你身后、身旁或屏幕边缘之外的人,都会在窗口边缘获得一个标记,以小队颜色指向他们的方向。在你前方,标记精确指向玩家投影到你视图上的位置,使用与 ESP 方框和线条相同的投影。在你身后,它按方位角工作,因此正后方的人会正下方显示,标记保持静止。每个标记显示玩家的职业(L、M 或 H),其背面有一条带表示生命值,后面是距离,当他们在你上方或下方一层或更多时,还有一个小上或下标记。远处的标记更小更淡。
当从准星绘制连线时(ESP 选项卡中连线旁边的开关),每个标记都位于其对应玩家的线上。方向几乎相同的玩家,其标记会被推开,刚好使标记及其距离都不重叠。
环半径从顶部开始,此时标记沿窗口边框排列。更低时,它们位于准星周围的环上,该环在会穿过屏幕边缘的地方会压平贴边。
在设定距离内,标记会闪烁霓虹绿色,玩家越近闪烁越快,而其边缘保持小队颜色。半径、大小、范围、不透明度、闪烁距离及其最慢和最快速率都在菜单的屏幕外选项卡中。不透明度设置整个指示器的实心程度,包括闪烁和文本,而远处不透明度设置最远标记保留多少。
一个独立窗口中的雷达,因此它可以放在游戏旁边或第二块屏幕上,而不是覆盖在视野之上。它随你转动:上方始终是你面朝的方向,而你就是中心的标记。
它在菜单中有自己的标签页。
在按住所选鼠标按钮时朝目标拉动。
当射击会命中时开火。准星是一个方向,而不是一个点,因此测试的是游戏本身所运行的测试:从摄像机穿过准星的线,与玩家身体的相交情况。
引擎决定每一帧绘制什么,并为每个网格打上最后一次绘制它的时间戳,因此读取该时间戳来判断玩家是否可见,远比任何从外部计算的方式更可靠:它与游戏实际依据的答案一致,包括遮挡、剔除以及被炸开的墙体。
settings.cfg 旁边的 vis.log:每秒记录每个玩家的时间戳,并在每次判定翻转、每个玩家离开列表以及时钟被校正时立即记录。PAGE DOWN 会标记一个看起来不对的时刻,并附上当时所有人的时间戳。当前未被游戏绘制的玩家会被划掉并淡化,瞄准辅助和扳机机器人可以分别设置为忽略他们。
它本质上是保守的。只要玩家的包围盒没有被完全遮挡,游戏就会绘制该玩家,而包围盒比玩家本身更大,因此躲在拐角或矮墙后的人仍可能被读为可见,且遮挡会滞后一两帧。引擎还保留了一个专用于在屏幕上绘制的第二时间戳;工具会在相邻字段中寻找它,Visibility 标签页会说明它正在读取哪个时间戳。在使用光线追踪光照时,引擎每帧都会为 50 米内所有移动物体打上时间戳,无论是否有墙;你身后持续被读为已绘制的玩家会暴露这一点,Visibility 标签页在检测到时会予以说明。
所有游戏特定的地址都位于 offsets.cfg 中,启动时从工作目录或其上一级目录读取。
工具在没有该文件时拒绝启动,或者缺少几个不可或缺的偏移时也会拒绝:相互指向的控制器和 pawn、玩家列表、每个玩家的 pawn、pawn 的位置,以及一个相机(相机管理器的 POV,或控制器的旋转)。它会指出缺少哪些。
其他每个偏移都属于某个功能,留空只会关闭该功能。工具在启动时会列出哪些功能被关闭。不会有任何东西被静默置零,因为零偏移仍会读取某些内容:对象的 vtable 指针,而对于小队来说,每个 pawn 上的该指针都相同,因此每个玩家看起来都像你的队友,屏幕保持空白且没有任何解释。
观战标志在错误而非为空时可能隐藏整个大厅,因此它会在运行期间与对局进行核对,当它与对局矛盾时被忽略,日志会说明这一点。当玩家被列出但无人被绘制时,日志会说明是什么移除了他们,包括队友。