Wisp Proxy Mod
Enables connections to Minecraft: Java Edition servers through a Wisp WebSocket proxy.
warning
This is not Wispcraft. This is a custom implementation of the Wisp protocol. You must have a valid Wisp Host URL to use this mod.
Generic Settings
- Use Wisp Proxy: Master toggle for the proxy functionality.
caution
The URL must start with wss:// (secure) or ws://.
- Wisp Host: The WebSocket URL of the Wisp proxy server.
- Connection Tries: The number of times the client will attempt to connect to the Wisp Host before giving up.
Proxy Status Display
This section displays the current connection status to the Wisp Host.
- Connect/Reconnect: Initiates a connection to the defined Wisp Host.
- Disconnect: Closes the connection to the proxy.
Java Server Settings
- Enable Java Server Connections: Toggles the ability to interpret specific server addresses as Java Edition targets.
- Java Server Prefix: The prefix required to trigger the proxy when adding a server or Direct Connecting.
- DNS Resolver: The DNS server IP used to resolve SRV records (finding the correct IP and Port for Java servers). Defaults to Cloudflare (
1.1.1.1). - Support Premium Servers: Enables the authentication flow required to join online-mode (Premium) servers.
Premium Login
This section manages your Microsoft Authentication session for premium servers.
- Login with Microsoft account: Starts the Device Code authentication flow. You will be provided with a code and a link (
https://microsoft.com/link) to authorize the login. - Refresh Token: Refreshes your session if it has expired without requiring a full re-login.
- Sign out: Clears your current session.
How to use
- Enter a valid Wisp Host in the Generic Settings.
- Click Connect in the Proxy Status Display.
- If playing on a premium server, complete the Premium Login process. Else, skip this step.
- Go to the Multiplayer menu.
- Add a server or Direct Connect using the configured Java Server Prefix.
- Example: If the prefix is
java://, connect tojava://hypixel.net.