If you make a game where voluntary informal participation is the main mode of play, like a museum exhibit or at an event, getting new players set up through the usual process of creating an account, logging in, and finding the game can be tedious and get in the way. Luckily, there is an alternative. You can create a QR code that can be scanned immediately after launching ARIS for the first time to take care of these chores all in one fell swoop. This QR code
- Creates a new player account (and either defines or adds to a group of players)
- Logs that player in, and
- Takes them into the game you specify
You may have even already noticed this QR code on the ARIS launch screen. It is in fact the button the new player uses to scan the QR code you prepare.
How to Create an Auto-Login QR Code for Your ARIS Game
Overall, this is pretty simple. You will need the
gameId of your game and a way to generate QR codes from strings.
Finding your gameId
gameId is not prominently displayed in the ARIS editor, but it is not too difficult to find either. As I explained in my post about creating urls for your ARIS games, you can
- Open your game in the ARIS editor.
- Add object > Web Page. You don’t really need a webpage, but a little bit of help text in the web page’s options will show you you game’s id.
- Double click the webpage in the sidebar and look for the gray help text with your game’s id. Screenshot below.
Creating the Magic String
Now that you have the
gameId you need to encode it, along with a few optional parameters into a string that will be used to create a QR code that ARIS knows how to use. For example, this summer a student wanted to make a game at the ABQ Museum and we used the following string:
Here are the essential rules for the parameters in this string. There are 4 comma separated sections:
- The first section is either a
0(login to an existing player account) or a
1(create a new player account), which informs the content of the second section.
- A. If first section is
0, the second section is
username,password(<- note that there is a comma in the middle of this section) . B. If the first section is
1, the second section is just a group name (this can be any word, mine was “unm”).
- The third section is optional: a
gameIdto automatically enter a specific game.
- The fourth section is also optional, and can only be included if the third is also included: a
0(default) is just business as usual. A
1makes it so the player cannot leave your game (museum mode).
Here are a few examples of encodings- all valid:
phildois an existing player with a password. This simply logs him in.
0,phildo,totallynotmypassword,1234– This code additionally takes him into game
0,phildo,totallynotmypassword,1234,1– The extra
1makes him unable to leave the game
1,uw_test_class– This creates a new player account, with random username and password, who is a member of the uw_test_class group.
1,uw_test_class,1234– This creates a new player and logs them into game
1,uw_test_class,1234,1– This creates a new player, logs them into game
1234, and puts them in museum mode.
A couple tips about making this string:
- Your strings cannot have spaces.
0as your first parameter is a pretty different use case than using
1is what you want to use to make it easy for drop-in participants to get started because it creates a new player account.
0is for logging in existing players and so is useful in other situations.
- Specifying groups is not currently very useful to you as the author. You can’t yet do anything with them once they exist.
Creating a QR Code
There are many options for creating a QR code from a string. Just google “qr code generator”. You just want to make sure you use one that does not
- Specify only urls, beginning with say “http://”. You want to be able to encode arbitrary strings.
- Add any extra crap into the string you use. Some generators do this I think as a way to monetize their services. If you are encoding a typical url and using it in a browser, the user won’t notice, but it doesn’t work for this.
I used this site, but like I said, there are plenty others. Here is the QR code that we used, encoding
If you scan this from the title screen QR code scanner in your ARIS client app, ARIS will create an account for you and log you into the game Quest for the Cities of Gold. We dressed it up a bit when testing the game in the museum.