tlg_pc/README.md

The Last Guardian — port nativo para PC

English below · Download · YouTube · Discord

The Last Guardian (PS4, CUSA03627, update 01.03) rodando no PC com imagem, som, controle e saves, a 30 FPS estáveis e sem emulador de CPU. O código original do jogo roda nativo no processador. O sistema do PS4 é reimplementado, e a GPU é traduzida para Vulkan.

Nenhum arquivo do jogo vem com este projeto. Para jogar, você precisa da sua própria cópia, tirada do seu PS4.

Por HayatoG · YouTube @hayatog-dev · Discord discord.gg/UMkdMYZh9g

_{Capturas na resolução nativa (1920×1080), direto da GPU, no Linux com uma RTX 2060.}

Status

Área	Estado
Boot, menu, intro e gameplay	✅ Funciona; sessões de 10+ minutos sem falhas
Imagem	✅ Nativa, 1080p, sem tremores
Áudio	✅ Com o libSceNgs2.sprx do firmware do seu console
Controle	✅ DualSense, DualShock 4, Xbox e 8BitDo via SDL3, com hot-plug
Saves	✅ Autosave e Continuar
Desempenho	✅ 30 FPS travados, como no PS4 (60 FPS: #5)
Linux	✅ Testado (Nobara/Fedora 44)
Windows	🧪 Build automático, ainda sem teste em jogo
macOS (Apple Silicon)	📋 Planejado (#1)

_{FPS, pior quadro e draws por quadro a cada 5 s, tirados do log do port (TLG_FRAME_STATS=1). Gerado por scripts/session_chart.py.}

Download

O build nightly é gerado pelo GitHub Actions a cada mudança e substitui o anterior:

• Linux x86-64 (glibc 2.39+: Ubuntu 24.04, Fedora 40, SteamOS 3.6 ou mais novos): tlg-linux-x86_64.tar.gz
• Windows 10/11 64 bits: tlg-windows-x86_64.zip

O que você precisa

Item	Onde conseguir
Pasta do jogo CUSA03627 + update 01.03: eboot.bin (do 1.03), sce_module/, sce_sys/ e os quatro trico_*.psarc	Dump do seu PS4 desbloqueado (GoldHEN). Arquivos acima de 4 GiB precisam vir por USB (Itemzflow), porque o FTP do GoldHEN 2.2 os trunca
libSceNgs2.sprx (opcional, para ter som)	Firmware do seu PS4, em /system/common/lib/
PC	Placa de vídeo com Vulkan 1.3 (6 GB de VRAM recomendados) e ~25 GB livres

Como jogar

1. Extraia o pacote e coloque o libSceNgs2.sprx na pasta system_lib/.
2. Abra o The Last Guardian, escolha a pasta do jogo e o idioma (inglês, português, espanhol ou francês) e clique em Jogar.
3. No jogo, F10 liga o contador de FPS, e Insert (ou R3 + L2 no controle) abre o menu do port.

O passo a passo completo, com os problemas mais comuns, está em README-player.md, que também vem dentro do pacote.

Compilar do código-fonte

git clone --recursive https://github.com/HayatoG/tlg_pc.git && cd tlg_pc
cd port && TLG_LTO=OFF bash build.sh   # Linux: SDL3, Vulkan, FFmpeg, Boost, fmt, Zydis, glslang
cd .. && ./tlg_launcher.sh             # ou ./run_tlg.sh pelo terminal

No Windows, o build roda no MSYS2 CLANG64 (port/packaging/windows/README.md). O workflow .github/workflows/build.yml mostra o processo completo nas duas plataformas.

Como funciona

Camada	O que faz	Base
Loader	Carrega o eboot.bin 1.03 e liga os módulos do jogo (libc.prx, libSceFios2.prx) e o libSceNgs2.sprx do console	bloodborne_pc, gow3_pc
Runtime	Reimplementa as bibliotecas do PS4: kernel, threads, arquivos, controle, áudio, saves	gow3_pc + 54 funções novas para o TLG
Vídeo	Traduz os comandos Gnm e os shaders GCN para Vulkan/SPIR-V	núcleo de vídeo do shadPS4

Os detalhes técnicos (achados no Ghidra, bugs resolvidos, opções TLG_*) estão em docs/TECNICO.md. O histórico do que foi feito e do que falta está em docs/PROGRESSO.md.

Próximos passos

Roadmap gráfico (#7): pós-processamento (#2), 60 FPS (#5), efeitos do jogo (#3), resolução interna (#4) e FSR/DLSS (#6). Também estão nas issues o macOS (#1) e as correções que forem aparecendo.

Créditos e aviso legal

Base de código: gow3_pc (FelipePrado0), bloodborne_pc e shadPS4, todos GPL-2.0, assim como este projeto (LICENSE). Áudio ATRAC9 via LibAtrac9.

Este projeto não tem vínculo com a Sony Interactive Entertainment, a SIE Japan Studio ou a genDESIGN. The Last Guardian é marca da Sony Interactive Entertainment. Nenhum código, arquivo ou arte do jogo é distribuído aqui. O ícone é uma arte original do projeto.

---

The Last Guardian — native PC port

The Last Guardian (PS4, CUSA03627, update 01.03) running on PC with graphics, audio, controller and saves, at a steady 30 FPS and without a CPU emulator. The game's original code runs natively on the processor. The PS4 system is reimplemented, and the GPU is translated to Vulkan.

No game files come with this project. To play, you need your own copy, dumped from your own PS4.

By HayatoG · YouTube @hayatog-dev · Discord discord.gg/UMkdMYZh9g

The screenshots and the performance chart are at the top of this page.

Status

Area	State
Boot, menu, intro and gameplay	✅ Works; 10+ minute sessions without failures
Graphics	✅ Native 1080p, no shimmering
Audio	✅ With libSceNgs2.sprx from your console's firmware
Controller	✅ DualSense, DualShock 4, Xbox and 8BitDo via SDL3, with hot-plug
Saves	✅ Autosave and Continue
Performance	✅ Locked 30 FPS, as on PS4 (60 FPS: #5)
Linux	✅ Tested (Nobara/Fedora 44)
Windows	🧪 Automatic build, not yet tested in game
macOS (Apple Silicon)	📋 Planned (#1)

Download

The nightly build is produced by GitHub Actions on every change and replaces the previous one:

• Linux x86-64 (glibc 2.39+: Ubuntu 24.04, Fedora 40, SteamOS 3.6 or newer): tlg-linux-x86_64.tar.gz
• Windows 10/11 64-bit: tlg-windows-x86_64.zip

What you need

Item	Where to get it
Game folder CUSA03627 + update 01.03: eboot.bin (from 1.03), sce_module/, sce_sys/ and the four trico_*.psarc	A dump from your own jailbroken PS4 (GoldHEN). Files larger than 4 GiB must be copied over USB (Itemzflow), because GoldHEN 2.2's FTP truncates them
libSceNgs2.sprx (optional, for audio)	Your PS4 firmware, in /system/common/lib/
PC	A graphics card with Vulkan 1.3 (6 GB of VRAM recommended) and ~25 GB free

How to play

1. Extract the package and put libSceNgs2.sprx in the system_lib/ folder.
2. Open The Last Guardian, pick the game folder and the language (English, Portuguese, Spanish or French), and click Play.
3. In game, F10 toggles the FPS counter, and Insert (or R3 + L2 on a controller) opens the port's menu.

The full guide, with common problems, is in README-player.md, which also ships inside the package.

Building from source

git clone --recursive https://github.com/HayatoG/tlg_pc.git && cd tlg_pc
cd port && TLG_LTO=OFF bash build.sh   # Linux: SDL3, Vulkan, FFmpeg, Boost, fmt, Zydis, glslang
cd .. && ./tlg_launcher.sh             # or ./run_tlg.sh from a terminal

On Windows, the build runs in MSYS2 CLANG64 (port/packaging/windows/README.md). The workflow .github/workflows/build.yml shows the full process on both platforms.

How it works

Layer	What it does	Based on
Loader	Loads eboot.bin 1.03 and links the game's modules (libc.prx, libSceFios2.prx) and the console's libSceNgs2.sprx	bloodborne_pc, gow3_pc
Runtime	Reimplements the PS4 libraries: kernel, threads, files, controller, audio, saves	gow3_pc + 54 new functions for TLG
Video	Translates Gnm commands and GCN shaders to Vulkan/SPIR-V	shadPS4 video core

Technical notes (Ghidra findings, fixed bugs, TLG_* options) are in docs/TECNICO.md, in Portuguese. The history of what was done and what is left is in docs/PROGRESSO.md.

Next steps

Graphics roadmap (#7): post-processing (#2), 60 FPS (#5), game effects (#3), internal resolution (#4) and FSR/DLSS (#6). macOS (#1) and new fixes are tracked in the issues as well.

Credits and legal notice

Code base: gow3_pc (FelipePrado0), bloodborne_pc and shadPS4, all GPL-2.0, as is this project (LICENSE). ATRAC9 audio via LibAtrac9.

This project is not affiliated with Sony Interactive Entertainment, SIE Japan Studio or genDESIGN. The Last Guardian is a trademark of Sony Interactive Entertainment. No game code, files or art are distributed here. The icon is original artwork made for this project.