Skip to content

WorkingRobot/EXDViewer

Repository files navigation

EXDViewer

Native Build Web Build License FFXIV Version

EXDViewer is a modern, fast, and user-friendly tool for exploring Excel files from Final Fantasy XIV Online. Excel files are structured data tables that store various in-game information, such as item stats, NPC data, and more.

Features

  • Web and Native: Instantly use the web version at exd.camora.dev or download a native build.
  • Easy Deployment: Host your own web instance via Docker.
  • Performance: Efficiently handles all sheets, even huge ones like Item, Action, or Quest.
  • EXDSchema Support: Provides tight integration with EXDSchema for enhanced data exploration and dynamic in-viewer schema editing.
  • Advanced Filtering: Supports simple, fuzzy, and complex (TBD) filtering to quickly find specific data.

Quick Start

Online

Visit exd.camora.dev to use the latest version, directly in your browser. Supports local game installs and schema files (Chromium-based browsers only).

Locally

Find pre-built binaries for your platform on the Releases page.

Self-Host with Docker

Deploy the website yourself with Docker:

docker pull ghcr.io/workingrobot/exdviewer-web:main
docker run -p 8080:80 ghcr.io/workingrobot/exdviewer-web:main

Then open http://localhost:8080 in your browser. Give it a few seconds to load the latest game version, and set the API url to http://localhost:8080/api in the settings.

What Are EXD Files?

Inside SqPack, category 0A (0a0000.win32... files) consists of Excel sheets serialized into a proprietary binary format read by the game. Excel files (of which .exd files contain the actual data) are a core part of Final Fantasy XIV's data storage, containing tabular information such as quests, items, and more. They're often used by the FFXIV community for datamining and developing community tools. Programmatic access to these files is typically done through via Lumina (C#), ironworks (Rust), or XIVAPI (REST API).

More info is available here.

What is EXDSchema?

FFXIV's internal development cycle generates header files for each sheet, which are then compiled into the game, thus, all structure information is lost on the client side when the game is compiled. This repository is an attempt to consolidate efforts into a language agnostic schema, easily parsed into any language that wishes to consume it, that accurately describes the structure of the EXH files as they are provided to the client.

More info is available here.

Building from Source

  1. Clone the repository:
    git clone https://github.com/WorkingRobot/EXDViewer.git
    cd EXDViewer

Native

  1. Build the project:
    cargo build --bin viewer --release

Web

  1. Install trunk:

    cargo install --locked trunk

    or follow the instructions. Make sure trunk is installed and available in your PATH before continuing.

  2. Build the web version:

    cargo run --bin web --release

Contributing

Contributions, bug reports, and feature requests are welcome! Please open an issue or a pull request.

About

Cross-platform FFXIV game data viewer

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors 2

  •  
  •