Requirements

To develop a downloadable game for Facebook Gameroom, you need the minimum SDK version of Unity 5.0. You should always download and use the latest Unity with Facebook Games for updated bug-fixes and improved performance. If you have an older version of Unity, you may publish in WebGL to run in Facebook Gameroom.

To start, you need a Facebook App ID associated to your game. This App ID will be used to configure your Facebook SDK within the Unity Editor. You can use an existing Facebook App ID if you already have one.

If you want to create a new Facebook App ID or if you've never developed a game with Facebook before, you may follow the Developer Onboarding Guide.

  1. Create an ID for your app on Facebook
  2. Add Gameroom Native to your app
  3. Install Unity with Facebook Games
  1. Only games built in Unity (version 5 or newer) and Unreal are supported.
  2. Games with custom launchers are not supported due to window handling issues.
  3. Maximum bundle size supported is 5 GB. Any assets above this limit would have to be manually hosted and downloaded by the game.

Create an ID for your app on Facebook

If you do not already have a Facebook App ID for your app, you should create one.

Create a New App

Add Gameroom Native to your app

You should now have access to the App Dashboard. Find your App ID at the top of your dashboard. You need to add this App ID within your Unity game's configuration to integrate with Facebook.


Click Add Product in the left side navigation menu to add the Gameroom Native product to your app.


Find Gameroom Native in the list of products, and click Get Started.


In the Gameroom Native card, you should set Enable Gameroom Native to Yes.


You should also check whether your game is restricted to 18+ and fill in the System Requirements.


Gameroom shares some settings with Facebook Web Games. You can find these under Settings > Basic > Facebook Web Games. To have both a Gameroom and a Facebook Web Game, you should leave your Facebook Web Games URL (https) unchanged.

For example, https://friendsmashsample.herokuapp.com/ as shown here:

Otherwise, if you only have a Gameroom title, you should enter https://localhost/ as shown here:


Change the Facebook Login OAuth settings. Click Add Product in the left side navigation menu to add the Facebook Login product to your app.


Find Facebook Login in the list of products, and click Get Started.


Skip the Get Started guide and go directly to Settings in the Facebook Login card. You should set Client OAuth Login and Web OAuth Login to Yes and append https://apps.facebook.com/{YOUR_APP_ID} to Valid OAuth redirect URIs.

Install Unity with Facebook Games

Download Unity with Facebook Games. Launch the installer, and follow the installation process.


For Windows, select Facebook Games Build Support when prompted to choose Unity components to install:


For Mac, select both Windows Build Support and Facebook Games Build Support when prompted to choose Unity components to install:

Ready to Build

Now that you have your Facebook App ID and you've installed the latest Unity with Facebook Games, it's time to build.