The Memoria engine is an open-source community rewrite of Final Fantasy IX's engine that aims to add features, fix bugs and expand modding possibilities. It includes built-in improvements (QoL, camera, framerate, audio, controller, UI, options, cheats, shaders...), bugfixes, a mod manager/downloader and a model viewer. More info here

Overview video by snouz

Note: This is not affiliated with the Memoria Project, a 2023 Proof-of-concept tribute render in Unreal Engine

Features

• Main features:
  • Easy to use, everything optional, main settings in the launcher, the rest in Memoria.ini
  • Mod Manager/downloader, using individual mod folders
  • Widescreen (for all resolutions)
  • Higher framerate (60fps+)
  • Smooth and stabilized camera movement
  • Improved rendering: Anti-aliasing, texture filtering, layer edges, shaders
  • Triple Triad / Tetra Triad option
  • Better sound engine, volume control
  • Many, many bugfixes
• UI
  • Font change (includes the original PSX font)
  • Battle speed change & Swirl skip
  • Turn-based mode / Simultaneous mode
  • Controller support with full analog movement
  • Battle UI layouts (includes original PSX layout)
  • More items displayed at once
  • PSX disc change screens
  • Model Viewer
• Modding support for:
  • UI, backgrounds, shaders, texture, FMV modding/upscale (e.g. Moguri)
  • Voice acting (e.g. WIP project ECHO-S)
  • Translations
  • Expanded features for mods
  • Moddable game data (StreamingAssets\Data) and abilities (StreamingAssets\Scripts)
  • More character playable mods (e.g. Playable character pack, Tantalus...)
  • Import/export text/audio/textures
• Optional Cheats:
  • Stealing 100% success
  • Enable/Disable vanilla cheats
  • Easy minigames (rope, frogs, racing...)
  • Excalibur II time limit removal
  • Cards: lower randomness, card limit raised, auto discard cards
  • Manual Trance

Install

• Latest stable release
• Latest canary release

Windows

• Download Memoria.Patcher.exe from which ever release channel you prefer
• Copy the file inside your game directory (next to FF9_Launcher.exe )
• Double click Memoria.Patcher.exe
• Launch the game and enjoy

Linux

PLEASE NOTE:

If you prefer to use an automated approach, MateriaForge provides an easy way to install and run Memoria. See https://github.com/dotaxis/MateriaForge-rs

• Download Memoria.Patcher-linux-x64 from which ever release channel you prefer
• Copy the file inside your game directory (next to FF9_Launcher.exe )
• Open a terminal session in your game path ( or cd to its path )
• chmod +x Memoria.Patcher-linux-x64 && ./Memoria.Patcher-linux-x64
• Launch the game and enjoy

MacOS

PLEASE NOTE:

If you prefer to use an automated approach, SummonKit provides an easy way to install and run Memoria. See https://github.com/julianxhokaxhiu/SummonKit

• Download Memoria.Patcher-osx-x64 from which ever release channel you prefer
• Copy the file inside your game directory (next to FF9_Launcher.exe )
• Open a terminal session in your game path ( or cd to its path )
• chmod +x Memoria.Patcher-osx-x64 && ./Memoria.Patcher-osx-x64
• Launch the game and enjoy

Update

• Memoria: Use the same steps described in Install.
• Mods: The Mod Manager will show a yellow dot if some of your mods are not up-to-date

Documentation

• Info for developers
• Knowledge base
• Memoria.ini
• Most crucial options and cheats are embedded in the game launcher
• More in-depth configuration is available in the file Memoria.ini (in the game folder)

Automated launch (Windows / Steam)

PowerShell examples (adjust the Steam path if needed):

• Battle: & "C:\Program Files (x86)\Steam\steam.exe" -applaunch 377840 -memoria-battle 336
• Model viewer: & "C:\Program Files (x86)\Steam\steam.exe" -applaunch 377840 -memoria-model-viewer
• Field creator: & "C:\Program Files (x86)\Steam\steam.exe" -applaunch 377840 -memoria-field-creator
• Continue from autosave: & "C:\Program Files (x86)\Steam\steam.exe" -applaunch 377840 -memoria-autoload

-memoria-autoload automatically loads the autosave and resumes the saved game without selecting Continue in the title menu. If the autosave cannot be loaded, the game logs the error and exits.

Battle launch always loads characters and the party from the autosave before entering the selected battle. Use -memoria-party 0,1,3 to override the saved party after loading. If the autosave cannot be loaded, the game logs the error and exits. -memoria-party and -memoria-seed are optional battle launch parameters and can only be used with -memoria-battle. Launching a battle requires neither parameter. If several startup modes are supplied, model viewer takes priority, followed by field creator, battle, and standalone autoload.

Third-party software

See THIRD-PARTY-NOTICES.md for third-party software and license information.

🚀 Build

Visual Studio

0. Download the the latest Visual Studio Community installer
1. Run the installer and import this .vsconfig file in the installer to pick the required components to build this project
2. Install the game ( Steam or GOG, whichever you prefer )
3. Open the file Memoria.sln in Visual Studio and click the build button
4. Click on Start to launch the Memoria.Launcher in the game directory

FF9SpecialEffectPlugin

Run from the repository root:

• Deploy locally: dotnet build FF9SpecialEffectPlugin/FF9SpecialEffectPlugin.csproj -c Release /p:DeploySpecialEffectPlugin=true
• Build a local patcher with the plugin (Visual Studio Developer PowerShell): msbuild Memoria.Patcher/Memoria.Patcher.csproj /restore /p:Configuration=Release /p:IncludeSpecialEffectPlugin=true

Both flags are off by default. To specify the game directory, add /p:MemoriaGamePath="<game root>" to the deployment command.

Call tracing

Build and deploy with -c Debug, then place FF9SpecialEffectPlugin.trace.json beside the DLL in <game root>/x64/FF9_Data/Plugins/. Tracing is disabled in Release.

All functions:

{
  "enabled": true,
  "log": "FF9SpecialEffectPlugin.trace.log",
  "functions": ["*"],
  "cap": {
    "perFunction": 0,
    "total": 0
  }
}

Tracing all functions generates hundreds of megabytes of logs within a few seconds.

Selected functions:

{
  "enabled": true,
  "log": "FF9SpecialEffectPlugin.trace.log",
  "functions": ["HostCallbackSend", "PsxClearOTagR"]
}

Relative log paths resolve from the configuration file's directory.