Instant Play

From YoYoGames Wiki

What is Instant Play

Instant Play is the mechanism used on the YoYo Games website to make it possible that visitors can play a game by simply pressing the Play button on the web page. This gives a much better user experience that having to download the game, unzipping it, and then running it.

How does it work

Instant Play works through a plugin (either in Internet Explorer, Firefox, Chrome, Opera or Safari). The user has to install this plugin once. When the user clicks on the Play button, the plugin checks whether the game has been played on the computer before. If not it downloads the game data. (So the game data is downloaded only once.) After this it starts the game, using the correct version of the Game Maker runner.

Game Maker 8 Compatibility

Instant Play now works with Game Maker 8, and the upload problems have been resolved.

Everybody uses Instant Play

It is clear from the site statistics that almost everybody plays the games using Instant Play and that it considerably increases the popularity of your game if it can be played using Instant Play. Hence, we strongly recommend you to create and upload your games in such a way that they are compatible with Instant Play.

Make your game work with Instant Play

To this end you should do the following:

• Either upload the executable of your game directly or use a zip file containing the executable and other files your game needs. The other files can be in a sub directory if you want but make sure the game executable is in the main directory. Don’t use a compressor other than zip.

• Don’t use an installer for your game.

• If you want to upload an editable version of your game, also include the executable in the zip file. (In the future we plan to create a different place on the website for editable games.)

• Make sure there is only one executable in the main directory of the zip file. If you need additional executables (such as a level editor), make sure they are in a subfolder.

• Use Game Maker 8, 7 or 6 for your game.

About screen resolution

Instant Play does not allow screen resolution changes in the game as that gives a very bad user experience. You are strongly recommended to take care of the following in your games:

• Don’t use the possibility to change the screen resolution. (It simply won’t do it.) Simply use the option (in the Global Game Settings) to scale when in full screen mode (this is the default setting anyhow).

• Don’t start the game in full screen mode. It is fine if the user can switch to full screen mode in the game but if you start in that mode, this can be somewhat of a shock to the player. (This is caused because players don’t expect that from games that you play directly from a website.) So make sure the game works perfectly fine in a window.

• If your game window is too small because you use very small sprites and rooms (or views), in the Global Game Settings, set the Scaling to a Fixed scale of e.g. 200%. This will solve the problem without the need to change the screen resolution.

• Make sure it is always easy and clear how to end the game. Nothing is more frustrating than games that cannot be interrupted. Also try to include such possibility during e.g. an intro sequence.

Installing Instant Play

Internet Explorer, Firefox or Chrome

If the plugin is not found when you press Play on an Instant Play game, you will be prompted to click a link to install the plugin, just click through the dialogs to install the plugin. Once these are complete the browser may have to restart, once it does you should be able to just start playing the games.

Safari

1. Download the plugin from http://www.yoyogames.com/plugins/opera/NPYYGInstantPlay.dll,
2. Close Safari
3. Copy the plugin into the Safari/plugins directory, you should find Safari in either the c:\Program Files or c:\Program Files (x86) directory, depending on which flavour of Windows you have installed.
4. Restart Safari
5. Check the Plugin is installed using Help->Installed-Plugins (Press ALT key to make the menu items visible if they are hidden), It should be listed under YoYo Games InstantPlay XPCOM Plugin
6. Navigate to a game with Instant Play enabled

Opera

1. Download the plugin from http://www.yoyogames.com/plugins/opera/NPYYGInstantPlay.dll,
2. Close Opera
3. Copy the plugin into the Opera/program/plugins directory, you should find Opera in either the c:\Program Files or c:\Program Files (x86) directory, depending on which flavour of Windows you have installed.
4. Restart Opera
5. Check the Plugin is installed using Tools->Advanced->Plugins, It should be listed under YoYo Games InstantPlay XPCOM Plugin
6. Navigate to a game with Instant Play enabled

Troubleshooting Instant Play plugin installation problems

Internet Explorer

Remove any previous add-on

1. Select Tools->Manage Add-Ons
2. Select Show: All add-ons.
3. Select YYGInstantPlay Control in the main list.
4. Right click and select More Information from the menu (or select More Information from the info bar at the bottom)
5. Click the Remove button at the bottom left of the dialog.

Install the add-on as above.

Firefox

First of all uninstall the current plugin, this is done by

1. Selecting Tools->Add-ons
2. Select Extensions
3. Select the YoYo Games InstantPlay plugin
4. Select Uninstall

Second Follow the guidelines here[1] for reinitializing the plugin database Third reinstall the plugin.

If this fails completely then install the plugin by hand

1. Download the XPI file at http://www.yoyogames.com/plugins/firefox/YoYo.xpi
2. Drag the YoYo.xpi file onto Firefox
3. Follow the on screen prompts and it should install fine.

Under Firefox 3.6.3 (and later?) there seems to be another issue, that makes even this fail. Worst case, you can rename the .XPI file to .ZIP, open it up and then find the file NPYYGInstantPlay.dll. You can then copy this into C:\Program Files (x86)\Mozilla Firefox\plugins (or where ever Firefox has been installed). You will then have to restart firefox, but it should then be available for use.

NOTE: Doing this final method will probably mean you will also have to manually UNINSTALL it as well by deleting the DLL directly.

Chrome

No known problems.. yet!

Safari

No known problems.. yet!

Opera

No known problems.. yet!

Compatibility issues

• There are some incompatibilities with gmthreads. If you want to use gmthreads in your game you have to make a blank game with a single room with a room creation code that runs the actual game from a subfolder. This bypasses instant play's restrictions and lets you use gmthreads. However, it will lead to warnings on Vista systems with high security settings.