| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
Discuss (mail)
|
| Lines of code | 3513 |
| Technical Name |
odoo_chess |
| License | LGPL-3 |
| Website | https://github.com/Codemarchant/odoo_chess |
| Versions | 17.0 18.0 19.0 |
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
Discuss (mail)
|
| Lines of code | 3513 |
| Technical Name |
odoo_chess |
| License | LGPL-3 |
| Website | https://github.com/Codemarchant/odoo_chess |
| Versions | 17.0 18.0 19.0 |
Odoo Chess
Multiplayer Chess Game for Odoo
Overview
A fully integrated multiplayer chess game that runs entirely inside Odoo. Challenge colleagues, play against computer bots, and compete on the leaderboard!
Odoo Chess brings the classic game of chess directly into your Odoo instance. Create games, invite opponents, and play in real-time with moves synchronized via Odoo's longpolling bus. No external chess servers or third-party services required — everything runs natively within Odoo.
Features include comprehensive time controls (Bullet, Blitz, Rapid, Classical), an Elo rating system with leaderboards, AI bot opponents of varying difficulty, game invitations with notifications, and full game controls including resign, draw offers, and timeout claims.
Real-Time Multiplayer Chess
Play against other Odoo users with live move updates and ticking clocks
Two players battling it out with Rapid time control - timers tick down after each move
How It Works
Create a Game
Click "New Game" and choose Human or Bot opponent with your preferred time control
Send Challenge
For human games, your opponent receives an invitation notification
Play Chess
Drag and drop pieces to make moves with real-time synchronization
Climb the Ranks
Win games to increase your Elo rating and top the leaderboard
Flexible Game Setup
Choose your opponent, color preference, and time control
New Game wizard with Human opponent selected and Rapid time control
Game Type
- Play vs Human: Challenge any Odoo user
- Play vs Bot: Practice against computer opponents
- Color Choice: Play as White, Black, or Random
Time Controls
- Bullet: 1+0, 1+1, 2+1
- Blitz: 3+0, 3+2, 5+0, 5+3
- Rapid: 10+0, 10+5, 15+10
- Classical: 30+0, 30+20, 60+30
- Custom: Set your own time and increment
Challenge System
Send and receive game invitations with optional stakes
Pending invitation showing Mitchell Admin challenging Marc Demo
Real-time notification when opponent accepts and game starts
Invitation Features
- Instant Notifications: Opponents receive real-time alerts via Odoo bus
- Chat Integration: A discuss channel is automatically created between players
- Stakes/Rewards: Add fun stakes like "Loser buys coffee" to make games interesting
- Accept/Decline: Recipients can accept or decline with a single click
Key Features
Real-Time Gameplay
Moves sync instantly via Odoo's longpolling bus. See your opponent's moves appear in real-time with sound effects for moves, captures, and checks.
Elo Rating System
Every player starts at 1200 Elo. Win games to increase your rating, lose to decrease it. Compete to become the office chess champion!
Time Controls
From lightning-fast Bullet to thoughtful Classical. Includes increment support. Players can claim timeout victories when opponent's clock runs out.
Bot Opponents
Practice against 4 difficulty levels: Beginner Bob (800), Casual Carl (1200), Serious Sam (1500), and Randy Ram (1800). Powered by the Sunfish engine.
Full Game Controls
Resign, offer draws, accept/decline draw offers. Claim draws by threefold repetition or fifty-move rule. All standard chess controls available.
Responsive Design
Play on desktop or mobile. The board and controls adapt to any screen size. Perfect for a quick game during lunch on your phone!
Leaderboard
See who's the best chess player in your organization
Leaderboard showing player cards with Elo ratings and win/loss/draw statistics
Elo Ratings
K-factor 32 rating system tracks skill progression
Win/Loss/Draw
Complete statistics for every player
Kanban View
Visual player cards ranked by rating
Odoo Fun Facts
Learn about Odoo while waiting for your opponent's move
Built-in Odoo facts displayed during gameplay - managers can add custom facts
Fact Categories
- Odoo History: Learn about Odoo's origins
- Odoo Features: Discover useful capabilities
- Usage Tips: Productivity shortcuts
- Fun Facts: Interesting trivia
Complete Chess Experience
Legal Move Validation
Server-side validation with python-chess ensures all moves are legal
Checkmate Detection
Automatic detection of checkmate, stalemate, and insufficient material
Draw Rules
Threefold repetition, fifty-move rule, and draw by agreement
Sound Effects
Audio feedback for moves, captures, castling, check, and game end
Technical Details
OWL Components
Modern frontend built with Odoo's OWL framework
Odoo Bus
Real-time move synchronization via longpolling
Access Control
Chess Player and Chess Manager security groups
Mail Integration
Games inherit mail.thread for comments and activity
Requirements
Dependencies
- base — Odoo core
- web — Web framework
- mail — Messaging
- bus — Real-time communication
Python Libraries
- python-chess —
pip install chess
Compatibility
- Odoo 17 Community & Enterprise
Support
Need help? We're here to assist you.
Email Support
support@codemarchant.com
Website
codemarchant.com
Ready to Play?
Install Odoo Chess, challenge a colleague, and may the best player win!
Odoo Chess
Requirements
Python Dependencies
This module requires the python-chess library for move validation and game logic.
Install via pip:
pip install chess
Changelog
Version 17.0.1.0.0
- Initial release
- Real-time multiplayer chess via Odoo bus
- AI bot opponents (4 difficulty levels)
- Time controls: Bullet, Blitz, Rapid, Classical, Custom
- Elo rating system with leaderboard
- Game invitations with notifications
- Draw offers, resignations, timeout claims
- Responsive design for desktop and mobile
- Odoo Fun Facts display during gameplay
Please log in to comment on this module