{"id":50360743,"url":"https://github.com/auntiepickle/ff7seventhheavensteamdeck","last_synced_at":"2026-05-30T01:13:55.353Z","repository":{"id":62962657,"uuid":"563131434","full_name":"auntiepickle/ff7seventhheavensteamdeck","owner":"auntiepickle","description":"7th Heaven Steam Deck Install Guide","archived":false,"fork":false,"pushed_at":"2022-12-02T04:43:49.000Z","size":63776,"stargazers_count":13,"open_issues_count":13,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2023-03-23T23:44:42.690Z","etag":null,"topics":["deck","finalfantasyvii","guide","modding-games","steam","steamdeck","steamdeckwindows","tutorial"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/auntiepickle.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-11-08T01:02:40.000Z","updated_at":"2023-03-14T13:46:18.000Z","dependencies_parsed_at":"2023-01-23T21:31:38.095Z","dependency_job_id":null,"html_url":"https://github.com/auntiepickle/ff7seventhheavensteamdeck","commit_stats":null,"previous_names":[],"tags_count":null,"template":null,"template_full_name":null,"purl":"pkg:github/auntiepickle/ff7seventhheavensteamdeck","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/auntiepickle%2Fff7seventhheavensteamdeck","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/auntiepickle%2Fff7seventhheavensteamdeck/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/auntiepickle%2Fff7seventhheavensteamdeck/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/auntiepickle%2Fff7seventhheavensteamdeck/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/auntiepickle","download_url":"https://codeload.github.com/auntiepickle/ff7seventhheavensteamdeck/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/auntiepickle%2Fff7seventhheavensteamdeck/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33676685,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-29T02:00:06.066Z","response_time":107,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["deck","finalfantasyvii","guide","modding-games","steam","steamdeck","steamdeckwindows","tutorial"],"created_at":"2026-05-30T01:13:54.744Z","updated_at":"2026-05-30T01:13:55.345Z","avatar_url":"https://github.com/auntiepickle.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Final Fantasy Seven: 7th Heaven (Steam Deck Install Guide)\n\n![7th Heaven Steam Deck](images/Logo.png)\n\n\nThis guide serves as a walkthrough on how you can get the [7th Heaven mod](https://7thheaven.rocks/) for Final Fantasy 7 up and running on the [Steam Deck](https://store.steampowered.com/steamdeck).\n\n  \n\n[Video Proof](https://youtu.be/quRb4NeWTGs)\n\n*Everything provided here is as is.*\n\nI am not affiliated with any of the related IP. A lot of smart people brought us 7th Heaven and this is just meant to illustrate how to get it working for the Steam Deck and snapshot a config that I know works end to end.\n\n## Requirements\n\nThis guide assumes that you have the Steam version of Final Fantasy 7. It might work for other versions but I am going to assume you have downloaded it through the Steam Store\n\nMake sure you have downloaded/installed the following resources as we will need them later:\n\n- A valid copy of Final Fantasy 7\n\n\t- [Installed from the Steam store](https://store.steampowered.com/app/39140/FINAL_FANTASY_VII/)\n\n- [Bottles](https://usebottles.com/)\n\n  - Discover store \u003e `Bottles`\n\n\t- Alternatively you can type this to install through flatpak\n\n\t-  `flatpak install flathub com.usebottles.bottles`\n\n- [Flatseal](https://flathub.org/apps/details/com.github.tchx84.Flatseal)\n\n\t- Discover Store \u003e `FlatSeal`\n\n\t- Alternatively you can type this to install through flatpak\n\n\t\t-  `flatpak install flathub com.github.tchx84.Flatseal`\n\n- [Full ZIP](https://github.com/auntiepickle/ff7seventhheavensteamdeck/archive/refs/heads/main.zip) (or you can download the components manually)\n\n\t- [7th Heaven mod](https://github.com/tsunamods-codes/7th-Heaven)\n\n\t\t- 7th Heaven GitHub \u003e [Latest Release](https://github.com/tsunamods-codes/7th-Heaven/releases/latest)\n\n\t- [Custom 7th Heaven Recipe](https://github.com/auntiepickle/ff7seventhheavensteamdeck/blob/main/FF7SeventhHeavenSteamDeckResources/ff7heavensd.yml)\n\n- [FFNx Release](https://github.com/julianxhokaxhiu/FFNx/releases)\n\n\t- At the time of writing, I am [using v1.14](https://github.com/julianxhokaxhiu/FFNx/releases/tag/1.14.0)\n\nI personally extract the ZIP to my `~/Downloads` folder, which is how I replicated this process successfully many times so you can avoid a world of pain :)\n\n## Walkthrough\n\nWith all the necessary components installed and downloaded lets begin by getting `Bottles` set up.\n\n### FlatSeal\n\nIn order to give access to your Steam libraries, we need to use `Flatseal` to manage permissions of `Bottles`.\n\n  \n\nUsing `Flatseal`, we can modify the permissions of any `flatpak` installed on our steam deck -- We'll need to modify our `Bottles` permissions in order to get the 7th Heaven installer running properly.\n\n  \n\n- Launch **Flatseal**\n\n- Select **Bottles**\n\n\t- On the left hand side, you will see a list of all flatpaks installed on your system. Scroll through that list until you find `Bottles` and select it.\n\n- Go to **Filesystem**\n\n\t- Scroll through the right-hand list of options until you see the `Filesystem` category.\n\nThis is where we will configure which files and folders `Bottles` has access to.\n\n- Use the **Other Files** toggle\n\n- Expose the following locations:\n\n\t- The location where you downloaded/stored all the config files:\n\n\t\t-  `~/Downloads`\n\n\t- Your Steamapps or Final Fantasy VII install directory:\n\n\t\t-  **Internal memory**: `~/.local/share/Steam/steamapps`\n\n\t\t\t- or\n\n\t\t- SD card: `/run/media/mmcblk0p1/steamapps/`\n\n  \n\n![Flat Seal](images/flatseal.png)\n  \n\n### Getting the right Runners and DLL Components\n\nThere are a bunch of [known issues with the latest versions of proton and 7th Heaven](https://github.com/tsunamods-codes/7th-Heaven/issues/19), hopefully this gets fixed in the future but because there are a host of issues, we need a specific configuration to get this working.\n\n  \n\nOn the Bottles home page, hit the hamburger menu in the top right \u003e Preferences \u003e Runner\n\n ![Custom Runners](images/runners.png) \n\nMake sure you install the following Runners:\n\n- Vaniglia-6.23\n\n- Vaniglia-7.18\n\nNow install the following DLL Components:\n\n- DXVK: dxvk-1.9.4\n\n- VKd3d: vkd3d-proton-2.5 (this is optional if you want to use DX12 but I don't document it)\n\n  \n\n### Making the custom bottle\n\nNow we need to make our own custom bottle where we can host the game with all our mods.\n\nTo do this start by hitting the \"+\" button in the top left to make a new Bottle\n![Custom Bottle](images/CustomRecipe.png)  \n\nName it whatever you want but I like \"FF7SeventhHeaven\"\n\n  \n\n- Select custom in the environment type.\n\n- Runner: soda-7.0.4\n\n- Recipe: Custom Recipe\n\n\t- Point it at your custom recipe file we downloaded earlier ([ff7heavensd.yml](https://github.com/auntiepickle/ff7seventhheavensteamdeck/blob/main/ff7heavensd.yml))\n\n  \n\n(This will take a bit to configure so go get a cup of coffee, browse reddit, take a bio break, w/e...)\n\n![Creating Bottle](images/CreatingBottle.png)    \n\nOnce it is done, go into the preferences tab of the newly created bottle and make sure the following options are set under Settings \u003e Components \n\n- DXVK : dxvk-1.9.4\n\n ![Creating Bottle](images/RunnerComponents.png)  \n\n### Installing 7th Heaven\n\nNext we want to run the installer for 7th Heaven. To do this from within the selected `Bottle` select \"Run Executable\" and point it at the 7th Heaven installer we downloaded earlier\n\n  \n\n![7th Heaven Installer](images/SelectInstaller.png)\n\n  ![Default Installer](images/DefaultInstaller.png)\n\n- Follow the default steps and it should launch!\n\n- The screen will be black, this is OK,\n\n- Close the app\n\n  \n\n*There is an issue where the UI renders black which will become a common theme but we'll solve it later*\n\n### Adding some files and folders\n\nThe next step is to add some files and folders to allow 7th Heaven to work properly when we launch it next.\n\nI will include each step below for completeness but, if you're like me and want a simple copy/paste. Here is a combined version of all the scripts below (modify it for your install paths if they differ)\n\n(There is also a [shell script](https://github.com/auntiepickle/ff7seventhheavensteamdeck/blob/main/FF7SeventhHeavenSteamDeckResources/7thHeavenSDConfig.sh) which you can run if that's easier for you)\n\nIf you do this, feel free to skip to the **Configuring 7th Heaven** section below\n\n```\nln -s ~/.local/share/Steam/steamapps/common/FINAL\\ FANTASY\\ VII ~/.var/app/com.usebottles.bottles/data/bottles/bottles/FF7SeventhHeaven/drive_c/FFVII_STEAM_FOLDER\nprintf 'FF7DISC1' \u003e ~/.var/app/com.usebottles.bottles/data/bottles/bottles/FF7SeventhHeaven/drive_c/.windows-label\nmkdir -p ~/.var/app/com.usebottles.bottles/data/bottles/bottles/FF7SeventhHeaven/drive_c/FFVII_STEAM_FOLDER/mods/{7thHeaven,textures}\ncp -r ~/Downloads/ff7seventhheavensteamdeck-main/FF7SeventhHeavenSteamDeckResources/FFNx-FF7_1998-v1.14.0.0/* ~/.local/share/Steam/steamapps/common/FINAL\\ FANTASY\\ VII\nmkdir ~/.var/app/com.usebottles.bottles/data/bottles/bottles/FF7SeventhHeaven/drive_c/Program\\ Files/7th\\ Heaven/Resources/Game\\ Driver/\ncp -r ~/Downloads/ff7seventhheavensteamdeck-main/FF7SeventhHeavenSteamDeckResources/FFNx-FF7_1998-v1.14.0.0/* ~/.var/app/com.usebottles.bottles/data/bottles/bottles/FF7SeventhHeaven/drive_c/Program\\ Files/7th\\ Heaven/Resources/Game\\ Driver/\n```\n\n  \n\n#### Hardlinking the game\n\nDepending on where you've installed FFVII, the following command will differ....\n\n  \n\n**When using the Steam Deck's internal memory storage**, you will need to type the following:\n\n  \n\n```\nln -s ~/.local/share/Steam/steamapps/common/FINAL\\ FANTASY\\ VII ~/.var/app/com.usebottles.bottles/data/bottles/bottles/FF7SeventhHeaven/drive_c/FFVII_STEAM_FOLDER\n```\n\n  \n\nOtherwise, **if you've installed Final Fantasy VII to an external storage (in this case, the inserted sd card)** the command will look like the following:\n\n  \n\n```\nln -s /run/media/mmcblk0p1/steamapps/common/FINAL\\ FANTASY\\ VII ~/.var/app/com.usebottles.bottles/data/bottles/bottles/FF7SeventhHeaven/drive_c/FFVII_STEAM_FOLDER\n```\n\n  \n\nTo summarize, we are creating a symbolic link between our Final Fantasy VII Common directory and our bottle environment where we will run the executable. This allows us to use our FF7 install folder.\n\n  \n\nNext we need to add a few files and folders to the 7th Heaven Folder to complete the config.\n\n#### Adding a default drive label of `FF7DISC1` to our C Drive\n\nWine requires a .windows-label file to give the drive a permanent label.\n- add `.windows-label` to the root of a shared drive\n  - add `FF7DISC1` to the contents of `.windows-label`  \n\n```\nprintf 'FF7DISC1' \u003e ~/.var/app/com.usebottles.bottles/data/bottles/bottles/FF7SeventhHeaven/drive_c/.windows-label\n```\n\n*This step adds the label \"FF7DISC1\" to your C Drive which avoids the issues where it looks for a disc and cannot find it.*\n\n#### Adding some folders for 7th Heaven\n\n7th Heaven stores some mod files in two different directories we will want to create ahead of time in the root folder of our install.\n- `mods/`\n  - `textures/`\n  - `7thHeaven/`\n\n```\nmkdir -p ~/.var/app/com.usebottles.bottles/data/bottles/bottles/FF7SeventhHeaven/drive_c/FFVII_STEAM_FOLDER/mods/{7thHeaven,textures}\n```\n\n#### Adding FFNx manually\n\nThis step is necessary because FFNx has issues getting its first download in my experience. I have gotten this to eventually download through the Bottle but it's not reliable and we will opt to just copy the files to stream line the configuration.\n- copy the contents of FFNx to:\n  - `FFVII` root folder\n  - New folder called `/Resources/Game Driver/` in 7th Heaven install\n\n  \n\n```\ncp -r ~/Downloads/ff7seventhheavensteamdeck-main/FF7SeventhHeavenSteamDeckResources/FFNx-FF7_1998-v1.14.0.0/* ~/.local/share/Steam/steamapps/common/FINAL\\ FANTASY\\ VII\nmkdir ~/.var/app/com.usebottles.bottles/data/bottles/bottles/FF7SeventhHeaven/drive_c/Program\\ Files/7th\\ Heaven/Resources/Game\\ Driver/\ncp -r ~/Downloads/ff7seventhheavensteamdeck-main/FF7SeventhHeavenSteamDeckResources/FFNx-FF7_1998-v1.14.0.0/* ~/.var/app/com.usebottles.bottles/data/bottles/bottles/FF7SeventhHeaven/drive_c/Program\\ Files/7th\\ Heaven/Resources/Game\\ Driver/\n```\n\nNow it's show time and we can config 7th Heaven!\n\n  \n  \n\n### Configuring 7th Heaven\n\nTo avoid the black screen, before launching 7th Heaven,\n\n![Disable Direct 3D](images/DisableD3D.png)\n\n- Change the DXVK setting to: Disabled\n\n- Launch 7th Heaven\n\n  \n\nThe next step of the installer will ask you about where FF7 is located.\n\n![File Config](images/7thHeavenFileConfig.png)  \n\n- FF7 Exe: My Computer \u003e FF7DISC1 \u003e FFVII_STEAM \u003e ff7_en.exe\n\n\t-  *This will throw an error and make a file called ff7.exe for you and point to it, which is correct*\n\n- Movies: My Computer \u003e FF7DISC1 \u003e FFVII_STEAM \u003e data \u003e movies\n\n- Textures: My Computer \u003e FF7DISC1 \u003e FFVII_STEAM \u003e mods \u003e textures\n\n- Library: My Computer \u003e FF7DISC1 \u003e FFVII_STEAM \u003e mods \u003e 7thHeaven\n\n- Hit **Save** \n\nThen modify the auto disk mount\n\n![Auto Mount Disable](images/automount.png)\n\n- Settings \u003e Game Launcher \u003e Options \u003e **Do not auto mount Disk**\n\n- Hit **Save**\n\nLaunch the game\n\n- Hit the **Play** button.\n\n  \n\nAt this point the game should config a bunch of things, launch, and display a red version of Eidos!\n\n ![Configuring](images/configging.png) \n  \n ![Red EIDOS](images/redEidos.png)\n\nThis means you have successfully enabled everything and can now move on to enabling some mods.\n\n  \n\nQuit the game by hitting the stop button in Bottles, or exiting out of the windows.\n\n  \n![Stop Button](images/StopButton.png)\n\nNow to test out some mods...\n\n  \n\n### Installing mods\n\n- Change the launcher to **Vaniglia-7.18**\n\n- Launch 7th Heaven\n\n\t- nothing should happen as it will silently crash (this was the only way I could get the runner we need to work working, odd workaround I know...)\n\n- Change the runner to be \"Vaniglia-6.23\" runner\n\n- Ensure \"DXVK\" is set to **disabled**\n\n- Reboot `Bottles`\n\n\nNow we can configure and download some mods!\n\n  \n  \n\n- Launch 7th Heaven\n\n- Install your mods (Browse Catalog tab)\n\n  \n\nI also suggest modifying the Game Driver now so you can get the native experience (optional)\n\n- Settings \u003e Game Driver \u003e Graphics\n\n\t- Resolution: 1920x1080 (or whatever it shows)\n\n\t- Graphics API: DirectX 11\n\n\t- Window Mode: Borderless\n\n\t- Aspect Ratio: 16:9\n\n- Advanced\n\n\t- Show Driver Version: Off\n\n\t- Show Graphics API: Off\n\n- Hit Save\n\n  \n\nWith all that done, we can try to run FF7 with mods by\n\n- Closing 7th Heaven\n\n- Turning on \"Improve Direct3D 9/10/11 Compatibility\"\n\n- Reboot `Bottles`\n\n\t- (I do this just to be safe since sometimes it doesnt always pick up the config changes)\n\n- Launch 7th Heaven\n\n\t- You'll likely notice black UI, thats why we turn this off and a necessary step to repeat as you config stuff and then try to play\n\n- Hit Play\n\nIf things went to plan you should see FF7 loaded with your selected mods\n\n![Modded FF7](images/moddedFF7.png)\n  \n\nWhenever you want to configure your mods, toggle D3D:\n\n- Set DXVK to \"Disabled\",\n\n- Reboot 7th Heaven,\n\n- Configure 7th Heaven\n\n- Quit 7th Heaven\n\n- Set DXVK to \"dxvk-1.9.4\"\n\n- Restart 7th Heaven\n\n- Hit Play\n\n\t-  *(If you don't see the black UI, I found I usually get a subsequent crash which can easily be solved by rebooting `Bottles`)*\n\n  \n\nAnd that's it! Now you can add Bottles to steam and spend the rest of your time in Gaming mode.\n\n  \n\n### Adding Bottles to steam \n\nThe last step in our journey is to add bottles to our known steam apps. This way you can run FF7 from Gaming mode. \n\n\n\nTo add Bottles, we need to add the Seventh Heaven Program manually in our Bottle\n![Add Program](images/addexepath.png)\n\n- Within the \"Programs\" section of our bottles hit the \"+ Add Shortcuts...\" button to add a manual reference to 7th Heaven\n  - If you followed the default config, the path should be:\n\t```\n\t/home/deck/.var/app/com.usebottles.bottles/data/bottles/bottles/FF7SeventhHeaven/drive_c/Program Files/7th Heaven/7th Heaven.exe\n\t```\n- A new entry will be added to your Programs list and we can now simply add a new game to steam\n![Add to Steam](images/CustomSteam.png)\n\n- Hit \"Add a Game\" in the bottom left corner of Steam\n- Add a Non-Steam Game\n- Select Bottles from the add a game list\n- \"Add Selected Programs\"\n- Now modify the Bottles entry\n\t- Right click Bottles in Steam\n\t\t- Properties\n\t\t\t- Rename the shortcut to your liking e.g. \"7th Heaven (FF7)\"\n\t\t\t- Remove the target and Start in fields\n\t\t\t- Add the following to LAUNCH OPTIONS\n  \t\t\t\t```\n\t\t\t\tflatpak run --command=bottles-cli com.usebottles.bottles run -p '7th Heaven' -b 'FF7SeventhHeaven'\n\t\t\t\t```\n\nAnd that's it! Now you can hit play and you should see 7th Heaven running from Steam and in Gaming mode\n\nAlternatively, if you plan to modify the mods inside of gaming mode, you can just add bottles as an entry like so:\n```\nflatpak run com.usebottles.bottles\n```\n\n## Looking for help\n\nI would love any optimizations you figure out after following my guide. I don't claim for this to be perfect but I was able to consistently get 7th Heaven running from scratch by following the instructions in this guide.\n \n\nOverall, I would say this process is really finicky but once I got everything up and running I didn't have anymore issues. I am hopeful with time many bug fixes can be applied in this space to make things a bit more smooth.\n\nI think we could automate the file and config process a bit more with some shell scripts and would be interested to collaborate with anyone who wants to make improvements in this space.\n\n## Common Issues\n\nIf you run into issues along the way I noticed a few things go wrong if I didn't follow the steps to a T, here are some things I found helpful to get things up and running\n\n- Missing DotNet installs. I attempted to do this with Vaniglia as the default runner from the get go but for some reason Bottles does not play nicely with dependencies when not using soda. If you notice there is no Microsoft.Net folder in C:/windows, you likely need to restart the bottle config and make sure you have the right runner selected if you cannot get a clean boot of 7th heaven\n\n- FF7 Crashing before mods are installed. It seems there is something going on with the ffnx files and the updater. You'll notice some errors and in general if I couldnt get a clean run of FF7 it was due to ffnx missing its components. You can check this within 7th Heaven hit the Settings \u003e Game Driver and it should throw an error if it doesn't have FFNx files. This is why I added the steps to manually add FFNx since the downloader causes crashes when it fails and seems flaky","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fauntiepickle%2Fff7seventhheavensteamdeck","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fauntiepickle%2Fff7seventhheavensteamdeck","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fauntiepickle%2Fff7seventhheavensteamdeck/lists"}