Skip to main content

Quick Start

Goal of this page is simple: prepare your account and enter WebShopX successfully in 3 minutes.

In This Page
  • Part 1: 3 steps before first login
  • Part 2: Account and password rules (validated in source code)
  • Part 3: Session and common errors

1. First Login

  1. Run this in game:
/ws password <yourNewPassword>
  1. Log in to the web page with the same account (default is your Minecraft username) and that password.

2. Commands

/ws market
/ws claim
/ws mailbox claim

3. Common Errors and Fixes

Error CodeMeaningSuggested Fix
invalid_usernameInvalid username formatCheck length and characters (letters/numbers/underscore)
invalid_passwordInvalid password lengthChange to 8-64 characters
username_existsUsername conflictUse another username and retry
invalid_credentialsWrong login credentialsVerify account, password, and case
auth_invalidSession expired/invalidLog in again for a new token
Recommended Troubleshooting Order
  1. Confirm you already ran /ws password in game.
  2. Confirm password length is between 8 and 64.
  3. If web session is invalid, fully log out and log in again.