🇰🇷 한국어로 보기: README.ko.md
Ender-Proxy is a Minecraft Bedrock Edition (MITM) proxy client, for Windows and Android. It sits between your Minecraft client and a joined Xbox Live session (a friend's world or your own Realm), forwards packets transparently, and adds an in-game command system and HUD with movement, combat, world, and visual utility modules, plus an optional bridge for external tools.
Everything is driven from in-game chat using a . command prefix (for example /.fly on) or from the proxy's own app: a dark-themed control panel on Windows, and a full app plus an optional floating overlay you can drive without leaving Minecraft on Android (no Termux or separate runtime needed).
Work in progress: Ender-Proxy is still early in development. Expect rough edges, and check the Releases page for the latest fixes before assuming something is broken for good. If you hit a bug, report it on Discord so it can get fixed.
Disclaimer: Ender-Proxy works against server-authoritative movement (mandatory on current Bedrock Dedicated Servers and Xbox Live friend sessions). It steers the server's own simulation of the player instead of teleporting the client. Some modules (combat automation, movement assistance, world manipulation) may violate the rules of servers or Realms you don't own. Only use it on worlds you own, or where every player involved has agreed to it, and always at your own risk.
- Features
- Requirements
- Download & Install
- Before You Start: Windows Loopback Exemption
- Windows: Step-by-Step Guide
- Android: Step-by-Step Guide
- Android Notes
- Settings
- Commands
- Optional Components
- Third-Party Components
- Terms of Use / Disclaimer
- License
- Xbox Live friend-session discovery: logs in with your own Microsoft account and lists active Bedrock sessions among your Xbox Live friends, no server IP needed. You can also join any Realm you own or belong to, or accept a Realm invite code or
realms.gglink on the spot. - In-game command menu: a HUD panel (
/.menu) plus a full chat command set, all under the.prefix. - Movement:
fly,speed,noclip,nofall,scaffold,blink/autoblink. - Combat:
killaura,multiaura,reach,autoclick,autototem,antikb(cancel knockback, server-side too). - World:
fastbreak,automine,nuker,filldupe(duplicate items). - Visual:
esp,xray,fullbright,tracer,derp(other players see your head spin wildly),freecam(fly the camera around while your body stays put), in-worldvideoplayback, customskinswitching. - Chat tools: chat messages and looped chat (
say,spam). - External tool bridge: a vanilla-
wsserver-compatible WebSocket endpoint (address set in the Settings tab) so outside tools can attach with no in-game command needed, plus a built-in relay forwssay/wsspam/whisperwspamthat needs no extra runtime to be installed. - Custom local resource pack for the in-game HUD, applied automatically. It never touches the server's own resource packs.
- Android app: the same proxy, packaged as a single sideloadable APK with the same Connect / Modules / Console / Settings panel as Windows, plus a draggable floating overlay bubble that expands into that same panel over the top of Minecraft so you never have to alt-tab out. No Termux, no separate Android build of Node.js or anything else to install.
- Windows 10/11, 64-bit.
- A Microsoft/Xbox Live account signed in to Xbox Live, with the target world or Realm already in your friends list or owned by you. Ender-Proxy discovers sessions through Xbox Live, it does not dial arbitrary server IPs.
- FFmpeg is bundled in the release zip (
bin\ffmpeg.exe) for the/.videomodule, so there is nothing extra to install for that. - Nothing else to install.
wssay/wsspam/whisperwspamare handled entirely insideenderproxy-gui.exe, no Node.js or any other runtime needed.
- Android 8.0 (API 26) or newer, 64-bit ARM (
arm64-v8a). That's effectively every real Android phone from the last several years; the handful of 32-bit-only devices still out there aren't supported yet. - The same Microsoft/Xbox Live account requirement as Windows, above.
- Nothing to install beyond the one APK. FFmpeg (and so
/.video) isn't available on Android yet, everything else is.
Both platforms' files are on the same Releases page.
- Grab the latest
Ender-Proxy-<version>-win64.zip. - Extract it anywhere (avoid
C:\Program Files, which Windows locks down for writing). - Run
enderproxy-gui.exe.
The extracted folder must keep its structure. enderproxy-gui.exe reads resource_packs/, skins/, and videos/ as relative paths next to itself, so don't move the exe out of its folder on its own.
- Grab the latest
Ender-Proxy-<version>-android-arm64.apk. - Open it from your file manager or downloads notification. Android will ask to allow installs from that source the first time, allow it.
- Open the app. Unlike Windows, there's no separate setup step needed first, no loopback exemption command to run. Just open it.
- After you log in, the app will ask to allow the floating overlay ("draw over other apps"). This is optional: it just lets you expand the same control panel over Minecraft without switching apps. You can decline and use the app's own screen instead, or grant it later from the Settings tab.
The APK bundles the local HUD resource pack and default skins already, they're unpacked automatically the first time the app runs.
Minecraft Bedrock (and Minecraft Preview) are UWP apps, and Windows blocks UWP apps from connecting to 127.0.0.1 (localhost) by default. Since Ender-Proxy runs locally and your Minecraft client connects through it, you need to lift that restriction once per PC before your first run. (This step is Windows-only. Android doesn't isolate loopback between apps the same way, so there's nothing equivalent to do there.)
-
Open PowerShell as Administrator (right-click the Start button, choose "Terminal (Admin)" or "Windows PowerShell (Admin)").
-
Run the command for your edition:
# Minecraft (retail, Microsoft Store) CheckNetIsolation LoopbackExempt -a -n="Microsoft.MinecraftUWP_8wekyb3d8bbwe" # Minecraft Preview CheckNetIsolation LoopbackExempt -a -n="Microsoft.MinecraftWindowsBeta_8wekyb3d8bbwe"
-
You should see
Ok.printed. Fully close and reopen Minecraft afterward.
Useful related commands:
# List every app currently exempted
CheckNetIsolation LoopbackExempt -s
# Undo it later (remove the exemption again)
CheckNetIsolation LoopbackExempt -d -n="Microsoft.MinecraftUWP_8wekyb3d8bbwe"This is a one-time, standard Windows setting used by any local Bedrock proxy or server tool. It does not modify Ender-Proxy or Minecraft itself, and removing the exemption later has no side effects.
This section walks through everything from a completely fresh download to your first working connection. If you've never used a tool like this before, start here.
Do this first, once per PC. Follow Before You Start above. If you skip this step, Minecraft will usually just sit at "Connecting..." and time out.
Right-click Ender-Proxy-<version>-win64.zip and choose "Extract All...". Pick a normal folder such as Documents\Ender-Proxy or your Desktop. Don't extract it into a system folder like C:\Windows or C:\Program Files.
Double-click enderproxy-gui.exe inside the extracted folder. A dark, frameless panel opens (no console window). If Windows SmartScreen shows a blue warning screen (this is normal for a small, unsigned tool), click "More info" and then "Run anyway".
The panel shows a Microsoft login link and a short code, with a LOG IN button. Click it, open the link in your browser, enter the code, and sign in with the same Microsoft account you use in Minecraft. After signing in, switch back to the panel, it detects the login automatically. Your login is cached on disk so you won't need to repeat this every time (use FORCE LOGIN in the app if you ever need to switch accounts).
On the Connect tab, the Friends sub-tab lists active Bedrock sessions among your Xbox Live friends. Click CONNECT next to the one you want to join, or switch to the Gamertag, LAN, Featured, Realms, or Direct sub-tab if you want to target something else. The Realms sub-tab lists every Realm your account owns or has joined, and also takes a Realm invite code or realms.gg link. If nothing shows up under Friends, make sure your friend has actually opened their world to "Friends" or "Friends of Friends" and that you're both signed in.
Open Minecraft Bedrock yourself, go to Play → Servers, and add (or use) a server entry pointing at 127.0.0.1 on port 19132 (the default; changeable in the Settings tab under "Local RakNet Port" before you connect). Join that server entry. You should land in your friend's world exactly as if you'd joined it directly, except now the proxy is watching and relaying every packet.
In Minecraft chat, type:
/.help
You should see a list of command categories. Try something harmless first, like:
/.pos
which prints your current coordinates, or:
/.menu
which opens the in-game HUD menu. From there, explore the Commands table below for the full list.
| Problem | Likely fix |
|---|---|
| Minecraft hangs on "Connecting..." or fails immediately | Redo the loopback exemption step, then fully close and reopen Minecraft. |
| No friend sessions are listed | Ask your friend to open their world to "Friends" or "Friends of Friends" in the pause menu, and confirm you're both online on Xbox Live. |
| Windows SmartScreen blocks the exe | Click "More info" then "Run anyway". This is expected for an independently distributed executable that isn't code-signed. |
/.video does nothing |
Make sure bin\ffmpeg.exe still exists next to enderproxy-gui.exe (don't delete the bin folder), and that you put a video/GIF file into videos/ or used a direct http(s):// link. |
wssay / wsspam / whisperwspam don't show a message in chat |
Give it a few seconds after connecting, the real client needs to finish its own handshake first. If it still doesn't work, rejoin the world so Ender-Proxy can reconnect the bridge. |
| Login link/code doesn't work | Make sure you're signing in with the same Microsoft account that owns your Minecraft/Xbox Live profile, and that your PC's clock is set correctly (a wrong system clock breaks Microsoft login). |
Same idea as the Windows guide above, just through the phone app. There's no loopback exemption step on Android, that's a Windows-only requirement.
Download Ender-Proxy-<version>-android-arm64.apk from Releases onto your phone and open it. Android will prompt to allow installing from that source the first time (Settings → allow), then installs normally.
Tap the Ender-Proxy icon. You'll see a login screen with a Microsoft login link and short code, plus a LOG IN button. Open the link in your phone's browser, enter the code, sign in with your Minecraft/Xbox Live Microsoft account, then switch back to the Ender-Proxy app, it detects the login automatically. If a notification permission prompt appears, allow it, that's just for the persistent "Ender-Proxy running" notification.
Right after logging in, the app asks to allow a floating overlay. This lets you drag a small bubble anywhere on screen and tap it to expand the full control panel over the top of Minecraft, no alt-tabbing needed. You can allow it now, allow it later from the Settings tab, or skip it entirely and just use the app's own screen.
On the Connect tab, the Friends sub-tab lists active Bedrock sessions among your Xbox Live friends. Tap CONNECT next to the one you want to join, or switch to the Gamertag, LAN, Featured, Realms, or Direct sub-tab for something else.
Open Minecraft Bedrock (same phone), go to Play → Servers, and add a server pointing at 127.0.0.1 port 19132 (changeable in the Settings tab before you connect). Join it, same as the Windows guide.
In Minecraft chat, type /.help, then try /.pos or /.menu. See the Commands table below for the full list, or use the Modules tab to toggle things on/off with a tap instead of typing commands.
Closing the app screen, switching to Minecraft, or collapsing the overlay does not stop it, that's intentional, so it survives while you're playing. Swiping Ender-Proxy away from your recent apps (fully closing it, not just backgrounding it) does stop it automatically and hides the overlay. You can also tap STOP in the app or overlay panel, or tap Stop on the persistent notification. See Android Notes below.
| Problem | Likely fix |
|---|---|
| Can't install the APK | Make sure you allowed "install from this source" when prompted. On some phones this is under Settings → Apps → Special access → Install unknown apps, per app (browser or file manager). |
| No friend sessions are listed | Same as Windows: ask your friend to open their world to "Friends" or "Friends of Friends", confirm you're both online on Xbox Live. |
Minecraft can't connect to 127.0.0.1:19132 |
Make sure the Ender-Proxy app (or its notification) shows it's still running, and that you typed the port correctly. Unlike Windows there's no loopback exemption to troubleshoot here. |
| Overlay bubble doesn't appear, or never asked for permission | Open the app's Settings tab and tap GRANT PERMISSION under "Floating overlay over game". Some phone makers (e.g. MIUI, ColorOS) hide this under a differently-named "Display over other apps" toggle in their own system settings. |
| Overlay circle looks squashed or the expanded panel's bottom is cut off | Update to the latest release, this was fixed after the first Android build (the overlay is now sized to fit the screen and Restart/Stop are always visible). |
/.video does nothing |
Expected for now, FFmpeg isn't bundled for Android yet. |
- Stopping the proxy: it runs as a background (foreground) service on purpose, so it isn't killed while you're alt-tabbed into Minecraft. Backgrounding the app, switching to Minecraft, or collapsing the overlay does not stop it. Swiping it away from Recents (fully closing the app, not just backgrounding it) does stop it and hides the overlay automatically. You can also use the STOP button in the app/overlay panel, or the Stop action on its notification.
- The floating overlay: a small draggable circle that shows the proxy's status at a glance (a colored ring) and expands, in place, into the exact same Connect/Modules/Console/Settings panel the app itself shows, so you can drive it without leaving Minecraft. Tapping it never switches you back to the app; use the small "open full app" button inside the expanded panel's header for that. Requires the "draw over other apps" permission, requested once after your first login and toggleable any time from the Settings tab.
- Permissions: Internet access, a notification (for the "running" status), and the optional "draw over other apps" permission for the floating overlay. None require a special explanation dialog beyond the one-time system prompts.
- Local port and external tool bridge: unlike the old console build, these are configurable per-connection from the app's own Settings tab (same fields as the Windows panel), not fixed at
19132/127.0.0.1:8000, though those remain the defaults. - Current limitations:
/.videoisn't available yet (no Android FFmpeg build bundled), and only 64-bit ARM (arm64-v8a) devices are supported.
Both the Windows panel and the Android app (including its overlay) expose the same Settings tab instead of command-line flags:
| Setting | Default | Description |
|---|---|---|
| Local RakNet Port | 19132 |
Local port Minecraft connects to on this device |
| External WS Bridge | 127.0.0.1:8000 |
Address for wssay/wsspam/whisperwspam and other external tools; leave blank to disable it |
| Ignore Resource Packs | off |
Skip downloading server resource packs and connect immediately using vanilla assets |
| Floating overlay (Android only) | off until granted | Toggles the draggable overlay bubble described above |
| Log Out | — | Clears the cached Xbox Live login; you'll need to sign in again next time |
All commands are typed as /.name in Minecraft chat, or just name (no /.) in the console. Type /.help in-game for the live list with aliases.
| Command | Description |
|---|---|
help |
Show command help |
modules |
List all modules and their on/off state |
menu |
Open the in-game HUD menu |
list |
List online players |
pos |
Show your current coordinates |
seed |
Show the world seed |
| Command | Description |
|---|---|
killaura |
Auto-attack the nearest enemy in range |
multiaura |
Attack several enemies in range at once |
reach |
Extend your manual attack reach |
autoclick |
Auto-click whatever is in your crosshair |
autototem |
Keep a Totem of Undying equipped |
antikb |
Cancel knockback, on the server too (a hit still shoves you about a block before you are pulled back) |
| Command | Description |
|---|---|
speed |
Accelerate your movement |
blink |
Choke movement packets, release to warp |
autoblink |
Auto-arm Blink and release it on attack |
fly |
Fly |
nofall |
Negate fall damage |
noclip |
Walk through walls |
scaffold |
Auto-place blocks under you while walking |
| Command | Description |
|---|---|
fastbreak |
Break blocks faster by adding extra mining ticks |
automine |
Continuously mine whatever block is under your crosshair |
nuker |
Break the block you mine and the blocks around it |
filldupe |
Duplicate items |
| Command | Description |
|---|---|
esp |
Draw 3D boxes around entities |
xray |
Draw 3D boxes around a chosen ore/block type through walls |
fullbright |
See in the dark |
tracer |
Draw lines from you to entities |
derp |
Spin your head and swing your pitch so other players see you look weird (your own screen is unchanged) |
freecam |
Fly the camera around freely while your body stays where it is, then snap back when you turn it off |
skin |
Change your player's skin, visible to others on the server |
invisible |
Switch to an invisible skin with your armor hidden (/skin reset to undo) |
kickall |
Switch to a crash skin with your armor hidden (/skin reset to undo) |
video |
Play a video on an in-world particle screen (needs FFmpeg, see below) |
| Command | Description |
|---|---|
say |
Send a chat message to the server |
spam |
Repeat a chat message (default 10 times, 100 ms apart) |
wspam |
Shortcut for .spam whisper |
| Command | Description |
|---|---|
wsconnect |
Connect to an external tool over Minecraft's vanilla wsserver protocol |
wsdisconnect |
Disconnect the external tool |
wsstatus |
Show whether an external tool is connected |
wssay |
Notify every connected external WebSocket tool of a message |
wsspam |
Repeatedly notify every connected external WebSocket tool of a message |
/.video renders a video or GIF onto an in-world particle screen by decoding it frame by frame with FFmpeg. The release zip already bundles bin\ffmpeg.exe, so this works out of the box. Just drop your own video/GIF files into the videos/ folder, or pass a direct http(s):// URL to /.video.
The release zip does not bundle any video files, only the FFmpeg binary itself. Supply your own media so you're not redistributing content you don't hold the rights to.
Not available on the Android app yet, there's no Android FFmpeg build bundled with it.
- sandertv/gophertunnel (vendored, patched): MIT License
- df-mc/dragonfly: MIT License
- FFmpeg (bundled prebuilt binary,
bin\ffmpeg.exe, "essentials" build from gyan.dev): GNU GPL v3. The corresponding source is freely available from ffmpeg.org and gyan.dev. The full license text ships inbin\ffmpeg-LICENSE.txt.
Ender-Proxy is provided as-is, with no warranty of any kind. By downloading or using it, you agree that:
- You are solely responsible for how you use it, including which worlds, Realms, or servers you connect to and which modules you enable.
- The author(s) are not liable for any account suspensions or bans, lost items or progress, world damage, or any other loss or damage arising from your use (or misuse) of this software.
- You are responsible for complying with Mojang/Microsoft's Minecraft End User License Agreement and the rules of any server, Realm, or world you connect to.
- This project is unofficial and is not affiliated with, endorsed by, or sponsored by Mojang Studios or Microsoft.
Released under the MIT License. Third-party components keep their own licenses, see Third-Party Components above.