Files
GeyserWebsite/_site/geyser/fixing-unable-to-connect-to-world/index.html
T
2023-11-07 19:40:55 -06:00

551 lines
21 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<!doctype html>
<html lang="en" data-bs-theme="dark">
<head>
<meta charset="utf-8">
<meta http-equiv='X-UA-Compatible' content='IE=edge'>
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>GeyserMC Wiki: Fixing 'Unable to Connect to World'</title>
<link href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.0-alpha1/dist/css/bootstrap.min.css" rel="stylesheet" integrity="sha384-GLhlTQ8iRABdZLl6O3oVMWSktQOp6b7In1Zl3/Jr59b6EGGoI1aFkw7cmDA6j6gD" crossorigin="anonymous">
<link href="https://cdn.jsdelivr.net/npm/bootstrap-icons@1.10.3/font/bootstrap-icons.css" rel="stylesheet">
<link href="https://fonts.googleapis.com/css?family=Montserrat&display=swap" rel="stylesheet">
<link rel="stylesheet" href="/css/style.css">
<link rel="stylesheet" href="/css/darcula.css">
<meta name="author" content="GeyserMC">
<meta name="description" content="This is the wiki for all of GeyserMC's projects.">
<meta name="theme-color" content="#2b3035">
<meta property="og:type" content="website">
<meta property="og:url" content="http://localhost:4000">
<meta property="og:title" content="GeyserMC Wiki: Fixing 'Unable to Connect to World'">
<meta property="og:description" content="This is the wiki for all of GeyserMC's projects.">
<meta property="og:image" content="/android-chrome-192x192.png">
<link rel="shortcut icon" type="image/x-icon" href="/favicon.ico">
<link rel="icon" type="image/x-icon" href="/favicon.ico">
<link rel="icon" type="image/png" sizes="16x16" href="/favicon-16x16.png">
<link rel="icon" type="image/png" sizes="32x32" href="/favicon-32x32.png">
<link rel="icon" type="image/png" sizes="192x192" href="/android-chrome-192x192.png">
<link rel="apple-touch-icon" href="/apple-touch-icon.png">
<link rel="mask-icon" href="/safari-pinned-tab.svg" color="#248f00">
</head>
<body>
<header>
<nav class="navbar navbar-expand-lg bg-body-tertiary fixed-top">
<div class="container-fluid">
<a class="navbar-brand" href="/"><img src="/android-chrome-512x512.png" alt="geyser logo" height="32"> GeyserMC Wiki</a>
<button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarLinks" aria-controls="navbarLinks" aria-expanded="false" aria-label="Toggle navigation">
<span class="navbar-toggler-icon"></span>
</button>
<div class="collapse navbar-collapse" id="navbarLinks">
<ul class="navbar-nav ms-auto mb-2 mb-lg-0">
<li class="nav-item">
<a class="nav-link" href="https://geysermc.org/"><i class="bi bi-house pe-1"></i> Home</a>
</li>
<li class="nav-item">
<a class="nav-link" href="https://geysermc.org/download"><i class="bi bi-download pe-1"></i> Download</a>
</li>
</ul>
<form class="d-flex" role="search" action="/search/">
<div class="input-group">
<button class="btn btn-outline-secondary" type="submit" id="button-search"><i class="bi bi-search"></i></button>
<input type="text" name="q" class="form-control" placeholder="Search the site..." aria-label="Search the site..." aria-describedby="button-search">
</div>
</form>
</div>
</div>
</nav>
</header>
<div id="page-content" class="container-fluid">
<div class="row">
<div class="col-12 col-md-3 col-xl-2">
<div class="sticky-top">
<div class="sidebar py-2 text-break">
<nav class="navbar navbar-expand-md">
<div class="container-fluid">
<div class="d-block d-md-none">Wiki Navigation</div>
<button class="navbar-toggler mb-2" type="button" data-bs-toggle="collapse" data-bs-target="#sidebarNav" aria-controls="sidebarNav" aria-expanded="false" aria-label="Toggle navigation">
<span class="navbar-toggler-icon"></span>
</button>
<div class="collapse navbar-collapse flex-column align-items-start" id="sidebarNav">
<div class="nav-item dropdown">
<a class="nav-link dropdown-toggle fw-bold show" href="#" role="button" data-bs-toggle="dropdown" data-bs-auto-close="false" aria-expanded="false">Geyser Documentation</a>
<ul class="pe-3 pt-0 dropdown-menu position-relative border-0 list-disc show">
<li class="ms-4">
<a href="/geyser/setup/">Setting up Geyser</a>
<ul>
<li>
<a href="/geyser/supported-hosting-providers/">Supported Hosting Providers</a>
</li>
<li>
<a href="/geyser/using-geyser-with-consoles/">Using Geyser with Consoles</a>
</li>
<li>
<a href="/geyser/playit-gg/">Using playit.gg with Geyser</a>
</li>
<li>
<a href="/geyser/creating-a-startup-script/">Creating a Startup Script</a>
</li>
</ul>
</li>
<li class="ms-4">
<a href="/geyser/common-issues/">Common Issues</a>
<ul>
<li>
<a href="/geyser/fixing-unable-to-connect-to-world/">Fixing 'Unable to Connect to World'</a>
</li>
</ul>
</li>
<li class="ms-4">
<a href="/geyser/understanding-the-config/">Configuring Geyser</a>
<ul>
<li>
<a href="/geyser/commands/">Commands</a>
</li>
<li>
<a href="/geyser/geyser-command-line-arguments-and-system-properties/">Geyser Command Line Arguments and System Properties</a>
</li>
</ul>
</li>
<li class="ms-4">
<a href="/geyser/faq/">FAQ</a>
<ul>
<li>
<a href="/geyser/anticheat-compatibility/">Anticheat Compatibility</a>
</li>
<li>
<a href="/geyser/current-limitations/">Current Limitations</a>
</li>
</ul>
</li>
<li class="ms-4">
<a href="/geyser/custom-items/">Custom items with Geyser</a>
<ul>
<li>
<a href="/geyser/custom-items/#json-mappings">JSON mappings</a>
</li>
<li>
<a href="/geyser/custom-items/#geyser-extensions">Geyser extensions</a>
</li>
<li>
<a href="/geyser/custom-items/#resource-pack">Resource pack</a>
</li>
</ul>
</li>
<li class="ms-4">
<a href="/geyser/custom-blocks/">Custom blocks with Geyser</a>
<ul>
<li>
<a href="/geyser/custom-blocks/#enabling-custom-blocks">Enabling custom blocks</a>
</li>
<li>
<a href="/geyser/custom-blocks/#json-mappings">JSON mappings</a>
</li>
<li>
<a href="/geyser/custom-blocks/#geyser-extensions">Geyser extensions</a>
</li>
</ul>
</li>
<li class="ms-4">
<a href="/geyser/custom-skulls/">Custom skulls with Geyser</a>
<ul>
<li>
<a href="/geyser/custom-skulls/#enabling-custom-skulls">Enabling custom skulls</a>
</li>
<li>
<a href="/geyser/custom-skulls/#custom-skullsyml">custom-skulls.yml</a>
</li>
</ul>
</li>
<li class="ms-4">
<a href="/geyser/api/">Geyser API</a>
<ul>
<li>
<a href="/geyser/getting-started-with-the-api/">Getting Started</a>
</li>
<li>
<a href="/geyser/api/#short-overview-of-the-geyser-api">Overview</a>
</li>
<li>
<a href="/geyser/events/">Events</a>
</li>
<li>
<a href="/geyser/forms/">Forms and Cumulus</a>
</li>
</ul>
</li>
<li class="ms-4">
<a href="/geyser/extensions/">Geyser Extensions</a>
<ul>
<li>
<a href="/geyser/extensions/#creating-the-main-class">Main class</a>
</li>
<li>
<a href="/geyser/extensions/#creating-commands-with-geyser-extensions">Creating Commands</a>
</li>
</ul>
</li>
<li class="ms-4">
<a href="/geyser/global-api/">Global API</a>
</li>
</ul>
</div>
<div class="nav-item dropdown">
<a class="nav-link dropdown-toggle fw-bold" href="#" role="button" data-bs-toggle="dropdown" data-bs-auto-close="false" aria-expanded="false">Floodgate Documentation</a>
<ul class="pe-3 pt-0 dropdown-menu position-relative border-0 list-disc">
<li class="ms-4">
<a href="/floodgate/setup/">Setup</a>
</li>
<li class="ms-4">
<a href="/floodgate/issues/">Issues</a>
</li>
<li class="ms-4">
<a href="/floodgate/faq/">FAQ</a>
</li>
<li class="ms-4">
<a href="/floodgate/features/">Features</a>
<ul>
<li>
<a href="/floodgate/features/#whitelist-command">Whitelist command</a>
</li>
<li>
<a href="/floodgate/commands/">Commands</a>
</li>
<li>
<a href="/floodgate/features/#what-is-skin-uploading">Skin Uploading</a>
</li>
</ul>
</li>
<li class="ms-4">
<a href="/floodgate/api/">Floodgate API</a>
<ul>
<li>
<a href="/floodgate/player/">FloodgatePlayer</a>
</li>
<li>
<a href="/geyser/forms/">Forms and Cumulus</a>
</li>
</ul>
</li>
<li class="ms-4">
<a href="/floodgate/linking/">Linking</a>
<ul>
<li>
<a href="/floodgate/linking/#what-is-global-linking">Global Linking</a>
</li>
<li>
<a href="/floodgate/linking/#local-linking">Local Linking</a>
</li>
</ul>
</li>
</ul>
</div>
<div class="nav-item dropdown">
<a class="nav-link dropdown-toggle fw-bold" href="#" role="button" data-bs-toggle="dropdown" data-bs-auto-close="false" aria-expanded="false">Other</a>
<ul class="pe-3 pt-0 dropdown-menu position-relative border-0 list-disc">
<li class="ms-4">
<a href="/other/geyseroptionalpack/">GeyserOptionalPack</a>
</li>
<li class="ms-4">
<a href="/other/hurricane/">Hurricane</a>
</li>
<li class="ms-4">
<a href="/other/geyserconnect/">GeyserConnect</a>
</li>
<li class="ms-4">
<a href="/other/community-geyser-projects/">Community Geyser Projects</a>
</li>
<li class="ms-4">
<a href="/other/test-server/">Test Server</a>
</li>
<li class="ms-4">
<a href="/other/developer-guide/">Developer Guide</a>
</li>
<li class="ms-4">
<a href="/other/discord-bot-usage/">Geyser Discord Bot Usage</a>
</li>
</ul>
</div>
</div>
</div>
</nav>
</div>
</div>
</div>
<main class="col-12 col-md-9 col-xl-8" role="main">
<nav aria-label="breadcrumb">
<ol class="breadcrumb">
<li class="breadcrumb-item"><a href="http://localhost:4000/geyser/">Geyser</a></li>
<li class="breadcrumb-item active" aria-current="page">Fixing 'Unable to Connect to World'</li>
</ol>
</nav>
<h1 id="fixing-unable-to-connect-to-world-errors">Fixing ‘Unable to Connect to World’ errors</h1>
<p>This is by far the most common error people get when attempting to set up Geyser. Here’s some steps on how to solve it.
Usually, this error is caused by improper configuration of Geyser, or issues with your network.</p>
<div class="alert alert-warning" role="alert">
If you are using a Minecraft server hosting provider (e.g. Aternos, or Apex Hosting), you should refer to the hosting provider setup instructions on
the <a href="/geyser/setup/">setup</a> page. Following these will most likely resolve the issue!
</div>
<p>If you are not using a Minecraft server hosting provider, carry on.</p>
<div class="alert alert-info" role="alert">
To check if your server is (theoretically) reachable on Bedrock edition, try running the following command in your server console:
<code>geyser connectiontest &lt;ip&gt;:&lt;port&gt;</code>, and see what it suggests to try.
</div>
<h3 id="java-edition-players-cant-connect">Java Edition players can’t connect!</h3>
<p>This <strong>should not be</strong> a Geyser problem. Geyser does not modify server behavior. Floodgate does modify the login structure, but only for Bedrock players.
Contact your hosting provider or look elsewhere for fixing this connection issue.</p>
<h3 id="connecting-fails-after-updating-geyser">Connecting fails after updating Geyser</h3>
<p>If this occurred after updating a plugin version of Geyser, ensure that you shut off your server, swapped the Geyser jar, and then started up your server.
Incase you reset your configuration file, check out the <a href="/geyser/setup/">setup guide</a> again.</p>
<h3 id="there-are-errors-in-my-console">There are errors in my console!</h3>
<p>Please read through the <a href="/geyser/common-issues/">common issues page</a>. If there is another error not documented there, join us on our <a href="https://discord.geysermc.org">Discord</a>.</p>
<h3 id="try-restarting-the-server-and-game">Try restarting the server and game</h3>
<p>Especially on mobile devices, sometimes just restarting Minecraft fixes the issue.</p>
<h3 id="is-it-the-server-or-the-client">Is it the server or the client?</h3>
<p>Run your Java server IP and Bedrock address here: https://mcsrvstat.us/. It’s a great way of determining if the server is reachable in the first place.
Additionally, check if you can see a connection attempt in the server console. If you can’t, it’s likely a network issue.</p>
<p>For console players specifically: If only they can’t join, while other Bedrock players can, it is likely an issue with their console connecting method.</p>
<h1 id="general-troubleshooting-steps">General troubleshooting steps</h1>
<h3 id="ensure-youre-connecting-on-the-right-ip-and-port">Ensure you’re connecting on the right IP and Port</h3>
<p>You should be connecting with the Java server IP and the Bedrock port (set in the Geyser config). If you port forwarded 19132, for example, you should specify port 19132 when connecting from Bedrock.</p>
<h3 id="im-using-a-hosting-provider-or-vps">I’m using a hosting provider or VPS!</h3>
<p>Please read <a href="/geyser/supported-hosting-providers/">this page on supported hosting providers</a> to see if there are extra configuration steps required for your hosting or server provider.
Some VPS/KVM providers may require further setup, such as OVH, SoYouStart, and Oracle Cloud. Please read this <a href="/geyser/port-forwarding/#issues-with-specific-vpskvm-providers">note</a> for more information.</p>
<h3 id="issues-using-docker-or-pterodactyl">Issues using Docker or Pterodactyl</h3>
<p>Make sure you assign the port to pterodactyl, and on docker, to the docker compose file. See our <a href="/geyser/port-forwarding/#using-docker-or-pterodactyl">port-forwarding</a> page for fixes.</p>
<h1 id="port-forwarding-issues">Port forwarding issues</h1>
<p>Your server does need to be port forwarded to allow connections from outside the local network. See <a href="/geyser/port-forwarding/">our port-forwarding guide</a> for more information.</p>
<h3 id="using-tcp-in-dns-optionsport-forwarding-instead-of-udp">Using TCP in DNS options/port forwarding instead of UDP</h3>
<p>Minecraft: Java Edition uses TCP for connecting; Minecraft: Bedrock Edition uses UDP. Port forwarding your Bedrock Edition port with only TCP will not work, it has to be UDP. Forwarding your Bedrock Edition port with <code class="language-plaintext highlighter-rouge">TCP/UDP</code> (both protocols) should also work but is not recommended unless Java Edition and Bedrock Edition is sharing the same port.</p>
<h3 id="bedrock-port-is-less-than-10000">Bedrock port is less than 10000</h3>
<p>Historically, having a Bedrock port that is a lower number will cause issues. Setting it to 10000 or above seems safe.</p>
<h3 id="bedrock-players-can-connect-after-hitting-the-server-on-a-tcp-port-eg-on-java-or-a-website-on-the-same-server-or-only-people-who-also-play-on-java-edition-can-join-from-geyser">Bedrock players can connect <em>after</em> hitting the server on a TCP port (e.g. on Java or a website on the same server), OR only people who also play on Java Edition can join from Geyser</h3>
<p>This is likely a firewall issue on your server. Try the following workaround:
Attempt to connect to the Bedrock IP and port through a web browser - for example, <code class="language-plaintext highlighter-rouge">http://test.geysermc.org:19132</code>. It won’t work, but then try connecting through Bedrock, and it should work.</p>
<p>Specific host fixes for OVH/SoYouStart can be found <a href="/geyser/port-forwarding/#issues-with-specific-vpskvm-providers">here</a>.</p>
<h3 id="changing-the-bedrock-address-in-the-geyser-config">Changing the <code class="language-plaintext highlighter-rouge">bedrock</code> <code class="language-plaintext highlighter-rouge">address</code> in the Geyser config.</h3>
<p>Except for a few specific hosting providers, you generally do not need to change this part of the Geyser config.
However, in rare instances, it does fix issues - for example, when Windows has multiple network adapters (check by running <code class="language-plaintext highlighter-rouge">ipconfig</code> in cmd),
it can help to set the <code class="language-plaintext highlighter-rouge">address</code> to the local IP of the adapter you want to use.</p>
<h1 id="using-a-hosting-provider-or-other-location">Using a hosting provider or other location</h1>
<h3 id="pterodactyl">Pterodactyl</h3>
<p>If you get this error while using the Pterodactyl Panel, try editing the Geyser config and changing the port to something besides <code class="language-plaintext highlighter-rouge">19132</code> (e.g. <code class="language-plaintext highlighter-rouge">25566</code>).</p>
<h1 id="hosting-geyser-on-another-computer-on-the-same-network">Hosting Geyser on another computer on the same network</h1>
<h3 id="can-only-connect-from-the-same-computer-and-not-anywhere-else">Can only connect from the same computer and not anywhere else</h3>
<p>Your firewall is likely in the way. Try adding an exception to Java, or disable the firewall for testing purposes.</p>
<h1 id="as-a-last-resort-for-troubleshooting">As a last resort for troubleshooting…</h1>
<p>Minecraft offers a vanilla Bedrock server <a href="https://www.minecraft.net/download/server/bedrock">here</a>. Downloading, running, and attempting to connect to it may help isolate if the issue is on Geyser’s end, or your computer/network’s end.</p>
<h1 id="using-geyser-on-the-same-computer">Using Geyser on the same computer</h1>
<h3 id="windows-1011">Windows 10/11</h3>
<p><em>This only affects people trying to join Geyser from Windows 10/11 Edition with Geyser hosted on the same computer.</em></p>
<p>This is an issue caused by Loopback restrictions not being lifted. By default, Microsoft Apps have this restriction on all their apps for local connections. Geyser will attempt to resolve this automatically; however, if you’re still having connection problems, you can lift it by typing the following in Windows PowerShell in administrator mode: (it should return <code class="language-plaintext highlighter-rouge">OK.</code> if it worked)</p>
<div class="language-powershell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">CheckNetIsolation</span><span class="w"> </span><span class="nx">LoopbackExempt</span><span class="w"> </span><span class="nt">-a</span><span class="w"> </span><span class="nt">-n</span><span class="o">=</span><span class="s2">"Microsoft.MinecraftUWP_8wekyb3d8bbwe"</span><span class="w">
</span></code></pre></div></div>
<p>Should this not work, you can try this set of steps:</p>
<ol>
<li>Hold down Windows Key + R</li>
<li>In the prompt, type <code class="language-plaintext highlighter-rouge">hdwwiz.exe</code>, then press Enter then Next</li>
<li>Install the Hardware Manually</li>
<li>Choose Network Adapter &gt; Next &gt; Microsoft &gt; “Microsoft KM-TEST Loopback Adapter” then hit Next until it’s done.</li>
</ol>
</main>
<div class="col-2 d-none d-xl-block">
<div class="sticky-top">
<div class="sidebar py-2">
<a class="d-block text-decoration-none" href="https://github.com/GeyserMC/GeyserWiki/edit/master/_docs/geyser/fixing-unable-to-connect-to-world.md" target="_blank"><i class="bi bi-pencil"></i> Edit this page</a>
<a class="d-block text-decoration-none" href="https://github.com/GeyserMC/GeyserWiki/issues/new?labels=question&title=Question:&body=Question on: _docs/geyser/fixing-unable-to-connect-to-world.md" target="_blank"><i class="bi bi-github"></i> Create Wiki issue/bug report</a>
<a class="d-block text-decoration-none" href="/issues/new" target="_blank"><i class="bi bi-list-check"></i> Create Geyser issue/bug report</a>
<div id="page-nav" class="py-3 "></div>
</div>
</div>
</div>
</div>
</div>
<!-- <footer class="p-4 text-center bg-body-tertiary">
&copy; 2023 GeyserMC
</footer> -->
<script src="https://cdn.jsdelivr.net/npm/bootstrap@5.3.0-alpha1/dist/js/bootstrap.bundle.min.js" integrity="sha384-w76AqPfDkMBDXo30jS1Sgez6pr3x5MlQ1ZAGC+nuZB+EYdgRZgiwxhTBTkF7CXvN" crossorigin="anonymous"></script>
<script src="/js/page-nav.js"></script>
</body>
</html>