# Luật chơi Chess-Uno (bản nguyên mẫu, phiên bản “lá bài lật ngửa”)

Chess-Uno là một trận đấu tay đôi kết hợp bàn cờ vua và một bộ bài. Người chơi **không giữ lá bài nào trên tay**: đầu mỗi lượt, người chơi rút một lá bài, lật ngửa lá đó, và hiệu ứng của nó được áp dụng ngay lập tức. Các luật dưới đây chính là những luật mà bộ máy của trò chơi thực sự áp dụng. Các luật được đánh dấu **[thử nghiệm]** là giả định của bản nguyên mẫu: giá trị của chúng nằm trong cấu hình (`RulesConfig`) và được cố định khi bắt đầu mỗi ván.

## 1. Chuẩn bị

- Bàn cờ tiêu chuẩn, thế cờ khởi đầu cổ điển. Người tạo ván riêng cầm quân Trắng; khi ghép trận nhanh và khi đấu với máy, phe của mỗi người được bốc thăm ngẫu nhiên (hoặc tự chọn khi đấu với máy).
- Bộ bài đầy đủ gồm **104 lá**: với mỗi màu trong bốn màu (đỏ, xanh dương, xanh lá, vàng) có hai lá cho mỗi giá trị từ 1 đến 9, hai lá “Mất lượt”, hai lá “Đảo chiều”, hai lá “+2”; cộng thêm bốn lá Joker và bốn lá “+4”. Mỗi lá bài có một mã định danh riêng. Không có lá số 0.
- Bộ bài dùng trong một ván được **lọc theo thiết lập**: lá số lớn nhất (`maxCardNumber`, mặc định là 5, từ 1 đến 9; chọn 5 sẽ bỏ các lá từ 6 đến 9) và có dùng Joker hay không (`includeJokers`).
- Bộ bài được xáo trên máy chủ bằng cơ chế ngẫu nhiên mật mã. Thứ tự của chồng bài rút không bao giờ được gửi cho người chơi.

## 2. Diễn biến một lượt

Mỗi lượt thuộc về phe đang có quyền đi. Người chơi điều khiển phe đó bắt đầu lượt. Các giai đoạn:

1. **Đầu lượt**, rồi **rút bài**: người chơi tự động rút lá trên cùng và **lật ngửa** cho mọi người cùng thấy (lá bài rút được ghi lại trước mọi thông báo).
2. **Hiệu ứng tức thì**: hiệu ứng của lá bài được áp dụng ngay (xem mục 4). Với lá +2 hoặc +4, giai đoạn **đặt lại Tốt** diễn ra trước các nước đi.
3. **Nước đi**: số nước đi mà lá bài cho phép.
4. **Cuối lượt**: quyền đi chuyển sang phe còn lại. Lá bài đã lật được đưa vào chồng bài bỏ **của người đã rút nó**.

Người chơi không có nước đi hợp lệ nào vẫn lật bài và áp dụng hiệu ứng của nó, sau đó lượt của họ kết thúc.

## 3. Chồng bài rút và chồng bài bỏ

- Mỗi người chơi có **chồng bài bỏ riêng**: nơi hiển thị các lá bài người đó đã rút.
- Khi chồng bài rút đã hết, hai chồng bài bỏ được xáo chung lại thành một chồng bài rút mới.
- Nếu cả chồng bài rút lẫn các chồng bài bỏ đều trống, người chơi không rút bài và đi một nước bình thường.

## 4. Hiệu ứng của các lá bài

| Lá bài | Hiệu ứng |
| --- | --- |
| Lá số 1 đến 9 | Người chơi hiện tại đi **số nước bằng con số trên lá bài** (một chuỗi nước đi). |
| Mất lượt | Người chơi hiện tại **mất lượt** mà không đi quân nào: đối phương lập tức rút một lá bài và chơi lá đó. |
| +2 | Người chơi **lấy lại 2 Tốt đã bị bắt của mình** (`plus2Pawns`) và đặt chúng trở lại bàn cờ, sau đó đi 1 nước (`movesAfterRecovery`) **[thử nghiệm]**. |
| +4 | Tương tự, với **4 Tốt** (`plus4Pawns`). |
| Đảo chiều | **Bàn cờ đảo chiều**: người cầm quân Trắng chuyển sang cầm quân Đen và ngược lại. Thế cờ không thay đổi. Người chơi hiện tại tiếp tục lượt của mình **với phe mới** (1 nước đi) **[thử nghiệm]**. Ở chế độ Thuần túy, nếu được rút khi đang bị chiếu, lá này lập tức trao quyền đi cho đối phương (mục 5). |
| Joker | Người chơi đi **1 nước**, và **bất kỳ quân nào của mình** cũng có thể đi **như Hậu** (theo đường thẳng hoặc đường chéo, đến vật cản đầu tiên, kể cả ăn quân). Các nước đi thông thường vẫn được phép. Tốt đi đến hàng cuối cùng sẽ được phong cấp; Tốt không được lùi về hàng đầu tiên của mình **[thử nghiệm]**. |

Luật về chuỗi nước đi (nhiều nước đi):

- Nước đi đầu tiên là bắt buộc nếu có nước đi hợp lệ; sau đó người chơi có thể **kết thúc chuỗi** bất cứ lúc nào.
- Một quân có thể được di chuyển nhiều lần. Không rút bài giữa các nước đi.
- Nếu không còn nước đi nào, chuỗi dừng lại.
- Ở chế độ Săn Vua, bắt được Vua sẽ kết thúc ván cờ ngay lập tức; ở chế độ Thuần túy, một nước chiếu sẽ kết thúc chuỗi.

Lấy lại Tốt (+2 / +4):

- Chỉ lấy lại những Tốt **thực sự đã bị đối phương bắt** (không bao giờ nhiều hơn số Tốt đã bị bắt).
- Người chơi chọn ô, **chỉ trong số các ô trống trên hàng xuất phát của mình** (hàng 2 với quân Trắng, hàng 7 với quân Đen): không bao giờ ở hàng khác. Số Tốt được đặt lại tối đa bằng số ô trống trên hàng đó.
- Nếu không có Tốt nào bị bắt, hoặc hàng xuất phát đã kín, lá bài chỉ cho 1 nước đi bình thường; các Tốt đã bị bắt vẫn được giữ lại cho một lá +2 hoặc +4 sau này.
- Ở chế độ Thuần túy, một Tốt được đặt lại mà chiếu Vua đối phương sẽ **kết thúc lượt ngay lập tức**, giống như một nước chiếu kết thúc chuỗi: các Tốt chưa đặt vẫn được giữ lại và các nước đi của lá bài không được thực hiện. Người chơi có Vua vẫn đang bị chiếu thì tiếp tục, để thoát chiếu. Ở chế độ Săn Vua, nếu một Tốt được đặt lại có thể bắt Vua đối phương, luật bắt Vua tự động được áp dụng ngay khi các nước đi bắt đầu.

Đảo chiều: vì không ai giữ bài trên tay, chỉ có hai phe được hoán đổi. Lá Đảo chiều không tạo ra cũng không kéo dài quyền bắt tốt qua đường.

## 5. Chế độ chơi: Thuần túy và Săn Vua

Chế độ được chọn trước ván (ván riêng, hàng chờ xếp hạng hoặc ván đấu với máy) và được cố định trong suốt ván. Điểm Elo dùng chung cho cả hai chế độ; hàng chờ xếp hạng chỉ ghép những người chơi đã chọn cùng chế độ.

### Chế độ Thuần túy

Luật cờ vua được áp dụng, có điều chỉnh cho phù hợp với các lá bài:

- **Không nước đi nào được để Vua của chính mình bị chiếu**: quân bị ghim không được rời khỏi đường thẳng hàng với Vua của nó, Vua không bao giờ đi vào ô bị tấn công (vì vậy không thể ăn một quân đang được bảo vệ), và hai Vua không bao giờ được đứng cạnh nhau. Điều này cũng áp dụng cho các nước đi “kiểu Hậu” của Joker.
- **Vua không bao giờ bị bắt.**
- **Nước chiếu kết thúc chuỗi**: ngay khi một nước đi — hoặc một Tốt được đặt lại — chiếu Vua đối phương, lượt chuyển sang đối phương để họ có cơ hội đáp trả. Không ai được đi quân khi Vua đối phương đang bị chiếu, trừ khi để thoát chiếu cho Vua của chính mình.
- **Rút được Đảo chiều khi đang bị chiếu**: việc hoán đổi phe chuyển nước chiếu sang đối phương (giờ đây chính Vua của họ bị tấn công). Vì vậy lượt kết thúc ngay, không có nước đi nào: đối phương rút bài và phải thoát chiếu, nếu không sẽ bị chiếu hết.
- **Chiếu hết**: khi một người chơi có quyền đi (sau khi rút bài), nếu Vua của họ đang bị chiếu và không có nước đi nào mà lá bài cho phép giúp thoát chiếu, người đó bị chiếu hết và thua ván. Lá bài rất quan trọng: một lá Joker hoặc các Tốt được lấy lại (+2, +4) có thể mang lại cách thoát chiếu mà một nước đi thông thường không có.
- **Đang bị chiếu thì không được mất lượt**: lá Mất lượt rút được khi Vua của mình đang bị chiếu được tính là 1 nước đi, để thoát chiếu. Tương tự, nếu cấu hình không cho nước đi nào sau khi lấy lại Tốt (`movesAfterRecovery` bằng 0) và các Tốt được đặt lại không giúp thoát chiếu, người chơi được đi 1 nước để thoát chiếu.
- **Nhập thành**: theo luật cổ điển, không được nhập thành khi đang bị chiếu, khi Vua đi qua hoặc đi vào ô bị tấn công.
- Người chơi không bị chiếu nhưng không có nước đi hợp lệ nào thì lượt của họ đơn giản là kết thúc.

### Chế độ Săn Vua

Luật gốc của Chess-Uno. Bạn thắng bằng cách **bắt Vua đối phương**.

- Bạn có thể để Vua đứng ở ô bị tấn công, để lộ Vua, di chuyển một quân “bị ghim”, hoặc đặt hai Vua cạnh nhau. Không có gì bắt buộc bạn phải đáp trả một mối đe dọa nhắm vào Vua: việc bị tấn công chỉ là thông tin, nó không chặn hành động nào.
- **Chiếu**: khi một Vua bị tấn công, dòng chữ “Chiếu!” hiện ra với cả hai người chơi và ô của Vua được làm nổi bật. Người chơi liên quan có thể chống đỡ bằng lá bài của lượt mình.
- **Bắt Vua tự động**: nếu, khi bạn có quyền đi (sau khi rút bài, hoặc trong chuỗi nước đi của bạn), một trong các nước đi của bạn có thể bắt Vua đối phương, ván cờ dừng ngay lập tức và bạn thắng, mà không cần thực hiện nước bắt đó. Nếu lá bài không cho bạn nước đi nào (lá Mất lượt), Vua sống sót qua lượt đó.
- Bắt Vua kết thúc ván cờ ngay lập tức và được ưu tiên hơn các nước đi còn lại. Tốt bắt Vua ở hàng cuối không phải chọn quân phong cấp: ván cờ đã kết thúc. Chiến thắng thuộc về **người hiện đang điều khiển** phe thắng (quan trọng sau một lá Đảo chiều).
- **Nhập thành**: điều kiện cổ điển (Vua và Xe chưa di chuyển, các ô ở giữa trống); được phép nhập thành từ, qua hoặc vào ô bị tấn công.

### Ở cả hai chế độ

- Cách đi của các quân, vật cản, việc ăn quân và phong cấp giống như trong cờ vua.
- **Bắt tốt qua đường**: sau khi một Tốt tiến hai ô, nước bắt chỉ có thể thực hiện ngay ở nước đi tiếp theo, bởi phe đối phương. Bất kỳ nước đi nào khác, một lượt bị bỏ qua hoàn toàn hoặc một nước đi thêm của cùng phe (chuỗi) đều làm mất quyền này.

## 6. Chốt chặn chuỗi nước đi **[thử nghiệm]**

Thiết lập `stopComboOnKingThreat = true` theo mặc định, có thể điều chỉnh ở chế độ Săn Vua (ở chế độ Thuần túy, nước chiếu luôn kết thúc chuỗi). Khi được bật, sau mỗi nước đi chưa phải nước cuối của một chuỗi, nếu Vua đối phương bị tấn công, chuỗi dừng lại và lượt chuyển sang phe còn lại. Việc bị tấn công được xác định chỉ dựa trên cách đi của các quân và vật cản trên bàn cờ. Thiết lập này có thể tắt trước ván; nó được cố định trong suốt ván.

## 7. Hòa, xin thua và mất kết nối

- Các trường hợp hòa tự động cổ điển (lặp lại thế cờ, không đủ quân để chiếu hết, luật 50 nước) bị vô hiệu hóa.
- Hòa khi cả hai người chơi đồng ý; xin thua; hòa sau **10 lượt liên tiếp không có quân nào di chuyển** **[thử nghiệm]** (ngưỡng `drawAfterTurnsWithoutMove`, được đặt lại sau bất kỳ nước đi nào thực sự được thực hiện).
- **Mất kết nối**: trong ván giữa hai người, người chơi bị mất kết nối có một khoảng thời gian để kết nối lại (thiết lập của máy chủ, mặc định 60 giây, hiển thị trong luật của ván). Quá thời gian đó mà không quay lại, người đó bị xử thua. Khoảng thời gian này chỉ tồn tại trong bộ nhớ của máy chủ: sự cố hoặc khởi động lại máy chủ không bao giờ khiến ai bị xử thua, ván cờ tiếp tục từ trạng thái đã lưu. Ván đấu với máy có thể được tiếp tục mà không giới hạn thời gian.
- Kết nối lại hoặc tải lại trang không bao giờ khiến bài bị rút lại: toàn bộ trạng thái được lưu sau mỗi lệnh được chấp nhận.

## 8. Những gì người chơi nhìn thấy

Ai cũng thấy: bàn cờ, lá bài được lật trong lượt, chồng bài rút (số lá), chồng bài bỏ của từng người chơi, các Tốt đã bị bắt có thể lấy lại của mỗi phe, phe mà mỗi người điều khiển, các hiệu ứng đang chờ, người chơi được phép hành động, số nước đi còn lại, nhật ký công khai và trạng thái kết nối. Thứ tự của chồng bài rút và yếu tố ngẫu nhiên của máy chủ không bao giờ được gửi đi. Máy cũng chỉ nhận được đúng những thông tin này.

## 9. Xếp hạng

- Chỉ các ván đã kết thúc **giữa hai tài khoản** mới được tính xếp hạng, ở cả hai chế độ và với cùng một điểm số; các ván đấu với máy không được tính.
- Điểm **Elo**: bắt đầu từ 1000; thắng người có điểm cao hơn sẽ được cộng nhiều điểm hơn. 10 ván đầu tiên được tính nặng hơn (K = 40, sau đó là 24) để nhanh chóng xác định vị trí của người chơi mới.
- Các hạng: 🥉 Đồng, 🥈 Bạc (950+), 🥇 Vàng (1050+), 🏆 Bạch kim (1200+), 💎 Kim cương (1400+).
- Xin thua và bị xử thua đều được tính là thua; ván hòa kéo điểm của hai người lại gần nhau hơn.
- Với mỗi cặp người chơi, thành tích đối đầu (thắng, thua, hòa, phong độ gần đây) được công khai.

## 10. Thiết lập có thể tùy chỉnh (giá trị mặc định)

| Thiết lập | Mặc định | Tác dụng |
| --- | --- | --- |
| `gameMode` | `capture` | chế độ chơi: `purist` (Thuần túy) hoặc `capture` (Săn Vua) |
| `maxCardNumber` | 5 | lá số lớn nhất trong bộ bài (1 đến 9) |
| `includeJokers` | true | có dùng Joker |
| `plus2Pawns` / `plus4Pawns` | 2 / 4 | số Tốt được lấy lại |
| `movesAfterRecovery` | 1 | số nước đi sau khi lấy lại Tốt |
| `stopComboOnKingThreat` | true | chốt chặn chuỗi nước đi |
| `drawAfterTurnsWithoutMove` | 10 | hòa do không đi quân |
| `reconnectGraceMs` | 60000 | thời gian chờ kết nối lại (máy chủ) |
