Skip to content

Latest commit

 

History

History
88 lines (55 loc) · 4.57 KB

README.md

File metadata and controls

88 lines (55 loc) · 4.57 KB

Awoo GitHub package.json version (branch)

An automated real-time Werewolf game manager and moderator for Discord servers.

What is this project?

Awoo is a discord bot that manages multiple games of Werewolf over a period of actual days and nights to give players the freedom to interact in the game throughout the day.

I created this project because I've been interested in running a Werewolf/Mafia-style game, but getting time to have all of my friends sit down and put aside at least an hour to play has been getting increasing harder to accomplish with all the responsibilities we have, so I created a bot to manage a game over the course of a real day.

Roles

Villagers

Villager

Villagers are basic Villager team roles that have no special actions.

Werewolves

Werewolf

Werewolves are Werewolf team roles that, once per night, choose a player to eliminate. They win when they outnumber the remaining villagers.

Seers

Seer

Seers are Villager team roles that can, once per night, inspect a player to learn if they are a villager or a werewolf. They are a large threat to the Werewolves.

Mayors

Mayor

Mayors are Villager team roles that are counted twice during lynching votes. That's how democracy works after all.

Lycans

Lycan

Lycans are Villager team roles that are for all intents and purposes normal villagers, but they appear to the seer as a werewolf.

Bodyguards

Bodyguard

Bodyguards are Villager team roles that, once per night, can protect a villager from elimination by the werewolves. They can even protect themselves!

Tanner

Tanner

The Tanner hates his job and hates his life. He only wins if he is eliminated. Take care not to eliminate him, werewolf or villager!

Princes

Prince

The Prince is a Villager team role that for all intents and purposes is a normal villager, but if they are voted to get lynched, they reveal their role and are not eliminated.

Sorceresses

Sorceress

The Sorceress is a Werewolf team villager that is aiming to assist the Werewolves. They, like the seer, can inspect a player each night to determine if they are the Seer. They WANT the werewolves to win!

Masons

Mason

The Masons are Villager team roles that are a part of a secret society that know who each other are. They are the only villagers they can trust.

Hunters

Hunter

The Hunter is a Villager team role that can take a player out with them if they get eliminated. Better be careful who you lynch or eliminate.

Witches

Witch

The witch is a Villager team role that can, once per game, save any player targeted by werewolf elimination or kill any player of their choosing.

Features

I am currently in the process of refactoring this application, but I plan for all of these features in the 1.0 release of this build:

  • No need for a moderator as all game management is handled by the bot.
  • Real day and night cycle, so you have plenty of time to interact in the game once you are free.
  • 20+ different roles for wildly different games each time you play.
  • Configurable by server administrator to tweak most game settings on a per server basis.
  • Games are saved server side so in the event of a failure, your game is safe and will pick back up where it left off when it restores.
  • Ability to see an overview of a game through the Awoo.io website outside of Discord.

Powered By

This project is powered by Node.js utilizing the Discord.js library. Developed in TypeScript.