マイクラ（Java版）のワールドを、友達と一緒に遊ぶ。それだけ。
URL をひとつ送るだけ。友達のマイクラに、あなたのワールドが出てきます。
❌ ルーターの設定（ポート開放） ❌ アカウント登録 ❌ サーバー契約 ❌ 月額料金 ❌ VPN ソフトのインストール ❌ ネットワークの知識 ❌ サーバー（realms など）の購入
✅ アプリを開く ✅ ボタンを押す ✅ 出てきた URL を友達に送る
これだけです。
- マイクラでワールドを開いて、ESC →「LAN に公開」
mc-share-guiをダブルクリックで起動- 「Host」を押す
- 出てきた URL をコピーして、友達に LINE / Discord / なんでもいいので送る
mc-share-guiを起動- 「Join」タブを開いて、もらった URL を貼り付ける
- 「Connect」を押す
- マイクラを開く → マルチプレイ → 友達のワールドが勝手に出てくる
- クリックして入る。以上。
マイクラ本体のマルチプレイ画面に、まるで同じ家にいるかのようにワールドが現れます。
自分の OS のものを選んでください。
| OS | 使うファイル |
|---|---|
| Windows | mc-share-gui-windows-x64.exe |
| Mac (Intel / Apple Silicon どちらも) | mc-share-gui-macos |
| Linux (x64) | mc-share-gui-linux-x64 |
| Linux (arm64) | mc-share-gui-linux-arm64 |
ダブルクリックで起動。インストール作業もいりません。
Mac / Linux の場合、初回だけ実行権限が必要です:
chmod +x mc-share-gui-macos
Windows の場合、wingetでインストールもできます。
PowerShellを開いて、 winget install minescale
これだけで、mc-share-gui が使えるようになります。
ふつうマイクラを友達と遊ぼうとすると、
- ルーターのポート開放
- グローバル IP の固定
- realms の月額契約
- Hamachi みたいな VPN ソフトのインストールとアカウント登録
- マイクラサーバーの建立と運用
…と、めちゃくちゃ面倒です。
MineScale-Java は、これら全部を 裏側で自動的に やってくれます。 あなたがやることは、ボタンを押すだけ。
# ホスト
mc-share host
# 参加
mc-share join <URL>GUI と機能はまったく同じです。お好みでどうぞ。
ダウンロード時に 「一般的にダウンロードされていません」 や、 起動時に 「Windows によって PC が保護されました」 という警告が出ることがあります。
これは Windows の SmartScreen 機能が「ダウンロード数の少ない exe ファイル」を 自動的に警告するためで、ファイルに問題があるわけではありません （ただ単に、まだあまり使われていないアプリだから）。
- ブラウザの「ダウンロード」一覧で当該ファイルの行の 「…」(三点) メニューを開く
- 「保持する」 （英語版は "Keep"）を選ぶ
- 確認ダイアログ → 「危険なファイルを保持する」 / "Keep anyway" を選択
「Windows によって PC が保護されました」のブルー画面で:
- 画面下の小さい 「詳細情報」 リンクをクリック
- その下に出てくる 「実行」 ボタンを押す
Invoke-WebRequest `
-Uri "https://github.com/mar1mo-41414/MineScale/releases/latest/download/mc-share-gui-windows-x64.exe" `
-OutFile "mc-share-gui.exe"症状: ジョイン側で「Connect」を押して ✅ Connected! まで進んだのに、
マイクラの「マルチプレイ」画面にワールドが現れない。
主に Mac でたまに起こる現象 です（同じ Mac でも環境で挙動が違います。 OS のバージョン・マイクラのバージョン・ネットワーク構成の差が原因と推測）。
mc-share-gui の Join タブには、接続後に 「Direct address: 127.0.0.1:XXXXX」 という行が
表示されます（CLI 版でも同じ情報が出ます）。これを直接マイクラに渡します。
- マイクラを開く → 「マルチプレイ」
- 画面下の 「サーバーを追加」 （または「直接接続」）を選ぶ
- サーバーアドレスに
127.0.0.1:XXXXXを入力（XXXXX は表示された番号） - 「サーバーに接続」または「完了」
これで LAN 自動検出に頼らず確実に入れます。 ホストには ID（数字や名前）に関係なく繋がります — 中身は同じ通信です。
- VPN を切る（Tailscale / WireGuard / NordVPN など） 仮想 NIC があると LAN マルチキャストの送信先が狂うことがあります
- マイクラを mc-share 起動の "あと" に開く 先にマイクラを起動していると、LAN 探索を見逃すことがあります
- macOS のファイアウォールで Minecraft / Java をブロックしていないか確認 （システム設定 → ネットワーク → ファイアウォール → オプション）
- 同じ Wi-Fi にいる必要はありません（P2P なので）
「Direct address」方式は LAN 自動検出を完全にバイパスするので、 環境差で不安定な場合の 確実な代替手段 です。困ったらまずこれを試してください。
Q. 危なくないの？ 知らないサーバーを経由するんでしょ？ A. 通信はあなたと友達の間で直接つながります（P2P）。 間にあるサーバーは「お互いのアドレスを伝えるだけ」の役目で、 ゲームのデータは見られませんし、見ることもできません（暗号化されています）。
Q. ワールドを乗っ取られたりしない？ A. URL を知っている人しか入れません。SNS で晒したりしなければ大丈夫です。
Q. ラグくない？ A. サーバーを経由しないので、友達と直接 LINE 電話するのと同じ仕組みです。 遠ければそれなりに遅延しますが、追加の遅延はほぼありません。
Q. アカウント登録しなくていいの？ A. はい。メールアドレスも電話番号も不要です。
Q. お金かかる？ A. かかりません。誰のサーバーも借りません。
Q. ホストの人がマイクラ閉じたらどうなる？ A. ふつうの LAN マルチと同じです。みんな抜けます。
Q. 何人まで一緒に遊べる？ A. マイクラの LAN 公開と同じ上限です（ホストの PC とネット回線次第）。
- Windows 10 / 11
- macOS（Intel / Apple Silicon）
- Linux（x64 / arm64）
実際にテストされて「接続して遊べる」ことが確認できた組み合わせです（v1.2.11 時点）。
| ホスト → ジョイン | Cone NAT | Symmetric NAT |
|---|---|---|
| Cone NAT | ✅ QUIC で直結（5〜7 秒） | ✅ relay 経由（14 秒前後） |
| Symmetric NAT | ✅ relay 経由（14 秒前後） | 未測定 |
NAT タイプは [Diag] タブで確認できます。「Cone NAT (P2P ready)」/「Symmetric NAT (relay mode)」のいずれか。
| ホスト | ジョイン | 結果 |
|---|---|---|
| macOS | macOS | ✅ |
| macOS | Windows | ✅ |
| macOS | Linux Mint | ✅ |
| Linux Mint | macOS | ✅ |
| Ubuntu (PaperMC サーバー) | macOS | ✅ |
複数 OS / アーキ（x86_64 / aarch64）の混在 OK。
| 種別 | 動作 |
|---|---|
| 通常の Minecraft Java Edition | ✅ |
| PaperMC / Spigot / Vanilla サーバー | ✅（mc-share は透過 TCP プロキシ） |
| 公式アカウント (MSA) | ✅ |
| オフラインアカウント |
- Symmetric NAT × Symmetric NAT
- Symmetric NAT 配下の Windows / Linux クライアント
協力してくださる方の環境でテレメトリ ON でテストいただけると、ここの行が埋まっていきます（詳しくは下記「接続調査への協力について」）。
v1.2 — Symmetric NAT 対応版
- v1.0: CLI 版リリース
- v1.1: GUI 版を追加、複数人同時接続、診断パネル追加
- v1.1.1: 接続調査用テレメトリ（オプトイン）を追加
- v1.1.2: テレメトリのチェックポイント化
- v1.2: Symmetric NAT 配下のジョイナーが接続できるようになりました（QUIC 失敗時に TCP リレーへ自動フォールバック）
- v1.2.1〜v1.2.11: テレメトリ精度向上 / 2 人目以降の NAT パンチ修正 / relay 安定化 / Windows メタデータ / macOS の LAN 一覧（VPN 環境下含む）対応など細かい改善
技術仕様・通信アーキテクチャ・セキュリティ設計は SPEC.md を見てください。 ビルド手順は BUILD.md を見てください。
MIT
このセクションは アプリ内には一切表示しません。 UI から協力を求めることはしません。
MineScale-Java は「どの NAT 構成・OS で接続が成功／失敗するか」を改善するため、 任意の opt-in 方式で 接続診断データを収集できる仕組みを持っています。 デフォルトでオフ。アプリ内のボタンや通知から有効化することはできません。
協力していただける方は、起動時に次の方法でオンにできます:
# CLI
mc-share host --telemetry
mc-share join <URL> --telemetry
# GUI（フラグでも環境変数でも OK）
./mc-share-gui --telemetry
MC_SHARE_TELEMETRY=1 ./mc-share-gui # Windows 以外Windows のエクスプローラからダブルクリック起動する場合は、 起動用ショートカットを作って「リンク先」に
--telemetryを追加する形が一番楽です。
| 項目 | 例 | 用途 |
|---|---|---|
session_id |
ランダム 16 文字 | 同一セッション内の start/result を紐付け（永続化なし） |
room_id |
共有 URL の末尾 | host と join のペアリング（部屋自体は 15 分で消えます） |
role |
host / join |
どちら側か |
phase |
start / registered / connected / result |
進捗マイルストーン（各イベント直後に送信） |
outcome |
success / cancelled / stun_failed / punch_failed / tls_failed / ... |
成否カテゴリ（result のみ） |
transport |
quic / relay |
実際に使われた経路（接続成立時のみ） |
duration_ms |
3421 |
開始から結果までの所要時間 |
nat_type |
Cone NAT (P2P ready) 等 |
NAT 種別（診断パネルと同じ判定） |
ipv6_available |
true / false |
IPv6 経路の有無 |
os / os_detail |
macos / macOS 14 |
OS の系統とメジャーバージョン |
arch |
aarch64 / x86_64 |
CPU アーキテクチャ |
app_version |
1.1.0 |
アプリのバージョン |
app_kind |
cli / gui |
フロントエンドの種類 |
- ❌ ユーザー名、ホスト名、MAC アドレス、メールアドレス
- ❌ あなたのグローバル IP / ローカル IP / 外部アドレス（STUN 結果含む）
- ❌ Minecraft のインストール済みバージョン一覧
- ❌ OS のマイナー／ビルド番号（例：「14.5.1 (23F79)」→「14」までに丸めます）
- ❌ ゲームデータの中身
- ❌ 永続的な端末識別子
- 受信時の 送信元 IP アドレスは記録しません
- HTTP リクエストヘッダも記録しません
- 上記の JSON 本文に、サーバー側で受信時刻のみを付けて JSONL に追記します
- 部屋 ID 自体は 15 分で消えるため、長期的にあなたを再識別する手段はありません
- 「どの NAT タイプ × どの OS の組み合わせなら成功するか」の統計を取る
- 失敗パターンの再現条件を絞り込む
- 将来の安定性向上（hole punch ロジックや fallback の調整）に役立てる
- 広告 / マーケティング目的では使いません
- 第三者には共有しません
- 取得データは集計後に削除します
- CLI: フラグや環境変数を外すだけ
- GUI:
MC_SHARE_TELEMETRY環境変数をセットしないで起動するだけ - 一度送ったデータの削除を希望する場合は
session_idを添えて GitHub の Issue でご連絡ください （session_idはアプリのログ ──RUST_LOG=debug等 ── に出ます）