# Regras do Chess-Uno (protótipo, versão “carta revelada”)

O Chess-Uno é um duelo que combina um tabuleiro de xadrez e um baralho. Os jogadores **não guardam nenhuma carta na mão**: no início de cada turno, o jogador compra uma carta e a revela, e o efeito dela se aplica imediatamente. As regras abaixo são exatamente as aplicadas pelo motor do jogo. As regras marcadas como **[experimental]** são hipóteses do protótipo: seus valores ficam na configuração (`RulesConfig`) e são fixados no início de cada partida.

## 1. Preparação

- Tabuleiro de xadrez padrão, posição inicial clássica. Quem cria uma partida privada joga com as brancas; na fila rápida e contra o computador, o exército é sorteado (ou escolhido, contra o computador).
- Baralho completo de **104 cartas**: para cada uma das quatro cores (vermelho, azul, verde, amarelo), duas cópias de cada valor de 1 a 9, duas “Pular a vez”, duas “Inversão” e duas “+2”; mais quatro Jokers e quatro “+4”. Cada carta tem um identificador único. Não há cartas 0.
- O baralho usado em uma partida é **filtrado pelas configurações**: valor máximo das cartas numéricas (`maxCardNumber`, 5 por padrão, de 1 a 9; 5 retira as cartas de 6 a 9) e presença dos Jokers (`includeJokers`).
- O baralho é embaralhado no servidor com aleatoriedade criptográfica. A ordem do monte de compra nunca é enviada aos jogadores.

## 2. Como funciona um turno

Um turno pertence ao exército que tem a vez. Quem controla esse exército é quem o começa. Fases:

1. **Início do turno**, depois **compra**: o jogador compra automaticamente a carta do topo e a **revela** a todos (a compra é registrada antes de qualquer notificação).
2. **Efeito imediato**: o efeito da carta se aplica na hora (ver a seção 4). Com um +2 ou um +4, uma fase de **colocação de peões** vem antes dos lances.
3. **Lances**: o número de lances concedido pela carta.
4. **Fim do turno**: a vez passa para o outro exército. A carta revelada vai para a pilha de descarte **do jogador que a comprou**.

Um jogador sem nenhum lance possível revela sua carta mesmo assim e aplica o efeito dela; depois, seu turno termina.

## 3. Monte de compra e pilhas de descarte

- Cada jogador tem **sua própria pilha de descarte**: nela aparecem as cartas que ele comprou.
- Quando o monte de compra acaba, as duas pilhas de descarte são embaralhadas juntas para formar um novo monte de compra.
- Se o monte de compra e as pilhas de descarte estiverem todos vazios, o jogador não compra e joga um lance normal.

## 4. Efeitos das cartas

| Carta | Efeito |
| --- | --- |
| Número 1 a 9 | O jogador da vez joga **tantos lances quanto o número** (uma série). |
| Pular a vez | O jogador da vez **perde a vez** sem mover nenhuma peça: o adversário compra imediatamente uma carta e a joga. |
| +2 | O jogador **recupera 2 dos seus peões capturados** (`plus2Pawns`) e os recoloca no tabuleiro, depois joga 1 lance (`movesAfterRecovery`) **[experimental]**. |
| +4 | O mesmo, com **4 peões** (`plus4Pawns`). |
| Inversão | **O tabuleiro vira**: o jogador das brancas passa a ser das pretas, e vice-versa. A posição não muda. O jogador da vez continua seu turno **com seu novo exército** (1 lance) **[experimental]**. No modo Purista, comprada em xeque, ela passa a vez direto para o adversário (seção 5). |
| Joker | O jogador joga **1 lance**, e **qualquer uma das suas peças** pode se mover **como uma dama** (em linha reta ou na diagonal, até o primeiro obstáculo, capturas incluídas). Os lances normais continuam possíveis. Um peão que chega à última fileira é promovido; ele não pode voltar para a sua primeira fileira **[experimental]**. |

Regras das séries (vários lances):

- O primeiro lance é obrigatório se houver algum; depois, o jogador pode **encerrar a série** a qualquer momento.
- A mesma peça pode se mover várias vezes. Não há compra entre os lances.
- Se nenhum lance for mais possível, a série termina.
- No modo Caça ao Rei, capturar o rei encerra a partida imediatamente; no modo Purista, um xeque encerra a série.

Recuperação de peões (+2 / +4):

- Só são recuperados peões **realmente capturados** pelo adversário (nunca mais do que o número capturado).
- O jogador escolhe as casas, **apenas entre as casas livres da sua fileira inicial** (a 2 para as brancas, a 7 para as pretas): nunca em outra fileira. São recolocados no máximo tantos peões quantas forem as casas livres dessa fileira.
- Sem peão capturado, ou se a fileira inicial estiver cheia, a carta simplesmente dá 1 lance normal; os peões capturados ficam na reserva para um próximo +2 ou +4.
- No modo Purista, um peão recolocado que dá xeque no rei adversário **encerra o turno na hora**, assim como um xeque encerra uma série: os peões ainda não colocados ficam na reserva e os lances da carta não são jogados. Um jogador cujo rei ainda está em xeque continua, para se defender. No modo Caça ao Rei, se um peão recolocado puder capturar o rei adversário, a captura automática se aplica assim que os lances começam.

Inversão: como ninguém tem cartas na mão, só os exércitos são trocados. Uma Inversão não concede nem prolonga um direito de captura en passant.

## 5. Modos de jogo: Purista e Caça ao Rei

O modo é escolhido antes da partida (partida privada, fila ranqueada ou partida contra o computador) e fica fixo durante a partida. O Elo é o mesmo nos dois modos; a fila ranqueada só junta jogadores que escolheram o mesmo modo.

### Modo Purista

As regras do xadrez se aplicam, adaptadas às cartas:

- **Nenhum lance pode deixar o próprio rei em xeque**: uma peça cravada não pode sair da linha do seu rei, o rei nunca vai para uma casa atacada (portanto, não pode capturar uma peça defendida) e os dois reis nunca podem ficar lado a lado. Isso também vale para os lances “de dama” do Joker.
- **O rei nunca é capturado.**
- **Um xeque encerra a série**: assim que um lance — ou um peão recolocado — dá xeque no rei adversário, a vez passa para o adversário, que precisa ter a chance de responder. Ninguém joga enquanto o rei adversário está em xeque, a não ser para se defender de um xeque ao próprio rei.
- **Inversão comprada em xeque**: a troca de exércitos passa o xeque para o adversário (agora é o rei dele que está sob ataque). Por isso, o turno termina na hora, sem lance: o adversário compra e precisa se defender, senão leva xeque-mate.
- **Xeque-mate**: quando um jogador tem a vez (depois de comprar), se o rei dele está em xeque e nenhum lance permitido pela carta tira o rei do xeque, ele leva xeque-mate e perde a partida. A carta importa: um Joker ou peões recuperados (+2, +4) podem oferecer uma defesa que um lance comum não ofereceria.
- **Em xeque, ninguém perde a vez**: uma carta “Pular a vez” comprada com o próprio rei em xeque vale 1 lance, para se defender. Da mesma forma, se a configuração não concede nenhum lance após a recuperação de peões (`movesAfterRecovery` igual a 0) e os peões recolocados não tiram o rei do xeque, o jogador joga 1 lance para se defender.
- **Roque**: regras clássicas; proibido em xeque, passando por uma casa atacada ou indo para uma.
- Um jogador que não está em xeque, mas não tem nenhum lance permitido, simplesmente vê seu turno terminar.

### Modo Caça ao Rei

As regras originais do Chess-Uno. Você vence **capturando o rei adversário**.

- Você pode deixar seu rei em uma casa atacada, expor seu rei, mover uma peça “cravada” ou colocar os reis lado a lado. Nada obriga você a responder a uma ameaça ao rei: o ataque é uma informação, não bloqueia nenhuma ação.
- **Xeque**: quando um rei está sob ataque, “Xeque!” aparece para os dois jogadores e a casa do rei fica destacada. O jogador em questão pode se defender com a carta do seu turno.
- **Captura automática**: se, quando você tem a vez (depois de comprar, ou durante sua série de lances), um dos seus lances pode capturar o rei adversário, a partida para na hora e você vence, sem precisar jogar a captura. Se a sua carta não der nenhum lance (uma carta “Pular a vez”), o rei sobrevive naquele turno.
- Capturar o rei encerra a partida imediatamente e tem prioridade sobre os lances restantes. Um peão que captura o rei na última fileira não escolhe peça de promoção: a partida acabou. A vitória vai para o **dono atual** do exército vencedor (importante depois de uma Inversão).
- **Roque**: condições clássicas (rei e torre ainda não movidos, casas intermediárias livres); permitido saindo de uma casa atacada, passando por uma ou indo para uma.

### Nos dois modos

- Os movimentos das peças, os obstáculos, as capturas e as promoções são os do xadrez.
- **En passant**: depois de um avanço duplo, a captura só é possível no lance imediatamente seguinte, pelo exército adversário. Qualquer outro lance, um turno pulado por inteiro ou um lance extra do mesmo exército (série) faz essa possibilidade expirar.

## 6. Trava de segurança das séries **[experimental]**

Parâmetro `stopComboOnKingThreat = true` por padrão, ajustável no modo Caça ao Rei (no modo Purista, um xeque sempre encerra a série). Quando ativado, depois de cada lance não final de uma série, se o rei adversário estiver sob ataque, a série para e a vez passa para o outro exército. O ataque é determinado apenas pelos movimentos e obstáculos do tabuleiro. Esse parâmetro pode ser desativado antes da partida; ele fica fixo durante a partida.

## 7. Empates, desistência e desconexão

- Os empates automáticos clássicos (repetição, material insuficiente, 50 lances) estão desativados.
- Empate de comum acordo entre os dois jogadores; desistência; empate após **10 turnos seguidos sem nenhuma peça se mover** **[experimental]** (limite `drawAfterTurnsWithoutMove`, zerado por qualquer lance efetivamente jogado).
- **Desconexão**: em uma partida entre humanos, um jogador desconectado tem um prazo para se reconectar (configuração do servidor, 60 s por padrão, mostrado nas regras da partida). Passado esse prazo sem voltar, ele perde por W.O. Esse prazo só existe na memória do servidor: uma falha ou reinicialização do servidor nunca causa W.O., e a partida continua a partir do estado salvo. Uma partida contra o computador pode ser retomada sem nenhum limite.
- Reconectar ou recarregar a página nunca provoca uma nova compra: o estado completo é salvo após cada comando aceito.

## 8. O que os jogadores veem

Todos veem: o tabuleiro, a carta revelada do turno, o monte de compra (quantidade de cartas), a pilha de descarte de cada jogador, os peões capturados recuperáveis de cada exército, os exércitos controlados, os efeitos pendentes, o jogador autorizado a agir, os lances restantes, o histórico público e os estados de conexão. A ordem do monte de compra e a aleatoriedade do servidor nunca são enviadas. O computador só recebe essa mesma observação.

## 9. Ranking

- Só as partidas terminadas **entre duas contas** são ranqueadas, nos dois modos e com uma pontuação única; as partidas contra o computador não contam.
- Pontuação **Elo**: 1000 no início; uma vitória contra um jogador com Elo mais alto rende mais pontos. As 10 primeiras partidas contam mais (K = 40, depois 24) para posicionar rápido um jogador novo.
- Divisões: 🥉 Bronze, 🥈 Prata (950+), 🥇 Ouro (1050+), 🏆 Platina (1200+), 💎 Diamante (1400+).
- Desistências e W.O. contam como derrotas; um empate aproxima as duas pontuações.
- Para cada par de jogadores, o retrospecto dos confrontos diretos (vitórias, derrotas, empates, forma recente) é público.

## 10. Parâmetros configuráveis (valores padrão)

| Parâmetro | Padrão | Função |
| --- | --- | --- |
| `gameMode` | `capture` | modo de jogo: `purist` (Purista) ou `capture` (Caça ao Rei) |
| `maxCardNumber` | 5 | valor máximo das cartas numéricas no baralho (1 a 9) |
| `includeJokers` | true | Jokers incluídos |
| `plus2Pawns` / `plus4Pawns` | 2 / 4 | peões recuperados |
| `movesAfterRecovery` | 1 | lances após a recuperação |
| `stopComboOnKingThreat` | true | trava de segurança das séries |
| `drawAfterTurnsWithoutMove` | 10 | empate por inatividade |
| `reconnectGraceMs` | 60000 | prazo de reconexão (servidor) |
