Overview
Payas Omi is a fully client-side, single-file web implementation of Omi — a traditional Sri Lankan trick-taking card game. It requires no server, no build step, and no installation. Open payas-omi.html in any modern browser and play immediately.
Payas Omi is released under the MIT License and built and maintained by Saman Udayanga Wijesinghe as part of the Payas design suite.
| Property | Value |
|---|---|
| File | payas-omi.html |
| Stack | HTML5 · CSS3 · Vanilla JS (ES2022) |
| Dependencies | Bootstrap 5.3 · Font Awesome 6.5 · Google Fonts |
| Storage | localStorage (auto-save) · .md file export/import |
| Players | 4 (1 human + 3 AI bots) |
| Teams | Us (South + North) vs Them (West + East) |
| Browser support | Chromium-based · Firefox |
| Theme | Light and Dark mode |
| Responsive | Desktop and mobile |
Quick Start
No build or server needed — just open the file:
xdg-open payas-omi.html # Linux
open payas-omi.html # macOS
start payas-omi.html # Windows
Or serve locally to avoid file:// quirks:
npx serve .
python3 -m http.server 8080
Game Rules
Omi is a trick-taking game for 4 players split into 2 partnerships:
- Us — South (you) + North (AI partner)
- Them — West (AI) + East (AI)
A standard 52-card deck is used. Each player receives 13 cards. Cards rank A > K > Q > J > 10 … > 2 within any suit.
Round Flow
Deal → Trump Reveal → Play 13 Tricks → Score → Next Round
- A trump suit is randomly chosen each round and beats all other suits.
- You must follow the led suit if you hold one; otherwise play any card including trump.
- The highest trump wins the trick, or the highest card of the led suit if no trump was played.
- The first team to reach the Winning Score (default: 52) wins the game.
Scoring Modes
| Mode | Rule |
|---|---|
| Each trick = 1 pt (default) | Both teams score the number of tricks won. 13 points per round. |
| Winner takes all | The team with more tricks scores 13. The other scores 0. |
AI Difficulty
All three AI players share the same decision engine, parameterised by difficulty:
| Level | Behaviour |
|---|---|
| Easy | Plays a random legal card — no strategy. |
| Medium (default) | Leads highest non-trump; tries to win tricks or conserve when partner is ahead. |
| Hard | Same as Medium, plus leads with the highest trump when holding multiple trumps to draw out opponents. |
Settings
| Setting | Options | Default |
|---|---|---|
| Winning Score | 29 / 52 / 100 | 52 |
| Scoring Mode | Each trick = 1 pt / Winner takes all | Each trick = 1 pt |
| Your Name | Text (max 12 chars) | You |
| AI Difficulty | Easy / Medium / Hard | Medium |
| Dark Mode | On / Off | Off |
Keyboard Shortcuts
| Shortcut | Action |
|---|---|
| Ctrl + N | Start a new game |
| Ctrl + T | Toggle dark / light theme |
Save & Load
Game state is auto-saved to localStorage after every completed round and restored on the next page load.
You can also export a human-readable .md save file from the round result screen or Settings, and import it later to resume from any saved score.
Get Payas Omi
| Resource | Link |
|---|---|
| GitLab Repository | gitlab.com/samanscode/payas-omi |
| Download ZIP | payas-omi-main.zip |
License
Payas Omi is released under the MIT License.
© 2025 Saman Udayanga Wijesinghe