Overview
Solstice is Atzl Project's flagship Tebex template, fully integrated with the hosted platform. Template source stays on Atzl servers — you configure everything from the dashboard.
Your public storefront URL:
https://yourdomain.com/store/{customer-id}
Requirements
- Active Atzl Project license with Solstice access
- A Tebex store with Headless API enabled
- Categories and packages configured in Tebex Creator Panel
Step 1 — Tebex Headless API
- Open Tebex Creator Panel → Developer → Headless API.
- Copy your Public Token and Private Key.
- In the Atzl dashboard, open your Solstice product → Tebex.
- Paste both values and save.
Private key security
The private key is encrypted before storage and is only used in server-side API calls. It never appears in browser network requests or page source.
Step 2 — Plugin Secret (optional)
For Recent Payments and Top Customer sidebar modules with package names and prices, connect the Tebex Plugin API:
- Tebex Creator Panel → Developer → Plugin API → create or copy the secret.
- Dashboard → Tebex → Plugin Secret → paste and save.
Without a plugin secret, payment sidebar modules still show usernames but may not include enriched product/price data.
Step 3 — Appearance
Dashboard → Appearance:
- Store name and tagline
- Primary accent colors
- Background image or particle settings
- Custom CSS overrides (advanced)
Changes apply to your hosted storefront after save. Use View Storefront to preview.
Step 4 — Sidebar widgets
Dashboard → Widgets (or Sidebar modules):
| Module | Description |
|---|---|
| Recent Payments | Live feed of recent purchases |
| Top Customer / Top Donator | Highlights highest spender |
| Text Box | Custom HTML text block (sanitized on render) |
| Community Goal | Progress bar toward a funding goal |
| Gift Card Balance | Lookup form for gift card balance |
Drag to reorder modules. Set optional start/end dates for seasonal widgets.
Step 5 — Product tabs & rank upgrades
Solstice supports advanced package presentation:
- Product tabs — commands, perks, and media on package pages (Markdown-style content in dashboard)
- Rank upgrades — promote/ladder UI linking Tebex packages for rank progression
Configure these from the product-specific dashboard sections after your Tebex packages are synced.
Storefront features
Categories & packages
Products load from Tebex via the Headless API. Category URLs follow:
/store/{customer-id}/category/{slug}
/store/{customer-id}/package/{id}
Cart & checkout
- Player adds packages to cart.
- Player authenticates with their Minecraft/game account via Tebex auth.
- Tebex.js opens the embedded checkout popup.
- After payment, the player returns to your storefront home.
Gift cards
Gift card balance lookup is available when enabled. Rate limits apply to prevent abuse.
Server info
Dashboard → Server Info:
- Server IP and port
- Discord invite link
- Optional MOTD or status text
Displayed on the storefront index and relevant sidebar areas.
Troubleshooting
Store shows no products
- Verify Tebex credentials in dashboard → Tebex
- Confirm packages are published in Tebex
- Check license status is active
Sidebar payments missing prices
- Add Plugin Secret in Tebex settings (see Step 2)
- Ensure the plugin secret matches the same Tebex store
Checkout redirect issues
- Set
NEXT_PUBLIC_APP_URLto your production domain (platform admin/hosting) - Confirm Cloudflare SSL is Full (strict)
Cart or add-to-cart errors
- Clear browser cookies for the storefront domain
- Re-authenticate via the store login flow
Still stuck?
Contact support on Discord with your customer ID (not your Tebex private key).
FAQ
Can I edit Solstice template files directly?
No. Solstice on the hosted platform is configured through the dashboard only. Template code is proprietary and server-hosted.
Can I use a custom domain for my store?
Custom domains for /store/{id} depend on your Atzl hosting plan and DNS setup — contact support for current options.
Does Solstice work for Rust / FiveM / other games?
Yes, as long as your Tebex store supports the game and Headless checkout flow.