Grasscutter/docs/README_ja-JP.md

EN | 简中 | 繁中 | FR | ES | HE | RU | PL | ID | KR | FIL/PH | NL | JP | IT | VI

＊: 私たちはプロジェクトへの貢献者をいつでも歓迎します。貢献を追加する前に、我々の 行動規範をよくお読みください。

現在機能している物

• ログイン
• 戦闘
• フレンドリスト
• テレポート
• 祈願(ガチャ)
• マルチプレイは一部機能しています
• コンソールを使用してモンスターをスポーンさせる
• インベントリ機能 (アイテム/キャラクターの受け取り､アイテム/キャラクターのアップグレードなど)

クイックセットアップガイド

＊: サポートが必要な場合はGrasscutterのDiscordに参加してください。

動作環境

• JAVAのバージョン17以降

＊: サーバーを動作させるだけならjreのみで十分です｡ 開発をしたい場合JDKが必要になるかもしれません。

• MongoDB (バージョン4.0以降を推奨)

• プロキシツール: mitmproxy (mitmdump, 推奨)、Fiddler Classic、その他｡

起動方法

＊: もしサーバーをアップデートしたい場合はconfig.jsonを削除してから再生成してください。

1. grasscutter.jarを入手する
   • releases か action からダウンロードするか、自分でビルドしてください｡
2. grasscutter.jar があるディレクトリに resources フォルダーを作成し、そこに BinOutput, ExcelBinOutput, Readables, Scripts, Subtitle, TextMap を移動してください (resources フォルダの中身の入手方法については wiki を参照してください.)
3. コマンドプロンプトにjava -jar grasscutter.jarを入力しGrasscutterを起動してください。このときMongoDBも実行する必要があります。

クライアントとの接続

½. このコマンドをサーバーコンソールから使用してアカウントを作成してください｡

1. 通信内容をリダイレクトする: (どちらか一つを選択してください)

   • mitmdump: mitmdump -s proxy.py -k

     • CA証明書を信頼する:

     • ＊: CA証明書は%USERPROFILE%\.mitmproxyに保存されています。ダブルクリックしてインストールするか...

     • コマンドライン経由でインストールします

     certutil -addstore root %USERPROFILE%\.mitmproxy\mitmproxy-ca-cert.cer
     

   • Fiddler Classic: Fiddler Classicを起動し(Tools -> Options -> HTTPS)からDecrypt https trafficをオンにしてください｡ (Tools -> Options -> Connections) に有るポート番号の設定を8888以外に設定してください。その後このスクリプトをFiddlerScriptタブにコピペしてロードします。

   • ホストファイル

2. ネットワークプロキシを 127.0.0.1:(自分で設定したポート番号) に設定してください｡

3. mitmproxyを使用した場合：プロキシの設定と証明書のインストールが終わった後、http://mitm.it/ でトラフィックがmitmproxyを通過しているか確認しましょう。

start.cmdでmitmdumpとサーバーをまとめて起動することが出来ます。ただ、事前にstart_config.cmdでJAVAのパスを指定している必要があります。

ビルド

GrasscutterはGradleを使用して依存関係とビルドを処理しています。

要件:

• Java SE Development Kits - 17以降
• Git

Windows

git clone https://github.com/Grasscutters/Grasscutter.git
cd Grasscutter
.\gradlew.bat # コンパイル環境の構築
.\gradlew jar # コンパイル

Linux

git clone https://github.com/Grasscutters/Grasscutter.git
cd Grasscutter
chmod +x gradlew
./gradlew jar # コンパイル

生成されたjarファイルはプロジェクトフォルダのルートに有ります。

コマンドリストはwikiへ移動しました｡

トラブルシューティング

• コンパイルが失敗した場合JDKがインストールされているか確認してください。(JDKのバージョンが17以降であることと、環境変数でJDKのパスが設定されている必要があります)
• クライアントが接続できない・ログインできない・エラーコード4206・またその他場合、ほとんどは、プロキシデーモンの設定が問題です。Fiddlerを使っている場合はデフォルトポートを8888以外の別のポートに変更してみてください。 Fiddlerを使用している場合はポートが8888以外に設定されていることを確認してください。
• 起動シーケンス(順番): MongoDB > Grasscutter > プロキシツール (mitmdumpかfiddler、その他) > ゲーム