Skip to main content

Link AMS account to games

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.

Introduction

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.

Prerequisites

  • Access to the AGS Admin Portal.
  • An existing AMS account linked to a game namespace. If you don't have one yet, follow the steps in Create AMS account to create one.

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.

    note

    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 > Setup 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

When an AMS account is created from a game namespace, the account is automatically linked to that namespace.

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 if the namespace is linked to an AMS account.
    • If an account is linked to this namespace, AccelByte Multiplayer Servers will have the following options:
      • Server Images
      • Fleets
      • Local Server
      • Logs and Artifacts
      • Download Resource
    • If an account is NOT linked to this namespace, AccelByte Multiplayer Servers will only have the Setup AMS Account option.

What's next

Check out what resources are available to your AMS-linked game namespaces. See Cross-game AMS resource sharing.