# BedrockConnect – A Technical Explanation

## BedrockConnect

### 1. Overview

**BedrockConnect** is an application (“app”) that helps Minecraft: Bedrock Edition players connect to external Bedrock servers via the console using Wi-Fi.\
Instead of acting like a full-time proxy between the player and the target server, BedrockConnect only sends a **“Transfer Packet”** once. This transfer packet instructs the Minecraft client to connect directly to the selected server.

Once you have joined the server, BedrockConnect **no longer** has any influence on your gameplay. You can even close or uninstall the app without disconnecting from the server.

***

### 2. How It Works

1. **Server Selection**
   * In BedrockConnect, you can select a server from a list or manually enter an IP address.
   * While running on the same network (Wi-Fi/LAN), the app appears under[ “Worlds” or the “Friends” tab](https://wiki.bedrockconnect.app/quickstart/how-do-i-join-a-server) in Minecraft as a local server.
2. **Connection via Transfer Packet**
   * BedrockConnect briefly sets up a local connection and sends the Minecraft client a [**Transfer Packet**](https://github.com/CloudburstMC/Protocol/blob/a01455c028a2418f8b63e55ff1aef6128bf67151/bedrock-codec/src/main/java/org/cloudburstmc/protocol/bedrock/packet/TransferPacket.java#L11).
   * This packet includes the IP address and port of the desired server.
3. **Direct Connection**
   * After receiving the Transfer Packet, the Minecraft client connects **directly** to the target server.
   * BedrockConnect does **not** act as a proxy and therefore does not relay chat messages or other data in real time.
4. **Closing the App**
   * Once the forwarding is complete, BedrockConnect is no longer involved.
   * You can close or even uninstall the app without affecting your ongoing game session.

***

### 3. Technical Details

* **Transfer Packet**
  * A special data packet that Minecraft Bedrock Edition recognizes to seamlessly transfer the client from one server to another.
  * BedrockConnect uses it only to provide the server IP and port.
* **Minimal Logging**
  * BedrockConnect does **not** log chat messages, commands, or other in-game data.
  * For technical and administrative purposes, it only records **Name, Date & Time, and XUUID** (for instance, for troubleshooting or statistics).
* **No Ongoing Connection**
  * Unlike proxy apps (e.g., *Lunar Proxy* or *MC Server Connector*), BedrockConnect does **not** remain between the client and server.
  * All data traffic after the transfer is handled directly between Minecraft and the target server.

***

### 4. Common Misunderstandings

1. **“BedrockConnect causes kicks or chat errors.”**
   * **Fact**: After a successful transfer, BedrockConnect is not involved in any data exchange.
   * Possible causes for kicks, chat issues, or lag include:
     * Configuration errors in Geyser, Floodgate, or other Bedrock-related plugins.
     * Network problems (e.g., unstable internet connection, packet loss, router settings).
     * Bugs in Minecraft itself or in alternative Bedrock server software (e.g., Pocketmine, Nukkit, Dragonfly).
2. **“BedrockConnect collects private data or logs chat content.”**
   * **Fact**: BedrockConnect only stores minimal information (`Name, Date & Time, XUUID`).
   * **No storage** of chat messages, commands, or gameplay data.
3. **“BedrockConnect is a proxy.”**
   * **Fact**: The app only provides the one-time redirection (via Transfer Packet). It does **not** continuously mediate the data flow.

***

### 5. Common Causes of Issues & Possible Solutions

1. **Server-Side Problems**
   * Check if the target server (e.g., with Geyser, Floodgate, or other Bedrock plugins) is correctly configured.
   * Ensure that Bedrock server software like Pocketmine, Nukkit, or Dragonfly is up to date and functioning properly.
2. **Network Issues**
   * [Make sure you have a stable internet connection. Wi-Fi in particular can cause packet loss.](https://wiki.bedrockconnect.app/general-help/bedrockconnect-troubleshooting)
3. **Minecraft Bugs or Incompatibilities**
   * Keep your Minecraft Bedrock Edition up to date.
   * Check the [official Minecraft Bedrock Feedback page](https://feedback.minecraft.net/hc/en-us) to see if there are any known bugs.

***

### 6. Conclusion

BedrockConnect is a **simple tool** that uses a **Transfer Packet** to direct the Minecraft client to the target server. **Once you’re connected**, BedrockConnect **no longer** affects your gameplay.\
If you experience issues like kicks, chat errors, or lag after joining the server, it is **not** caused by BedrockConnect, but rather by other factors such as server plugins, network issues, or game bugs