Skip to content

A tool for Riichi Mahjong how-to-cut (何切る) training.

License

Notifications You must be signed in to change notification settings

AokoC/MahJourney

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

31 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

MahJourney 何切之旅

[ Eng | 简中 | 繁中 | 日本語 ]

A tool for Riichi Mahjong how-to-cut (何切る) training. You can upload custom discard problems with images; manage problem sets, import or export problem collections; and practice discards after selecting modes or filtering problems. It can also be used simply as a collection and appreciation tool for gathering complex board state discards you have encountered.

Wish you continuous improvement in your Mahjong skills.

Features

Practice!

Practice makes perfect.



On the practice page, filter the desired problems and modes, then start answering. Select your discard action and tile, then submit.

You can immediately see the pre-set answers (correct/incorrect indicated by green/red borders), and the "Question" on the left sidebar will change to show "Explanation".



Also supports problems with images. Suitable for complex situations involving call judgments, point calculations. Note that the images themselves are not clickable.


Upload Problem



The initial page for uploading problems. Here you can:

  • Fill in basic information like title, background, and game info.
  • Write the question and explanation.
  • (Optional) Upload or paste an image.
  • (Optional) Set a custom difficulty level for future reference and filtering.
    • Default is 0. If set to 0, the difficulty will not be displayed in the practice interface or problem bank.


  • Select Dora indicators, hand tiles, answer action, and answer tile.

Manage Problems





The management page. Here you can:

  • Browse your problem bank in list or grid view.
  • Select a specific problem to modify it or view its practice statistics.
  • Batch select multiple problems for operations like deletion or export.
    • Export packages the corresponding data and images into a .zip file, saved to .../saves/export/. You can use this for backups.
    • Deletion cannot be undone.
  • Import problems.
    • Generally only accepts .zip files generated by the export function.


  • Use condition filters or hand tile filters to browse only problems that meet specific criteria.

Planned Features

Listed from more likely to less likely:

  • Improve translations and fix errors in various language versions.
  • Add a stats page to view special data, like total attempts, total time spent, etc.
  • Web version.
  • Automated analysis of tile counts and waiting tiles, eliminating the need to manually write related explanations.
  • Mobile app version.
  • Image recognition for automatic hand tile input.

This project was initially created to fulfill my personal needs, so it's unlikely I will implement most of the above features... PRs are welcome if you are interested.

Download

v0.9.1 Releases

FAQ

What's the "何切三百" in your screenshot?

That's a set of problems and I created that set myself. You can also find it in Releases, named 300.zip. Import this file in the management interface. Think of it as an optional built-in problem bank.

Note that this problem set only contains the problems themselves, without explanations, and there might be errors due to manual entry. Some answers have been adjusted according to Naga's suggestions or include multiple correct answers. Please refer to the original "300 Problems" book and this Bilibili article for details.

Uploading a large number of problems at once can be very labor-intensive. If you need to do bulk uploads (e.g., for other problem books):

Please refer to this file. This script can help you convert a large number of .txt format problems (separated by newlines) into the data.json format used by this software. However, you still need to create the .txt files manually (and I forgot to make it require a .zip for import, so you might need to compress it manually afterwards).

Can I change the tile faces?

Certainly. Open .../_internal/src/assets/tiles - that's where the tile face resources are stored. You can freely replace them as long as you keep the filename, format, and dimensions (70*100) the same.

Some text appears cramped or overlapping when I open the software.

Try resizing the window, or adjust the font size until it looks right. Then restart the software.

About

A tool for Riichi Mahjong how-to-cut (何切る) training.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages