Skip to content

Add solution for forced hosts not working in velocity faq.md #592

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: main
Choose a base branch
from
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 15 additions & 4 deletions src/content/docs/velocity/admin/getting-started/faq.md
Original file line number Diff line number Diff line change
Expand Up @@ -99,10 +99,21 @@ the best read timeout to use, use `-Dfml.readTimeout=120` and set `read-timeout

### My forced hosts are not working!

First, double-check that you properly set up DNS records pointing to your proxy for the forced hosts
you have selected. Forced hosts are _not_ compatible with SRV records, so if you are relying on SRV
records to direct the player to the proxy, you will need to find a way to get the proxy running on
the default Minecraft port, 25565.
If you are relying on SRV records to direct the player to the proxy, remember that Velocity matches `forced-hosts` using the **hostname the client sends**, which is resolved before the connection — not necessarily the address the player types.

To make `forced-hosts` work with a proxy on a non-default port (e.g. `12345`), use this setup:

Create DNS records:
- **CNAME:** `forced1.example.com → actual.server.address.com`
- **SRV:** `_minecraft._tcp.survival → forced1.example.com` (priority: 0, weight: 0, port: 12345)

In velocity.toml:
```
[forced-hosts]
"forced1.example.com" = ["survival"] # survival.example.com
```

Although the player connects via `survival.example.com`, the SRV record points to `forced1.example.com`, and that is what the client sends to Velocity — allowing it to match correctly in `forced-hosts`.

### Plugins unable to modify messages or commands

Expand Down