Accounts And Authentication

Identify the authentication layer

SoulFire has two separate authentication layers:

• logging a GUI or CLI client into a SoulFire server
• importing and refreshing Minecraft accounts for bots

If your GUI cannot log into a remote SoulFire server, start with Cannot Connect Or Times Out. This page covers bot account imports and Minecraft authentication.

Identify the account type first

Before you change anything, identify the account type:

• offline
• Microsoft Java
• Microsoft Bedrock
• cookie-based formats

Then compare your input against Account Formats. An incorrect input format often causes authentication errors.

Test without proxies first

If you have proxying enabled for account authentication, disable it and try the same account again.

This test shows whether the account or the proxy causes the error.

Only re-enable auth-through-proxy after the plain import path works.

Use the current install requirements

Use a supported SoulFire release and Java version before you test authentication.

Before going deeper:

• make sure that you use the SoulFire release that you intend to run
• use the Java/runtime version required by the current install docs
• retest with one account before importing a large batch

Re-import a minimal sample

If a large account set is failing, do not keep retrying the entire batch.

Instead:

1. pick one known-good account
2. import only that account
3. test without proxies
4. test with the exact target server you care about

If one account works, test a smaller batch before you import all accounts.

If import succeeds but joining still fails

The problem now occurs after account import. Find out whether:

• whether the target server needs additional in-game login or registration
• whether proxies are only failing after the join step
• whether the wrong protocol version is selected

At that point, continue with Cannot Connect Or Times Out or Proxies.

Access tokens for remote SoulFire servers

If the problem is your GUI or CLI login to a remote SoulFire server, generate a fresh API token:

generate-token api

That token is for SoulFire server access. It is not the same thing as a Minecraft account credential.

What to capture before you report it

• account type
• whether proxies were used for account auth
• whether a single account reproduces the problem
• the exact error text
• whether import fails, refresh fails, or join fails after import

Related pages

• Import Accounts
• Account Formats
• Proxies
• Cannot Connect Or Times Out