🌙

Werewolf Moderator

â„šī¸ About

Learn about the Werewolf Moderator Tool and its features

đŸē Project Overview

The Werewolf Moderator Tool is a comprehensive digital assistant designed to streamline the process of running Werewolf (Mafia) games. Whether you're a seasoned moderator or hosting your first game, this tool provides everything you need to manage players, roles, and game flow efficiently.

Built with modern web technologies, the tool offers an intuitive interface that makes game management seamless and enjoyable.

✨ Key Features

🎭 Role Management

Support for 12 different roles including Werewolf, Villager, Seer, Doctor, Witch, Hunter, and more. Easy role assignment and discovery system.

🌙 Night Phase Automation

Streamlined night phase with automatic role calling, action processing, and protection mechanics.

â˜€ī¸ Day Phase Tools

Built-in discussion timer, voting system, and elimination tracking for smooth day phases.

📊 Game History

Complete game tracking with statistics, win rates, and detailed game logs for analysis.

🎮 Game Flow

Intuitive interface that guides moderators through each phase with clear instructions and confirmations.

💾 Data Persistence

Automatic saving of game state, player configurations, and game history across sessions.

📱 Responsive Design

Works seamlessly on desktop, tablet, and mobile devices for flexible game hosting.

🎨 Modern UI

Clean, modern interface with dark theme support and intuitive navigation.

🎭 Special Roles

The tool includes support for unique roles that add complexity and excitement to your games:

đŸēđŸŧ Wolf Cub

A special werewolf role with unique mechanics including protection from werewolf attacks and double-kill abilities.

💘 Cupid

Links two players as lovers, creating a third team with their own win condition.

🎭 Doppelganger

Copies another player's role and transforms when that player dies.

âš™ī¸ Technology Stack

Frontend

  • â€ĸ Next.js - React framework for production
  • â€ĸ TypeScript - Type-safe JavaScript
  • â€ĸ Tailwind CSS - Utility-first CSS framework
  • â€ĸ Boardgame.io - Game state management

Features

  • â€ĸ Local Storage - Data persistence
  • â€ĸ SEO Optimization - Search engine friendly
  • â€ĸ Responsive Design - Mobile-first approach
  • â€ĸ Dark Theme - Modern UI/UX

📖 How to Use

1

Setup Players

Add players to your game and configure the number of participants. The tool will suggest optimal role distributions.

2

Configure Roles

Select which roles to include in your game. The tool provides recommendations based on player count.

3

Start Game

Begin the game and follow the guided night phase. The tool will call roles in the correct order and handle all mechanics.

4

Manage Phases

Use the day phase tools for discussion timing and voting, then transition back to night phase as needed.

💡 Tips for Moderators

Before the Game

  • â€ĸ Familiarize yourself with all roles and their abilities
  • â€ĸ Set up the discussion timer duration based on your group's preferences
  • â€ĸ Ensure all players understand the basic rules
  • â€ĸ Have a backup plan for technical issues

During the Game

  • â€ĸ Keep the game moving at a good pace
  • â€ĸ Be consistent with your rulings
  • â€ĸ Use the game log to track important events
  • â€ĸ Encourage player engagement and discussion

📞 Contact & Support

The Werewolf Moderator Tool is an open-source project designed to enhance the Werewolf gaming experience. For questions, suggestions, or to report issues, please refer to the project documentation or contact the development team.