MateriaForge

All-in-one installer for 7th Heaven and Junction VIII on Linux.

MateriaForge is the successor to 7thDeck and 8thDeck, automating the installation and setup of 7th Heaven and Junction VIII on Linux — now wrapped up nicely in a single application!

---

Features

• 7th Heaven installation: downloads, configures, and launches 7th Heaven with no manual setup
• Junction VIII installation: downloads, configures, and launches Junction VIII with no manual setup
• Multi-platform game detection: supports multiple storefronts out of the box
• Written in Rust: fast, reliable, and expandable

---

Supported Mod Loaders

Mod Loader	Game	Steam	GOG (Heroic)	GOG (Lutris)
7th Heaven	Final Fantasy VII (2026)	✅	✅	🔜
	Final Fantasy VII (2013)	✅	➖	➖
Junction VIII	Final Fantasy VIII (2013)	✅	➖	➖

---

Installation

Pre-built binaries are available on the Releases page.

1. Ensure you have installed FF7 or FF8 and clicked "Play" in the game's launcher at least once. You can close the game once you get to the main menu.

2. Download the latest release, unzip, and run it in a terminal:

./MateriaForge

3. On first launch of 7th Heaven or Junction VIII, click Save. Do NOT click Reset Defaults.

---

Options

Flag	Description
-c, --canary	Install pre-release (canary) versions of 7th Heaven and FFNx
-d, --deck	Force detection of Steam Deck for controller config option

---

Configuration (TOML)

MateriaForge generates a MateriaForge.toml file in the 7th Heaven installation folder. This file is created automatically during setup, but you can edit it manually to customize behavior.

Example

app_id = "3837340"
type = "steam"
steam_dir = "/home/user/.steam/root"
runner = "proton_9"
launch_args = "/launch /quit"

[env]
WINEDEBUG = "+err,+warn,+debugstr"
PROTON_LOG = "1"
MANGOHUD = "1"

Keys

Key	Description	Default	Required
type	Game install type: steam or gog	steam	Yes
app_id	The game's app ID (Steam or GOG)	(set during install)	Yes
steam_dir	Path to Steam installation directory	(set during install)	Only for type = "steam"
runner	Proton version override	(none)	No
launch_args	Extra arguments passed to 7th Heaven on launch	(none)	No

Environment Variables

The [env] table lets you set environment variables that are passed to the game runner:

[env]
WINEDEBUG = "+err,+warn,+debugstr"

Any key/value pair under [env] will be set as an environment variable when launching the game. WINEDEBUG is included by default.

Note: CLI arguments passed directly to the launcher take priority over launch_args in the TOML.

---

Building from Source

You'll need a recent stable Rust toolchain.

git clone https://github.com/dotaxis/MateriaForge-rs
cd MateriaForge-rs
make release

The compiled binary will be at target/release/MateriaForge.

---

Related Projects

• 7thDeck — the 7th Heaven Linux installer this project succeeds
• 8thDeck — the Junction VIII Linux installer this project succeeds (coming soon)
• 7th Heaven — the FF7 mod loader MateriaForge installs
• Junction VIII — the FF8 mod loader MateriaForge installs (coming soon)
• Heroic Games Launcher — GOG & Epic launcher for Linux
• lib_game_detector — Rust crate used for detecting installed GOG games
• steamlocate — Rust crate used for parsing Steam libraries

---

Contributing & Support

• Issues and pull requests are welcome. If you run into problems with a specific game version or platform setup, please open an issue with your distro and MateriaForge.log.
• You can find me at the Tsunamods Discord in the #ff7-linux and #ff8-linux channels for quick questions.

---

Donate

☕ You can buy me a coffee on Ko-fi if you appreciate my work!