
Linux向けの外部読み取り専用ゲームオーバーレイ。派生オフセット、合成スケルトン、ptrace非依存のメモリ読み取りとポインターレベル入力のためのオプションのカーネルモジュールを備えています。
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
そのうち2点は、厄介なケースであるため特筆に値します:
これは開発マシンであるため、実際に検証済みの唯一の構成です。他のディストリビューション、 デスクトップ環境、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 タブのスイッチで、それでも表示させることができます。ソナーと画面外ピンは決して表示せず、エイムアシストとトリガーボットも、Aim タブで別段の指定がない限り観戦者を対象外とします。
背後、側方、または画面の端の外にいるプレイヤーには、ウィンドウの縁に沿ってスクワッドの色のピンが表示され、その方向を指します。前方にいる場合は、ESP のボックスやラインと同じ投影を通じて、プレイヤーがビュー上に投影される正確な位置をピンが指します。背後にいる場合は方位に基づくため、真後ろにいるプレイヤーは真下に表示され、ピンは静止したままです。各ピンにはプレイヤーのクラス(L、M、H)が表示され、背面には体力を示す帯、その背後に距離、そして自分より 1 フロア以上上または下にいる場合は小さな上向き/下向きマーカーが付きます。遠くのピンは小さく、より薄く表示されます。
クロスヘアからスナップラインを描画している場合(ESP タブの Snaplines の隣のスイッチ)、各ピンはそれぞれのプレイヤーのライン上に配置されます。ほぼ同じ方向にいるプレイヤー同士は、ピンも距離も重ならないよう、ちょうど必要な分だけピンがずらされます。
リング半径は最大値では、ピンがウィンドウの境界に沿って並びます。値を下げると、ピンはクロスヘアを囲むリング上に配置され、画面の端と交差する箇所では端に沿って平らになります。
一定距離以内に入ると、ピンはネオングリーンで点滅し、プレイヤーが近づくほど速くなりますが、縁はスクワッドの色を保ちます。半径、サイズ、範囲、不透明度、点滅距離、および点滅の最遅・最速レートはすべてメニューの Off-screen タブにあります。不透明度は点滅やテキストを含むインジケーター全体の濃さを設定し、Far opacity は最も遠いピンがそのうちどれだけを保つかを設定します。
独自のウィンドウに表示されるレーダーなので、視界に重ねるのではなく、ゲームの横やセカンドスクリーンに置くことができます。レーダーはあなたと一緒に回転します。上方向は常にあなたが向いている方向であり、中心のマーカーがあなたです。
メニューに専用のタブがあります。
選択したマウスボタンを押している間、ターゲットに向かって引っ張ります。
射撃が当たる場合に発砲します。クロスヘアは点ではなく方向であるため、テストはゲーム自体が実行するものと同じです。カメラからクロスヘアを通る線を、プレイヤーの体に対して判定します。