Creating ASCII Art Items - Dungeons-of-Kathallion/Bane-Of-Wargs GitHub Wiki
Introduction
Every item as its own colored ASCII art, that adds more depth to the game and its plot. In this guide, you'll learn how these ASCII arts get displayed by the game engine, and how to make them the best way possible. You can and should use yaml data color codes, to add color to your ASCII art. Note that as any artwork, you need to copyright it in the plugin's copyright file. Note that you can find many examples at the data/items.yaml
file and imgs/
directory.
Explanation
First, you need to define your item, and as an example I'll take the vanilla game's Chuckle Sword
:
Chuckle Sword: &chuckle_sword
display name: "Chuckle Sword"
upgrade tier: 0
type: "Weapon"
damage: 8
defend: 6
agility: .12
gold: 67.23
critical hit chance: .4
description: "These swords are used by the most advanced knights, and they can cost a fortune to forge."
Then, add both thumbnail
and thumbnail raw
keys (note that you can use any shape or character for the box, if you don't wanna stick to the vanilla look):
thumbnail: |
ββββββββββββββββββββββββββββββ
β β
β β
β β
β β
β β
β β
β β
β β
β β
β β
β β
β β
ββββββββββββββββββββββββββββββ
thumbnail raw: |
ββββββββββββββββββββββββββββββ
β β
β β
β β
β β
β β
β β
β β
β β
β β
β β
β β
β β
ββββββββββββββββββββββββββββββ
You can then decide to make the ASCII all of your own, or search for examples and starting base in various ASCII art library. Here's a few that I use for the vanilla game (you can also simply search on the net):
- https://asciiart.eu
- https://manytools.org/hacker-tools/convert-images-to-ascii-art/
- https://www.oocities.org/spunk1111/
Then start creating the item's ASCII art, apart from the box:
|]\
|β|\
|β||
|β||
|β||
|β||
|β||
[--+--]
0
0
After that, you can add it to the thumbnail raw
and thumbnail
box.
thumbnail raw: |
ββββββββββββββββββββββββββββββ
β β
β |]\ β
β |β|\ β
β |β|| β
β |β|| β
β |β|| β
β |β|| β
β |β|| β
β [--+--] β
β 0 β
β 0 β
β β
ββββββββββββββββββββββββββββββ
The thumbnail raw
box won't be used by the game engine, it's used so that you can look at the ASCII art, without all that color codes, that will be added in the thumbnail
box.
Finally, you can add the yaml data color codes to your thumbnail
box:
thumbnail: |
ββββββββββββββββββββββββββββββ
β β
β$SILVER |]\ $WHITEβ
β$SILVER |$GRAYβ$SILVER|\ $WHITEβ
β$SILVER |$GRAYβ$SILVER|| $WHITEβ
β$SILVER |$GRAYβ$SILVER|| $WHITEβ
β$SILVER |$GRAYβ$SILVER|| $WHITEβ
β$SILVER |$GRAYβ$SILVER|| $WHITEβ
β$SILVER |$GRAYβ$SILVER|| $WHITEβ
β $BROWN[$YELLOW--$CYAN+$YELLOW--$BROWN] $WHITEβ
β $RED0 $WHITEβ
β $RED0 $WHITEβ
β β
ββββββββββββββββββββββββββββββ
Here's how it looks in-game: