# folk.moe

> Every second-edition Folk in FOLK, the free indie sandbox MMORPG: stats, artifacts and spells, fetched live from the FOLK bot API, with the code that fetches them.

folk.moe is an example of the FOLK bot API (https://folk.lol/bots) in use. FOLK
(https://folk.lol) is a free-to-play indie sandbox MMORPG: tame Folk creatures
from world folklore, craft, fight and build a settlement. Play it in the
browser at https://folk.lol/game, or see every platform at https://folk.lol/apps.

## FOLK bot API
- [Bot API guide](https://folk.lol/bots): keys, rules, events, a hello-world bot
- [OpenAPI spec](https://api.folk.lol/v1/openapi.json): every endpoint of the bot API
- [Developer resources](https://folk.lol/developers): keys, public endpoints, feeds
- Requests use a bot key: `Authorization: Bearer folkbot_...`
- `GET /v1/meta/folks`: every Folk with stats, drops, summon cost, images
- `GET /v1/meta/items`: every item; artifacts have `kind: "artifact"`
- `GET /v1/meta/spells`: every spell with damage, accuracy, status, price
- `GET /v1/meta/game`: game constants, element chart, icons

```js
const res = await fetch("https://api.folk.lol/v1/meta/folks", {
  headers: { Authorization: `Bearer ${process.env.FOLK_BOT_KEY}` },
});
const { folks } = await res.json();
const secondEdition = folks.filter((folk) => folk.edition === 2);
```

## Pages
- [Folks, artifacts and spells](https://www.folk.moe/): this site, with the code that fetches each section
- [FOLK wiki](https://folk.lol/wiki): how the game works; the reference for Folks, artifacts and spells

## Folks (second edition)
Stats are the raw values from `/v1/meta/folks`. For in-game numbers, see each
Folk's page on the wiki.

- [Yurei](https://folk.lol/wiki/folks/yurei): ghost. These guys can be pretty annoying when you meet them on your night walks in the cemetery. HP 175, Attack 190, Defense 135, Speed 325, Sp. Attack 375, Luck 200. Summon: Bad Tooth ×3, Clean Bone ×2, Gravestone ×1.
- [Hime uo](https://folk.lol/wiki/folks/hime-uo): water. This enormous mermaid is endowed with extraordinary luck. HP 425, Attack 300, Defense 265, Speed 350, Sp. Attack 340, Luck 325. Summon: Shark Fang ×2, Squid Ink ×1, Salt Crystal ×3.
- [Kasa-obake](https://folk.lol/wiki/folks/kasa-obake): psychic. It is said to bounce around on its single leg, playing pranks on people. HP 250, Attack 175, Defense 175, Speed 400, Sp. Attack 450, Luck 250. Summon: Chicken Leg ×1, Sycamore Root ×1, Human Eye ×2.
- [Chochin'obake](https://folk.lol/wiki/folks/chochinobake): fire. It often keeps entire neighborhoods awake by lighting up the streets at night. HP 280, Attack 325, Defense 290, Speed 400, Sp. Attack 400, Luck 310. Summon: Candle ×1, Tongue ×2, Amber ×1.
- [Amabiko](https://folk.lol/wiki/folks/amabiko): water. It's not as agile as land monkeys, but swimming is good for its physical condition. HP 400, Attack 500, Defense 300, Speed 225, Sp. Attack 225, Luck 200. Summon: Blue Water Stone ×1, Monkey Brain ×1, Black Tulip ×2.
- [Okka](https://folk.lol/wiki/folks/okka): normal. Friendly with all other Folks, this creature has enviable legs. HP 325, Attack 225, Defense 300, Speed 300, Sp. Attack 225, Luck 330. Summon: Ivy ×3, Amanita ×3, Faded Parchment ×1.
- [Zhizh](https://folk.lol/wiki/folks/zhizh): fire. For those who like to play with fire. HP 400, Attack 440, Defense 310, Speed 250, Sp. Attack 460, Luck 225. Summon: Meteorite ×1, Burned Bean ×3, Pirate Earring ×1.
- [Qiqirn](https://folk.lol/wiki/folks/qiqirn): normal. The absence of hair makes this creature very aerodynamic. HP 250, Attack 260, Defense 190, Speed 475, Sp. Attack 210, Luck 340. Summon: Werewolf Fang ×1, Pine Cone ×3, Bouncing Ball ×1.
- [Konaki-jiji](https://folk.lol/wiki/folks/konaki-jiji): ghost. The sheer bulk of this crying man-child makes him incredibly hard to withstand. HP 425, Attack 210, Defense 440, Speed 110, Sp. Attack 190, Luck 300. Summon: Porcini Mushroom ×1, Dirty Nail ×2, Omelette ×3.
- [Minobi](https://folk.lol/wiki/folks/minobi): ghost. If you cross its path at night in the rain, be careful not to slip on it. HP 350, Attack 100, Defense 250, Speed 300, Sp. Attack 350, Luck 275. Summon: Ginger Root ×1, Lavender ×3, Lotus ×1.
- [Shirime](https://folk.lol/wiki/folks/shirime): psychic. They say that under the kimono, instead of a booty, there's its true face. HP 335, Attack 225, Defense 285, Speed 300, Sp. Attack 340, Luck 445. Summon: Ancient Book ×1, Marble ×3, Good Wine ×2.
- [Shurale](https://folk.lol/wiki/folks/shurale): plant. As adults, the branch on their forehead becomes dry and withered, like their soul, but as children, it is still a sprout. HP 310, Attack 355, Defense 350, Speed 275, Sp. Attack 235, Luck 260. Summon: Agave Flower ×1, Caterpillar ×2, Holy Water ×2.
- [Ifrit](https://folk.lol/wiki/folks/ifrit): fire. A powerful fire spirit, no one knows what face lies behind his mask. HP 375, Attack 475, Defense 350, Speed 325, Sp. Attack 525, Luck 300. Summon: Genie's Lamp ×1, Broken Stela ×2, Silver Maple Seed ×2.
- [Torakoishi](https://folk.lol/wiki/folks/torakoishi): earth. It loves to curl up in stony areas to avoid being recognized. HP 325, Attack 425, Defense 475, Speed 125, Sp. Attack 150, Luck 190. Summon: Quartz ×2, Cat Whiskers ×2, Rotten Apple ×1.
- [Wendigo](https://folk.lol/wiki/folks/wendigo): dark. Some think they feed on humans, but in reality, they are just craving tea time. HP 375, Attack 350, Defense 290, Speed 350, Sp. Attack 325, Luck 275. Summon: Cute Cup ×3, Guillotine ×1, Shroom ×1.
- [Jin Chan](https://folk.lol/wiki/folks/jin-chan): water. This three-legged frog has a hunger for coins. HP 350, Attack 175, Defense 300, Speed 275, Sp. Attack 250, Luck 550. Summon: Frog Eye ×2, Mahjong ×1, Fly ×3.
- [Kappa](https://folk.lol/wiki/folks/kappa): water. Barely stronger than a big toad, but they've got an attitude. HP 240, Attack 200, Defense 225, Speed 325, Sp. Attack 225, Luck 200. Summon: Cockroach ×2, Tea Cup ×2, Holy Water ×2.
- [Hane no Haeta Kappa](https://folk.lol/wiki/folks/hane-no-haeta-kappa): dark. Among the weakest Folks, a truly disgraceful creature. HP 275, Attack 200, Defense 160, Speed 300, Sp. Attack 215, Luck 90. Summon: Bird Skull ×8, Owl Nest ×8, Chicken Leg ×8.
- [Leshy](https://folk.lol/wiki/folks/leshy): plant. The guardian of the forest, it can change its size at will. HP 340, Attack 250, Defense 360, Speed 290, Sp. Attack 450, Luck 275. Summon: Cherry Blossom ×5, Spear Of Destiny ×1, Voodoo Doll ×3.
- [Sachayoj](https://folk.lol/wiki/folks/sachayoj): plant. A great walker, it has made its flowing mane its style. HP 400, Attack 345, Defense 285, Speed 365, Sp. Attack 335, Luck 245. Summon: Heart Seed ×1, Spear Of Destiny ×1, Mandrake Root ×3.
- [Mandragola](https://folk.lol/wiki/folks/mandragola): plant. Even though it is entirely plant-based, it is very bulky. HP 575, Attack 540, Defense 560, Speed 110, Sp. Attack 75, Luck 190. Summon: Rake ×2, Used Dagger ×2, Mandrake Root ×3.

## Spells
- [Charge](https://folk.lol/wiki/spells#charge): normal physical, damage 10, accuracy 75%, not sold.
- [Hit](https://folk.lol/wiki/spells#hit): normal physical, damage 30, accuracy 85%, 350 coins.
- [Slap](https://folk.lol/wiki/spells#slap): normal physical, damage 36, accuracy 100%, 600 coins.
- [Punch](https://folk.lol/wiki/spells#punch): normal physical, damage 56, accuracy 90%, 1700 coins.
- [Headbutt](https://folk.lol/wiki/spells#headbutt): normal physical, damage 80, accuracy 75%, 3850 coins.
- [Rear throw](https://folk.lol/wiki/spells#rear_throw): normal special, damage 110, accuracy 90%, 9150 coins.
- [Flame](https://folk.lol/wiki/spells#flame): fire special, damage 30, accuracy 90%, burn 15%, 350 coins.
- [Burning Hit](https://folk.lol/wiki/spells#burning_hit): fire physical, damage 30, accuracy 90%, burn 25%, 350 coins.
- [Bonfire](https://folk.lol/wiki/spells#bonfire): fire special, damage 50, accuracy 100%, burn 15%, 1350 coins.
- [Hot Coal](https://folk.lol/wiki/spells#hot_coal): fire physical, damage 80, accuracy 80%, burn 10%, not sold.
- [Lava Storm](https://folk.lol/wiki/spells#lava_storm): fire special, damage 130, accuracy 95%, 14150 coins.
- [Puddle](https://folk.lol/wiki/spells#puddle): water special, damage 30, accuracy 100%, chill 30%, 350 coins.
- [Water Punch](https://folk.lol/wiki/spells#water_punch): water physical, damage 30, accuracy 90%, 350 coins.
- [Fierce Wave](https://folk.lol/wiki/spells#fierce_wave): water special, damage 56, accuracy 100%, chill 25%, 1750 coins.
- [Water Bomb](https://folk.lol/wiki/spells#water_bomb): water physical, damage 100, accuracy 75%, 6750 coins.
- [Flood](https://folk.lol/wiki/spells#flood): water special, damage 120, accuracy 100%, 11850 coins.
- [Branch Whip](https://folk.lol/wiki/spells#branch_whip): plant physical, damage 30, accuracy 90%, 350 coins.
- [Vine Buckle](https://folk.lol/wiki/spells#vine_bucle): plant physical, damage 30, accuracy 100%, 350 coins.
- [Razor Leaf](https://folk.lol/wiki/spells#razor_leaves): plant physical, damage 56, accuracy 90%, 1700 coins.
- [Leaf Storm](https://folk.lol/wiki/spells#leavs_storm): plant special, damage 80, accuracy 100%, 4300 coins.
- [Draining Roots](https://folk.lol/wiki/spells#draining_roots): plant special, damage 150, accuracy 75%, drain 20%, 18600 coins.
- [Dig](https://folk.lol/wiki/spells#dig): earth physical, damage 30, accuracy 100%, 350 coins.
- [Stalactite](https://folk.lol/wiki/spells#stalactite): earth special, damage 36, accuracy 70%, chill 25%, not sold.
- [Earthquake](https://folk.lol/wiki/spells#earthquake): earth special, damage 140, accuracy 65%, 14950 coins.
- [Wind Blow](https://folk.lol/wiki/spells#wind_blow): wind special, damage 30, accuracy 100%, chill 20%, 350 coins.
- [Flying Strike](https://folk.lol/wiki/spells#flying_strike): wind physical, damage 56, accuracy 90%, not sold.
- [Rolling Tornado](https://folk.lol/wiki/spells#rolling_tornado): wind physical, damage 80, accuracy 100%, 4300 coins.
- [Buzzzz](https://folk.lol/wiki/spells#buzzzz): electric special, damage 30, accuracy 100%, shock 25%, 350 coins.
- [Plasma Slap](https://folk.lol/wiki/spells#plasma_slap): electric physical, damage 30, accuracy 100%, shock 20%, 350 coins.
- [Palm Bolt](https://folk.lol/wiki/spells#palm_bolt): electric special, damage 50, accuracy 80%, shock 20%, not sold.
- [Electric Thunder](https://folk.lol/wiki/spells#electric_thunder): electric special, damage 90, accuracy 95%, not sold.
- [Poisonous Bite](https://folk.lol/wiki/spells#poisonous_bite): poison physical, damage 36, accuracy 80%, 550 coins.
- [Nauseating Cloud](https://folk.lol/wiki/spells#nauseating_cloud): poison special, damage 56, accuracy 100%, 1750 coins.
- [Toxic Bomb](https://folk.lol/wiki/spells#toxic_bomb): poison special, damage 110, accuracy 90%, 9150 coins.
- [Laser](https://folk.lol/wiki/spells#laser): light special, damage 170, accuracy 80%, not sold.
- [Black Hole](https://folk.lol/wiki/spells#black_hole): dark special, damage 150, accuracy 95%, drain 10%, not sold.
- [Mentalist](https://folk.lol/wiki/spells#mentalist): psychic physical, damage 56, accuracy 100%, shock 20%, 1750 coins.
- [Therapy](https://folk.lol/wiki/spells#therapy): psychic special, damage 100, accuracy 80%, 6900 coins.
- [Unlimited Fangs](https://folk.lol/wiki/spells#unlimited_fangs): dragon physical, damage 140, accuracy 90%, 16700 coins.
- [Dragon Beam](https://folk.lol/wiki/spells#dragon_beam): dragon special, damage 180, accuracy 70%, not sold.
- [Scare](https://folk.lol/wiki/spells#scare): ghost special, damage 30, accuracy 80%, drain 25%, 350 coins.
- [Grudge](https://folk.lol/wiki/spells#grudge): ghost special, damage 56, accuracy 80%, drain 15%, 1600 coins.
- [Poltergeist](https://folk.lol/wiki/spells#poltergeist): ghost physical, damage 100, accuracy 75%, 6750 coins.
- [Calcination](https://folk.lol/wiki/spells#calcination): mystical special, damage 80, accuracy 90%, not sold.
- [Hyperuranium](https://folk.lol/wiki/spells#hyperuranium): mystical special, damage 160, accuracy 100%, not sold.
- [Tsunami](https://folk.lol/wiki/spells#tsunami): water special, damage 160, accuracy 95%, not sold.

## More
- [Play FOLK](https://folk.lol/game)
- [FOLK wiki](https://folk.lol/wiki)
- [FOLK on Bluesky](https://bsky.app/profile/folk.lol)
- [Folk Software](https://folk.software)