# Complete Final Fantasy XI Linux Setup Guide

## Step 1: Download Required Files
1. Download [FFXIFullSetup_US](./FFXIFullSetup_US/?zip)
2. Download [FFXI-UpdatePatch](./FFXI-UpdatePatch/?zip)
3. Download [dotnet-injector](./dotnet-injector/?zip)
4. Download [latest XIloader](https://github.com/LandSandBoat/xiloader/releases)
5. Download [Ashita](https://ashitaxi.com/)

## Step 2: Initial Setup
**IMPORTANT: Run the dotnet injector BEFORE installing FFXI to avoid breaking activation**

1. **Add FFXISetup.exe as non-Steam game:**
   - In Steam → Add Game → Add Non-Steam Game
   - Browse and select `FFXISetup.exe`
   - Properties → Compatibility → Force Proton 9 or 10

2. **Run briefly to generate prefix:**
   - Launch the setup once, then immediately exit
   - This creates the Proton prefix directory

3. **Inject .NET 4.8:**
   - Open the `dotnet-injector` folder
   - Run `dotnet-injector.sh`
   - It will show the Prefix ID - enter it when prompted (You will also need this later)
   - The script will merge .NET 4.8 into your prefix

4. **Now install FFXI:**
   - Run `FFXISetup.exe` from Steam again
   - Complete the full installation process
   - Don't freak out if it's on computing space for a long time, just wait
   
## Step 4: PlayOnline Setup & Update
1. **Locate PlayOnline Viewer:**
   - Navigate to your prefix: `~/.steam/steam/steamapps/compatdata/PREFIX-ID/pfx/drive_c/Program Files/PlayOnline/PlayOnlineViewer/`
   - Find `pol.exe`

2. **Run with ProtonTricks:**
   Right click it and run with `Protontricks Launcher` and select "FFXISetup.exe" when prompted to select a prefix/game
   or run this (paste in your ID):
   ```bash
   protontricks-launch --appid PREFIX-ID ./pol.exe 
   ```

3. **Update Process:**
   - If update available: Next → Update → OK → Next
   - PlayOnline will restart automatically
   - Select "For PlayOnline Members!"
   - Enter `ABCD1234` in both "Member Name" and "PlayOnline ID"
   - Click: Register → Yes → OK → Exit → Yes

## Step 5: File Verification & Patching
1. **Apply update patch:**
   - Extract `FFXI-UpdatePatch.zip` into your FFXI install folder
   - Overwrite files when prompted

2. **Verify files:**
   - Open PlayOnline Viewer again
   - Select "Check Files"
   - **Important:** In dropdown (click PlayOnline Viewer), select "FINAL FANTASY XI"
   - Click "Check Files"
   - When errors found: "File Repair" → "Yes"
   - Complete: OK → Exit Viewer → Yes

*Note: Repeat this file check process after every major client update*

## Step 6: Ashita & XIloader Setup
1. **Place files:**
   - Extract latest XIloader to FFXI install folder
   - Move Ashita to FFXI install folder

2. **Configure Ashita:**
   - Run Ashita using ProtonTricks (same method as PlayOnline)
   - Click "+" bottom left
   - **Boot Tab:**
     - Configuration Name: `The Wired`
     - File: `xiloader.exe`
     - Command: `--server ffxithewired.servegame.com`
   - **Window Tab:**
     - Uncheck "Show Border"
     - Set your resolution
   - **Game Tab:** Configure graphics settings
   - Save configuration

3. **Create account:**
   - Click "Play" next to "The Wired"
   - In xiloader: Press `2` → Enter for "Create New Account"
   - Create username/password
   - FFXI will launch (test then close)

## Step 7: Final Steam Configuration
1. **Update Ashita command:**
   - Edit "The Wired" configuration in Ashita
   - **Boot Tab:** Change Command to:
     ```
     --server ffxithewired.servegame.com --user YOUR_USERNAME --pass YOUR_PASSWORD
     ```
   - Save

2. **Create Steam shortcut:**
   - Right click your already made shortcut to the setup
   - Properties → Paste in the following for the TARGET field:
     ```
     "Ashita.exe" --config="./config/boot/The Wired.xml"
     ```
   - And the following for the START IN field, change the Prefix ID of course:
     ```
     "$HOME/.steam/steam/steamapps/compatdata/PREFIX-ID/pfx/drive_c/Program Files/PlayOnline/SquareEnix/FINAL FANTASY XI/"
     ```
   - Rename to "Final Fantasy XI" or "The Wired"