Account Linking

Anonymous vs Authenticated

How to Link

1. Start the Linking Process

Run the following command on your server:

/bench link

2. Receive a Linking Code

The plugin contacts the VoxelBench backend and receives a temporary code and URL. You'll see something like:

   VB-A1B2C3

Visit: https://voxelbench.com/link?code=VB-A1B2C3

Click the URL or copy it to your browser.

3. Confirm on the Website

Log in to your VoxelBench account (or create one) and confirm the link. The plugin automatically detects when you've confirmed.

4. Done

Once confirmed, the plugin saves an authentication token and switches to authenticated mode:

mode: authenticated
authentication:
  token: "your-jwt-token"

Important: Never share your authentication token. It grants access to submit reports on behalf of your server.

Re-Linking

If you need to link to a different account:

/bench link force

This replaces the existing token with a new one.

Timeouts

• The linking code expires after 10 minutes
• If you don't confirm in time, run /bench link again to get a new code
• The plugin polls for up to 5 minutes before timing out

Troubleshooting

"Connection error" when linking

• Ensure your server can make outgoing HTTPS connections
• Check that voxelbench.com is not blocked by a firewall
• Try again in a few minutes if the backend is temporarily down

"Already linked" message

Your server already has an authentication token. Use /bench link force to replace it.

Token issues

If you experience authentication errors after linking:

1. Check that the token in config.yml is not corrupted
2. Try re-linking with /bench link force
3. Check that the VoxelBench backend is reachable