Skip to content

About

General-Purpose Utility MITM Proxy

Resources

Stars

2 stars

Watchers

0 watching

Forks

Latest commit

 

History

11 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 

Repository files navigation

💬 Join the Discord

Ender-Proxy

🇰🇷 한국어로 보기: 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.

Contents

Features

  • 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.gg link 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-world video playback, custom skin switching.
  • 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 for wssay / wsspam / whisperwspam that 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.

Requirements

Windows

  • 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 /.video module, so there is nothing extra to install for that.
  • Nothing else to install. wssay / wsspam / whisperwspam are handled entirely inside enderproxy-gui.exe, no Node.js or any other runtime needed.

Android

  • 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.

Download & Install

Both platforms' files are on the same Releases page.

Windows

  1. Grab the latest Ender-Proxy-<version>-win64.zip.
  2. Extract it anywhere (avoid C:\Program Files, which Windows locks down for writing).
  3. 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.

Android

  1. Grab the latest Ender-Proxy-<version>-android-arm64.apk.
  2. Open it from your file manager or downloads notification. Android will ask to allow installs from that source the first time, allow it.
  3. Open the app. Unlike Windows, there's no separate setup step needed first, no loopback exemption command to run. Just open it.
  4. 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.

Before You Start: Windows Loopback Exemption

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.)

  1. Open PowerShell as Administrator (right-click the Start button, choose "Terminal (Admin)" or "Windows PowerShell (Admin)").

  2. 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"
  3. 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.

Windows: Step-by-Step Guide

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.

Step 1: Apply the loopback exemption

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.

Step 2: Extract the zip

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.

Step 3: Run the program

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".

Step 4: Sign in with Xbox Live

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).

Step 5: Pick a session

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.

Step 6: Connect Minecraft to the proxy

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.

Step 7: Try your first command

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.

Troubleshooting

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).

Android: Step-by-Step Guide

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.

Step 1: Install the APK

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.

Step 2: Open the app and log in

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.

Step 3: Allow the overlay (optional)

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.

Step 4: Pick a session

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.

Step 5: Connect Minecraft to the proxy

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.

Step 6: Try your first command

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.

Step 7: Stopping it

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.

Troubleshooting

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.

Android Notes

  • 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: /.video isn't available yet (no Android FFmpeg build bundled), and only 64-bit ARM (arm64-v8a) devices are supported.

Settings

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

Commands

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.

General

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

Combat

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)

Movement

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

World

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

Visual

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)

Chat

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

External Tool Bridge

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

Optional Components

Video playback (FFmpeg, Windows only)

/.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.

Third-Party Components

Terms of Use / Disclaimer

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.

License

Released under the MIT License. Third-party components keep their own licenses, see Third-Party Components above.

About

General-Purpose Utility MITM Proxy

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors