
Overlay di gioco esterno in sola lettura per Linux. Offset derivati, skeleton composti, modulo kernel opzionale per letture di memoria indipendenti da ptrace e input a livello di puntatore.
Un overlay esterno per THE FINALS su Linux.
Legge la memoria del gioco da un processo separato, disegna una finestra trasparente click-through sopra di essa e fornisce un aim assist e un triggerbot. Nulla viene iniettato nel gioco e nulla viene mai riscritto; lo strumento legge la memoria e muove il mouse, e questo è tutto.
Costruito da zero su Linux: ogni offset del gioco in questo repository è stato ricavato osservando il processo in esecuzione, non copiato da un dump SDK pubblicato.
https://github.com/user-attachments/assets/858e94f2-762b-4c26-877f-fb490e66e42b
third_party/; nulla da installareArch / 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
Le release più vecchie includono una versione di raylib troppo datata per poter essere compilata; compilala dai sorgenti se pkg-config riporta una versione inferiore alla 5.0.
REQUIREMENTS.md copre il resto: la compilazione di raylib dai sorgenti, gli header del kernel per il modulo, Secure Boot, ptrace_scope e come verificare una configurazione funzionante.
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
Due parti di questo meritano una menzione, perché sono i casi scomodi:
Questa è la macchina di sviluppo, quindi è l'unica configurazione effettivamente verificata. Altre distribuzioni, desktop e kernel compilati con GCC dovrebbero funzionare e non sono testati.
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
Il binario viene scritto in build/TheFinals.
CMake memorizza il percorso assoluto del sorgente nella propria cache, quindi una directory di build
trasferita dopo uno spostamento o una rinomina smette di funzionare. build.sh se ne accorge e
si riconfigura da solo, quindi spostare il progetto non è qualcosa a cui devi
pensare.
kmod/ compila un piccolo modulo che rende lo strumento considerevolmente più silenzioso sul
sistema. È del tutto opzionale: senza di esso tutto continua a funzionare, usando i
fallback in userspace indicati di seguito.
access_process_vm() nello spazio kernel, quindi
ptrace_scope non si applica. Lo strumento non necessita di sudo, nulla deve agganciarsi
al gioco, e yama non deve essere allentato per l'intero sistema./proc/bus/input/devices per qualsiasi cosa
voglia guardare. Con il modulo non c'è alcun dispositivo aggiuntivo.cd kmod && make
sudo insmod suite_kmod.ko
Un modulo deve essere compilato con lo stesso compilatore del kernel in cui viene caricato. Il Makefile lo legge dalla configurazione del kernel stesso e imposta autonomamente la toolchain, quindi un semplice make è corretto sia su un kernel GCC che su uno clang:
kernel 7.1.2-3-cachyos
toolchain clang (LLVM=1)
Sovrascrivi con make LLVM=0 o make LLVM=1 se dovesse mai indovinare male. Se gli header del kernel sono mancanti lo segnala e stampa il comando di installazione per la tua distribuzione.
Con Secure Boot abilitato un modulo non firmato non verrà caricato: firmalo, disabilita Secure Boot, oppure semplicemente salta il modulo.
Caricalo prima di avviare lo strumento; il backend viene scelto una sola volta, all'avvio.
Conferma quale backend è attivo nel menu, oppure nel log:
[mem] kernel backend: /dev/suite_kmod
[vmouse] kernel injection into the real pointer
Scarica con sudo rmmod suite_kmod.
Imposta prima il gioco in modalità Finestra. In modalità Schermo intero il gioco possiede il display in modo esclusivo e nulla può essere disegnato sopra di esso, quindi l'overlay sarà in esecuzione correttamente e sarà comunque invisibile.
L'overlay individua la finestra del gioco e ne replica posizione e dimensioni, ricontrollando man mano, così segue la finestra se la sposti o la ridimensioni, e si adatta a qualsiasi risoluzione.
./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
Avvialo quando vuoi, anche dal menu. Risolve di nuovo i suoi oggetti quando una partita inizia o finisce, quindi non serve riavviarlo tra un round e l'altro.
All'avvio chiede anche a GitHub se è disponibile una versione più recente e, se c'è, lo segnala, con un link. Non scarica né modifica mai nulla, e lo strumento non attende la risposta.
| Tasto | Azione |
|---|---|
INSERT | Attiva/disattiva il menu delle impostazioni. Mentre è aperto, l'overlay riceve i clic del mouse; mentre è chiuso, i clic passano al gioco. |
HOME | Attiva/disattiva l'aim assist. |
PAGE DOWN | Contrassegna il momento in vis.log, per un verdetto di visibilità che è sembrato sbagliato. |
End | Esce, con l'overlay in primo piano. Funziona anche Ctrl-C nel terminale. |
Le impostazioni vengono modificate nel menu e scritte in settings.cfg pochi secondi
dopo che smettono di cambiare, oltre che all'uscita, quindi un crash o un kill non
costa nulla. Il file viene sostituito per intero anziché riscritto sul posto, e
il contenuto precedente viene conservato una volta come settings.cfg.bak.
Riquadri, scheletri, nomi, barre della salute, distanza e snapline. I colori delle squadre distinguono le fazioni, e un cursore di opacità generale governa tutto ciò che viene disegnato.
Lo scheletro è composto dalla gerarchia di ossa della mesh stessa, quindi segue l'animazione anziché approssimarla da una capsula.