readme_jp.md

プロジェクトについて

このプロジェクトは、ブラウザで雀魂 -じゃんたま-用の麻雀AIです。 ライブラリは使わず、すべてネイティブのジャバスクリプトで作りました。
AIは機械学習ではなく、従来のアルゴリズムを用いている。 簡単に言うといくつかのターンをシミュレートして、最適な手を探しているのです。
三人麻雀と四人麻雀の両モードに対応。
Click here for the English readme.
中文自述在这里.

使用方法

• ユーザースクリプトを実行できるブラウザ拡張機能（例：Tampermonkey）をインストールする。
• この最新リリースを入手し、ブラウザの拡張機能にインストールします。 (Tampermonkeyの場合は、ユーティリティ -> URL からインポートで、ダウンロードURLを入力します)。
• 雀魂 -じゃんたま-を開き、ログインしていることを確認します。
• ゲームに入り、上部のGUIで「Start Bot」をクリックします。
• 「Autostart」にチェックを入れると、ボットが自動的に次のゲームを開始します。
• ログはブラウザのコンソールに出力されます。

BANにならないために

準備なしにBANを受けるリスクは高い。 MajSoul Mod PlusはBANを回避する方法を提供しています。以下、その使い方を紹介します:

1. Header Editor プラグインをインストールする.
2. プラグインを開き、Export and Importタブに移動します。
3. Download Ruleとしてhttps://cdn.jsdelivr.net/gh/Avenshy/majsoul_mod_plus/header%20editor.jsonを記入し、右のダウンロードボタンを押す。
4. Suggested Groupを選び、Saveをクリックします。
5. Tampermonkeyが無効になっていることを確認し、雀魂のゲームウェブページを開いてください。
6. ブラウザのキャッシュをクリアします(下の画像を参照)。F12キーを押してブラウザのコンソールを開き、Applicationタブを開きます。Storageを選択し、Cache storageにチェックを入れます。そして、Clear site dataというボタンをクリックします。
7. ウェブページをリフレッシし（F5）、ブラウザのコンソールを確認します。一番上に"CODE.JS替换成功！"と表示されているはずで、これは成功したことを意味します。
8. Tampermonkeyを有効にし、BANされることなくこのボットを使用できるようになりました。

注意: ゲームが新しいバージョンにアップデートされ、コードが動作しなくなった場合、まずキャッシュをもう一度クリーニングしてみてください（上の画像にあるように）。 それがうまくいかない場合、安全なコードを更新する必要がある:

1. MajSoul Mod Plusのsafe_code.js がまだ新しいバージョンに更新されていないか確認します。
2. その場合は、このリンクをクリックして更新してください。: jsdelivr_purge_cache。 "status": "finished"は成功を意味する。
3. 雀魂に入り、ブラウザのキャッシュをクリアし、ページを更新する。

上記の手順で問題が発生した場合は、MajSoul Mod Plusで質問してください。

GUI

ボットを制御するための簡単なGUIがあります。

• 左ボタン: ボットを起動または停止します。
• ComboBox：AIモード，2つのAIモードがあります。
  • AUTO：プレーヤーの操作を自動的に支援します
  • HELP：ヒントのみを提供し、動作しません
• チェックボックス: オートランモードを有効にする。前のゲームが終了した後にボットは自動的にサイトを再読み込みし、新しいゲームを検索します。ルームは隣のコンボボックスで選択することができます。
• テキストボックス: ボットが現在行っていること、あるいは待っていることを見せます。
• 右ボタンです: GUIを隠します。テンキーで＋を押すと再表示されます。

パラメーター

デフォルトのパラメータは大抵問題ありません。ボットの挙動を変更したい場合（例えば、より攻撃的なプレイスタイルなど）、スクリプトの先頭で定数を変更することができます:

• Defense: 防衛のプレイスタイルを変更する定数です。
• Calls: ボットがタイルを呼び出す頻度を変更する定数です。
• Hand Evaluation Constants: 手牌の価値を計算する方法を変更する定数です。ボットが速い手と高い手のどちらを選ぶかに影響する。
• Strategy Constants: 戦略を修正する定数です。

成果

ボットは雀豪に到達することができます。

テスト

簡単な「何切る?」テストが含まれています。

既知の問題点

-時としてゲームが無為のためにコネクションを切ることがあります。 ブラウザが最小化されていたり、別のタブを使用していることが原因である可能性があります。