Skip to content

Windower Plugin

Vanaportal is the plugin for the Vana Portal addon. It handles the connection between Windower and Vana Portal so your character data can sync smoothly in the background.

A secondary purpose of the plugin is to avoid microstutters or freezes in the Windower addon caused by limitations in Windower's Lua engine.

Install

Download the latest release from Vana Portal.

Install steps

Extract the archive into your Windower installation folder.

Files should end up here:

FileFolder
vanaportal.dll/plugins/
vanaportal_client.exe/plugins/Vanaportal/

Common Windower paths:

C:/Windower/

/home/username/Games/final-fantasy-xi/drive_c/Windower4/

First-time setup

  1. Load the plugin in Windower.
  2. The plugin creates the local files it needs.
  3. The addon detects the plugin and starts the linking flow.
  4. Use the generated code to link your setup with Vana Portal. Read more here.
  5. After that, future syncs happen automatically.

Troubleshooting

If something goes wrong, check:

/plugins/Vanaportal/plugin.log

Common causes:

  • vanaportal_client.exe was not placed in the correct folder
  • the client was blocked by antivirus or security software
  • the plugin was not loaded in Windower
  • the initial link process was not completed

Details

The plugin starts a small local background client that handles communication with Vana Portal and retries temporary sync failures automatically.

Files

FileNote
config.iniPlugin settings used for registration
.state.iniInternal plugin state
plugin.logError logs

Client

vanaportal_client.exe runs locally in the background and handles communication between the plugin and Vana Portal.

It listens on 127.0.0.1:39777, which is reserved for the client.

The client starts automatically when the plugin loads and closes automatically when the plugin unloads.