# Avatar Twitch Bot Design Document Draft
*Date: June 1st, 2021*
*Authors: scorpion81*
## Player
* Registration: Born into a nation (can choose once)
* Deregistration: leave nation by swapping, or death (zeroing stats)
* Rank
* XP,
* Named Ranks
* 1-3 neuling
* 4-6 anfänger
* 7-9 kompetenter
* 10-12 gewandter
* 13+(?) experte
* Unlock criteria (which stats improve)
* Nation
* unlocks national perks, mounts
* Mount
* later: Stats, invest yuans to feed and care
* cosmetical (text descriptions)
* Stats: Category, Name, Value
* Equipment
* Abilities
* Upgradeability
## Player Stats
* category, item, stat difference
* clothing,
* head
* torso
* arms
* legs
* "armor" (coat)
* abilities,
* fire beam, water wave ? xyz...
* mount
* ride speed, carry capacity...
## Player upgrades
* for stat category, name +-value, cost
## NPC upgrades / stats
* randomized per category, upgrade applies to all (otherwise it becomes too complex, if you do npc micromanagement)
## National upgrades
* for perk stats
## Nations and Perks
* Fire
* Mount: Dragon
* Specialized National Stats
* effective at day
* effective at time / weather / territory type ?
* Water
* Mount: polar bear dog ?
* Earth
* Mount: yyy
* Air
* Mount: zzz
* Leaders
* can be elected
* can be delegated
* have access to national balance for npc upgrading
## Moves
* NvN Raid
* national stats
* PvP Combat
* Individual stats
* Equipment and XP / Rank determinate attack power (damage, speed)
* Special
* espionage
* swap nations
## NvN Raid
* calculate attack effectivity from participating players and npcs
* calculate defense effectivity also
* factors like time, terrain, weather ?
* event triggered by timer or streamer
* manual join a running raid event as player of nation X
* autofill with NPCs, randomly stats
* can upgrade Player and stats
## PvP combat
* Player can attack other player with direct command
* attack command cooldown timer
* attack cost, attack yuans collected by time and chat activity
* can other players assist ?
* can this trigger a national war ?
* attack effectivity, defense effectivity
* with powers vs defensive equipment
* higher ranks, higher powers, better equipment
* win brings currency (yuan)
* defeat loses currency or equipment or "life" ?
## PvE combat
* AI(!) controlled enemies and bosses, random stats
* randomly "placed" in map ?
## Environment
* Map, Player "location" (no graphical display, text descriptions)
* Event area, coordinates
* Time
* National membership
* Stats (how does environment element affect stat x)
* Rank (which effect has environment element on ability with rank x)
* generate story-like log snippets
like: "You, {player} of {nation}, are in a dark castle, to the north we have x, to the south is a monster y, no further ways. You have x health and y armor... your move ?
1) go north,
2) attack monster in south... like that
## Currency
* earned from NvN and PvP wins
* purchaseable from channel points or secondary channel currency
* can convert back to secondary currency ?
* can get channel awards like VIP status, subgifts etc ?
* can (perhaps) be bought by bits (via secondary currency) ?
## Discord bridge
* combat logs
* interface for players to play from there
* assignment of roles according to ranks