マイクラリモコン / 移行

🔄 移行

2026年10月までのマイクラリモコンを使っていた方への案内です。新しいマイクラリモコンは、マイクラとプログラムの間の通信の決まり(プロトコル)が新しくなり、旧版とはつながりません。旧版のまま使える期間と、新しい版へ移る手順をまとめました。

🙋 対象の方

マイクラリモコンは、時期によって次の構成で動いてきました。2026年10月までの構成を使っていた方が対象です。

時期 Python Pythonのつなぎ先 Scratchとつなぎ先
2021年7月〜2024年10月 Pythonモジュールmcje(MinecraftRemote) 自分のマイクラ(Forge+RemoteControllerMod入り)。作者:takecxさん 改造版Scratch ― 自分のマイクラ(Forge+RemoteControllerMod入り)。作者:takecxさん
2024年10月〜2025年3月 mcje 箱庭などのマイクラサーバー(JuicyRaspberryPieプラグイン)
2025年3月〜2026年10月 minecraft-remote-api 1214.10.13など1214系 箱庭などのマイクラサーバー(McRemote v1.21.8-1.4.0プラグイン)
2026年11月から minecraft-remote-api 2321.0.0以降 箱庭や自分のPaperサーバー(McRemote 2321.0.0以降のプラグイン、マイクラ1.21.11、26.3) マイクラリモコンのScratch 2321.0.0以降(箱庭のScratch、Scratch LANパッケージ)― Pythonと同じサーバー

2024年10月から2026年10月までは、つなぎ先が2系統でした。Pythonなどは箱庭などのマイクラサーバー(プラグイン)へ、旧版のScratchは自分のPCのマイクラ(Forgeとmodを入れたマイクラアプリ。アプリの中でサーバーも動いている)へつないでいました。2026年11月からは、PythonもScratchも、McRemoteを入れた同じマイクラサーバーにつなぎます。

2026年11月からの構成は、通信の決まり(プロトコル)が新しく、それより前の構成とはつながりません。これから始める方は、移行は要りません。はじめるへ進んでください。

📅 移行スケジュール

初回Stableを公開した2026年11月1日に、箱庭サーバーの名前を切り替えました。sb.mc-remote.comは新しいプロトコルの安定版になり、旧プロトコルのサーバーはsb-retro.mc-remote.comとして11月末まで動かします。12月から、箱庭サーバーは新しいプロトコルに一本化します。

11月の間は、sb.mc-remote.comとsb-beta.mc-remote.comのどちらにつないでも、同じサーバーにつながります。12月からは、sb-beta.mc-remote.comは別のサーバーになり、安定版か、それより進んだ版(先行版)を動かす先行環境になります。ふだんは安定版のsb.mc-remote.comを使い、新しい機能を先に試したいときにsb-beta.mc-remote.comを使います。

11月1日からは、旧版のPython(1214系)でsb.mc-remote.comにつなごうとしても、つながりません。旧版を使い続ける間は、つなぎ先をsb-retro.mc-remote.comに変えてください。旧版のScratchは自分のPCのマイクラにつなぐので、この切り替えの影響はありません。

時期 sb.mc-remote.com sb-retro.mc-remote.com sb-beta.mc-remote.com
2026年10月31日まで 旧プロトコル ― 新プロトコル(リリース候補版)
2026年11月1日〜30日 新プロトコルの安定版 旧プロトコル 新プロトコルの安定版
2026年12月から 新プロトコルの安定版 終了 先行版(安定版か、それより進んだ版)

初回Stableの公開で、Pythonで版を指定せずに入れたときに入る版も、新しい版に変わりました(下の「Python」)。

📱 統合版のポート

統合版のマイクラ(PC、タブレット、スマホなど)で箱庭サーバーにつなぐときのポートが、25565から、統合版のデフォルトの19132に変わりました。サーバーを追加するとき、ポートの欄は最初から入っている19132のままでつながります。

箱庭サーバーで統合版を受け付けているプラグインのGeyserが、統合版の大型アップデート(26.60、2026年10月28日)に合わせて、UDPに加えてTCPも使うように変わりました(Geyserの案内)。Java版がTCPの25565を使っているので、統合版を25565のままにできなくなり、統合版のデフォルトの19132にしました。

つなぐもの ポート
Java版のマイクラ TCPの25565(変わりません)
統合版のマイクラ 19132(UDPとTCP)。これまではUDPの25565
マイクラリモコン(Python、Scratchなど) TCPの25575(変わりません)
「このサーバーを信頼しますか?」の画面。「信頼して参加」と「信頼しない」のボタンがある

初めてつなぐときに、「このサーバーを信頼しますか?」という画面が出ます。時間切れになると失敗するので、そのまま「信頼して参加」を押してください。

iPad、iPhoneの統合版も、26.60からは箱庭サーバーにつながるようになりました(2026年10月28日にiPhoneで確かめました)。初めてつなぐときは、上と同じ「このサーバーを信頼しますか?」の画面が出ます。

🐍 Python

何が変わるか

初回Stableの公開から、版を指定しないpip install minecraft-remote-apiやuv add minecraft-remote-apiで入るのは、新しい版(今は2321.1.0)です。新しい版は旧プロトコルのサーバーにはつながりません。また、旧版のプログラムは、接続のしかたなどが変わるため、そのままでは動かないものがあります。

旧版を使い続ける(2026年11月まで)

旧プロトコルの箱庭サーバーや、旧版のmodを入れたサーバーにつなぐ間は、旧版を版を指定して入れてください。11月1日からは、箱庭サーバーのつなぎ先をsb-retro.mc-remote.comに変えてください。

pip install "minecraft-remote-api==1214.10.13"

新しい版へ移る

mcjeを使っていた方も、新しいminecraft-remote-apiへ移ります。新しい版では、Pythonの環境とパッケージの管理にuvを使います。pyenvやpoetryを使っていた方も、uvへ移ると手順が短くなります。

  1. uvを入れます(手順はuvの公式の案内にあります)。
  2. 作業用のフォルダーで、uv init --no-packageを実行します。
  3. uv add minecraft-remote-apiで新しい版を入れます。
  4. トップページのPythonでのHello, world!のhello.pyを、uv run hello.pyで動かします。初めてつなぐときは、マイクラのチャットでペアリングします。

くわしい手順は、minecraft-remote-apiのREADMEにあります。使える命令はAPI一覧で確かめられます。

🐱 Scratch

旧版の改造版Scratch(マイクラ1.12.2用、1.16.5用)とRemoteControllerModから、新しいScratch(scratch-editor)へ移ります。新しいScratchはmodを使わず、マイクラサーバーのMcRemoteとつながります。拡張機能が新しくなり、ブロックも変わっています。ブロックはScratchのブロック一覧で確かめられます。

箱庭のScratchは、2026年11月1日からscratch.mc-remote.comで開きます。先行環境はscratch-beta.mc-remote.comです。

ブラウザに保存した作品は、開いたアドレスごとに分かれています。scratch-beta.mc-remote.comで保存した作品をscratch.mc-remote.comで使うときは、scratch-beta.mc-remote.comで開いて「ファイル」→「コンピューターに保存する」で書き出し、scratch.mc-remote.comの「ファイル」→「コンピューターから読み込む」で読み込みます。安定版と先行環境を行き来するときは、いつもこの方法です。

🖥️ マイクラサーバー

Forgeのmod(RemoteControllerMod)、JuicyRaspberryPie、旧版のMcRemote(v1.21.8-1.4.0など)から、Paperサーバーと、そこへ入れる新しいプラグインMcRemote(今は2321.1.0)へ移ります。対応するマイクラの版は1.21.11と26.3です。PaperのJavaは、Temurinの21(マイクラ1.21.11)と25(26.3)を使い、最新のパッチを勧めます。準備のしかたはMcRemoteのREADMEにあります。

統合版でも遊べるようにGeyserを入れている場合は、Geyserを新しい版にして、TCPとUDPの両方で19132を開けます(Geyserの案内)。XServer GAMEsの無料サーバーでは、統合版も使いたいときに制約があります。統合版26.60のマイクラをつなぐには、26.60に対応したGeyserの版が要ります。

💬 困ったときは

分からないことはDiscordで相談できます。不具合や気づいたことはフィードバックのフォームへお寄せください。