From d5e2c156a7c0a1db76545dd2fb590adb85a38c13 Mon Sep 17 00:00:00 2001 From: Daniel Schadt Date: Sun, 8 Dec 2019 16:01:25 +0100 Subject: add README and screenshot --- README.md | 63 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 63 insertions(+) create mode 100644 README.md (limited to 'README.md') diff --git a/README.md b/README.md new file mode 100644 index 0000000..6670466 --- /dev/null +++ b/README.md @@ -0,0 +1,63 @@ +kondou +====== + +`kondou` is a program that allows you to generate Guild Wars 2 build images (including traitlines and skills) with support for parsing and generating chat links as well, which allow you to link builds in-game. + +Unlike the alternatives (see below), kondou is designed around non-interactive use, for example to batch-generate images to be included in offline guides or documents. kondou was written as [a result of](https://xkcd.com/1319/) screenshotting and embedding gw2skills images. + +Features +======== + +* Finds skills and traitlines by name instead of ID. +* Can parse and generate chat codes. + +Building +======== + +The complete build process is managed by `cargo`, the standard Rust package manager. As such, `cargo build --release` will download all required dependencies and build kondou in `target/release/kondou`. + +Usage +===== + +(See `kondou --help` for a list of all supported options) + +Generate a build by specifying traits/skills by hand: + +``` +kondou Mesmer -s 'Signet of the Ether' -s 'Signet of Inspiration' -s 'Well of Action' -s 'Well of Recall' -s 'Time Warp' -t 'dueling:top:bot:top' -t 'inspiration:bot:mid:bot' -t 'chronomancer:mid:top:bot' +``` + +Generate a build by using a chat code: + +``` +kondou -c '[&DQcBHRc7KDYjDwAAgAEAAIcSAADPEgAAvAEAAAAAAAAAAAAAAAAAAAAAAAA=]' +``` + +Output: + +``` +Profession: Mesmer +Skills: Signet of the Ether + Signet of Inspiration + Well of Recall + Well of Action + Time Warp +Traitlines: Dueling - top - bot - top + Inspiration - bot - mid - bot + Chronomancer - mid - top - bot + +Chat code: [&DQcBHRc7KDYjDwAAgAEAAIcSAADPEgAAvAEAAAAAAAAAAAAAAAAAAAAAAAA=] +Image saved in buildtemplate.png +``` + +Example image: + +![Example output image](screenshots/buildtemplate.png) + +You can change the output file location by using `-o filename` and you can suppress the output by using `-q`, in which case only the chat code will be printed (useful for usage in other scripts). + +Alternatives +============ + +* [gw2skills](http://en.gw2skills.net) has more features and allows you to test out different stat combinations, runes, sigils, ... in your armor/weapons as well. However, it is designed for interactive use, which makes it harder to use in an automated fashion. +* [armory-embeds](https://github.com/madou/armory-embeds) are good for websites, but lack the feature to render a static image. Additionally, you have to use the skill/traitline IDs instead of the names, and you cannot use/generate chat codes. -- cgit v1.2.3