# chocodye
A Rust library for changing the color of the chocobos' plumage in *Final Fantasy XIV*.
[](https://crates.io/crates/chocodye/)
[](#license)
[](https://blog.rust-lang.org/2023/06/01/Rust-1.70.0.html)
[](https://docs.rs/chocodye/)
This repository also includes language-agnostic files such as [`dyes.xml`](build/dyes.xml)
and [Fluent translation lists](locales).
Furthermore, a live version using WebAssembly is available on [this web page](https://she3py.github.io/chocodye/).
## Documentation
Latest version:
https://docs.rs/chocodye/
## Cargo Features
- `fluent`: enables localization through [Fluent](https://projectfluent.org/).
- `truecolor`: enables text to be colored in the terminal.
## Examples
List of colors:
```bash
cargo run --example truecolor -- en
```

Sample menu:
```bash
cargo run --example menu -- en
```

The displayed language can be changed by replacing `en` with `fr`, `de` or `jp`.
Please note that for colors to be displayed under Windows, this command must first be run:
```bat
set COLORTERM=truecolor
```
See the documentation for [`chocodye::ansi_text`](https://docs.rs/chocodye/latest/chocodye/fn.ansi_text.html).
## License
Licensed under either of
* Apache License, Version 2.0
([LICENSE-APACHE](LICENSE-APACHE) or http://www.apache.org/licenses/LICENSE-2.0)
* MIT license
([LICENSE-MIT](LICENSE-MIT) or http://opensource.org/licenses/MIT)
at your option.
## Contribution
Unless you explicitly state otherwise, any contribution intentionally submitted
for inclusion in the work by you, as defined in the Apache-2.0 license, shall be
dual licensed as above, without any additional terms or conditions.