Help

Troubleshooting

Solutions to the most common issues on ForgeStore.

💸 Payment Issues

Player paid but didn't receive their rank

⚠️
This is almost always caused by the plugin not being connected, or the server being offline at the time of purchase.

Check these in order:

  1. Go to Dashboard → Orders and find the order. Check its status.
  2. If status is paid but command is pending — your server was offline. The command will retry automatically when it reconnects.
  3. If status is failed — check your plugin is running: /fs status in-game.
  4. Verify the command syntax in Packages → Edit Package → Commands. Use {player} not %player%.
  5. Manually re-run the command from Orders → View Order → Retry Command.

Payment stuck on "pending"

Crypto payments confirm on-chain — this usually takes 1–3 minutes for USDT TRC-20, up to 30 minutes for Bitcoin.

💡
If it's been over 30 minutes, ask the player to check their transaction on a block explorer (TronScan, Etherscan, etc.) to confirm it was actually sent.

Player sent the wrong amount

Each payment generates a unique address with an exact amount. If the player sends a different amount, the payment will not be automatically detected. Contact support with the transaction hash.

🔌 Plugin Issues

Plugin not connecting to ForgeStore

1
Check your API key
In plugins/ForgeStore/config.yml, verify api_key matches the key in Store Settings → Developers → Plugin API Key.
2
Check your store ID
The store_id in config.yml must match your store's numeric ID (visible in the URL when you edit your store).
3
Check outbound connections
Your server must be able to make HTTPS requests to forgestore.net. Some hosts block outbound connections — contact your host if needed.
4
Reload the plugin
Run /fs reload or restart your server after changing config.

Commands not executing

ProblemSolution
Player name not substitutedUse {player} (curly braces), not %player%
Command requires consoleEnable "Run as console" in package settings
Permission plugin not installedInstall LuckPerms (Minecraft) or equivalent for your game
Command has extra spacesCheck for leading/trailing spaces in the command field

👤 Account Issues

Can't log in

  1. Double-check your email and password (case-sensitive).
  2. Try Reset Password.
  3. If you signed up with Discord or Google, use that button instead of the email form.
  4. Check if your account was disabled — contact support with your email.

Forgot password

Go to /forgot-password and enter your email. You'll receive a reset link within 2 minutes. Check your spam folder if you don't see it.

💡
If you registered with Discord or Google, you don't have a password. Use the social login button.

💳 Billing Issues

Pro plan not activating

After payment, your plan should activate within a few seconds. If it doesn't:

  1. Refresh the page.
  2. Go to Billing → History and verify the payment shows as completed.
  3. Log out and log back in.
  4. Contact support with your payment confirmation.

Refund policy

Platform fees (5% or 2%) are non-refundable once a sale is processed. Pro plan subscriptions can be cancelled at any time — no refund for the current period. Contact [email protected] for exceptional cases.

🆘
Still stuck? Email us at [email protected] with your store ID, order ID (if applicable), and a description of the issue. We respond within 24 hours.
Troubleshooting — ForgeStore Docs