How to Fix Invalid Session on Minecraft Server
Fix Minecraft Invalid Session errors by checking launcher login, Microsoft authentication, online-mode, proxy forwarding, cracked clients, and session refresh.
Invalid Session is an authentication problem. The client reached the server, but the login/session check failed. It is not the same as a port forwarding or DNS error.
Player-Side First Fix
Ask the player to:
- Close Minecraft.
- Close the launcher completely.
- Reopen the launcher.
- Sign out and sign back in if needed.
- Join again with a clean session.
This fixes many expired session cases without changing server settings.
Check online-mode
For a normal public Java server:
online-mode=true
online-mode=true means the server checks players against Microsoft/Mojang authentication. That prevents username impersonation.
Read what online-mode does before changing it. For most public servers, the safe answer is to keep it enabled.
Setting `online-mode=false` on a public backend can allow username spoofing, permission abuse, and inventory/profile confusion. Only use it behind a correctly configured authenticated proxy.
Proxy Networks
Velocity and BungeeCord networks are different. Players authenticate at the proxy, and backend servers usually run in a mode that trusts the proxy. If forwarding secrets or modes do not match, players can see authentication/session errors or unsafe profile behavior.
Check:
- Proxy forwarding mode.
- Backend server forwarding settings.
- Secret/token matches.
- Backend firewall only allows proxy traffic.
- LuckPerms or auth plugins are installed on the right layer.
Cracked Clients and Offline Networks
MineFixTools does not recommend disabling authentication for normal public servers. If you operate a private offline-mode environment, understand the tradeoff: the server no longer verifies account ownership through the official session service. You must handle identity risk yourself.
Use should you set online-mode=false before making that decision.
FAQ
What does Invalid Session mean?
It usually means the client session token is missing, expired, or rejected by the authentication path.
Can a server setting cause Invalid Session?
Yes. Misconfigured online-mode or proxy forwarding can make valid players fail authentication.
Should I set online-mode=false to fix it?
Not on a normal public server. Disabling online-mode removes Mojang/Microsoft authentication and creates serious impersonation risk unless a properly configured proxy handles authentication.
Related Tools
server.properties Generator
Generate a clean Minecraft server.properties baseline for online mode, max players, difficulty, view distance, simulation distance, and command blocks.
Startup Log Classifier
Paste a Minecraft startup log excerpt to classify Java mismatch, port conflicts, memory errors, plugin failures, dependency issues, and TPS overload.
Geyser Setup Wizard
Build a Geyser setup plan for Paper, Purpur, Velocity, or standalone installs with Bedrock UDP ports, Floodgate, proxy, and firewall reminders.
Related Articles
What Does online-mode Do in Minecraft?
Understand online-mode in Minecraft server.properties, how authentication works, why UUIDs matter, and when proxies use different backend settings.
Should You Set online-mode=false?
Learn when online-mode=false is risky, when proxies may require backend offline mode, and how to avoid Minecraft username spoofing and UUID problems.
Fix Can't Connect to a Minecraft Server
Fix Minecraft server connection errors by checking startup, server.properties, port forwarding, firewalls, DNS, SRV records, and proxies.