CubeCoders AMP WHMCS Module

This WHMCS module provides provisioning integration with CubeCoders AMP with WHMCS.

Installing the AMP WHMCS module

1. Download the .Zip file from this GitHub
2. Upload the package content into your MAIN WHMCS DIRECTORY. 
(We recommend using an FTP Client)
3. Login to WHMCS Admin Area
4. Navigate to System Settings -> Product & Services -> Servers
5. Click on Add New Server

• For the Module type, select AMP

• Enter the hostname for your AMP server followed by a Username and Password

• Note: You should create a seperate AMP user for WHMCS with the Super Admin Role and ensure MFA is disabled for this user.

6. Click Test Connection

• If the connection was successful you will see a green banner confirming the connection at the top

• Enter a Name for this AMP server that will be displayed in WHMCS

7. Click Save Changes
8. From the Servers overview page click on Create New Group

• Enter a Name for your AMP Server Group
• Select your AMP Server(s) from the list and Add to Selected Servers

9. Click Save Changes

Creating the AMP Welcome & Password Reset Email Template

10. Navigate to System Settings -> System -> Email Templates
11. Click on Create New Email Template

• For Email Type, click the dropdown and select Product/Service
• Enter the name “AMP Welcome Email” for this template.

⚠️ Its important you use this exact template title name otherwise the email will not be sent once AMP has provisioned the Instance. This name will not be visible to your customers

• Enter an Email Subject that your customers will see such as “Important Account Information”

• Copy and paste the below template into the text area of the email template

    Congratulations {$client_name},
    
    Your order has now been activated and you are minuets away from starting an epic journey with your friends in {$service_product_name}
    
    
    
    Username: {$service_username}
    
    Generated Password: {$service_password}
    
    Console Login: https://{$service_server_hostname}/?instance={$service_instance_id}
    
    
    
    Lets get started!
    
    Now that you are a {$service_product_name} Server owner, you'll need to login to the above link and accept the {$service_product_name} EULA and then Start your server.
    
    Please raise a ticket on our website if you require assistance. 
    
    
    {$signature}
  

12. Click Save Changes
13. Next, we'll setup the AMP Password Reset email.
14. Navigate to System Settings -> System -> Email Templates
15. Click on Create New Email Template

• For Email Type, click the dropdown and select Product/Service
• Enter the name “AMP Password Reset” for this template.

⚠️ Its important you use this exact template title name otherwise the email will not be sent once AMP has provisioned the Instance. This name will not be visible to your customers

• Enter an Email Subject that your customers will see such as “Password Reset Information”

• Copy and paste the below template into the text area of the email template

  Hello {$client_name},
  
    We've reset your password to your Control Panel. Please find your new login details below:
    
    
    Username: {$service_username}
    
    Generated Password: {$service_password}
    
    Console Login: https://{$service_server_hostname}/?instance={$service_instance_id}
    
    
    
    If you did not request this password change, please reply to this email.
    
    {$signature}
  

16: Click Save Changes

Set the callback function between AMP & WHMCS

17. Login to your AMP Control Panel

18. Navigate to Configuration -> Instance Deployment

19. Set the Template deployment callback URL as follows :

    https://WHMCS_URL/index.php?ampCallback=1
    eg. https://example.com/index.php?ampCallback=1
    

⚠️ Ensure to change WHMCS_URL to your own domain where WHMCS is installed as this will allow AMP to tell WHMCS once the product is created and the status of the instance.

Setting up a Server Group & Product within WHMCS

20. Navigate to System Settings -> Products & Services -> Products/Services
21. Create New Product Group ( or use existing one )

• Select Create New Product
• For the Product Type, select [Other]
• From the Product Group dropdown, select the Product Group you created earlier
• Enter a product name (For Example, Minecraft Java)
• Click on the drop down menu for Module and select AMP

22. Click on Continue

• Click on the Module Settings tab

• Ensure that Module Name is set to AMP

• Click on the Server Group drop down menu and select the Server Group you created earlier

• You will now see new fields appear that are specific to this product

• The Provisioning Template allows you to select your deployment template within AMP for specific server you want to deploy

• Then select the Post Create Action from the below list depending on your desired outcome

    Do Nothing = Creates instance and doesnt start the instance or application
    Start Instance = Creates and starts the instance but doesnt start the application automatcially
    Start instance & update application = Creates & Starts the instance and performs an application update.
    Full Instance & application startup = Creates & Starts the instance and starts & updates the application and starts the application everytime the instance starts. (Providing no additional setup is required on the customers behalf such as EULA acknowledgement or Steam sign in)
  

• Set the Required Tags field as per below

• If you are running AMP in Standalone or Hybrid mode, enter the value ‘Local’

• If you are running AMP in Controller/Target mode, enter the Tag value that you have set on a Target within the AMP panel

• Extra Provision Setting field allows you to set a static setting that will apply to all Instances created for this product. If you wish to sell customisable parameters such as RAM & CPU allocations, please see the Configurable Options section further down.

• The Update Every Time option tells AMP if the application should be updated everytime the instance is started in teh future

• The Mode selection allows you to specify how teh Endpoints are displayed in the Client section of WHMCS. For example:

    Standalone URL will be displayed as https://yourdomain.com:25565
    Target/Node IP Address will be displayed as 0.0.0.0:25565
  

• Now select your preference for the Automatic Setup

23. Click Save Changes

⚠️ Don’t forget to set the other configurations in the other tabs for this product such as pricing.

You’re ready to go! Module is ready to use. After activation of ordered product, module will wait for callback - then Application URL will be show in client area.

Configurable Options

You can set custom configuration options within WHMCS for settings such as RAM Allocation & CPU Allocation.

1. Navigate to System Settings -> Products & Services -> Configurable Options

2. Click on Create a New Group and give it a name such as ‘AMP Product Options’

3. From the Assigned Products select the products that these configurable options applies to

4. Click on Add New Configurable Option

5. Enter the configrable option that you would like to set from the list below and click Save Changes

   Example Configurable Options

    +$$ContainerCPUs|Server CPU Allocation
    	2|2 CPU Cores
    	4|4 CPU Cores
    +$$ContainerMemoryMB|RAM Allowance
    	1024|1 GB
    	2048|2 GB
    	4096|4 GB
   

6. Further values can be set using a template as described in the following article or can be set in WHMCS directly by adding a + to the beginning of the key. Configuring AMP for Enterprise or Network Usage

FAQ’s

Q: Do I need to set a Product Welcome Email in each product?

A: No, the AMP WHMCS Module will always send out the email Template called “AMP Welcome Email”. You can however send an additional welcome email by selecting another email template in the Welcome Email drop down box within each product.