Learn GS2 by building an adventure game on Game Server Services | Docs

Prepare your development environment

Mon, 01 Jan 0001 00:00:00 +0000

Prepare a GS2 tutorial project and an empty Unity scene. The GS2 account created here is a developer account for managing game settings.

Screenshots show the Japanese interface. The steps below use English interface labels.

1. Register with GS2

Register a developer account on the GS2 website (new tab). Verify your email address using the link you receive, then log in to the management console (new tab).

2. Create a tutorial project

Open Project → Project list → Create project.
Enter adventure as the name and “Adventure game practice” as the description.
Select Tokyo as the first region to enable. The tutorial code also connects to Tokyo (ap-northeast-1).
Review the plan and other details, then click Create.

1. Create an account and log in

Mon, 01 Jan 0001 00:00:00 +0000

Start by making it possible to log in to the game. Display the logged-in player’s ID, and make sure you can return to the same account after stopping Play Mode in Unity.

On the first run, create an account and save its player ID and password. On later runs, log in with those saved credentials. The access token returned after login expires, so log in again each time the app starts.

2. Add a quest and display the quest list

Mon, 01 Jan 0001 00:00:00 +0000

Now that login works, let’s add a list of adventures. Your first adventure will be Forest exploration. GS2 calls these adventures quests and organizes them into quest groups. Register this one as forest in the main quest group, then display its name in the game.

Prepare the game settings

Settings that you define, such as quest names and rewards, are called master data. A player’s coin balance and current quest progress are user data. Start by creating the master data for the quest list.

3. Start a quest and receive rewards

Mon, 01 Jan 0001 00:00:00 +0000

Let’s make Forest exploration playable. Click Start to begin and Complete to return with 10 coins. Every clear gives the same reward; this chapter does not add a first-clear bonus.

Configure clear rewards in GS2

Set the reward amount in the GS2 quest settings. With a normal clear reward of 10 free coins, GS2 adds the coins when Unity reports a clear. Unity updates the display when the balance changes.

4. Restart and continue playing

Mon, 01 Jan 0001 00:00:00 +0000

Restart the game you built through chapter 3 to check that your coins and active quest are still there. This chapter needs no code or server-setting changes.

Check that your coins are saved

Clear a quest and collect at least 10 coins. Once the reward appears, note the player ID and coin balance.
Stop and restart Play Mode. Studio logs in automatically; with the SDK, click Log in. Use this login method each time you restart during this chapter.
Compare the player ID and balance with the values you noted. They should match, with no quest in progress.

Coins and quest progress are stored in GS2. In chapter 1, you saved the credentials for the same account on the device. On restart, the game logs in with that account, and chapter 3’s display code fetches its data from GS2.

5. Spend stamina when starting a quest

Mon, 01 Jan 0001 00:00:00 +0000

Let’s make quests cost stamina. Starting Forest exploration costs 5; if you have less, you must wait for it to recover.

Before you start

Complete any active quest before adding the stamina settings.

Settings to add

Name the stamina setting stamina. Both its initial value and normal recovery limit are 20. Spent stamina recovers naturally by 1 every 300 seconds.

Steps

Create the stamina table

Add Stamina under Add features, then create the following row in Tables → Stamina (Energy).

6. Restore stamina with coins

Mon, 01 Jan 0001 00:00:00 +0000

Let’s spend the coins earned from quests. Create a product named refill that restores 10 stamina for 20 coins. Players can buy it with the free coins received as quest rewards.

Process payment and recovery together

Combine the coin payment and stamina recovery into one transaction. If the player has too few coins, the purchase must fail without restoring stamina.

Steps

Create the product table

Add Stamina Shop under Add features, then create the following row in Tables → Stamina product (EnergyProduct).

7. Change settings and apply them to the game

Mon, 01 Jan 0001 00:00:00 +0000

With the basic game working, let’s change its content. Increase Forest exploration’s reward from 10 to 15 coins and add Cave exploration. Check how the settings affect the display and the rewards you receive.

Before you start

Clear any active quest and wait for purchases or other operations to finish before changing settings.

Changes to make

Quest	Stamina cost	Normal reward	First-clear reward
`forest` Forest exploration	5	15 coins	None
`cave` Cave exploration	8	20 coins	None

Steps

Edit the existing row and add a new one

Open Tables → Quest (Quest) and make these edits.

8. Handle network errors and repeated clicks

Mon, 01 Jan 0001 00:00:00 +0000

Try clicking the purchase button repeatedly and disconnecting the network. Continue with the same player you have been using.

Click again while a purchase is processing

Prepare at least 20 coins. Clear quests to earn more if needed.
Click Restore 10 stamina for 20 coins, then immediately click again.
Check that the button is disabled during processing and cannot start another purchase.

The code sets busy to true when an operation starts and resets it to false in finally. In addition to disabling buttons, Studio’s Run() and the SDK’s RunWrite() reject calls while busy.