Store Settings
Everything you can configure per store — branding, domain, SEO, server connection, and visibility.
General & Branding
Store Name & Description
The store name appears in the browser tab, on the store page header, and in order confirmation emails. Keep it short and recognizable — ideally matching your server's name.
The description is shown below your store name on the public store page. Use it to explain what your server is, what game it runs, and why players should donate.
Logo & Banner
Upload a square logo (PNG or WebP recommended, min 200×200px). It appears in the store header and in purchase confirmation emails.
The banner is a wide image shown at the top of your store page (recommended size: 1200×300px). Use a screenshot from your server or a custom graphic.
Currency
Set your store's display currency (EUR, USD, GBP, CAD...). This affects how prices are shown to players. Payouts are always sent in USDT regardless of display currency — the conversion happens automatically at checkout.
Custom Domain
By default your store is accessible at yourstore.forgestore.net. Pro plan users can connect their own domain.
Setup a custom domain
- Go to Store Settings → Details → Custom Domain
- Enter your domain (e.g.
store.yourserver.com) - In your domain registrar's DNS settings, add a CNAME record:
DNS Record
Type: CNAME Name: store (or @ for root domain) Value: forgestore.net TTL: 3600
- Wait 5–30 minutes for DNS propagation
- ForgeStore will automatically provision an SSL certificate for your domain
store.yourserver.com rather than your root domain. Root domains require additional DNS configuration.Cloudflare users
If your domain is behind Cloudflare, set the CNAME record to DNS only (grey cloud, not orange) during initial setup. Once ForgeStore has issued the SSL certificate, you can re-enable the Cloudflare proxy.
SEO Settings
These settings control how your store appears in Google search results.
| Field | Description | Max length |
|---|---|---|
| SEO Title | The title shown in search results. Default: store name + "— ForgeStore" | 60 characters |
| SEO Description | The snippet shown below the title in search results | 160 characters |
| OG Image | Image shown when the store URL is shared on Discord/Twitter | 1200×630px |
Payment Configuration
ForgeStore Pay (Crypto)
Connect your ForgeStore Pay account to accept 50+ cryptocurrencies.
- Add your crypto wallet address in Ledger & Payments
- Go to Store → API Keys and generate an API key
- In Store Settings → Payments → ForgeStore Pay, enter your API key and IPN Secret
- ForgeStore Pay handles payments automatically — no extra configuration needed
- Toggle Enable ForgeStore Pay → Save
Stripe (Card Payments)
Stripe Connect lets your players pay with credit/debit cards. Requires Stripe identity verification.
- In Store Settings → Payments → Stripe, click Connect with Stripe
- Complete Stripe's onboarding (identity verification, bank account)
- Once approved, card payments are automatically enabled on your store
Server Connection (RCON)
RCON lets ForgeStore execute commands directly on your game server when a player purchases. This is the recommended delivery method for Minecraft, Rust, and ARK.
- Enable RCON on your server (see your server's documentation)
- Go to Store Settings → Server → RCON
- Enter your server's IP, RCON port (default: 25575), and RCON password
- Click Test Connection — you should see a success message
Webhooks
Webhooks let you receive real-time notifications in your own systems when events occur on your store.
| Event | When it fires |
|---|---|
purchase.completed | A payment is confirmed and commands have been queued |
purchase.failed | A payment attempt failed |
goal.reached | A community goal hits 100% |
subscription.renewed | A subscription package renews |
subscription.cancelled | A subscription is cancelled |
chargeback.received | A card chargeback is filed |
All webhooks are signed with HMAC-SHA256. Verify the X-ForgeStore-Signature header in your endpoint.
$secret = 'your_webhook_secret';
$payload = file_get_contents('php://input');
$sig = $_SERVER['HTTP_X_FORGESTORE_SIGNATURE'] ?? '';
$expected = hash_hmac('sha256', $payload, $secret);
if (!hash_equals($expected, $sig)) {
http_response_code(403);
exit('Invalid signature');
}
Maintenance Mode
When maintenance mode is active, your store page shows a "Back soon" message and players cannot check out. Use this when you're making major changes to your packages or pricing.
Toggle it in Store Settings → General → Maintenance Mode or directly from the Discord Bot with /maintenance enabled:true.