This short mission of TwilioQuest was designed for Twilio's Devangels to run at booths. A mission takes about 5-7 minutes to complete.
You can install this extension by following the steps in Enabling Extensions on their machines and then placing your extension in the folder they specified for extensions.
The first step is to enable extensions in the TQ game client.
In the Settings UI (press the 3 key in-game), navigate to the Extensions submenu. Click the button there labeled Enable Extensions.
IMPORTANT NOTE: As the UI indicates, only use extensions from trusted sources. Like "mods" from other games you may have played before (Minecraft, Skyrim, etc.), a TwilioQuest extension will be able to execute code on your computer. Exercise caution when installing an extension, just as you would using any third-party code on your computer. Once you have enabled extensions, specify a folder on your computer where you will download and manage extensions. This folder contains the parent folder of images, levels, objects, and so on, i.e., two levels above these folders. Specify the full path to this folder on your computer.
Once you have enabled extensions, you should see a listing of automatically-installed "base extensions" and a list of any extensions you have installed yourself.
Hint: If you don't see the extension loaded, hit the "Disable Extensions" button and enable them again.
There are a few bits of code that you need to modify so that the instructions are consistent with your account.
- Ensure that the TwilioQuest game has your demo account sid and auth token. You can do this by playing the "Twilio API Setup" training mission from the Fog Owl.
- Change the WhatsApp Join Code in
./levels/vr_mission_template/join_sandbox/description.mdto the code from your console.
Here are instructions that should help guide you through the prep to run TQ at the booth.
To run this custom extension at the booth you will need to have 2 or 3 windows open:
- Window running TwilioQuest, with the Booth Mission, already loaded
- Use the demo user to log into the Twilio Console and open the Active Numbers (and buy a number) or the Buy Numbers page.
It's helpful to prepare address/identity requirements ahead of time or have a number already owned in countries with a difficult process for acquiring numbers.
- Open the Twiml Bins page with a prepared TwiML bin ready.
- Optional Install a browser extension like SessionBuddy to save the open tabs in case you need to restore them between players.
- Optional if you pre-purchased a number Add TwiML responses for incoming calls and messages in case the players want to interact with the demo number. Here are two examples:
and
<Response> <Say language="de-DE">Twilio sagt "Hallo von der {eventName}"!</Say> </Response>
<Response> <Message> This is the Twilio bot @ {eventName}. Feel free to stop by our booth if you want to learn more. </Message>
### Playthrough
1. When someone starts the game, they can play through the first barrier with little guidance.
2. At the second barrier, they will need to buy a phone number or find the number you already own. Please direct them to switch to the other window where they can do this. When they input the number, it will be saved as an environment variable.
3. After this, they will have three choices;
* SMS Message: Turn Right; They will have to add a `to` and `body` parameter and send a message to themselves.
* Phone Call: Turn Left; They will have to add a `to` and `url`. For the URL direct them to the TwiML bin page, where they can edit the TwiML Bin to Say what they would like.
* WhatsApp: Head straight up; They will have to join the sandbox associated with whatever account you are using. They can then send a WhatsApp message to themselves on the second mission.
4. Once they have completed the mission, they can open the chest. In the future, this will increment a counter to keep a count of the missions completed. To reset the game, simply walk through the exit at the top of the screen. This will reload the mission with all the code, and the barriers reset.
## Future To-Do List
- [ ] Create an automated counter for how many times each mission has been completed
- [ ] Create an embedded form for people to submit job title, company, and email to win prizes
## License
[This template](https://github.com/TwilioQuest/twilioquest-extension-template) is open source under the MIT license.