diff --git a/static/img/wiki/playit-gg/add_tunnel.png b/static/img/wiki/playit-gg/add_tunnel.png deleted file mode 100644 index 693c79a..0000000 Binary files a/static/img/wiki/playit-gg/add_tunnel.png and /dev/null differ diff --git a/static/img/wiki/playit-gg/added_tunnel.png b/static/img/wiki/playit-gg/added_tunnel.png deleted file mode 100644 index 72bfb59..0000000 Binary files a/static/img/wiki/playit-gg/added_tunnel.png and /dev/null differ diff --git a/static/img/wiki/playit-gg/playit_add_agent.png b/static/img/wiki/playit-gg/playit_add_agent.png new file mode 100644 index 0000000..dff1a4d Binary files /dev/null and b/static/img/wiki/playit-gg/playit_add_agent.png differ diff --git a/static/img/wiki/playit-gg/playit_add_tunnel.png b/static/img/wiki/playit-gg/playit_add_tunnel.png new file mode 100644 index 0000000..db1bb08 Binary files /dev/null and b/static/img/wiki/playit-gg/playit_add_tunnel.png differ diff --git a/static/img/wiki/playit-gg/playit_claim.png b/static/img/wiki/playit-gg/playit_claim.png new file mode 100644 index 0000000..d9d3d92 Binary files /dev/null and b/static/img/wiki/playit-gg/playit_claim.png differ diff --git a/static/img/wiki/playit-gg/playit_claim_confirm.png b/static/img/wiki/playit-gg/playit_claim_confirm.png new file mode 100644 index 0000000..b0d6bdf Binary files /dev/null and b/static/img/wiki/playit-gg/playit_claim_confirm.png differ diff --git a/static/img/wiki/playit-gg/playit_create_tunnel.png b/static/img/wiki/playit-gg/playit_create_tunnel.png new file mode 100644 index 0000000..4000f53 Binary files /dev/null and b/static/img/wiki/playit-gg/playit_create_tunnel.png differ diff --git a/static/img/wiki/playit-gg/playit_name_tunnel.png b/static/img/wiki/playit-gg/playit_name_tunnel.png new file mode 100644 index 0000000..41aecdf Binary files /dev/null and b/static/img/wiki/playit-gg/playit_name_tunnel.png differ diff --git a/static/img/wiki/playit-gg/playit_select_network.png b/static/img/wiki/playit-gg/playit_select_network.png new file mode 100644 index 0000000..939ac7b Binary files /dev/null and b/static/img/wiki/playit-gg/playit_select_network.png differ diff --git a/static/img/wiki/playit-gg/playit_set_ipandport.png b/static/img/wiki/playit-gg/playit_set_ipandport.png new file mode 100644 index 0000000..6568c38 Binary files /dev/null and b/static/img/wiki/playit-gg/playit_set_ipandport.png differ diff --git a/static/img/wiki/playit-gg/playit_tunnel_type.png b/static/img/wiki/playit-gg/playit_tunnel_type.png new file mode 100644 index 0000000..5551a9c Binary files /dev/null and b/static/img/wiki/playit-gg/playit_tunnel_type.png differ diff --git a/static/img/wiki/playit-gg/running.png b/static/img/wiki/playit-gg/running.png deleted file mode 100644 index fdf8ecc..0000000 Binary files a/static/img/wiki/playit-gg/running.png and /dev/null differ diff --git a/wiki/geyser/playit-gg.md b/wiki/geyser/playit-gg.md index 108366e..ce040b6 100644 --- a/wiki/geyser/playit-gg.md +++ b/wiki/geyser/playit-gg.md @@ -16,20 +16,31 @@ The playit.gg Minecraft server plugin does not support UDP tunnels. You will nee - If you already have playit.gg running & set up (for e.g. Minecraft Java edition), skip steps 1 and 2 and proceed with step 3. ## Setup {#setup} -1. Head over to [playit.gg's website](https://playit.gg/) - download the program & run it. It will open the login site in the browser - create an account & sign in. Or, use a guest account. -2. Once logged in, make sure to connect the program + site, until step 4 is reached. This should happen automatically, if it does not, follow the instructions on the website and the playit.gg program console. - ![img](/img/wiki/playit-gg/running.png) -3. Click "Create Tunnel" if you see the screen above, or, select the "Tunnels" tab when logged in to your account. There, select "Minecraft Bedrock", leave "Enable Tunnel" ticked, and click "Add tunnel". - ![img](/img/wiki/playit-gg/add_tunnel.png) -4. Once "Add tunnel" is clicked, it should create a new tunnel, and you are set! Scroll down until you see this: - ![img](/img/wiki/playit-gg/added_tunnel.png) - In Geyser config, set the `advanced.bedrock.broadcast-port` to the playit.gg port from the "Allocation" tab. It is necessary for the motd to appear. - - **Please do not change your Geyser port in `config.yml`** unless you have a reason to (e.g. hosting another Geyser server on the same machine), in which case skip to the paragraph below. The bedrock (Geyser) port in `config.yml` and the playit.gg ports are entirely seperate, playit.gg will forward its port to the default Geyser port and should already work. Changing it can cause errors. If you have changed your config port, change the bedrock port back to the default of 19132 and ensure that `clone-remote-port` is `false`. - - If you have Geyser running on a port that is not 19132, update the "Local Port" with your Geyser port on the page shown above. The "Local Address" does not need to be changed unless you are not running playit.gg and Geyser on the same device. -5. Connect to your server - use the IP and Port from the "Allocation" tab. In our example - "180.ip.ply.gg" as the IP, and "17019" as the port. Alternatively, use the Domain it gives you instead of the IP. -6. If you join successfully, then you are done! Make sure to leave the playit.gg program running as closing it will close the tunnel. You also may want to ratelimit individual connections - use the "Per Connection Rate Limit" option to do so. +1. Head over to [playit.gg's website](https://playit.gg/) - download the program & run it. +2. The program will provide a claiming link. Visit that link, log in. + ![img](/img/wiki/playit-gg/playit_claim.png) +3. Confirm your agent. + ![img](/img/wiki/playit-gg/playit_claim_confirm.png) +4. Add the agent. + ![img](/img/wiki/playit-gg/playit_add_agent.png) +5. After the agent is created, create a tunnel. + ![img](/img/wiki/playit-gg/playit_add_tunnel.png) +6. Name your tunnel and click Next. + ![img](/img/wiki/playit-gg/playit_name_tunnel.png) +7. Select "Minecraft Bedrock" as the tunnel type and click Next. + ![img](/img/wiki/playit-gg/playit_tunnel_type.png) +8. Select the Free Network and click Next. + **Do not change your Geyser port in `config.yml` unless you have a reason (for example, hosting another Geyser server on the same machine).** The Bedrock (Geyser) port in `config.yml` and the playit.gg ports are separate. playit.gg will forward its port to the default Geyser port and should work as-is. Changing it can cause errors. If you have changed your config port, set the Bedrock port back to the default `19132` and ensure `clone-remote-port` is `false`. +9. If the playit.gg agent and GeyserMC are running on the same device, leave the IP as `127.0.0.1` and set the port to whatever you configured in GeyserMC's config. + ![img](/img/wiki/playit-gg/playit_set_ipandport.png) +10. Select `proxy-protocol-v2` for the Proxy Protocol section and click Next. +11. In the GeyserMC config, under `advanced:` `bedrock:`, set `use-haproxy-protocol` to `true`. +12. Click Create Tunnel and wait for the tunnel to be created. + ![img](/img/wiki/playit-gg/playit_create_tunnel.png) +13. Copy your tunnel's port. For example, if your tunnel address is `visiting-phone.gl.at.ply.gg:6695`, then `6695` is the tunnel port. +14. In the GeyserMC config under `advanced:` `bedrock:`, set `broadcast-port` to your tunnel port (`6695` in the example). +15. Save your config. Start your Minecraft server and connect using your tunnel's IP and port. +16. If you join successfully, then you are done! Make sure to leave the playit.gg program running as closing it will close the tunnel. You also may want to ratelimit individual connections - use the "Per Connection Rate Limit" option to do so. (If you failed to join, check out the [troubleshooting](#troubleshooting) section of the page.) ## Troubleshooting {#troubleshooting} @@ -37,7 +48,7 @@ The playit.gg Minecraft server plugin does not support UDP tunnels. You will nee ### I can't connect to my server! {#i-cant-connect-to-my-server} * *Are there errors in your minecraft server console?* * *Unless you manually changed the "Local Port" on the playit.gg website, in Geyser config, ensure that the bedrock port is the default of `19132` and that `clone-remote-port` is `false`.* -* *If you changed the `bedrock-port` or set `clone-remote-port` to `true` and have a reason for doing so (e.g. hosting another Geyser server on the same machine), you'll have to tell playit.gg to use that port instead! See the last paragraph in step 4.* +* *If you changed the `bedrock-port` or set `clone-remote-port` to `true` and have a reason for doing so (e.g. hosting another Geyser server on the same machine), you'll have to tell playit.gg to use that port instead! See the last paragraph in step 8.* * *Check that you're joining with playit.gg's IP and port from the "Allocation" tab.* * *Make sure that you have the program agent open while trying to join.* * *See [here](/wiki/geyser/fixing-unable-to-connect-to-world/) for general troubleshooting steps.*