FFXIV Guildleve Profit Calculator
A simple web application to calculate the expected profit of Final Fantasy XIV guildleve tasks.
Features
- Select a crafting job and then a specific levequest.
- Calculates material costs based on real-time market data from Universalis.
- Compares purchasing materials vs. crafting them, considering sub-crafts.
- Supports HQ (High Quality) targeted crafting for potentially higher profits.
- Manual Mode: Allows users to input their own total cost for leve items if they prefer not to use automatic market prices.
- Displays estimated profit per leve allowance.
- Game data (leves, recipes) is sourced from Garland Tools data, now served via jsDelivr CDN.
How to Run
- Ensure you have an internet connection (for Universalis market data and base game data from CDN).
- Simply open the
src/index.html file in a modern web browser.
- For best results and to avoid potential browser restrictions with local files (
file:/// protocol), it’s recommended to serve the files through a simple local HTTP server. Many tools can do this, e.g., python -m http.server in the project root, then navigate to http://localhost:8000/src/.
Data Sources
- Market Prices: Universalis API
- Game Data (Leves, Items, Recipes): Based on data from Garland Tools, accessed via jsDelivr CDN.
- Original data mining scripts were used to fetch from Garland Tools. The application now uses static JSON files derived from this process, hosted on the CDN.
Development Notes
- The application is built with HTML, CSS, and vanilla JavaScript (with jQuery for DOM manipulation and Select2 for dropdowns).
- Bootstrap 5 is used for styling.
- JavaScript code is organized into:
src/js/app.js: Main application logic, event listeners, and global state.src/js/api.js: Functions for fetching data from Universalis and the game data CDN.src/js/calculations.js: Core logic for cost and profit calculations.src/js/ui.js: Functions for DOM manipulation and UI updates.
- Basic tests can be run by opening
test.html in a browser.
License
This project was originally licensed under GPL-3.0-or-later by fisherwise. Modifications continue under the same license. (Assuming license file LICENSE still applies).