Tholinar User Guide

What Tholinar does

Tholinar helps Final Fantasy XIV crafters plan materials, track what they already own, and turn a shopping list into a clearer craft plan. The plugin uploads your inventory to the API, and the web app automatically loads the latest snapshot when you open it.

First-time setup

1. Install the Dalamud plugin and open Tholinar in game.
2. Click Sync Inventory once to upload your current inventory snapshot.
3. Open the web app and refresh it if it is already open.
4. Confirm the inventory status message shows that the snapshot loaded from the API.

Syncing inventory

Clicking Sync Inventory in the plugin uploads the current snapshot to the API and also keeps the local JSON export as a fallback for development. The web app downloads that snapshot automatically on load, so you should not need to paste JSON into the site.

Searching for recipes

Use the search box on the main page to find a craftable item by name. Select the item you want, and Tholinar will fetch the recipe tree and material totals for that item.

Choosing craft quantity

The quantity you enter is the target amount to craft or obtain. Tholinar scales the recipe tree and shopping list around that quantity, so you can plan for a single item or a larger batch.

Understanding the shopping list

The shopping list shows the raw materials still needed after applying your inventory. It combines quantities from character inventory, retainers, and saddlebags so you can see what remains to gather or buy.

Inventory locations

Tholinar keeps track of character inventory, retainer inventory, and saddlebags. Retainers are identified by stable slot index, and location details are shown in the materials and intermediate craft panels when available.

Keeping inventory current

Sync Inventory in the plugin whenever your in-game inventory changes. The app will load the latest snapshot on refresh and keep using the browser inventory model automatically.

MVP limitations

• The app is still Alpha software.
• Manual JSON import is no longer part of the normal UI, but the local export remains.
• API availability depends on the local development setup.
• Tholinar still relies on external recipe and item data sources.

Troubleshooting

• If the inventory status says the API is unavailable, try again after the API starts.
• If no snapshot is found, click Sync Inventory in the plugin and refresh the app.
• If shopping list totals look wrong, resync inventory and confirm the right character is active.
• If you still have issues, check the plugin chat message for upload success or failure.

FAQ

Do I still need to import JSON manually?

No for normal use. The web app loads the latest snapshot automatically. Manual JSON import remains only as a temporary development fallback.

Does Tholinar store my data in a database?

No. The app uses browser storage for the local inventory model, and the API stores the latest snapshot as a file for now.

What inventory is supported?

Character inventory, retainers, and saddlebags are all supported in the synced snapshot.