Skip to content

About

Save tracker, save analyzer and 100% achievement tracker for Final Fantasy Resonance: reads your save file and shows Visions, Espers, Tablet Shards, side quests, chests and achievements, with what's missing and where to find it.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

4 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

FF Resonance Save Tracker

Save tracker, save analyzer and 100 % achievement tracker for Final Fantasy Resonance (PC/Steam).

Load your GameSaveData.sav and the tracker reads your progress straight from the save file. You see what you have and what's still missing for 100 % completion, and where to find each missing piece:

  • Visions and Espers
  • Tablet Shards and Cave Masters
  • Legendary Arms and Adamantite
  • side quests and substories
  • chests and gear
  • all 40 achievements

A chapter-by-chapter story progression with bosses, weaknesses and collectibles comes on top.

It runs entirely in the browser: no install, no account, and the save file never leaves your computer. Available in English and German, using the official in-game names of both languages.

Keywords: Final Fantasy Resonance save analyzer · save viewer · save file reader · achievement tracker · 100 % completion checklist · collectible tracker · Tablet Shard locations · Vision locations

Features

  • Save summary: play time, gil, location, active party, staggers, Resonances, Tablet Shards and overall completion.
  • Everything on one page: the overview shows every category in collapsible sections, with a jump bar and progress counters.
  • Automatic tracking from the save:
    • side quests and substories, including the current stage
    • Visions, telling obtained apart from only discovered
    • Cave Masters, bosses and Esper fights from the bestiary
    • Colosseum battles
    • Tablet Shards collected per area and handed in
    • gear and Legendary Arms
    • chapter progress
    • every achievement that can be derived from these
  • Where to get it: hover any Vision, Esper, item or collectible to see where it's found: chest, shop, side quest reward or pre-order bonus.
  • 100 % focus: entries that count toward achievements are marked and name the exact achievements. A filter hides everything optional.
  • Story progression: areas in order with recommended levels, new party members, bosses with element weaknesses, collectibles and side quests per chapter.
  • Live mode (optional): a small local helper lets the page refresh automatically whenever you save in game.
  • Private by design: the save file is decrypted and parsed entirely in your browser. Nothing is uploaded.

Compared to other tools

The tracker follows the idea of community save analyzers for other games, such as the save completion analysers for Hollow Knight: Silksong: load the save, see your completion. It adds a few things specific to Final Fantasy Resonance:

Typical save viewer FF Resonance Save Tracker
Reads the save file in the browser ✓ ✓ (decrypts the game's AES-encrypted Unreal Engine save)
Collected vs. missing per category ✓ ✓ Visions, Espers, Tablet Shards, Cave Masters, side quests, chests, gear
Where to get missing items rarely ✓ chest, shop, side quest or pre-order source on hover
Achievement progress rarely ✓ all 40, many checked automatically with counters
Marks what matters for 100 % – ✓ entries name the achievements they count toward
Story progression with bosses and weaknesses – ✓
Updates while you play – ✓ optional live mode
Official names in several languages – ✓ English and German from the game's own text tables

It's a read-only tracker, not a save editor: it never modifies your save. To edit saves, use the atma.gg save editor.

Usage

Online

Open the hosted site, click Load save and choose your save file:

%LOCALAPPDATA%\FFRS\Steam\<Steam ID>\GameSaveData0.sav

GameSaveData0.sav is slot 1, GameSaveData1.sav slot 2, and so on. Load the file again after saving in game, or use live mode.

Locally

Clone the repository and open index.html. There is no build step and there are no dependencies.

Live mode

Browsers can't watch files inside %LOCALAPPDATA%, so a small helper serves your newest save locally:

python tools/live.py

Then click Enable live mode below the upload area. The helper listens only on 127.0.0.1:8765, only reads the save folder, and runs on Windows or inside WSL.

Game graphics (optional)

Without game graphics the viewer shows placeholders. To use the original logo, world map, portraits, Vision and Esper sprites and icons, extract them from your own installation. This needs the .NET 10 SDK:

dotnet run --project tools/extractor -c Release -- "X:\SteamLibrary\steamapps\common\FINAL FANTASY RESONANCE\FFRS\Content\Paks" "%TEMP%\ffr-extract"
python tools/import_icons.py "%TEMP%\ffr-extract"

The extractor uses CUE4Parse to unpack the game's IoStore containers and downloads the Oodle library on first run. The game ships without type mappings (.usmap), so texture pixel data is read directly from the package layout. The graphics are written to icons/, which is git-ignored.

Updating game data

Item, Vision, Esper and achievement names, place, boss, quest and skill names, and the side quest table come from the game files. After a game update, regenerate them:

dotnet run --project tools/extractor -c Release -- "<Paks folder>" "%TEMP%\ffr-data" --raw .locres Datatable/Request/
python tools/locres.py names "%TEMP%\ffr-data"
python tools/quests.py "%TEMP%\ffr-data"

Deployment

The site is static. On Vercel, import the repository with the framework preset Other, no build command, and the project root as the output directory. vercel.json sets security headers and caching. GitHub Pages and other static hosts work as well.

Project structure

Path Purpose
index.html Page shell
js/save.js Save decryption, GVAS parser, save summary
js/app.js Views, automatic tracking, tooltips, live mode
js/i18n.js UI texts (EN/DE) and name localization
css/theme.css Styling in the style of the classic Final Fantasy menu windows
data/story.*.js Story progression per language
data/names.js Official in-game names EN/DE (generated)
data/quests.js Side quest counters and stages (generated)
data/catalog.js Character, Vision and item IDs
data/areas.js Map IDs, area names, chest and Tablet Shard locations
tools/extractor/ Texture and raw file exporter (C#, CUE4Parse)
tools/import_icons.py Copies the graphics the viewer uses into icons/
tools/locres.py Reads the game's text tables and writes data/names.js
tools/quests.py Reads the side quest table and writes data/quests.js
tools/live.py Local helper for live mode
tools/ffrs_save.py Dumps a save as JSON for inspection

Save format

GameSaveDataN.sav consists of a 32-byte header (SVHD, container version, SHA-1 of the payload, zero padding), followed by an AES-256-ECB encrypted Unreal Engine 5 GVAS save (/Script/mucha.CPP_MuchaGameSaveData). The format is documented by the atma.gg save editor. This viewer only reads saves and never modifies them.

Contributing

Area names and chest contents are known for the early chapters. Unknown map IDs appear as "Area <ID>". Additions to data/areas.js are welcome.

Credits

Disclaimer

This is a fan project and is not affiliated with or endorsed by Square Enix. FINAL FANTASY is a registered trademark of Square Enix Holdings Co., Ltd. No game assets are included in this repository.

License

MIT

About

Save tracker, save analyzer and 100% achievement tracker for Final Fantasy Resonance: reads your save file and shows Visions, Espers, Tablet Shards, side quests, chests and achievements, with what's missing and where to find it.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages