WHMCS products

Creating WHMCS products that provision HexaHost GameCloud Minecraft servers.

Product setup

Setup → Products/Services → Create New Product

Field	Value
Product type	Other
Module	HexaHost GameCloud (`hexagamecloud`)
Server group	Server entry with GameCloud API hostname

Plan mapping

Each product must resolve to a GameCloud plan slug (defines RAM, CPU, backup slots, etc.).

Recommended: Configure via addon Mappings tab — product mappings

Fallback: Set config option GameCloud Plan Slug on the product module settings.

Validate slugs against live catalog:

GET /api/v1/catalog/plans

Only active plans appear in the addon mapping dropdown.

Example products

WHMCS product name	Plan slug	Target audience
Minecraft Starter	`starter`	2 GB RAM, 10 slots
Minecraft Pro	`pro`	4 GB RAM, backup included
Minecraft Enterprise	`enterprise`	Custom limits

Plan slugs are defined in GameCloud admin/catalog — not in WHMCS.

Software defaults

Set per mapping or config options:

Minecraft Version — e.g. 1.21.1
Software Family — VANILLA, PAPER, PURPUR, FABRIC, FORGE, etc.

Customers may change software via panel after provision if plan allows.

Billing cycle

WHMCS owns billing cycles. GameCloud receives externalServiceId and syncs lifecycle (suspend on overdue invoice via WHMCS module actions or events).

Usage-based overages: see usage billing.

Client area

The server module renders status and Login to Panel (SSO). Domain field is used as display name default (server-{serviceId} if empty).

Testing

Create admin-only product group
Place test order with 100% discount
Confirm CreateAccount success in module log
SSO into panel and verify server RUNNING or STARTING

2.0 KiB Raw Blame History