
Externes schreibgeschütztes Spiel-Overlay für Linux. Abgeleitete Offsets, zusammengesetzte Skelette, optionales Kernelmodul für ptrace-unabhängige Speicherzugriffe und Eingaben auf Zeigerebene
Ein externes Overlay für THE FINALS unter Linux.
Es liest den Speicher des Spiels aus einem separaten Prozess, zeichnet ein transparentes, klickdurchlässiges Fenster darüber und bietet eine Zielhilfe sowie einen Triggerbot. Nichts wird in das Spiel injiziert und nichts wird jemals zurückgeschrieben; das Tool liest den Speicher und bewegt die Maus, mehr nicht.
Von Grund auf unter Linux entwickelt: Jeder Spiel-Offset in diesem Repository wurde durch Beobachtung des laufenden Prozesses ermittelt, nicht aus einem veröffentlichten SDK-Dump kopiert.
https://github.com/user-attachments/assets/858e94f2-762b-4c26-877f-fb490e66e42b
third_party/ mitgeliefert; nichts zu installierenArch / 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
Ältere Releases enthalten ein zu altes raylib, um dagegen zu bauen; baue es aus dem Quellcode, wenn pkg-config eine Version unter 5.0 meldet.
REQUIREMENTS.md behandelt den Rest: das Bauen von raylib aus dem Quellcode, Kernel-Header für das Modul, Secure Boot, ptrace_scope und wie man eine funktionierende Einrichtung überprüft.
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
Zwei Teile davon sind es wert, hervorgehoben zu werden, weil sie die kniffligen Fälle sind:
Dies ist die Entwicklungsmaschine, daher ist es die einzige tatsächlich verifizierte Konfiguration. Andere Distributionen, Desktops und mit GCC gebaute Kernel sollten funktionieren und sind ungetestet.
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
Die Binärdatei wird nach build/TheFinals geschrieben.
CMake speichert den absoluten Quellpfad in seinem Cache, sodass ein Build-Verzeichnis,
das über eine Verschiebung oder Umbenennung hinweg mitgeführt wird, nicht mehr funktioniert. build.sh bemerkt dies und
konfiguriert sich selbst neu, sodass das Verschieben des Projekts nichts ist, worüber man
nachdenken muss.
kmod/ baut ein kleines Modul, das das Tool erheblich leiser auf dem
System macht. Es ist vollständig optional: Ohne es funktioniert alles weiterhin, unter Verwendung der
unten genannten Userspace-Fallbacks.
access_process_vm() im Kernelspace, sodass
ptrace_scope nicht gilt. Das Tool benötigt kein sudo, nichts muss sich an
das Spiel anhängen, und yama muss nicht für das gesamte System gelockert werden./proc/bus/input/devices für alles,
was nachsehen möchte. Mit dem Modul gibt es überhaupt kein zusätzliches Gerät.cd kmod && make
sudo insmod suite_kmod.ko
Ein Modul muss mit demselben Compiler gebaut werden wie der Kernel, in den es geladen wird. Das Makefile liest dies aus der Konfiguration des Kernels selbst und legt die Toolchain eigenständig fest, sodass ein einfaches make sowohl bei einem GCC-Kernel als auch bei einem clang-Kernel korrekt ist:
kernel 7.1.2-3-cachyos
toolchain clang (LLVM=1)
Mit make LLVM=0 oder make LLVM=1 überschreiben, falls es jemals falsch rät. Wenn die Kernel-Header fehlen, wird dies gemeldet und der Installationsbefehl für Ihre Distribution ausgegeben.
Bei aktiviertem Secure Boot wird ein unsigniertes Modul nicht geladen: Signieren Sie es, deaktivieren Sie Secure Boot oder überspringen Sie das Modul einfach.
Laden Sie es vor dem Start des Tools; das Backend wird einmalig beim Start ausgewählt.
Bestätigen Sie im Menü oder im Log, welches Backend aktiv ist:
[mem] kernel backend: /dev/suite_kmod
[vmouse] kernel injection into the real pointer
Mit sudo rmmod suite_kmod entladen.
Stelle das Spiel zuerst auf den Fenstermodus ein. Im Vollbildmodus besitzt das Spiel die Anzeige vollständig und nichts kann darüber zeichnen, sodass das Overlay zwar korrekt läuft, aber dennoch unsichtbar bleibt.
Das Overlay findet das Fenster des Spiels und gleicht dessen Position und Größe ab, wobei es dies fortlaufend erneut prüft. Dadurch folgt es dem Fenster, wenn du es verschiebst oder in der Größe änderst, und passt sich an jede Auflösung an.
./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
Starten Sie es, wann immer Sie möchten, auch im Menü. Es löst seine Objekte neu auf, wenn ein Match beginnt oder endet, sodass es zwischen Runden nicht neu gestartet werden muss.
Beim Start fragt es außerdem bei GitHub nach, ob eine neuere Version veröffentlicht wurde, und falls ja, teilt es dies mit einem Link mit. Es lädt niemals etwas herunter oder ändert etwas, und das Tool wartet nicht auf die Antwort.
| Taste | Aktion |
|---|---|
INSERT | Schaltet das Einstellungsmenü um. Während es geöffnet ist, nimmt das Overlay Mausklicks an; während es geschlossen ist, gehen Klicks an das Spiel durch. |
HOME | Schaltet die Zielhilfe um. |
PAGE DOWN | Markiert den Moment in vis.log für ein Sichtbarkeitsurteil, das falsch erschien. |
End | Beendet das Programm, mit fokussiertem Overlay. Ctrl-C im Terminal funktioniert ebenfalls. |
Einstellungen werden im Menü bearbeitet und einige Sekunden nach der letzten
Änderung in settings.cfg geschrieben, ebenso beim Beenden, sodass ein Absturz
oder ein Kill nichts kostet. Die Datei wird vollständig ersetzt statt an Ort und
Stelle neu geschrieben, und der vorherige Inhalt wird einmal als
settings.cfg.bak aufbewahrt.
Boxen, Skelette, Namen, Gesundheitsbalken, Entfernung und Snaplines. Teamfarben unterscheiden die Teams, und ein globaler Deckkraft-Regler steuert alles Gezeichnete.
Das Skelett wird aus der eigenen Knochenhierarchie des Meshes zusammengesetzt, sodass es der Animation folgt, statt sie aus einer Kapsel anzunähern.