README.md

majsoul-monthTicket-auto

日本語 한국어

This project automates daily logins to Majsoul to achieve the attendance achievement (8bit Riichi BGM) and collect the daily Fortune Charm using GitHub Actions.
This project is based on the mahjong_soul_api.

Prerequisites

1. Access Majsoul through a browser.
2. Press F12 to open developer mode.
3. Navigate to the Network tab and search for login.
4. Check the payload of the xhr or fetch format login file that appears in the search results.
5. Note down the required token and uid values.
   
   

Setup Instructions

1. Fork this project on GitHub.
2. Navigate to Settings > Secrets and variables > Actions in your forked project.
3. Click New repository secret.
4. For Name, enter UID, and for Secret, enter the uid value noted earlier, then click Add secret.
5. Create another Repository secret with Name as TOKEN and Secret as the token value noted earlier, then click Add secret.
6. The default server location is set to the JP server. If you wish to switch to the EN server, modify the MS_HOST value in main.py to https://mahjongsoul.game.yo-star.com/.
7. The default connection time is set to 6:05 AM KST daily. If you want to change this, modify the cron value in .github/workflows/main.yml.
8. Go to the Actions tab at the top and click the I understand my workflows, go ahead and enable them button to activate the workflows.
9. Navigate to the Login to Majsoul tab under Workflows on the left and click Enable workflow.
   
   

Testing Instructions

1. Log in to Majsoul through a browser.
2. Click Run workflow under the Actions > Workflows tab.
3. If it operates correctly, the browser session of Majsoul will be forcibly terminated due to double connection.
   
   

Caution

• GitHub Actions can be delayed by up to 30 minutes beyond the scheduled time due to server load on GitHub.
• Be cautious not to disclose your token and uid to others.