impostor-game-maria 0.1.2

Um jogo de terminal simples para encontrar o impostor

Impostor Game (impostor-game-maria)

Um jogo de terminal leve e divertido baseado na dinâmica clássica de "Caneco/Impostor". Nele, o programa sorteia secretamente uma palavra válida a partir de uma lista textual e define, de forma aleatória, quem entre os participantes será o impostor da rodada. Para garantir o segredo dos papéis, a tela é limpa automaticamente a cada turno.

Ao final das rodadas de dicas, o grupo deve debater e votar em quem acredita ser o infiltrado — ou seja, aquele que não soube usar palavras semelhantes às do resto dos integrantes.

Condições de Vitória:

- O grupo ganha se identificar o impostor e este errar a palavra secreta ao final.

- O impostor ganha se o grupo votar na pessoa errada ou se, mesmo sendo descoberto, ele conseguir adivinhar a palavra secreta dos jogadores comuns.

---

🛠️ Pré-requisitos: Instalando o Python

Para executar o jogo, você precisa ter o Python (versão 3.9 ou superior) instalado no seu computador.

No Windows (CMD / PowerShell):

1. Baixe o instalador oficial no site python.org.
2. MUITO IMPORTANTE: Durante a instalação, marque a caixinha "Add Python to PATH" na primeira tela antes de clicar em instalar. Se esquecer disso, o comando pip não vai funcionar globalmente.

No Linux (Arch Linux / Ubuntu / Debian):

Abra o seu terminal e instale usando o gerenciador de pacotes da sua distribuição:

• Arch Linux: sudo pacman -S python python-pip
• Ubuntu/Debian: sudo apt update && sudo apt install python3 python3-pip

---

🚀 Como Instalar o Jogo

Você pode instalar o jogo de duas formas: diretamente da internet (via PyPI) ou através do código-fonte baixado no seu computador.

Opção A: Instalando pela Internet (PyPI)

Se o pacote já estiver publicado, abra o terminal/CMD de qualquer lugar e digite:

pip install impostor-game-maria

Opção B: Instalando Localmente (Código-Fonte)

Se você clonou a pasta do projeto do GitHub, abra o terminal dentro da pasta raiz do projeto (onde está o arquivo pyproject.toml) e execute:

pip install .

🎮 Como Executar e Jogar

1. Depois de instalado via pip, o Python cria um atalho global no sistema. Você não precisa chamar o interpretador do Python e nem caçar arquivos .py pelas pastas. O jogo vira um comando nativo do sistema.

• Windows: Pressione Win + R, digite cmd e dê Enter.
• Linux: Abra o seu emulador de terminal padrão.
• Android (Termux): Abra o aplicativo Termux.

2. Basta digitar o comando abaixo e dar Enter:

impostor-game

3. Dinâmica de Entrada de Dados: O jogo iniciará solicitando os dados dos jogadores no seguinte formato: Digite os dados dos jogadores: 5 maria vitor clara julia marcos

OBS:. O primeiro elemento deve ser o número total de jogadores. Em sequência, digite os nomes separados por um espaço simples.

4. Fluxo da Rodada:

• O terminal será limpo automaticamente e exibirá a mensagem: É a vez de: maria.
• O jogador da vez assume o controle da tela e pressiona Enter para revelar seu papel.
• Se ele for um jogador comum, verá a palavra secreta sorteada. Se for o impostor, verá o aviso de perigo.
• Após ler, o jogador pressiona Enter novamente. A tela é completamente limpa para que o próximo jogador se aproxime sem receber spoilers.

Contributions

Want to contribute a new feature? Perfect. Want to suggest/collaborate on something? Send me an email at [e-mail], or open an issue.

Follow me: