
Overlay de jeu externe en lecture seule pour Linux. Décalages dérivés, squelettes composés, module noyau optionnel pour des lectures mémoire indépendantes de ptrace et une entrée au niveau des pointeurs.
Une superposition externe pour THE FINALS sous Linux.
Il lit la mémoire du jeu depuis un processus séparé, dessine une fenêtre transparente cliquable à travers au-dessus de celui-ci, et fournit une assistance à la visée et un triggerbot. Rien n'est injecté dans le jeu et rien n'est jamais réécrit ; l'outil lit la mémoire et déplace la souris, et c'est tout.
Construit de zéro sous Linux : chaque offset de jeu dans ce dépôt a été dérivé en observant le processus en cours d'exécution, et non copié depuis un dump de SDK publié.
https://github.com/user-attachments/assets/858e94f2-762b-4c26-877f-bb490e66e42b
third_party/ ; rien à installerArch / 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
Les anciennes versions empaquettent une raylib trop ancienne pour être compilée ; compilez-la depuis les sources si pkg-config signale une version inférieure à 5.0.
REQUIREMENTS.md couvre le reste : la compilation de raylib depuis les sources, les en-têtes du noyau pour le module, Secure Boot, ptrace_scope, et comment vérifier une installation fonctionnelle.
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
Deux éléments méritent d'être signalés, car ce sont les cas délicats :
Il s'agit de la machine de développement, c'est donc la seule configuration réellement vérifiée. Les autres distributions, environnements de bureau et noyaux compilés avec GCC sont censés fonctionner mais ne sont pas testés.
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
Le binaire est écrit dans build/TheFinals.
CMake stocke le chemin absolu de la source dans son cache, donc un répertoire de build
déplacé ou renommé cesse de fonctionner. build.sh le détecte et
se reconfigure de lui-même, donc déplacer le projet n'est pas quelque chose auquel vous devez
penser.
kmod/ compile un petit module qui rend l'outil nettement plus silencieux sur le
système. Il est entièrement optionnel : sans lui, tout fonctionne toujours, en utilisant les
solutions de repli en espace utilisateur mentionnées ci-dessous.
access_process_vm() dans l'espace noyau, donc
ptrace_scope ne s'applique pas. L'outil n'a pas besoin de sudo, rien ne doit s'attacher
au jeu, et yama n'a pas besoin d'être assoupli pour l'ensemble du système./proc/bus/input/devices pour tout ce
qui souhaite le voir. Avec le module, il n'y a aucun périphérique supplémentaire du tout.cd kmod && make
sudo insmod suite_kmod.ko
Un module doit être compilé avec le même compilateur que le noyau dans lequel il est chargé. Le Makefile lit cela depuis la configuration propre du noyau et définit lui-même la chaîne d'outils, de sorte que make seul est correct aussi bien sur un noyau GCC que sur un noyau clang :
kernel 7.1.2-3-cachyos
toolchain clang (LLVM=1)
Remplacez avec make LLVM=0 ou make LLVM=1 s'il devine mal. Si les
en-têtes du noyau sont manquants, il le signale et affiche la commande d'installation pour votre
distribution.
Avec Secure Boot activé, un module non signé ne se chargera pas : signez-le, désactivez Secure Boot, ou ignorez simplement le module.
Chargez-le avant de démarrer l'outil ; le backend est choisi une seule fois, au démarrage.
Confirmez quel backend est actif dans le menu, ou dans le journal :
[mem] kernel backend: /dev/suite_kmod
[vmouse] kernel injection into the real pointer
Déchargez avec sudo rmmod suite_kmod.
Réglez d'abord le jeu en mode Fenêtré. En Plein écran, le jeu possède l'affichage de manière exclusive et rien ne peut être dessiné par-dessus, donc l'overlay fonctionnera correctement tout en restant invisible.
L'overlay trouve la fenêtre du jeu et fait correspondre sa position et sa taille, en revérifiant au fur et à mesure, de sorte qu'il suit la fenêtre si vous la déplacez ou la redimensionnez, et s'adapte à toute résolution.
./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
Lancez-le quand vous voulez, y compris depuis le menu. Il résout à nouveau ses objets lorsqu'un match commence ou se termine, il n'a donc pas besoin d'être redémarré entre les manches.
Au démarrage, il demande aussi à GitHub si une version plus récente est disponible, et s'il y en a une, il l'indique, avec un lien. Il ne télécharge ni ne modifie jamais rien, et l'outil n'attend pas la réponse.
| Touche | Action |
|---|---|
INSERT | Affiche ou masque le menu des paramètres. Lorsqu'il est ouvert, l'overlay capte les clics de souris ; lorsqu'il est fermé, les clics passent au jeu. |
HOME | Active ou désactive l'aide à la visée. |
PAGE DOWN | Marque l'instant dans vis.log, pour un verdict de visibilité qui semblait erroné. |
End | Quitte, avec l'overlay au premier plan. Ctrl-C dans le terminal fonctionne aussi. |
Les paramètres sont modifiés dans le menu et écrits dans settings.cfg quelques secondes
après qu'ils ont cessé de changer, ainsi qu'à la fermeture, de sorte qu'un plantage ou un kill ne coûte
rien. Le fichier est remplacé en entier plutôt que réécrit sur place, et le
contenu précédent est conservé une fois sous settings.cfg.bak.
Boîtes, squelettes, noms, barres de vie, distance et lignes de repère. Les couleurs d'escouade distinguent les équipes, et un curseur d'opacité globale régit tout ce qui est dessiné.
Le squelette est composé à partir de la hiérarchie d'os du maillage lui-même, il suit donc l'animation plutôt que de l'approximer à partir d'une capsule.