# FFBE Memorial — English Patch

A community-built English patch for **Final Fantasy Brave Exvius Memorial Edition** (JP offline re-release), bringing the Global version's English translations to the preserved offline JP Memorial APK.

This patch includes:
- English UI (all menu text, buttons, system messages)
- English unit names, abilities, items, equipment, and descriptions
- English battle script dialog (Seasons 1–6, ~4,500 scenes)
- English story CPKs where available (Season 2 Ch 1–5)
- Custom CDN downloader that fetches ~6 GB of game assets from a community-hosted server (replaces Google Play Asset Delivery, which is no longer accessible)

## Requirements

- Android device (ARM64 or ARM, Android 5.0+)
- ~7 GB free storage
- Internet connection for first-run asset download
- USB debugging enabled on your phone (Settings → About phone → tap Build number 7 times, then Settings → System → Developer options → USB debugging)
- USB cable

## Installation (Windows)

1. **Connect your phone via USB** and accept the "Allow USB debugging" prompt
2. **Double-click `install.bat`**
3. Wait for "Success"
4. **Launch "FFBE" from your app drawer**
5. Accept the TOS (you may need to scroll to the bottom of the terms first)
6. Tap the download button — the game will fetch ~6 GB in the background (takes 15–60 minutes depending on your connection)
7. Play!

## Manual install (any OS)

If the script doesn't work, run this command with `adb` on your PATH:

```
adb install -r FFBE-Memorial-EN.apk
```

## Uninstall

Just remove the **FFBE** app from Android like any other. The 6 GB of downloaded assets are stored under
`/sdcard/Android/data/com.square_enix.ffbejpn/files/assetpacks/` and will be cleaned up automatically.

## Known Issues

- Story cutscene dialog is still in Japanese for Seasons 3+, and Season 1/2 intros. Only the translated CPKs are in English.
- 4 sprite-atlas UI elements still have Japanese text baked into the graphics (`common.png`, `footer.png`, etc.) — the buttons work, just the labels are Japanese.
- Season 7 is JP-only content that wasn't released in Global, so it's still in Japanese.

## Credits

- FFBE was made by Alim / Square Enix / gumi
- Memorial offline edition by Square Enix (JP only)
- Preservation, translation, and patching work by the community

This patch is non-commercial and intended solely for preservation of the original story experience after the game's end-of-service. No copyrighted Square Enix content is redistributed with this patch — the APK is modified from the publicly released Memorial edition, and game assets are the player's own property.

## Troubleshooting

**"App not installed" error:** Your phone may have an older version from a different signature. Uninstall any existing "FFBE" app first, then retry.

**Download fails partway:** Force-quit the app (don't uninstall) and relaunch. It will resume from where it stopped.

**"An error occurred during data loading" on every start:** Something in the CDN is unreachable. Check your internet and retry.

**Still not working?** Run `adb logcat | findstr FFBE-EN` to see download errors, or check the GitHub issue tracker.
