Pumpkin-Docs/docs/en/troubleshooting/common_issues.md
Alexander Medvedev 5c23b676ed feat: d binding
2026-09-17 09:23:24 +02:00

21 lines
1.2 KiB
Markdown

# Common Issues
1. ## Failed to verify username
**Issue:** Some players reported having issues logging into the server, including encountering a "Failed to verify username" error.
**Cause:** This has to do with authentication, and usually with the `prevent_proxy_connections` setting.
**Fix:** Disable `prevent_proxy_connections` under `[networking.java.authentication]` in `pumpkin.toml`
2. ## Cannot connect using 0.0.0.0
**Issue:** Players attempting to join a server running on their own machine cannot connect (e.g., encountering a "Connection refused" error) when entering `0.0.0.0` or `0.0.0.0:25565`.
**Cause:** In `pumpkin.toml`, `0.0.0.0` is a wildcard listener address that tells Pumpkin to bind and listen on all local network interfaces. It is not a valid destination address for Minecraft clients to connect to.
**Fix:**
- When connecting from the **same machine**, enter `localhost` or `127.0.0.1` in the Minecraft client.
- When connecting from **another device on the same local network (LAN)**, use the server host's local IP address (e.g., `192.168.x.x`).
- When connecting over the **internet**, other players must connect using your public IP address or domain name (with port `25565` forwarded on your router).