1.9 KiB
1.9 KiB
WHMCS addon products
Bill optional GameCloud features as WHMCS addon products linked to the main Minecraft service.
Supported addon types
| WHMCS addon | GameCloud feature | Module action |
|---|---|---|
| Extra backup retention | Extended backup slots | Usage / plan metadata sync |
| Dedicated IP (future) | Reserved port/IP on node | Manual / Phase 10 |
| Priority support | No technical change | Billing only |
Technical addons call GameCloud APIs during CreateAccount / TerminateAccount on the addon service or via usage records — see usage billing.
Setup
Setup → Products/Services → Product Addons → Create New Addon
- Assign to Minecraft parent products
- Module: HexaHost GameCloud (if addon provisioning implemented) or None for pure billing markers
- Map addon ID in GameCloud addon module Mappings (addon tab) when available
Linking to parent service
GameCloud correlates via:
externalServiceId— parent WHMCS service IDexternalAddonId— addon service ID (usage export)
Ensure parent service is provisioned before addon activation.
Lifecycle
| WHMCS event | Expected behavior |
|---|---|
| Addon ordered | Enable feature flag on server |
| Addon suspended | Disable feature; do not delete data |
| Addon terminated | Revert limits; purge addon-specific data |
Metered addons
For usage-based billing (playtime, storage overage):
- GameCloud worker aggregates usage
- WHMCS polls via addon module or server module metric export
- WHMCS generates invoices — usage billing
Reconciliation
Orphaned addons (parent terminated, addon active) appear in Reconciliation dashboard. Run dry-run before live fix.