Build your Downloadable Game

Now that you have all the tools you need, it's time to build, configure and test your game in Facebook Gameroom.

  1. Create a Test App
  2. Build your game in Unity
  3. Test your game in Gameroom
    • Via Build and Run
    • Via Debug Menu
    • Via Command Line Option
    • Via Gameroom search bar
  4. Hosting your game on Facebook

Create a Test App

You should create a Test App for development, and switch back to your Production App when you are ready to release your game.

In your App Dashboard, click the drop-down arrow next to your app name. Select the Create Test App button to create a Test App. The Test App is created with a snapshot of your Production App's settings. Changes made in either app will not affect the other app.

You should note the following differences between Test Apps and normal (Production) apps:

Test App

  • Visible to admins, developers and testers of your app
  • Uses a different App ID from the Production App
  • Allows you to test your app while in development for Gameroom
  • Does not have an App Review section

Normal (Production) App

  • Visible to public once live
  • Uses a different App ID from the Test App
  • The production version of your app played by the public

Build your game in Unity

Go to File > Build Settings, then select Facebook as your Platform and click Switch Platform.

Click Player Settings and enter your AppID.


Configure the resolution and window settings to the following:

  • Capture single screen - ON
  • Display Resolution Dialog - Hidden By Default
  • Resizable window - OFF
  • Allow fullscreen switch - OFF

Windows

  • Click Build And Run to launch your game in Gameroom.

Mac

  • Click Build and save your game as an .EXE executable.

Note: If you don't see Facebook listed as a Platform, it means that the required Facebook libraries are not installed in the editor. Rerun the installer to install the missing modules, and make sure you select Facebook Games Build Support to add the component.

See Install Unity with Facebook Games for more information.

Test your game in Gameroom

A Windows machine is required to fully test the game.

To test whether the game integrates correctly with the SDK, you need to install the Facebook Gameroom client from www.gameroom.com.


Via Build and Run

Select the Facebook platform and click Build And Run. This will launch your game locally in Facebook Gameroom.


Via Debug Menu

Click on your profile icon at the top right corner of the screen.

Select [DEV] Debug Unity, and open the local .exe file that you have built.


Via Command Line Option

You may also launch your game locally via the following command:

%LOCALAPPDATA%\Facebook\Games\FacebookGameroom.exe fbgames://launch_local/"<PATH_TO_EXE>"

Via Gameroom search bar

(Only for approved, uploaded .zip files)

Once you have uploaded a .zip for the first time, you will need to submit it for App Review. Make sure that you do not see the following message in your hosting card:

After approval, your game should be visible to all admins and developers of your app. Configure this in the Roles section of the App Dashboard.

Type the App Name in the search bar of Gameroom to find your app:

Hosting your game on Facebook

Hosting requirements

Facebook offers free hosting for games up to 500 MB per .zip binary. We may extend this free hosting up to 25 GB on a case-by-case basis.

For more information on Facebook Hosting, you may take a look at the documentation.


Uploading your game to Facebook Hosting

Once you are satisfied with your testing, prepare your game for upload to Facebook Hosting. In Build Settings, select Package build for uploading.

This step will package your game by zipping up the data directory and game executable (shown below), creating a .zip file. If you are manually creating a .zip file, make sure that the .exe and data folder are in the root of the zip.


If you have installed Unity with Facebook Games, you can upload the build directly from the Unity Editor. Follow Option A if you have the Unity. Otherwise, you should follow Option B to manually upload your build via the App Dashboard.

Open the App Dashboard in your browser:

https://developers.facebook.com/apps/YOUR_APP_ID/hosting/

Option A: Upload build from Unity

Under Canvas Hosting, click the Get Asset Upload Access Token button.

Copy your Upload Access Token:

In the Unity Editor, under Player Settings > Publishing Settings, paste your Upload Access Token:

Under Build Settings, enter an upload comment and click Upload last build to Facebook. If this button is disabled, you need to select Package build for uploading and click Build again.

Your build should now appear in the App Dashboard with your upload comment.


Option B: Upload build via Graph API

Follow the above steps to get your Upload Access Token.

With the token, perform a CURL post to upload your .zip file to your App Dashboard as follows:

curl -X POST https://graph-video.facebook.com/{App ID}/assets 
  -F 'access_token={ASSET UPLOAD ACCESS TOKEN}' 
  -F 'type=GAMES_DESKTOP' 
  -F 'asset=@./{YOUR GAME}.zip' 
  -F 'comment=Graph API upload'

For more information on this endpoint, you may refer to the Graph API documentation.


Option C: Upload build from the App Dashboard

In Web Hosting > Facebook Gameroom, click the Upload Version button.

Directory upload

Zip upload

In the latest Chrome or Firefox, you will see the following upload dialog:

Choose the directory containing your game executable and data folder, and we will handle the zip and processing on your behalf.

On unsupported browsers, you will see the following upload dialog:

Choose your .zip file to upload instead.


Push to Production

Once the upload finishes, click the star button to push your game to production.

Launch

Now that your game is built and tested, it's time to launch it to Facebook Gameroom.