VIAaaS/README.md

VIAaaS

Idea: server.example.com._p25565._v1_12_2._otrue._uBACKUSERNAME.viaaas.example.com (default backend 25565 port and version default as auto, online-mode can be optional/required) (similar to tor to web proxies)

• TODO: _o option for disabling online mode only in front end, protocol auto detection

• Connection to private IP addresses are currently blocked

• VIAaaS auth page is designed for storing accounts in the browser local storage. It requires a CORS Proxy for calling Mojang APIs, which may make Mojang see that as suspicious and reset/block your account password.

• VIAaaS may have security vulnerabilities, make sure to block the ports in firewall and take care of browser local storage.

Usage for offline mode:

• Run the shadow jar or ./gradlew clean run
• Connect to mc.example.com._v1_8.viaaas.localhost

Usage for online mode (may block your Mojang account):

• Run the shadow jar or ./gradlew clean run
• It's recommended to use 2 premium accounts for online mode (using only one account is possible but, as only one access tokens can be active, your Minecraft client will give Bad Login after you approve the login in your browser. You can use https://www.curseforge.com/minecraft/mc-mods/auth-me for reauthenticate the client.)
• You should set up a CORS Proxy (something like https://github.com/Rob--W/cors-anywhere) on local machine.
• Go to https://localhost:25543/auth.html, configure the CORS Proxy URL (something like http://localhost:8080/) and listen to the username you're using to connect.
• Add web page the account you used in _u parameter.
• Connect to mc.example.com._v1_8.viaaas._u(BACKUSERNAME).localhost
• Approve the login
• There are some information about Mojang password resetting: https://github.com/GeyserMC/Geyser/wiki/Common-Issues#mojang-resetting-account-credentials and https://mobile.twitter.com/MojangSupport/status/863697596350517248