Client Installation & Updates - CatsAndBoats/catseyexi GitHub Wiki

Installation

The CatsEyeXI client installer is distributed as a single executable file at the following location:

https://www.catseyexi.com/install.

After launching setup, you will be prompted to install several pre-requisites, these are all required for proper operation. The pre-requisites consist of Visual Studio runtimes (required for Final Fantasy XI), .NET 3.1 runtime (required for Launcher) and Git for Windows (the heart of the client).

It is strongly recommended that your installation path does not include any spaces (i.e., Program Files). It is recommended that the user installs the software to the root of an SSD hard drive (i.e., C:, D:, etc.) Following a successful installation, a shortcut to the Launcher will be created on the user’s desktop for ease of access.

Game Launcher

The CatsEyeXI Client is built from the ground up using the Git protocol and broken up into 2 separate repositories:

1.The “main” game installation, located in ‘catseyexi-client’. This covers both Ashita and the sandbox deployment of Final Fantasy XI.

2.The optional “FFXI-HD” repository in ‘catseyexi-client\Ashita\polplugins\DATs\ffxi-hd’, which is downloaded only when checking the HD checkbox.

Automatic Updates

The Launcher checks for application updates each time it is launched, this is different from game updates, and the update mechanism is different as well. While the game updates are handled via Git, the Launcher checks a predefined CSV/TXT file stored on the CatsEyeXI server which will contain the latest version number, and the URL of the patch file. Text file location: http://www.catseyexi.com/launcher_version.txt If the Launcher application’s current version is lower than the version advertised in the above text file, the app will attempt to download the patch from the URL in the first field of this text file.

Launcher will then call an external application, “Launcher-Helper.exe” from the root of the Installation directory, attempt to extract the zip file, and restart the Launcher application.

Launcher version can always be viewed by opening the log window which is accessed by clicking on the progress bar of the main Launcher window.

Full documentation as well as troubleshooting procedures can be found here: Launcher.pdf