#cli #minecraft #mcbe #mcpe #mc-lan-games

bin+lib mcbe-lan-advertizer

Listens for Minecraft Bedrock LAN Ping packets and responds with a Pong packet

1 unstable release

0.1.0 Jan 10, 2023

#120 in Games

MIT license

382 lines

Minecraft Bedrock LAN Advertizer

Keywords: MCPE, Minecraft Bedrock, Friends tab, LAN games, cannot join local dedicated server.


MCBE - Minecraft Bedrock Edition

MS - Microsoft

What can this program do

An MCBE client sends out special network broadcasts called Pings and asks all other devices on the network if they have a server running.

Say you have a phone and an iPad. If you start a LAN world on an iPad and then open minecraft on the phone, your phone will ask the iPad if it has a server (Pings the iPad). The iPad will say "Yes, on port 12345" (Thats a Pong). The phone will take iPad's IP address, that port 12345 and try to connect to it.

However a dedicated minecraft server that you run on a computer or laptop may not respond to your phone's Pings for whatever reason. Even if you are on the same network. So this program will do that for the server. This way if you cannot use the Servers tab because of parental restrictions/don't have a microsoft account logged in then you can still join your dedicated LAN server that runs on your laptop.

This is also useful if the dedicated server does not accept 2 players under 1 MS account so you may want to disable online mode and maybe log out from your MS account on one of the devices.

What this program cannot do

If the server's IP is not the same IP from which the Pong packet was sent then you will not be able to connect to the server. This is because the IP address is not part of the Pong packet. Instead the Pong sender's IP is the IP address that the client will connect.

So, no you cannot join some-server.net using this program. If really want to do that I can only point you to setting up a proxy. This is beyond the scope of this application.


Relay mode


  • The information presented to the client will be up-to-date. Meaning the name, descrition, player count, etc. Everything will be the same as the server says.
  • If the server is not running you will not see anything in the Friends tab.


advertize relay [ optional path to server.properties ]

In this mode the program will look into the current directory for a file called server.properties. In this file it will look for the server-port. Then it will start a UDP socket on port 19132 and when it recieves a Ping it will forward it to And the responce from that (a Pong) will be sent back to the client that Pinged the program. This is useful if you want to accurately reflect the number of players online.

From properties mode


  • The app will not check if the server is actually running. So while you may see the button to join the server, it is not guaranteed that the server is actually running, or that the server is running on the port the client thinks it runs on.


  • If the server ignores this app's Pings and you dont see anything in the Friends tab, you can try this mode. There is a caveat: Make sure that the port in server.properties that the program uses is the same as the port for the server. You can remove the need to check by simply running the app in the same directory as your server or giving it a path the correct file.
advertize from_props [ optional path to server.properties ] proto <num> <str>

In this mode the server.properties is read and only the information there is used to respond to Pings. In this mode online player count will always be 0. Look up <num> and <str> in Bedrock protocol version numbers. num is the single number (560) and str is the 1.19.51 representation.


In the project's github you will find the sample server.properties. It only contains the configuration that is required by this program, but it is not sufficient for an MCBE server. Ideally you will run the advertize executable in the same directory as the bedrock server executable.


Currently we recommend to use cargo install. We might provide binary releases in the future.

Using cargo

You need to have cargo and rust installed for this.

cargo install mcbe-lan-advertizer

Then either:

  • Navigate to the directory where your server is located.
  • Create a server.properties in the current directory.
  • Specify the path to server.propeties.

Build from source

Run the following commands in your terminal (cmd.exe on Windows).

  1. Clone the repository and enter it's directory. You have to have git installed for this.
git clone https://github.com/max-ishere/mcbe-lan-advertizer
  1. Build the application. You will need cargo and rust installed.
cargo build --release
  1. Copy the executable somewhere convinient.
cp target/release/advertize (path)
  1. If you dont need the repository and you have saved the executable to a different location then you can delete it.
cd ..
rm mcbe-lan-advertizer

Have questions?

Ask on Discussions.


~54K SLoC