Makes hosted Bedrock/MCPE servers show up as LAN servers, specifically for consoles.
You can now play on remote servers (not Realms!) on your Xbox and PS4 with friends.
It's like having a LAN server that's not actually there, spooky.
phantom is a command line application with no GUI (yet). See the usage section below.
Download phantom from the releases page.
macOS / Linux
Add execute permissions if necessary:
$ chmod u+x ./phantom-<os>
<os> with macos, linux, etc. for the correct OS you're using.
Open up a command prompt (Windows) or terminal (macOS & Linux) to the location where you downloaded phantom, then type in the phantom command and hit enter. The server should show up on your LAN server list within a few seconds. If not, you did something wrong. Or I did ;)
Usage: ./phantom-<os> [options] -server <server-ip> Options: -6 Optional: Enables IPv6 support on port 19133 (experimental) -bind string Optional: IP address to listen on. Defaults to all interfaces. (default "0.0.0.0") -bind_port int Optional: Port to listen on. Defaults to 0, which selects a random port. Note that phantom always binds to port 19132 as well, so both ports need to be open. -debug Optional: Enables debug logging -remove_ports Optional: Forces ports to be excluded from pong packets (experimental) -server string Required: Bedrock/MCPE server IP address and port (ex: 22.214.171.124:19132) -timeout int Optional: Seconds to wait before cleaning up a disconnected client (default 60)
Connect to a server at IP
./phantom-<os> -server lax.mcbr.cubed.host:19132
Same as above but bind to a specific local IP:
./phantom-<os> -bind 10.0.0.5 -server lax.mcbr.cubed.host:19132
Same as above but bind the proxy server to port 19133:
./phantom-<os> -bind_port 19133 -server lax.mcbr.cubed.host:19132
Same as above but bind the proxy server to local IP 10.0.0.5 and port 19133:
./phantom-<os> -bind 10.0.0.5 -bind_port 19133 -server lax.mcbr.cubed.host:19132
Running multiple instances
If you have multiple Bedrock servers, you can run phantom multiple times on
the same device to allow all of your servers to show up on the LAN list. All
you have to do is start one instance of phantom for each server and set the
-server flag appropriately. You don't need to use
-bind or change the port.
But you probably do need to make sure you have a firewall rule that allows
all UDP traffic for the phantom executable.
A note on
The port is randomized by default and specifically omitted from the flag because the port that phantom runs on is irrelevant to the user. phantom must bind to port 19132 on all interfaces (or at least the broadcast address) to receive ping packets from LAN devices. So phantom will always do that and there's no way to configure otherwise, but you can also pick which IP you want the proxy itself to listen on, just in case you need that. You shouldn't though.
As long as the device you run phantom from is on the same LAN, the default settings should allow other LAN devices to see it when you open Minecraft.
A note on
The port used by the proxy server can be defined with the
It can be useful if you are behind a firewall or using Docker and want to open only
necessary ports to phantom. Note that you'll always need to open port 19132 in addition
to the bind port for phantom to work.
This flag can be used with or without the
Default value is 0, which means a random port will be used.
Makefile builds for Windows, macOS, and Linux, including x86 and ARM.
How does this work?
On Minecraft platforms that support LAN servers, the game will broadcast a server ping packet to every device on the same network and display any valid replies as connectable servers. This tool runs on your computer - desktop, laptop, Raspberry Pi, etc. - and pretends to be a LAN server, acting as a proxy, passing all traffic from your game through your computer and to the server (and back), so that Minecraft thinks you're connected to a LAN server, but you're really playing on a remote server. As soon as you start it up, you should see the fake server listed under LAN and, upon selecting it, connect to the real Bedrock/MCPE server hosted elsewhere.
For an optimal experience, run this on a device that is connected via ethernet and not over WiFi, since a wireless connection could introduce some lag. Your game device can be connected to WiFi. Your remote server can be running on a computer, a VM, or even with a Minecraft hosting service.
- This tool should work on Windows, macOS, and Linux.
- ARM builds are available for Raspberry Pi and similar SOCs.
- Minecraft for Windows 10, iOS/Android, Xbox One, and PS4 are currently supported.
- Nintendo Switch is not supported.
Note that you almost definitely need to create a firewall rule for this to work. On macOS, you'll be prompted automatically. On Windows, you may need to go into your Windows Firewall settings and open up all UDP ports for phantom.
My server isn't showing up on the list but it's online and phantom is showing connections!
Make sure "Visible to LAN players" is turn ON in your server's settings: (below shows setting OFF)