1 – Using Tweet Sheet

Tweet Sheet allows designers to attach images from their game projects along with the twitter message that will show up in the player’s feed. 

Screen Shot 2015-08-28 at 3.30.23 PM

  1. Tweet Sheet is an iOS5+ feature, and the player will need to be logged into Twitter to utilize it when playing your game.
  2. You must import the image to be used as twitter_yourimage.png
  3. The image reference in your Tweet Sheet rule will not be entered in expression editor and does not require the .png after the image name.
  4. If you are referencing game values you must use the Expression Editor and set up your message following the guidelines below.

How to Use Tweet Sheet

The Tweet Sheet behavior is broken down into 2 fields and a toggle box.

Screen Shot 2015-08-28 at 2.39.11 PM

Message: this is a 140 character string that can be set by the game developer or by the player.

Image: The developer can attach an image from the project image library to the Tweet.  The image must be named following this format “twitter_imagename.png”.  When inputting the image into your Tweet Sheet rule you will cut the .png extension.  If left blank or if the image reference is not recognized the message will not include the image attachment.  This is NOT editable by the player.

Editable by Player (toggle): This toggle will always be greyed out.  All tweets are editable by the player.  When sending a tweet from your game a virtual keyboard will appear for the player to use.

Design: Player Triggered Tweet Sheet

The most general use of a Twitter message is to spread the word about your game on your players’ feeds. Most times, you will want to trigger the Tweet Sheet behavior off of a button in on the Main Menu or somewhere equally accessible. For this kind of message, you may want the player to be able to edit so that they can tell the world how awesome your game is in their own words. It is also recommended to attach an icon or screen shot of your app to the message so other viewers can get a sense of what your game has to offer regardless of the message. A picture is worth a thousand words after all.

Screen Shot 2015-08-28 at 3.08.21 PM

  •  Create a new actor for your Twitter button
  •  Add a rule with the condition “Actor receives event: touch: pressed”
  •  Place the Tweet Sheet behavior inside and set up the values as desired. 
  •  Put this actor in the desired location in your menu scene

When the message is sent by the player they will get access to the iOS keyboard to enter in their own custom text:


Design: Game Event Triggered Tweet Sheet

Another way Tweet Sheet can be used to enhance the game experience for players is to have special messages that are generated when specific events have been triggered. When a specific game event has occurred (like unlocking an achievement) you can let the player tell the world all about it. This must be written in the expression editor, with the displayed text in quotations and two periods separating words from game values.

Screen Shot 2015-08-28 at 3.09.03 PM

This particular use of Tweet Sheet can be automated when the event has triggered or it could be on a button event. It all depends on how aggressively you wish to approach your players’ feeds. Twitter recommends not spamming user feeds otherwise they are likely to stop engaging with your product.

NOTE: by utilizing tables and game attributes your message and image fields can be driven by expressions that update the message with dynamic values.

Considerations for Non-iOS5 Users

Because Tweet Sheet is specifically tailored for Apple iOS5 it will not operate the same way when triggered in iOS4.

When triggered, the game will pause and a prompt will display asking the player if they would like to go to www.twitter.com.  If they click YES, the game will switch over to the browser and go to the Twitter website.  If they click NO, the game will resume.