/Killer-Queen

[💀] Killer Queen is an agent participating in the International AIWolf Competition. The goal is to make bots play the Werewolf game together!

Primary LanguagePython

[💀] Killer Queen

«I'm going to eliminate you now, before you have a chance to speak, so I can sleep soundly again tonight.» - Yoshikage Kira

Killer Queen is an agent participating in the International AIWolf Competition. The goal is to make bots play the Werewolf game together!

This repository contains the source code of Killer Queen, as well as the necessary files to run simulations and documentation on how to setup your own agent. KQ's architecture was designed to be simple, efficient and easily hackable.

For any questions or suggestions, contact me at yrabii@ensc.fr, or on Twitter.

What is AIWolf?

Parts of this repository were adapted from ehauckdo/AIWoof

AIWolf is a project dedicated to creating virtual agents capable of playing the Werewolf game. To understand why this problem is important, please check this presentation of the project. In the AIWolf Competition, participants must create AI agents and make them compete with each other.

To learn the rules and how to play the Werewolf game, please refer to this website

The AI Competition currently has 2 branches, one protocol-based where agents can use a predefined grammar to communicate, and one NLP-based. This repository has information on the protocol-based branch of the competition.

See the Manual folder/ for information about how to setup your own agents :

  • Quick Start to understand the course of the game
  • Protocol for details about the communication protocol between agents
  • Agent Programming for documentations about the functions your agent should use

How does Killer Queen work ?

Check this page about's Killer Queen simple and efficient behavior.

Contents of this repo

  • /server : the AIWolf server that run Werewolf games with several agents
  • /killerQueen : code source of the Killer Queen agent
  • /other_agents : code source of other public agents, for testing purpose
  • /archive : older versions of Killer Queen

How to run a test game

  1. Configure the game's settings in gameSettings.ini. follow the format specified to choose games composition (agents algorithms and roles). Here are useful parameters:

  • game (int) : number of games to simulate

  • log (path) : path to the folder where the server will write game logs

  • view (bool) : use the GUI to follow the course of the game (Japanese)

  1. Start the server.