FloatPilot User Guide

Game Version Guide

“Game Version” helps FloatPilot understand the game version you are using. The executable file is named FloatPilot.VersionExtractor.exe; it reads aLogin.exe and data\Item.Dat from the game folder, analyzes the login version and data-file size, and creates version.ini.

Important: Start FloatPilot.VersionExtractor.exe with Run as administrator. Without administrator privileges, Windows permissions or security software may block the tool from reading the game files. App login also requires correct game-version information. If version.ini is missing, copied to the wrong location, or does not match the game, you may see a version mismatch, a data-file version mismatch, or be unable to log in.

Why the App needs it

When FloatPilot.App logs in to the game, it needs more than the game username, password, and server. It also needs the correct login-version data for the game client. That information comes from version.ini.

You do not need to guess the Header, Version, or ItemDatSize values. VersionExtractor analyzes the actual game files you use, reducing the chance of entering the wrong values manually.

In simple terms:

  1. VersionExtractor reads your game files.
  2. The tool creates a version.ini that matches that game version.
  3. You copy the file into FloatPilot.App’s configs folder.
  4. The App reads the version data during login and uses the correct login and data version.

Quick start

  1. Find the game folder that contains both aLogin.exe and data\Item.Dat.
  2. Copy FloatPilot.VersionExtractor.exe into that game folder.
  3. Right-click FloatPilot.VersionExtractor.exe and select Run as administrator.
  4. Wait for the message that version analysis succeeded.
  5. Open the game folder’s configs folder and find version.ini.
  6. Copy version.ini.
  7. Find the FloatPilot.App installation folder and open its configs folder.
  8. Paste version.ini into the FloatPilot.App configs folder. If Windows asks whether to replace the file, choose Replace.
  9. If FloatPilot.App is already open, close it completely and start it again.
  10. Refresh the version group list in the game account login window and select the matching version.

Required files

File or folder Purpose
FloatPilot.VersionExtractor.exe Analyzes the game version and creates version.ini.
aLogin.exe The source for the login Header and Version analysis.
data\Item.Dat Its actual file size is written to ItemDatSize.
configs\version.ini in the game folder The output created by VersionExtractor.
configs\version.ini in FloatPilot.App The version configuration actually read by App login.

Run the tool from the game root, not from the desktop, Downloads folder, or FloatPilot.App installation folder. The correct folder should contain aLogin.exe and data\Item.Dat.

Generated version data

VersionExtractor creates a section based on the game-folder name and writes these values:

Setting Plain-language meaning
Header The version identifier used by game login packets.
Version The game login version number.
ItemDatSize The actual size of the current data\Item.Dat, used to help verify the data-file version.

After copying the file to the App, the game account login window shows the available entries in the “Version Group” list. Choose the entry whose section, Header, Version, and Item size match the current game files.

When to run it again

Run VersionExtractor again in the updated game folder and copy the new version.ini to the App when:

  • The game client has been updated.
  • aLogin.exe has been replaced.
  • data\Item.Dat has been updated or replaced.
  • The App reports a version mismatch or data-file version mismatch.
  • The version group list has no entry matching the current game.

Do not reuse a file generated from an old game folder. Analyze the actual game folder you use for login each time.

Frequently asked questions and troubleshooting

The tool says required files are missing

Make sure the tool is in the same game root as aLogin.exe, and confirm that data\Item.Dat exists. Running it directly from the desktop or Downloads folder usually causes this error.

I cannot find version.ini

Confirm that the tool reported successful analysis. The file is created at configs\version.ini inside the game folder. If it is missing, run the tool again and check that the folder is writable.

The App still shows the old version

Make sure you copied the file to FloatPilot.App’s configs\version.ini, not only to the game folder. Close and restart the App completely, then refresh the version group list.

The App reports a version mismatch or data-file version mismatch

Run VersionExtractor again from the current game folder and copy its new version.ini. Do not edit the numbers manually or use a file left by another game version.

Windows shows “Windows protected your PC”

Windows or antivirus software may warn about a tool that has not yet been trusted. Confirm that the file came from a trusted source first. If it is trusted, follow the Windows prompt to select “More info” and “Run anyway”, or add the tool to the antivirus allow list.

The tool cannot write version.ini

The game folder may be read-only, you may not have write permission, antivirus software may be blocking the write, or the disk may be full. Confirm that the folder is writable and, if necessary, run the tool as administrator.

The tool reports an unsupported aLogin.exe

The game version may be too old, too new, or not a supported official client. Confirm that the game is updated to a supported version. If analysis still fails, keep the complete error message for troubleshooting.

Final checklist

  • VersionExtractor and aLogin.exe are in the same game root.
  • data\Item.Dat comes from the game version you want to log in to.
  • The tool reported successful version analysis.
  • configs\version.ini exists in the game folder.
  • The file was copied into FloatPilot.App’s configs folder.
  • The App was fully closed and restarted.
  • The game account login window uses the correct version group.