mahjong-utils-app - 日麻计算器 App

项目说明

Riichi Mahjong Calculator
======

中文 日本語

!icon

For Web:

For Android:

Download from F-Droid:

<img src="
alt="Get it on F-Droid"
height="80">

Or go to Releases and download

composeApp-release.apk in the latest release.

For Desktop:

Go to Releases and download installer/JAR

for your OS in the latest release.

| OS | Installer File (install to run, no Ja) | JAR File (click to run, Java 11+ required) |
|---------------|---------------------------------------------------|---------------------------------------------------|
| Windows (x64) | mahjong-utils-app-xxx-x64.exe | mahjong-utils-app-windows-x64-xxx-release.jar |
| macOS (arm64) | mahjong-utils-app-xxx-arm64.dmg | mahjong-utils-app-macos-arm64-xxx-release.jar |
| macOS (x64) | mahjong-utils-app-xxx-x64.dmg | mahjong-utils-app-macos-x64-xxx-release.jar |
| Linux (x64) | mahjong-utils-app-xxx-x86_64.AppImage | mahjong-utils-app-linux-x64-xxx-release.jar |

For iOS:

Go to Releases and download

iosApp-unsigned.ipa in the latest release.

Sign it yourself and install using Sideloadly or any other signing

tools.

Features

Hand Efficiency: Includes tile efficiency, good-shape tile efficiency (for one-shanten only), and

backwards strategy.

!Hand Efficiency

Meld Hand Efficiency: Tile efficiency for chow, pung, kong, and pass; includes good-shape tile

efficiency (for one-shanten only) and backwards strategy.

!Meld Hand Efficiency

Winning Hand Analysis: Defaults to 麻将 Soul/Tenhou rules, with customizable rules to some

extent.

!Winning Hand Analysis
!Customizable Rules

Score Calculation By Fan and Minipoints: Defaults to 麻将 Soul/Tenhou rules, with customizable

rules to some extent.

!Score Calculation By Fan and Minipoints

Image Recognition for Mahjong Tiles

Any input field that requires 麻将 tiles can utilize the image recognition feature.
Open the menu from the input keyboard, or long-press/right-click on the input field
to select options like "Recognize from Image". You can also paste from the clipboard
using the shortcut Ctrl+V (or Cmd+V on macOS).

Note: For optimal recognition results, use screenshots from ~Majsoul~ (the trained model is
specifically designed for ~Majsoul~).

!image-recognize.gif

Addition

The algorithm runs at local, no 网络 access will be made.

App based on Kotlin/Multiplatform and Compose Multiplatform, PR is welcomed.

If you find any bug or incorrect translation, please report
in issue.

LICENSE

MIT

技术栈

开发语言：Kotlin

项目类型：日麻计算器 App

Star 数：117

功能特点

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

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

部署说明

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

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

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

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

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

学习价值

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

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

免责声明

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