Activate AMS and create AMS account

Overview​

This article walks you through activating the AccelByte Multiplayer Servers (AMS) add-on in your namespace, creating an AMS account, and linking an AMS account across game namespaces.

AGS Starter

In Starter, the AMS add-on is available for a free trial with the following limitations:

  • The free trial will expire 120 days after activation.
  • You can create only one AMS account, which you can link to the game namespaces in your studio.
  • You will have access to:
    • 1 ttx1.s AMS instance (2 vCPUs, 2 GB RAM) for 2,160 hours (90 days)
    • 224 GB of network egress available for up to four players at ~60kbps per player for 2,160 hours (90 days)
  • You can create up to three fleets, which you can assign to the North America East region only.
  • You can upload and maintain up to 50 GB of dedicated server images.

You can keep track of your AMS usage in your studio namespace. Go to your studio namespace and click on Usage on the sidebar. On the Usage page, you will see your AMS usage information and for every other add-on you've enabled in your AGS account.

Prerequisites​

  • Access to the AccelByte Gaming Services (AGS) Admin Portal.
  • In AGS Starter, an existing studio and a game namespace.
  • In AGS Premium, an existing publisher and a game namespace.

Activate AMS in your namespace​

  1. Go to your studio namespace on the AGS Admin Portal.

  2. On the homepage, go to the Add-ons section. You will see the option to activate AMS.

    Image shows the Activate AMS button

  3. Click on the the Activate AMS button. A pop-up showing the AMS limitations on Starter appears.

  4. Click on Start Free Trial. AMS is now activated in your studio and across your game namespaces. You can proceed to creating an AMS account.

Create an AMS account​

When an AMS account is created from a game namespace, the account is automatically linked to that namespace. AMS supports account linking across game namespaces to share resources such as server images, observability account and metrics, and a billing account. See Link your AMS account to your games.

In Starter, you can only create one AMS account, which you can later on link to your other game namespaces.

To create an AMS account, follow these steps:

  1. Go to your game namespace on the AGS Admin Portal.

  2. On the sidebar, under the ADD-ONS menu, select AccelByte Multiplayer Servers. The AMS welcome page appears.

  3. In the Set up AMS account section, type in a name for your AMS account.

  4. Click Create, then click Yes on the pop-up. The details page of your AMS account appears.

After you create your AMS account, the full functionality and user interface for AMS will be enabled under the AccelByte Multiplayer Servers menu on the Admin Portal sidebar.

If you have multiple AGS environments and/or multiple game namespaces, see Link your AMS account to your games for how to link your AMS account to them.

When an AMS account is created from a game namespace, the account is automatically linked to that namespace. AMS supports account linking across game namespaces to share resources such as server images, observability account and metrics, and a billing account.

To link an AMS account to a game namespace, follow these steps, in this order:

  1. Generate linking token from a linked game namespace.
  2. Link AMS account to an unlinked game namespace.

Generate linking token from linked game namespace​

  1. In the AGS Admin Portal, go into the game namespace where you created your AMS account.

  2. On the sidebar, go to any of the components under the AccelByte Multiplayer Servers menu (e.g., Fleet Manager).

  3. In the upper-right corner on the page of your selected component, you will see AMS Account: <account name and info>. Click or your account name. The AMS Account page appears.

  4. Click the + Generate New Linking button.

  5. On the New Linking Token pop-up that appears, copy the linking token.

    注記

    This token will expire after the date and time shown on this pop-up.

You will apply this linking token to an unlinked game namespace to link the AMS account to that namespace. Proceed to the next section.

  1. In the AGS Admin Portal, go to the unlinked game namespace.
  2. On the sidebar, go to AccelByte Multiplayer Servers > Set up AMS Account.
  3. On the Setup AMS Account page, click Already have an AMS Account? to expand it.
  4. Enter (paste) your linking token into the Linking Token field and click the Link button.
  5. On the Link AMS Account confirmation pop-up, type in the name of your game namespace in the field and click the Link button.

Your game namespace is now linked with your AMS account.

Verify linked game namespaces​

To check if a game namespace has an AMS account linked to it, follow these steps:

  1. In the AGS Admin Portal, go into the game namespace that you want to check.
  2. On the sidebar, open the AccelByte Multiplayer Servers.
  3. Verify that the namespace is linked to an AMS account.
    • If an account is linked to the namespace, the full functionality and user interface for AMS will be enabled under the AccelByte Multiplayer Servers menu on the Admin Portal sidebar.
    • If an account is NOT linked to this namespace, AccelByte Multiplayer Servers will only have the Setup AMS Account option.

What's next​

Now that you have set up your AMS account, see Download CLI tools from the Admin Portal to get the AMS tools for your local development environment.

に最終更新

On this page