tenhou-python-bot - 天凤麻将 Python机器人

项目说明

!Build [[Tests co]]()

The project is not maintained anymore, and exists primary for historical reasons and references.

Bot was tested with Python 3.7+ and PyPy3, we are not supporting Python 2.

What do we have here?

!Example of bot game

Mahjong hands calculation

You can find it here:

Mahjong bot

For research purposes we built a simple bot to play riichi 麻将. It can be run locally.

For de

How to run it?

1. pip install -r requirements/lint.txt
1. Run cd project && python main.py it will connect to the tenhou.net and will play a 游戏.

How to run bot battle with pypy

To make it easier run bot vs bot battles we prepared PyPy3 Docker container.

Run the game locally:

1. Install Docker
1. Run make build_docker
1. Run make GAMES=1 run_battle it will play one 游戏 locally. Logs and replays will be stored in bots_battle folder.

Run bots with enabled decision logger (use it only for debug, since it harms performance):
1. Run make GAMES=1 ARGS=--logs run_battle

Run multiple bots to play one game

1. Install Docker and Install Docker Compose
1. Run make build_docker
1. Put bot configs to project/settings/. By default we are looking for these configs: bot_1_settings.py, bot_2_settings.py, bot_3_settings.py, bot_4_settings.py, bot_5_settings.py. Why 5 settings? Because tenhou doesn't start 2+ 游戏 in the custom lobby if you are running only 4 bots.
1. Run make run_on_tenhou

Configuration instructions

1. Put your own settings to the project/settings/settings_local.py file.
They will o settings from default settings/base.py file.
1. Also, you can o some default settings with command arguments.
Use python main.py -h to check all a commands.

Game reproducer

It can be useful to debug bot errors or strange discards: 游戏 reproducer

技术栈

开发语言：Python

项目类型：天凤麻将 Python bot

Star 数：209

功能特点

这是一套天凤麻将 Python bot，代码结构清晰，适合开发者学习游戏的客户端渲染、服务端逻辑、场景管理与资源加载。项目涵盖了游戏的核心玩法、界面交互、地图与角色系统等模块，对理解游戏开发的完整流程具有较高的参考价值。

从技术实现角度看，游戏项目的难点在于：游戏循环与状态管理、资源加载与渲染优化、客户端与服务端的协议同步、以及多平台适配。本项目在这些方面提供了可运行的实现，开发者可以在此基础上进行二次开发或学习研究。

部署说明

1. 下载源码压缩包，解压到本地开发环境。

2. 根据项目类型准备对应的运行环境（Node.js / Go / C# / Unity / Godot 等）。

3. 按照 README 中的步骤配置依赖、数据库和配置文件。

4. 先启动服务端，再运行客户端，即可进入游戏进行测试。

注意：本项目仅供学习研究使用，请勿用于商业或非法用途。

学习价值

对于想进入游戏开发领域的开发者来说，这套源码是一个很好的入门参考。通过阅读代码，可以学习到游戏的核心玩法实现、场景与资源管理、网络协议设计、以及渲染优化等关键技术点。

同时，项目中的代码组织方式和模块划分，也展示了游戏项目在工程化方面的实践经验，值得开发者深入研究和借鉴。理解一个完整游戏项目的架构，对后续开发其他类型游戏也很有帮助。

免责声明

本资源来源于开源社区，仅供学习研究和技术交流使用，请勿用于任何商业或违法违规用途。使用本项目产生的一切后果由使用者自行承担。若涉及第三方权益，请联系删除。