Metadata-Version: 2.4
Name: impostor-game-maria
Version: 0.1.2
Summary: Um jogo de terminal simples para encontrar o impostor
Author-email: Maria Eduarda <maria.andrade23@ufu.br>
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.9
Description-Content-Type: text/markdown

<div align="center">
  
[![Em Progresso](https://img.shields.io/badge/Status-Em%20Progresso-yellow.svg)](https://github.com/me15degreesm/interface-calculadora-rendimento)
[![Python](https://img.shields.io/badge/Python-3776AB?style=flat&logo=python&logoColor=white)](https://www.python.org/)
  
</div>

# 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](https://www.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:
```bash
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:
```bash
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:
```bash
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 me15degrees@gmail.com, or open an issue.

<div align="center">
Follow me:
  
  [![LinkedIn](https://img.shields.io/badge/LinkedIn-0077B5?style=flat&logo=linkedin&logoColor=white)](https://www.linkedin.com/in/maria-eduarda-nascimento-andrade-bb0b86213/)
  [![YouTube](https://img.shields.io/badge/YouTube-FF0000?style=flat&logo=youtube&logoColor=white)](https://www.youtube.com/channel/UCh6sgz1ij_my64lX8rQnPXg)
  [![Spotify](https://img.shields.io/badge/Spotify-1ED760?style=flat&logo=spotify&logoColor=white)](https://open.spotify.com/user/223w3q4xdm4pquahzl5xhfpia?si=t08g7SlVRvqhF0LseXTyXg&nd=1&dlsi=87356229bcf14264)
  [![Last.fm](https://img.shields.io/badge/Last.fm-D51007?style=flat&logo=last.fm&logoColor=white)](https://www.last.fm/user/me15degrees)
  

</div>
