Player Settings

Player Settings is where you define various parameters (platform specific) for the final game that you will build in Unity. Some of these values for example are used in the Resolution Dialog that launches when you open a standalone game, others are used by XCode when building your game for the iOS devices, so it's important to fill them out correctly.

To see the Player Settings choose Edit->Project Settings->Player from the menu bar.


Global Settings that apply to any project you create.
Cross-Platform Properties
Company NameThe name of your company. This is used to locate the preferences file.
Product NameThe name that will appear on the menu bar when your game is running and is used to locate the preferences file also.
Default IconDefault icon the application will have on every platform (You can override this later for platform specific needs).
Default CursorDefault cursor the application will have on every supported platform.
Cursor HotspotCursor hotspot in pixels from the top left of the default cursor

Per-Platform Settings

Desktop

Web-Player

Resolution And Presentation

Resolution
Default Screen WidthScreen Width the player will be generated with.
Default Screen HeightScreen Height the plater will be generated with.
Run in backgroundCheck this if you dont want to stop executing your game if the player looses focus.
WebPlayer TemplateFor more information you should check the "Using WebPlayer templates page", note that for each built-in and custom template there will be an icon in this section.

Icon

Icons don't have any meaning for webplayer builds (you can set icons for Native Client builds in the Native Client section of the Player Settings).

Other Settings

Rendering
Rendering PathThis property is shared between Standalone and WebPlayer content.
Vertex LitLowest lighting fidelity, no shadows support. Best used on old machines or limited mobile platforms.
Forward with ShadersGood support for lighting features; limited support for shadows.
Deferred LightingBest support for lighting and shadowing features, but requires certain level of hardware support. Best used if you have many realtime lights. Unity Pro only.
Color SpaceThe color space to be used for rendering
GammaSpace RenderingRendering is gamma-corrected
Linear Rendering Hardware SamplingRendering is done in linear space
Use Direct3D 11Use Direct3D 11 for rendering.
Static BatchingSet this to use Static batching on your build (Inactive by default in webplayers). Unity Pro only.
Dynamic BatchingSet this to use Dynamic Batching on your build (Activated by default).
Streaming
First Streamed LevelIf you are publishing a Streamed Web Player, this is the index of the first level that will have access to all Resources.Load assets.
Configuration
Scripting Define SymbolsCustom compilation flags (see the platform dependent compilation page for details).
Optimization
Optimize Mesh DataRemove any data from meshes that is not required by the material applied to them (tangents, normals, colors, UV).

Standalone

Resolution And Presentation

Resolution
Default Screen WidthScreen Width the stand alone game will be using by default.
Default Screen HeightScreen Height the plater will be using by default.
Run in backgroundCheck this if you dont want to stop executing your game if it looses focus.
Standalone Player Options
Default is Full ScreenCheck this if you want to start your game by default in full screen mode.
Capture Single ScreenIf enabled, standalone games in fullscreen mode will not darken the secondary monitor in multi-monitor setups.
DisplayResolution Dialog
DisabledNo resolution dialog will appear when starting the game.
EnabledResolution dialog will always appear when the game is launched.
Hidden by defaultThe resolution player is possible to be opened only if you have pressed the "alt" key when starting the game.
Use Player LogWrite a log file with debugging information. If you plan to submit your application to the Mac App Store you will want to leave this option un-ticked. Ticked is the default.
Resizable WindowAllow user to resize the standalone player window.
Mac App Store ValidationEnable receipt validation for the Mac App Store.
Mac Fullscreen ModeOptions for fullscreen mode on Mac builds
Capture DisplayUnity will take over the whole display (ie, GUI from other apps will not appear and the user cannot switch apps until fullscreen mode is exited).
Fullscreen WindowUnity runs in a window that covers the whole screen at desktop resolution. Other apps' GUI will display correctly and it is possible to switch apps with cmd + tab or trackpad gestures on OSX 10.7 and above.
Fullscreen Window with Menu Bar and DockAs fullscreen window mode but the standard menu bar and dock will also be shown.
Supported Aspect RatiosAspect Ratios selectable in the Resolution Dialog will be monitor-supported resolutions of enabled items from this list.

Icon

Override for StandaloneCheck if you want to assign a custom icon you would like to be used for your standalone game. Different sizes of the icon should fill in the squares below.

Splash Image

Config Dialog BannerAdd your custom splash image that will be displayed when the game is starting.

Other Settings

Rendering
Rendering PathThis property is shared between Standalone and WebPlayer content.
Vertex LitLowest lighting fidelity, no shadows support. Best used on old machines or limited mobile platforms.
Forward with ShadersGood support for lighting features; limited support for shadows.
Deferred LightingBest support for lighting and shadowing features, but requires certain level of hardware support. Best used if you have many realtime lights. Unity Pro only.
Color SpaceThe color space to be used for rendering
GammaSpace RenderingRendering is gamma-corrected
Linear Rendering Hardware SamplingRendering is done in linear space
Static BatchingSet this to use Static batching on your build (Inactive by default in webplayers). Unity Pro only.
Dynamic BatchingSet this to use Dynamic Batching on your build (Activated by default).
Configuration
Scripting Define SymbolsCustom compilation flags (see the platform dependent compilation page for details).
Optimization
API Compatibility LevelSee below
.Net 2.0.Net 2.0 libraries. Maximum .net compatibility, biggest file sizes
.Net 2.0 SubsetSubset of full .net compatibility, smaller file sizes
Optimize Mesh DataRemove any data from meshes that is not required by the material applied to them (tangents, normals, colors, UV).

API Compatibility Level

You can choose your mono api compatibility level for all targets except the webplayer. Sometimes a 3rd party .net dll will use things that are outside of the .net compatibility level that you would like to use. In order to understand what is going on in such cases, and how to best fix it, get "Reflector" on windows.

  1. Drag the .net assemblies for the api compatilibity level in question into reflector. You can find these in Frameworks/Mono/lib/mono/YOURSUBSET/
  2. Also drag in your 3rd party assembly.
  3. Right click your 3rd party assembly, and select "Analyze".
  4. In the analysis report, inspect the "Depends on" section. Anything that the 3rd party assembly depends on, but is not available in the .net compatibility level of your choice will be highlighted in red there.

iOS

Android

Flash

Resolution And Presentation

Resolution
Default Screen WidthScreen Width the player will be generated with.
Default Screen HeightScreen Height the plater will be generated with.

Other Settings

Optimization
StrippingBytecode can optionally be stripped during the build.
Strip Physics CodeRemove physics engine code from the build when not required.
Optimize Mesh DataRemove any data from meshes that is not required by the material applied to them (tangents, normals, colors, UV).

Google Native Client

Resolution and Presentation

Resolution
Default Screen WidthScreen Width the player will be generated with.
Default Screen HeightScreen Height the plater will be generated with.

Icon


Different icons that your project will have when built.
Override for WebCheck if you want to assign a custom icon you would like to be used for your Native Client game. Different sizes of the icon should fill in the squares.

Other Settings

Rendering
Static BatchingSet this to use Static batching on your build (Inactive by default in webplayers). Unity Pro only.
Dynamic BatchingSet this to use Dynamic Batching on your build (Activated by default).
Configuration
Scripting Define SymbolsCustom compilation flags (see the platform dependent compilation page for details).
Optimization
API Compatibility LevelSee below
.Net 2.0.Net 2.0 libraries. Maximum .net compatibility, biggest file sizes
.Net 2.0 SubsetSubset of full .net compatibility, smaller file sizes
Strip Physics CodeRemove physics engine code from the build when not required.
Optimize Mesh DataRemove any data from meshes that is not required by the material applied to them (tangents, normals, colors, UV).

API Compatibility Level

You can choose your mono api compatibility level for all targets except the webplayer. Sometimes a 3rd party .net dll will use things that are outside of the .net compatibility level that you would like to use. In order to understand what is going on in such cases, and how to best fix it, get "Reflector" on windows.

  1. Drag the .net assemblies for the api compatilibity level in question into reflector. You can find these in Frameworks/Mono/lib/mono/YOURSUBSET/
  2. Also drag in your 3rd party assembly.
  3. Right click your 3rd party assembly, and select "Analyze".
  4. In the analysis report, inspect the "Depends on" section. Anything that the 3rd party assembly depends on, but is not available in the .net compatibility level of your choice will be highlighted in red there.

Details

Desktop

The Player Settings window is where many technical preference defaults are set. See also Quality Settings where the different graphics quality levels can be set up.

Publishing a web player

Default Web Screen Width and Default Web Screen Height determine the size used in the html file. You can modify the size in the html file later.

Default Screen Width and Default Screen Height are used by the Web Player when entering fullscreen mode through the context menu in the Web Player at runtime.

Customizing your Resolution Dialog


The Resolution Dialog, presented to end-users

You have the option of adding a custom banner image to the Screen Resolution Dialog in the Standalone Player. The maximum image size is 432 x 163 pixels. The image will not be scaled up to fit the screen selector. Instead it will be centered and cropped.

Publishing to Mac App Store

Use Player Log enables writing a log file with debugging information. This is useful to find out what happened if there are problems with your game. When publishing games for Apple's Mac App Store, it is recommended to turn this off, because Apple may reject your submission otherwise. See this manual page for further information about log files.

Use Mac App Store Validation enables receipt validation for the Mac App Store. If this is enabled, your game will only run when it contains a valid receipt from the Mac App Store. Use this when submitting games to Apple for publishing on the App Store. This prevents people from running the game on any computer then the one it was purchased on. Note that this feature does not implement any strong copy protection. In particular, any potential crack against one Unity game would work against any other Unity content. For this reason, it is recommended that you implement your own receipt validation code on top of this using Unity's plugin feature. However, since Apple requires plugin validation to initially happen before showing the screen setup dialog, you should still enable this check, or Apple might reject your submission.

iOS

Android

Page last updated: 2013-07-16