- The project aims to provide more people with experience of a new form of Hold'em game.
- Develop an on-line strategy card game based on Texas Hold'em rule that allows multiplaying using an artificial intelligence agent.
- Astrologers of the past must use their foresight to create stars, turning all stars into black dwarfs.
- Astronomers of the future must use the energy of gravitational collapse to annihilate stars, turning all stars into black holes.
- In the process, countless stars, from protostars to supergiants, are created, along with numerous supernova explosions.
- You can become the greatest astrologer and travel to the future, or the greatest astronomer and leap into the past.
- Or you can choose to remain neutral and simply become a brilliant star collector or a ruthless star destroyer.
- Develop the game application that supports multiplayer with online.
- Train AI agents capable of playing Hold'em and integrate them into the application.
More Infomation for Fallentia-project : Please refer to the documents in Notion page
-
Domain Knowledge : No Limit Texas Holdem, Astrophysics
-
Programming :
1) Architecture : - Building a server-to-server communication network through HTTP, MessageBroker(RabbitMQ) and gRPC - Design and implementation of an actor-model-based asynchronous event-driven MSA using DDD and DI patterns 2) PL : Python, C#, Rust(PyO3) 3) Backend : - Design and implementation of a multi-user game engine utilizing an asynchronous lock-based state isolation structure - Building a Python WebSocket server - Building a FastAPI Web server 4) DB : - Building a MySQL(SQLAlchemy) and MongoDB(Beanie, Motor) database server for managing web/app service user data 5) Application : Mobile(Android, iOS) app UI development using Unity 6) Asyncrnous Programming : AsyncIO 7) Parallel Computing : Multi-processsing, Threading -
Design system : Figma
-
Deep Learning : LLM, DRL
-
DevOps : AWS, Docker
1. Implementing "AI agent System".
2.
06.28.2025
- Converting code from MSA to Monolithic for test-driven development [시스템 구성도 Monolithic]
06.12.2025
- Game Story Writing
06.03.2025
- Migrating virtual environments from conda to poetry
05.27.2025
- Modify all functions that use asynchronous lock
05.20.2025
- Plans to modify the MQ implementation (reprocessing logic, DLQ).
- plans to optimize asynchronous/synchronous functions.
- consider introducing a dedicated WebSocket message loop.
[시스템 구성도 MSA scale-out]
05.12.2025
[시스템 구성도 MSA]
04.21.2025
- MSA Structure Review
04.11.2025
- Message Queue Design Feasibility Review
04.07.2025
- Reviewing the asynchronous lock custom dictionary bottleneck issue
03.25.2025
- Card design completed
03.24.2025
- Game concept confirmed
03.21.2025
- The game title is named "Fallentia"
1. Implementing "Tier-Point System" for SNG tournament level structure.
2. Implementing "Ranking System" for Cash game.
03.10.2025
- Completed establishing Text Holdem House_3.0 operating detailed rules.
- Completed making implementation rules.
02.24.2025
- completed implementation of "Observer Mode"
- completed implementation of "Seat Selection System"
02.13.2025
- Completed implementation of Positioning algorithm for Cash and SNG
12.31.2024
- Buy-in and Bank system, Observer Mode, Seat Selection system, Positioning algorithm, Sit-out system logic completed and reviewed. Pseudo code completed.
1. Implementing "Buy-in and Bank system" when joining to the table.
2. Implementing "Observer Mode" allowing users to spectate table without joining.
3. Implementing "Seat Selection System" that players can manually select empty seats at a table.
4. Implementing "Positioning Algorithm" which incorporates 'WSOP' and 'TDA' rules for seat positioning and action order at the start of a new hand.
5. Implementing "Cash" table that actual ring game, in addition to the 'Sit and go tournament game' in House_1.0.
6. Implementing "Quick Join feature" that allow users to start playing immediately.
7. Implementing "Friend System" providing 'Private Sit-and-Go Tables' and 'direct message' to friends
8. Implementing "Penalty System"
12.12.2024
- Completed establishing Text Holdem House_2.0 operating detailed rules.
- Completed making implementation rules.
- Completed final design of Table scene.
- Completed final design of Lobby scene.
12.04.2024
- Fully mastered the rules of casino.
11.04.2024
-
Started learning the rules of casino.
1. Differences between Cash Games and Tournaments in Texas Hold'em 2. Rules for new players to follow when joining a hand at a table with existing players 3. Rules for 'sit out' / 'sit in' at a table Official References: WSOP, TDA Unofficial References: GGpoker, Pokerstars, REPLAYpoker, IgnitionCasino
[break 10.26 ~ 11.03 travel to Japan]
10.25.2024
- Completed initial design of Table scene
10.23.2024
- Completed initial design of Lobby scene
10.08.2024
- Started UI Design
- Improvement of server routers for WebGL Builds
10.05.2024
- Completed implementation of WebSocket Connection script between Unity Client and FastAPI Server(Floor and Dealer) through BestHTTP
- Completed design of GoLobby scene and connection between Enter scene and GoLobby scene
09.27.2024
- Completed implementation of HTTP connection script between Unity Client and FastAPI Server(Reception)
- Completed design of Enter scene
1. Reception-Client : application UI for user services
2. Floor-Client : application UI for floor services, lobby services, broadcasting services
3. Dealer-Client : application UI for dealer services
4. HTTP, WebSocket connection : using BestHTTP
5. UI Rendering : Images and Animations for scenes (Common, Enter, GoLobby, Lobby, GoTable, Table, LeaveTable)
6. Build and Distribution test
[break 09.14 ~ 09.18 Korean Thanksgiving Day]
1) NLHE Dealer Engine
- A robust dealer engine for No-Limit Texas Hold'em.
2) Sit and Go (SNG) Table
- Automatic random seating; players cannot choose empty seats.
- Dealer button moves clockwise by one position after each hand.
- Games begin only when the table is full and restart once a game ends and the table fills again.
3) Lobby System
- Features table creation, joining, cancellation, and search functionality.
4) Global Chat System
- Allows players to communicate across the platform.
09.12.2024
- Schematic diagram of class connection structure
| Server | Reception | Floor | Dealer | Agency |
|---|---|---|---|---|
| Router | UR : user_router | LR : lobby_router | DR : dealer_router | |
| CM : ConnectManager | CM : ConnectManager | |||
| Service | UM : UserManager | FM : FloorManager | DM : DealerManager | AM : AgentManager |
| SM : StackManager | LM : lobbyManager | Dealer | TM : TrainManager | |
| TB : TableBroadcaster | Base | |||
| CB : ChatBroadcaster | ||||
| BB : BigBoss | ||||
| DB | DB : MySQL | DB : MongoDB | DB : MongoDB | |
| MessageBroker | MP : MessageProducer | MP : MessageProducer | MP : MessageProducer | |
| MC : MessageConsumer | MC : MessageConsumer | MC : MessageConsumer |
09.11.2024
- Test log analysis
- completed implementation of logic for handling users who disconnect during the game
- completed implementation of logic for handling users who reconnect to the game
- completed implementation of logic for imposing penalties on users who violate the rules
- completed implementation of server reconnection client logic
- completed modification of table continuation logic
- completed optimization of managing table logic
- completed optimization of Hold'em game end conditions
09.04.2024
- completed test for Dealer server
- completed test for Communication between servers
08.14.2024
- completed test for Floor server
08.08.2024
- completed test for Reception server
- completed test for communication between Reception and Floor
1. Reception: Test sign-up, sign-in, authentication procedures, and anti-fraud functions
2. Floor: Test chat service, broadcasting service, and table matching service after connecting the client and websocket
3. Dealer: Test hold'em game progress after connecting the client and websocket
4. Communication between servers: Test message broker (Reception-Floor-Dealer)
5. Asynchronous programming test
6. Server performance test: Resource usage, load test, bottleneck test
08.06.2024
- completed implementation of reception, floor, dealer server algorithms
- completed implementation of floor server and dealer server connection with message broker
08.03.2024
- completed implementation of reception server and floor server connection with message broker
07.31.2024
- Completed implementation of floor server and client connection via websocket
07.30.2024
- Concurrency test for CPU bound / disk I/O bound / CPU + diskI/O bound
- Planned to additional test for network I/O bound test after back-end development.
07.29.2024
- Completed implementation of dealer server and client connection via websocket
07.24.2024
- Completed MicroService Architecture design.
1. Implementing reception, floor, and dealer server algorithms
2. Implementing server-client connections
3. Implementing communication between servers
07.19.2024
- Started learning AsyncIO.
07.18.2024
- Started learning message broker.
07.16.2024
- Started learning socket programming. (WebSocket)
07.10.2024
- Completed implementation of "side pot" creation and management algorithm.
- Completed implementation of "pot award" algorithm.
07.05.2024
- Completed implementation of “end condition” algorithm.
- Implement test case DB and test functions and start dealer logic testing.
07.02.2024
- Completed implementation of “Showdown” ranking comparison algorithm.
07.01.2024
- Review of “showdown” and “pot award” connection logic.
06.28.2024
- Review “end condition” and “showdown” connection logic.
06.27.2024
- Review “pot creation and management” logic.
06.26.2024
- Review “end condition” logic.
06.25.2024
- Completed implementation of “bet”, “raise”, “all-in”, “call”, “check”, and “fold action” algorithms.
1. Implementing an algorithm that acts as a dealer in a Texas Hold'em game
2. Implementing calculations of the types of actions a user can make each turn
3. Implementing calculations of conditions for ending each street and hand
4. Implementing calculations of main pot and side pot
5. Implementing showdown
6. Implementing pot distribution
06.19.2024
-
Completed Monolithic Architecture design.
-
Planned to upgrade to MicroService Architecture after development of texas holdem dealer algorithm.
06.10.2024
- Started learning Unity.
06.08.2024
- Started Designing the game architecture.
- Conceptualized the core logic for the Holdem game application.
06.04.2024
- Fully mastered the rules of Texas Holdem.
05.14.2024
- Started studying FastAPI for backend development
04.24.2024
- Started learning the rules of Texas Holdem.
This project is proprietary and all rights are reserved.
Unauthorized copying, distribution, modification, or any other use is strictly prohibited without explicit permission from the author.