
Overlay de jogo externo somente leitura para Linux. Offsets derivados, esqueletos compostos, módulo de kernel opcional para leituras de memória independentes de ptrace e entrada em nível de ponteiro.
Um overlay externo para THE FINALS no Linux.
Ele lê a memória do jogo a partir de um processo separado, desenha uma janela transparente click-through por cima dele e fornece um aim assist e um triggerbot. Nada é injetado no jogo e nada é jamais escrito de volta; a ferramenta lê a memória e move o mouse, e é só isso.
Construído do zero no Linux: cada offset de jogo neste repositório foi derivado observando o processo em execução, não copiado de um dump de SDK publicado.
https://github.com/user-attachments/assets/858e94f2-762b-4c26-877f-fb490e66e42b
third_party/; nada a instalarArch / 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
Versões mais antigas empacotam uma raylib demasiado antiga para compilar; compile-a a partir do código-fonte se o pkg-config reportar uma versão inferior a 5.0.
O REQUIREMENTS.md cobre o resto: compilar a raylib a partir do código-fonte, os headers do kernel para o módulo, o Secure Boot, o ptrace_scope e como verificar uma configuração funcional.
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
Duas partes disso merecem destaque, porque são os casos complicados:
Esta é a máquina de desenvolvimento, então é a única configuração realmente verificada. Outras distribuições, desktops e kernels compilados com GCC devem funcionar e não foram testados.
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
O binário é gravado em build/TheFinals.
O CMake armazena o caminho absoluto do código-fonte em seu cache, portanto, um diretório de build
transportado após uma movimentação ou renomeação deixa de funcionar. O build.sh percebe isso e
se reconfigura sozinho, então mover o projeto não é algo com que você precise
se preocupar.
kmod/ compila um pequeno módulo que torna a ferramenta consideravelmente mais silenciosa no
sistema. É totalmente opcional: sem ele, tudo continua funcionando, usando os
fallbacks em espaço de usuário indicados abaixo.
access_process_vm() no espaço do kernel, então
ptrace_scope não se aplica. A ferramenta não precisa de sudo, nada precisa se anexar
ao jogo, e o yama não precisa ser afrouxado para todo o sistema./proc/bus/input/devices para qualquer coisa
que se importe em olhar. Com o módulo, não há nenhum dispositivo extra.cd kmod && make
sudo insmod suite_kmod.ko
Um módulo deve ser compilado com o mesmo compilador do kernel no qual será carregado. O Makefile lê essa informação da própria configuração do kernel e define a toolchain por conta própria, portanto make simples é o correto tanto em um kernel GCC quanto em um kernel clang:
kernel 7.1.2-3-cachyos
toolchain clang (LLVM=1)
Substitua com make LLVM=0 ou make LLVM=1 caso ele faça a escolha errada. Se os
cabeçalhos do kernel estiverem ausentes, ele avisa e imprime o comando de instalação para a sua
distribuição.
Com o Secure Boot habilitado, um módulo não assinado não será carregado: assine-o, desative o Secure Boot, ou simplesmente ignore o módulo.
Carregue-o antes de iniciar a ferramenta; o backend é escolhido uma única vez, na inicialização.
Confirme qual backend está ativo no menu, ou no log:
[mem] kernel backend: /dev/suite_kmod
[vmouse] kernel injection into the real pointer
Descarregue com sudo rmmod suite_kmod.
Defina o jogo para o modo Janela primeiro. Em Ecrã Inteiro, o jogo controla o ecrã por completo e nada pode ser desenhado por cima, pelo que a sobreposição estará a funcionar corretamente e ainda assim ficará invisível.
A sobreposição localiza a janela do jogo e corresponde à sua posição e tamanho, verificando novamente à medida que avança, pelo que segue a janela se a mover ou redimensionar, e adapta-se a qualquer resolução.
./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
Inicie-o quando quiser, inclusive no menu. Ele resolve novamente seus objetos quando uma partida começa ou termina, então não precisa ser reiniciado entre rodadas.
Ao iniciar, ele também pergunta ao GitHub se há uma versão mais recente disponível e, se houver, informa isso, com um link. Ele nunca baixa ou altera nada, e a ferramenta não espera pela resposta.
| Tecla | Ação |
|---|---|
INSERT | Alterna o menu de configurações. Enquanto aberto, a sobreposição recebe cliques do mouse; enquanto fechado, os cliques passam para o jogo. |
HOME | Alterna a assistência de mira. |
PAGE DOWN | Marca o momento em vis.log, para um veredito de visibilidade que pareceu errado. |
End | Encerra, com a sobreposição em foco. Ctrl-C no terminal também funciona. |
As configurações são editadas no menu e gravadas em settings.cfg alguns segundos
depois de pararem de mudar, bem como ao sair, então uma falha ou um encerramento forçado não custa nada.
O arquivo é substituído por inteiro em vez de reescrito no local, e o
conteúdo anterior é mantido uma vez como settings.cfg.bak.
Caixas, esqueletos, nomes, barras de vida, distância e linhas de conexão. As cores do esquadrão distinguem as equipes, e um controle deslizante de opacidade geral governa tudo o que é desenhado.
O esqueleto é composto a partir da própria hierarquia de ossos da malha, então ele segue a animação em vez de aproximar a partir de uma cápsula.