Help

Stuck joining?

This page helps you narrow down the problem before Discord turns into twenty screenshots and no context.

Troubleshooting

Find your symptom

Each card lists the likely cause, the fix, and where to ask if it does not work.

Issue

Cannot connect / "not whitelisted" message.

Likely cause
Your username is not on the whitelist yet, or the server address you used is outdated.
Fix
Confirm staff has whitelisted you in Discord, double-check the server address shown for your status, and try again.
Where to ask: #join-help on Discord

Issue

Wrong modpack version / missing mods on join.

Likely cause
Your installed pack version does not match the server's current version.
Fix
Match the recommended version listed on the Homestead page. Do not auto-update unless staff confirms the server has updated.
Where to ask: #join-help on Discord

Issue

Whitelist not active because of a username typo.

Likely cause
The Java username posted in #whitelist did not exactly match your real Mojang/Minecraft username.
Fix
Post your exact Java username again in #whitelist so staff can re-add it. Capitalization counts.
Where to ask: #join-help on Discord

Issue

CurseForge or launcher won't launch the pack.

Likely cause
Corrupt install, account not signed in, or invalid install folder path.
Fix
Repair the install from the launcher, confirm your Minecraft account is signed in, and avoid install folders with special characters or OneDrive sync.
Where to ask: #join-help on Discord

Issue

Wrong Java version (Java 17 required).

Likely cause
The launcher is using a bundled or system Java that is not Java 17.
Fix
Set the pack profile to use Java 17. Homestead's official guide calls out Java 17 for startup crashes.
Where to ask: #join-help on Discord

Issue

Memory allocation too low (allocate 6-8 GB).

Likely cause
Default 2-4 GB is not enough for a modded pack like Homestead.
Fix
In your launcher's per-pack settings, allocate 6 GB minimum, 8 GB recommended for the Homestead client.
Where to ask: #join-help on Discord

Issue

Shaders or low-end device causing crashes/lag.

Likely cause
Shaders, ultra render distance, or outdated GPU drivers on a low-end device.
Fix
Disable shaders, lower render distance, and update GPU drivers. The pack should be playable without shaders.
Where to ask: #join-help on Discord

Issue

Server appears offline because it just restarted.

Likely cause
Modded servers can show online before they are fully ready after a restart.
Fix
Give it a minute or two and try again. If it stays unreachable, check Discord for a status note.
Where to ask: #join-help on Discord

When you ask for help

Send these in #join-help

Bring this and someone can help in two messages instead of twelve.

  1. Minecraft username
  2. Launcher used
  3. Pack version
  4. Screenshot of error
  5. Latest log or mclo.gs link
  6. What you already tried
Tip: paste your launcher's latest log into mclo.gs and share the link. Logs over a megabyte get mangled in Discord.

Quick checks

Common pitfalls

If your install does not work, start here.

  • Match the version on /homestead, not the newest CurseForge file.
  • Use Java 17 for the Homestead client.
  • Allocate 6–8 GB of RAM.

Where to go next

Most join issues clear up after a closer look at the install steps or rules. If they do not, post in #join-help.

Read the rules Join Discord