quantumwerewolf


Namequantumwerewolf JSON
Version 3.2.2 PyPI version JSON
download
home_pageNone
SummaryQuantum version of the werewolves party game.
upload_time2024-05-23 19:14:19
maintainerNone
docs_urlNone
authorNone
requires_python>=3.8
licenseMIT License Copyright (c) 2022 Jesse Straat Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
keywords quantum werewolf werewolves game
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # Quantum Werewolf

Quantum Werewolf is a game based on the party game "The Werewolves of Millers Hollow" (known as "Weerwolven van Wakkerdam" to Dutch audiences) with a quantum mechanical twist: Players play all possible games of werewolf at the same time.

Original puzzle:
https://web.archive.org/web/20080719133809/http://puzzle.cisra.com.au/D-5-Schroedingers-Wolves.pdf

Solution and original explanation:
https://web.archive.org/web/20181116123708/https://puzzle.cisra.com.au/2008/quantumwerewolf.html

## Installation

`$ pip install quantumwerewolf`

## Usage

Start the game in a terminal by running the `quantumwerewolf` command.

## About

### What is "The Werewolves of Millers Hollow"?

The Werewolves of Millers Hollow is a classical party game where each player (save the game master) gets a secret role card assigned to them. There are two teams: the werewolves
and the village (consisting of all roles except the werewolves). At night, each player secretly takes an action corresponding to their role -- the seer gets to see another player's card,
Cupid can make two players fall in love, and the werewolves vote on who they will eat that night. During the day, all players vote on another player to be lynched.
The village's goal is to kill all werewolves, and the werewolves' goal is to kill all non-werewolves. When only one faction is left, they win.

### What is the quantum twist?

The quantum twist introduced in Quantum Werewolf is a superposition of roles. This means that every player is every role at once, and gets to take actions corresponding to all roles at night.
Of course, the superposition can be collapsed by measurements. Currently, there are two ways of measuring the superposition:

1. A player uses his Seer action to look at someone else's role, partially collapsing the superposition (and introducing entanglement!);
2. A player dies, which reveals his role to all players, collapsing the superposition quite a bit.

Since there is no way of knowing the final gamestate (in fact, your actions influence what the final measurement will be), it is important to players to "crack" the permutations
and try to make the superposition collapse in their favour. The game is very complex, and honestly isn't much fun to play with your grandma. However, it can be used as an
education tool for superpositions, or as a way to pit physicists against each other in cracking the code.

## What are the rules?

### Game setup

When you start a game of quantum werewolf, you are prompted to enter the names of all participating players first.
After entering and confirming the list of players, you are presented with the standard role selection of 2 werewolves and the seer.
You may refuse this role selection and choose the amount of werewolves as well as the additional roles.

A game of quantum werewolf needs at least 1 werewolf, optional roles are:

 * Seer: Inspects the identity of a player each night, revealing their role to the seer.
 * Cupid: Chooses two players to fall in love during the first night. Whenever one of the lovers dies, the other dies as well. The lovers win if they are the only 2 players left, regardless of role.
 * Hunter: Whenever the hunter dies, they may choose to kill another player.

You should also decide on the rules to follow during the day phase.

### Night phase

During the night all special roles get to take their specific actions. In quantum werewolf all players will take all their actions in turns.
In your turn you must specify how you would act as each role. You are only promted for actions corresponding to roles for which you have a non-zero probability to be.

### Day phase

At the start of the day phase all players that have died during the night will be revealed, as will their roles.
After the reveal, the players are presented with the current state of the game in which all players and their chances of being each role is tabulated.
All players in the table are anomymous except for dead players. The order of the players is random, but fixed throughout the game.

All players that are still alive must now discuss whoever they will lynch.
This discussion is separate from the interface of the game.
You should decide beforehand on the format of this discussion and how the lynch target will be decided.

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "quantumwerewolf",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.8",
    "maintainer_email": null,
    "keywords": "quantum, werewolf, werewolves, game",
    "author": null,
    "author_email": null,
    "download_url": "https://files.pythonhosted.org/packages/01/49/79e064074b892fc0e2e9c5bc8632e2d8d9dabb30e78741fa9d2c21d8701d/quantumwerewolf-3.2.2.tar.gz",
    "platform": null,
    "description": "# Quantum Werewolf\n\nQuantum Werewolf is a game based on the party game \"The Werewolves of Millers Hollow\" (known as \"Weerwolven van Wakkerdam\" to Dutch audiences) with a quantum mechanical twist: Players play all possible games of werewolf at the same time.\n\nOriginal puzzle:\nhttps://web.archive.org/web/20080719133809/http://puzzle.cisra.com.au/D-5-Schroedingers-Wolves.pdf\n\nSolution and original explanation:\nhttps://web.archive.org/web/20181116123708/https://puzzle.cisra.com.au/2008/quantumwerewolf.html\n\n## Installation\n\n`$ pip install quantumwerewolf`\n\n## Usage\n\nStart the game in a terminal by running the `quantumwerewolf` command.\n\n## About\n\n### What is \"The Werewolves of Millers Hollow\"?\n\nThe Werewolves of Millers Hollow is a classical party game where each player (save the game master) gets a secret role card assigned to them. There are two teams: the werewolves\nand the village (consisting of all roles except the werewolves). At night, each player secretly takes an action corresponding to their role -- the seer gets to see another player's card,\nCupid can make two players fall in love, and the werewolves vote on who they will eat that night. During the day, all players vote on another player to be lynched.\nThe village's goal is to kill all werewolves, and the werewolves' goal is to kill all non-werewolves. When only one faction is left, they win.\n\n### What is the quantum twist?\n\nThe quantum twist introduced in Quantum Werewolf is a superposition of roles. This means that every player is every role at once, and gets to take actions corresponding to all roles at night.\nOf course, the superposition can be collapsed by measurements. Currently, there are two ways of measuring the superposition:\n\n1. A player uses his Seer action to look at someone else's role, partially collapsing the superposition (and introducing entanglement!);\n2. A player dies, which reveals his role to all players, collapsing the superposition quite a bit.\n\nSince there is no way of knowing the final gamestate (in fact, your actions influence what the final measurement will be), it is important to players to \"crack\" the permutations\nand try to make the superposition collapse in their favour. The game is very complex, and honestly isn't much fun to play with your grandma. However, it can be used as an\neducation tool for superpositions, or as a way to pit physicists against each other in cracking the code.\n\n## What are the rules?\n\n### Game setup\n\nWhen you start a game of quantum werewolf, you are prompted to enter the names of all participating players first.\nAfter entering and confirming the list of players, you are presented with the standard role selection of 2 werewolves and the seer.\nYou may refuse this role selection and choose the amount of werewolves as well as the additional roles.\n\nA game of quantum werewolf needs at least 1 werewolf, optional roles are:\n\n * Seer: Inspects the identity of a player each night, revealing their role to the seer.\n * Cupid: Chooses two players to fall in love during the first night. Whenever one of the lovers dies, the other dies as well. The lovers win if they are the only 2 players left, regardless of role.\n * Hunter: Whenever the hunter dies, they may choose to kill another player.\n\nYou should also decide on the rules to follow during the day phase.\n\n### Night phase\n\nDuring the night all special roles get to take their specific actions. In quantum werewolf all players will take all their actions in turns.\nIn your turn you must specify how you would act as each role. You are only promted for actions corresponding to roles for which you have a non-zero probability to be.\n\n### Day phase\n\nAt the start of the day phase all players that have died during the night will be revealed, as will their roles.\nAfter the reveal, the players are presented with the current state of the game in which all players and their chances of being each role is tabulated.\nAll players in the table are anomymous except for dead players. The order of the players is random, but fixed throughout the game.\n\nAll players that are still alive must now discuss whoever they will lynch.\nThis discussion is separate from the interface of the game.\nYou should decide beforehand on the format of this discussion and how the lynch target will be decided.\n",
    "bugtrack_url": null,
    "license": "MIT License  Copyright (c) 2022 Jesse Straat  Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the \"Software\"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:  The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.  THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. ",
    "summary": "Quantum version of the werewolves party game.",
    "version": "3.2.2",
    "project_urls": {
        "Bug Tracker": "https://github.com/ProodjePindakaas/Quantum-Werewolf/issues",
        "Homepage": "https://github.com/ProodjePindakaas/Quantum-Werewolf"
    },
    "split_keywords": [
        "quantum",
        " werewolf",
        " werewolves",
        " game"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "66bcc0f7dd50845f5f7467d62d4a613327a49e05b53313c59e768dc85e90fcf6",
                "md5": "7dc62ff31d2f6ed73e85378720f84548",
                "sha256": "8457f42ddce75525e72ddb8c21b98e1cb9e33cc8bee60c0ff7585a27fbb26564"
            },
            "downloads": -1,
            "filename": "quantumwerewolf-3.2.2-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "7dc62ff31d2f6ed73e85378720f84548",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.8",
            "size": 13688,
            "upload_time": "2024-05-23T19:14:17",
            "upload_time_iso_8601": "2024-05-23T19:14:17.830652Z",
            "url": "https://files.pythonhosted.org/packages/66/bc/c0f7dd50845f5f7467d62d4a613327a49e05b53313c59e768dc85e90fcf6/quantumwerewolf-3.2.2-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "014979e064074b892fc0e2e9c5bc8632e2d8d9dabb30e78741fa9d2c21d8701d",
                "md5": "a7f6fb0ab895c0fe230b75f2c9468763",
                "sha256": "acc7b1aaeaf8eddc7b7906673561b2b95691ec6e1800ba45d7129bb0e665fe21"
            },
            "downloads": -1,
            "filename": "quantumwerewolf-3.2.2.tar.gz",
            "has_sig": false,
            "md5_digest": "a7f6fb0ab895c0fe230b75f2c9468763",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.8",
            "size": 16090,
            "upload_time": "2024-05-23T19:14:19",
            "upload_time_iso_8601": "2024-05-23T19:14:19.274480Z",
            "url": "https://files.pythonhosted.org/packages/01/49/79e064074b892fc0e2e9c5bc8632e2d8d9dabb30e78741fa9d2c21d8701d/quantumwerewolf-3.2.2.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-05-23 19:14:19",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "ProodjePindakaas",
    "github_project": "Quantum-Werewolf",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "quantumwerewolf"
}
        
Elapsed time: 0.89275s