1
Fork 0
mirror of https://github.com/redstrate/Auracite.git synced 2025-04-23 13:17:45 +00:00
auracite/README.md

55 lines
3.1 KiB
Markdown
Raw Normal View History

2024-09-29 17:45:53 -04:00
# Auracite
Export your FFXIV character in portable, generic formats.
In the eventual future, the official servers will shut down and the Lodestone will disappear. This tool exports your
character's data in machine-readable JSON (so it can be imported by something else) and a Lodestone-like HTML page which
you can display in your browser.
## Usage
### CLI
2024-09-29 17:45:53 -04:00
Provide a character name via `--name`:
```shell
auracite --name "John Doe"
```
The tool will create a new folder with the name "John Doe", which will contain the available data. See the table below
for the currently supported data that can be recorded. You may want to check out the `character.html` file that can be
viewed locally in your browser.
This tool makes several HTTP requests to the Lodestone, but they currently are only a few. The tool does not contact any
3rd-party external services.
### Dalamud Mode
Auracite can only collect so much data from the Lodestone, some data can only be collected when logged in. To do this,
we provide a Dalamud plugin to run alongside the tool. The plugin is currently available
[in my personal Dalamud repository](https://github.com/redstrate/DalamudPlugins).
When running the tool, append the `--dalamud` argument. It will walk you through starting the plugin. The plugin can be
safely removed if you're done using Auracite.
2024-09-29 17:45:53 -04:00
## Supported Data
| Data | Supported | Notes |
|---------------------------|-----------|-----------------------------------------------------------------------------------|
| Name | ✅ | |
| World/Data Center | ✅ | |
| Race/Subrace/Gender | ✅ | |
| City-state | ✅ | |
| Nameday | ✅ | |
| Guardian | ✅ | |
| Portrait/Full-body Images | ✅ | These are the images displayed on the Lodestone. |
| Playtime | ✅ | Requires the Dalamud plugin. |
| Currencies | 〰️ | Only gil is supported, and requires the Dalamud plugin. |
| Appearance Data | 〰️ | Only some appearance data, and requires the Dalamud plugin. |
| Misc. state | 〰️ | Mentor and novice status, also player commendations. Requires the Dalamud plugin. |
2024-09-29 17:45:53 -04:00
Currently, more types of data is planned to be supported in the future.
## License
This project is licensed under the [GNU Affero General Public License 3](LICENSE).