CatsEyeXI Tech Document

General

Installation

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

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: Here.

• 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

Legacy Ashita v3 & Windower Setup

Please be aware that CatsEyeXI now has a one-step Launcher available at www.catseyexi.com/install. Windower is not supported. You are on your own.

Configuring Your Launcher

Note: Both Ashita and Windower launchers have some pretty cool bells and whistles available to you. Use caution in enabling these as many of them will get you banned as they are basically cheats. Best rule of thumb is, when in doubt, don't do it.

Note: Regarding plugins add-ons and other 3rd party tools: There is a list of approved addons/plugins at the Main CatsEyeXI Page. If it is not mentioned then it is not allowed. If it seems like cheating it probably is. "I didn't know" is not a valid defense if what you are doing impacts server stability or alters the gameplay experience of others. Forcing doors open in the client is allowed with this drawback: if you sequence break you do so at your own risk.

• Staff will NOT assist you if the reason you are stuck is you skipped something.

Using Ashita

For CatsEyeXI and other private servers, you will need some way to connect to the private server. Ashita is one of these configurable game client launchers.

Where can I get it, or what is Ashita all about? You can download the Ashita 3 client from here.

Note: the link above will start the exe download, so if your browser doesn't like it, or if you would like more information about Ashita itself, please visit Atom0s.com or you can visit this post Bluegartr forum post by Atom0s

To configure Ashita 3 to connect to CatsEyeXI, please take these steps:

• Note: Note: Windows users, you will likely be prompted by UAC (user account controller) when you open the file. It's in your best interest to always r-click the shortcut and run as an administrator to make sure your settings are saved.

1. Click on the + icon at the bottom of the loaded Ashita window.
2. Click on the gear icon to the left to access the configuration settings.
3. Name the configuration something like CatsEyeXI, or something that will help you remember what you are connecting to.
4. The file setting should be .\ffxi-bootmod\pol.exe
5. The Command settings should be --server server.catseyexi.com
6. Leave the script setting alone.
7. The checkboxes can be left unchecked
8. At the bottom locate the checkmark at the bottom to save your settings.

Using Windower

Note: This is not supported.

For CatsEyeXI and other private servers, you will need some way to connect to the private server. Windower is one of these configurable game client launchers.

Where can I get it, or what is Windower all about? You can download the latest Windower client from here.

Note: The link above will start the exe download, so if your browser doesn't like it, or if you would like more information about Windower itself, please visit Windower.net.

To configure Windower to connect to CatsEyeXI, please take these steps: Note: Windows users, you will likely be prompted by UAC (User Account Controller) when you open the file. It's in your best interest to always r-click the shortcut and run as an administrator to make sure your settings are saved.

1. Open the folder that you installed Windower in and locate the settings.xml file.
2. Open it in a program such as Notepad or Notepad++ to edit it
3. Add a new profile setting with the information and then save your file.

<profile name="CatsEyeXI">
  <consolekey>Insert</consolekey>
  <windowmode>Window</windowmode>
  <width>1280</width>
  <height>720</height>
  <uiscale>1</uiscale>
  <args>--server server.catseyexi.com</args>
  <executable>..\..\xiloader\pol.exe</executable>
</profile>

Troubleshooting

Please note that the <executable> location may be different depending on where you installed Windower. So please change path to xiloader to wherever yours is located.

Come join us in Discord for help, a link is on the main CatsEyeXI page.

Controller Setup

The controller can easily be setup via the launcher.

General Troubleshooting

Please see the CatsEyeXI General Troubleshooting for possible help with issues you may be having in game.