PS5 Jailbreak Lua Save File Update Script

This tool automates the process of updating the Lua save files on your jailbroken PlayStation 5. It is designed to assist users who utilize the etaHEN exploit and want to switch or update their Lua loaders safely via FTP.

⚠️ WARNING
This script modifies files on your PS5's internal storage. Misuse may result in data loss or corruption of your exploit environment. BACK UP YOUR FILES before using this tool.
Use at your own risk.

⚠️ Project Status

This project is currently unfinished and partially working.

While most automation steps work correctly — including connecting to the PS5, navigating the filesystem, and identifying the correct save data folder — the final step of replacing the save files is not yet functional. The destination folder appears to be temporarily read-only, and reliable overwriting of the files has not been achieved at this point.

The actual goal would be to move the previously uploaded lua files from the /data/lua-tmp folder into the /mnt/pfs folder without having to upload them at the time the folder becomes writable - which is impossible due to the long upload time.

If you want to contribute, troubleshoot, or just experiment, feel free to fork and test things out. Any fixes or insights are welcome!

---

⚙️ Features

• Ensures you've acknowledged the risks and confirmed backups.
• Automatically checks for and installs lftp if missing.
• Validates PS5 IP address and FTP port input.
• Lets you choose between two popular Lua loaders:
  • itsPLK/ps5_lua_loader (Recommended)
  • shahrilnet/remote_lua_loader
• Establishes FTP connection to your PS5 and uploads the loader files.
• Monitors /mnt/pfs for a savedata directory.
• Automatically detects when it's writable and uploads the updated Lua files.

---

🧰 Prerequisites

• A jailbroken PS5 with FTP access enabled (e.g., via etaHEN).
• Git installed (for cloning the loader).
• PowerShell (comes with Windows).
• Internet connection (to fetch lftp and loader).

---

🚀 Usage

1. Download or clone this repository.
2. Run the script: Double-click ps5_loader_update.bat or execute from command line.
3. Follow the prompts:
   • Confirm backup and accept the disclaimer.
   • Input your PS5's IP address and FTP port (default is 1337).
   • Choose which Lua loader to use.
4. The script will:
   • Connect to your PS5.
   • Reset /data/lua-tmp and upload the loader.
   • Detect the active savedata folder.
   • Wait for it to become writable.
   • Upload the necessary Lua files.

---

🧪 Tested On

• Windows 11
• etaHEN-enabled PS5
• PowerShell 5+

---

❗ Disclaimer

This tool is intended for educational and development purposes only.
Neither the creator nor contributors are responsible for any damage or misuse.

---

📄 License

This project is released under the MIT License.