Config

Phaser.Core.Config

The active game configuration settings, parsed from a Phaser.Types.Core.GameConfig object.

Constructor

new Config([GameConfig])

Parameters

name

type

optional

description

GameConfig

Phaser.Types.Core.GameConfig

Yes

The configuration object for your Phaser Game instance.


Scope: static

Source: src/core/Config.js#L19
Since: 3.0.0

Constants:

Public Members

antialias

antialias: boolean

Description:

When set to true, WebGL uses linear interpolation to draw scaled or rotated textures, giving a smooth appearance. When set to false, WebGL uses nearest-neighbor interpolation, giving a crisper appearance. false also disables antialiasing of the game canvas itself, if the browser supports it, when the game canvas is scaled.

Source: src/core/Config.js#L373


antialiasGL

antialiasGL: boolean

Description:

Sets the antialias property when the WebGL context is created. Setting this value does not impact any subsequent textures that are created, or the canvas style attributes.

Source: src/core/Config.js#L378


audio

audio: Phaser.Types.Core.AudioConfig

Description:

The Audio Configuration object.

Source: src/core/Config.js#L307


autoCenter

autoCenter: Phaser.Scale.CenterType

Description:

Automatically center the canvas within the parent?

Source: src/core/Config.js#L89


autoFocus

autoFocus: boolean

Description:

If true the window will automatically be given focus immediately and on any future mousedown event.

Source: src/core/Config.js#L186


autoMobilePipeline

autoMobilePipeline: boolean

Description:

Automatically enable the Mobile Pipeline if iOS or Android detected?

Source: src/core/Config.js#L363


autoRound

autoRound: boolean

Description:

Automatically round the display and style sizes of the canvas. This can help with performance in lower-powered devices.

Source: src/core/Config.js#L84


backgroundColor

backgroundColor: Phaser.Display.Color

Description:

The background color of the game canvas. The default is black. This value is ignored if transparent is set to true.

Source: src/core/Config.js#L457


bannerBackgroundColor

bannerBackgroundColor: Array.<string>

Description:

The background colors of the banner.

Source: src/core/Config.js#L329


bannerTextColor

bannerTextColor: string

Description:

The color of the banner text.

Source: src/core/Config.js#L324


batchSize

batchSize: number

Description:

The default WebGL Batch size. Represents the number of quads that can be added to a single batch.

Source: src/core/Config.js#L440


canvas

canvas: HTMLCanvasElement

Description:

Force Phaser to use your own Canvas element instead of creating one.

Source: src/core/Config.js#L139


canvasStyle

canvasStyle: string

Description:

Optional CSS attributes to be set on the canvas object created by the renderer.

Source: src/core/Config.js#L149


clearBeforeRender

clearBeforeRender: boolean

Description:

Whether the game canvas will be cleared between each rendering frame. You can disable this if you have a full-screen background image or game object.

Source: src/core/Config.js#L415


context

context: CanvasRenderingContext2D, WebGLRenderingContext

Description:

Force Phaser to use your own Canvas context instead of creating one.

Source: src/core/Config.js#L144


customEnvironment

customEnvironment: boolean

Description:

Is Phaser running under a custom (non-native web) environment? If so, set this to true to skip internal Feature detection. If true the renderType cannot be left as AUTO.

Source: src/core/Config.js#L154


defaultImage

defaultImage: string

Description:

A base64 encoded PNG that will be used as the default blank texture.

Source: src/core/Config.js#L628


defaultPhysicsSystem

defaultPhysicsSystem: boolean, string

Description:

The default physics system. It will be started for each scene. Either 'arcade', 'impact' or 'matter'.

Source: src/core/Config.js#L483


defaultPipeline

defaultPipeline: string

Description:

The WebGL Pipeline that Game Objects will use by default. Set to 'MultiPipeline' as standard. See also 'autoMobilePipeline'.

Source: src/core/Config.js#L368


defaultPlugins

defaultPlugins: any

Description:

The plugins installed into every Scene (in addition to CoreScene and Global).

Source: src/core/Config.js#L620


desynchronized

desynchronized: boolean

Description:

When set to true it will create a desynchronized context for both 2D and WebGL. See https://developers.google.com/web/updates/2019/05/desynchronized for details.

Source: src/core/Config.js#L388


disableContextMenu

disableContextMenu: boolean

Description:

Set to true to disable the right-click context menu.

Source: src/core/Config.js#L302


disablePostFX

disablePostFX: boolean

Description:

Disables the automatic creation of the Post FX Pipelines. If disabled, you cannot use the built-in Post FX on Game Objects.

Source: src/core/Config.js#L349


disablePreFX

disablePreFX: boolean

Description:

Disables the automatic creation of the Pre FX Pipelines. If disabled, you cannot use the built-in Pre FX on Game Objects.

Source: src/core/Config.js#L344


domCreateContainer

domCreateContainer: boolean

Description:

Should the game create a div element to act as a DOM Container? Only enable if you're using DOM Element objects. You must provide a parent object if you use this feature.

Source: src/core/Config.js#L205


domPointerEvents

domPointerEvents: string

Description:

The default pointerEvents attribute set on the DOM Container.

Source: src/core/Config.js#L210


expandParent

expandParent: boolean

Description:

Is the Scale Manager allowed to adjust the CSS height property of the parent to be 100%?

Source: src/core/Config.js#L79


failIfMajorPerformanceCaveat

failIfMajorPerformanceCaveat: boolean

Description:

Let the browser abort creating a WebGL context if it judges performance would be unacceptable.

Source: src/core/Config.js#L430


fps

fps: Phaser.Types.Core.FPSConfig

Description:

The Frame Rate Configuration object, as parsed by the Timestep class.

Source: src/core/Config.js#L339


fullscreenTarget

fullscreenTarget: HTMLElement, string

Description:

The DOM element that will be sent into full screen mode, or its id. If undefined Phaser will create its own div and insert the canvas into it when entering fullscreen mode.

Source: src/core/Config.js#L99


gameTitle

gameTitle: string

Description:

The title of the game.

Source: src/core/Config.js#L171


gameURL

gameURL: string

Description:

The URL of the game.

Source: src/core/Config.js#L176


gameVersion

gameVersion: string

Description:

The version of the game.

Source: src/core/Config.js#L181


glowFXDistance

glowFXDistance: number

Description:

The distance of the Glow FX (defaults to 10)

Source: src/core/Config.js#L561


glowFXQuality

glowFXQuality: number

Description:

The quality of the Glow FX (defaults to 0.1)

Source: src/core/Config.js#L556


height

height: number, string

Description:

The height of the underlying canvas, in pixels.

Source: src/core/Config.js#L59


hideBanner

hideBanner: boolean

Description:

Don't write the banner line to the console.log. See Phaser.Types.Core.BannerConfig for details of this object.

Source: src/core/Config.js#L314


hidePhaser

hidePhaser: boolean

Description:

Omit Phaser's name and version from the banner.

Source: src/core/Config.js#L319


inputActivePointers

inputActivePointers: number

Description:

The number of Pointer objects created by default. In a mouse-only, or non-multi touch game, you can leave this as 1.

Source: src/core/Config.js#L277


inputGamepad

inputGamepad: boolean

Description:

Enable the Gamepad Plugin. This can be disabled in games that don't need gamepad input.

Source: src/core/Config.js#L292


inputGamepadEventTarget

inputGamepadEventTarget: *

Description:

The DOM Target to listen for gamepad events on. Defaults to window if not specified.

Source: src/core/Config.js#L297


inputKeyboard

inputKeyboard: boolean

Description:

Enable the Keyboard Plugin. This can be disabled in games that don't need keyboard input.

Source: src/core/Config.js#L217


inputKeyboardCapture

inputKeyboardCapture: Array.<number>

Description:

preventDefault will be called on every non-modified key which has a key code in this array. By default, it is empty.

Source: src/core/Config.js#L227


inputKeyboardEventTarget

inputKeyboardEventTarget: *

Description:

The DOM Target to listen for keyboard events on. Defaults to window if not specified.

Source: src/core/Config.js#L222


inputMouse

inputMouse: boolean, object

Description:

Enable the Mouse Plugin. This can be disabled in games that don't need mouse input.

Source: src/core/Config.js#L232


inputMouseEventTarget

inputMouseEventTarget: *

Description:

The DOM Target to listen for mouse events on. Defaults to the game canvas if not specified.

Source: src/core/Config.js#L237


inputMousePreventDefaultDown

inputMousePreventDefaultDown: boolean

Description:

Should mousedown DOM events have preventDefault called on them?

Source: src/core/Config.js#L242


inputMousePreventDefaultMove

inputMousePreventDefaultMove: boolean

Description:

Should mousemove DOM events have preventDefault called on them?

Source: src/core/Config.js#L252


inputMousePreventDefaultUp

inputMousePreventDefaultUp: boolean

Description:

Should mouseup DOM events have preventDefault called on them?

Source: src/core/Config.js#L247


inputMousePreventDefaultWheel

inputMousePreventDefaultWheel: boolean

Description:

Should wheel DOM events have preventDefault called on them?

Source: src/core/Config.js#L257


inputSmoothFactor

inputSmoothFactor: number

Description:

The smoothing factor to apply during Pointer movement. See Phaser.Input.Pointer#smoothFactor.

Source: src/core/Config.js#L282


inputTouch

inputTouch: boolean

Description:

Enable the Touch Plugin. This can be disabled in games that don't need touch input.

Source: src/core/Config.js#L262


inputTouchCapture

inputTouchCapture: boolean

Description:

Should touch events be captured? I.e. have prevent default called on them.

Source: src/core/Config.js#L272


inputTouchEventTarget

inputTouchEventTarget: *

Description:

The DOM Target to listen for touch events on. Defaults to the game canvas if not specified.

Source: src/core/Config.js#L267


inputWindowEvents

inputWindowEvents: boolean

Description:

Should Phaser listen for input events on the Window? If you disable this, events like 'POINTER_UP_OUTSIDE' will no longer fire.

Source: src/core/Config.js#L287


installGlobalPlugins

installGlobalPlugins: any

Description:

An array of global plugins to be installed.

Source: src/core/Config.js#L584


installScenePlugins

installScenePlugins: any

Description:

An array of Scene level plugins to be installed.

Source: src/core/Config.js#L589


loaderAsync

loaderAsync: boolean

Description:

Should the XHR request use async or not?

Source: src/core/Config.js#L513


loaderBaseURL

loaderBaseURL: string

Description:

A URL used to resolve paths given to the loader. Example: 'http://labs.phaser.io/assets/'.

Source: src/core/Config.js#L488


loaderCrossOrigin

loaderCrossOrigin: string, undefined

Description:

'anonymous', 'use-credentials', or undefined. If you're not making cross-origin requests, leave this as undefined. See {@link https://developer.mozilla.org/en-US/docs/Web/HTML/CORS_settings_attributes}.

Source: src/core/Config.js#L503


loaderImageLoadType

loaderImageLoadType: string

Description:

Optional load type for image, XHR is default, or HTMLImageElement for a lightweight way.

Source: src/core/Config.js#L543


loaderLocalScheme

loaderLocalScheme: Array.<string>

Description:

An array of schemes that the Loader considers as being 'local' files. Defaults to: [ 'file://', 'capacitor://' ].

Source: src/core/Config.js#L551


loaderMaxParallelDownloads

loaderMaxParallelDownloads: number

Description:

Maximum parallel downloads allowed for resources (Default to 32).

Source: src/core/Config.js#L498


loaderMaxRetries

loaderMaxRetries: number

Description:

The number of times to retry a file load if it fails.

Source: src/core/Config.js#L533


loaderPassword

loaderPassword: string

Description:

Optional password for all XHR requests.

Source: src/core/Config.js#L523


loaderPath

loaderPath: string

Description:

A URL path used to resolve relative paths given to the loader. Example: 'images/sprites/'.

Source: src/core/Config.js#L493


loaderResponseType

loaderResponseType: string

Description:

The response type of the XHR request, e.g. blob, text, etc.

Source: src/core/Config.js#L508


loaderTimeout

loaderTimeout: number

Description:

Optional XHR timeout value, in ms.

Source: src/core/Config.js#L528


loaderUser

loaderUser: string

Description:

Optional username for all XHR requests.

Source: src/core/Config.js#L518


loaderWithCredentials

loaderWithCredentials: boolean

Description:

Optional XHR withCredentials value.

Source: src/core/Config.js#L538


maxHeight

maxHeight: number

Description:

The maximum height, in pixels, the canvas will scale up to. A value of zero means no maximum.

Source: src/core/Config.js#L119


maxLights

maxLights: number

Description:

The maximum number of lights allowed to be visible within range of a single Camera in the LightManager.

Source: src/core/Config.js#L450


maxTextures

maxTextures: number

Description:

When in WebGL mode, this sets the maximum number of GPU Textures to use. The default, -1, will use all available units. The WebGL1 spec says all browsers should provide a minimum of 8.

Source: src/core/Config.js#L445


maxWidth

maxWidth: number

Description:

The maximum width, in pixels, the canvas will scale up to. A value of zero means no maximum.

Source: src/core/Config.js#L109


minHeight

minHeight: number

Description:

The minimum height, in pixels, the canvas will scale down to. A value of zero means no minimum.

Source: src/core/Config.js#L114


minWidth

minWidth: number

Description:

The minimum width, in pixels, the canvas will scale down to. A value of zero means no minimum.

Source: src/core/Config.js#L104


mipmapFilter

mipmapFilter: string

Description:

Sets the mipmap magFilter to be used when creating WebGL textures. Don't set unless you wish to create mipmaps. Set to one of the following: 'NEAREST', 'LINEAR', 'NEAREST_MIPMAP_NEAREST', 'LINEAR_MIPMAP_NEAREST', 'NEAREST_MIPMAP_LINEAR' or 'LINEAR_MIPMAP_LINEAR'.

Source: src/core/Config.js#L383


missingImage

missingImage: string

Description:

A base64 encoded PNG that will be used as the default texture when a texture is assigned that is missing or not loaded.

Source: src/core/Config.js#L633


parent

parent: *

Description:

A parent DOM element into which the canvas created by the renderer will be injected.

Source: src/core/Config.js#L69


physics

physics: Phaser.Types.Core.PhysicsConfig

Description:

The Physics Configuration object.

Source: src/core/Config.js#L478


pipeline

pipeline: Phaser.Types.Core.PipelineConfig

Description:

An object mapping WebGL names to WebGLPipeline classes. These should be class constructors, not instances.

Source: src/core/Config.js#L358


pixelArt

pixelArt: boolean

Description:

Prevent pixel art from becoming blurred when scaled. It will remain crisp (tells the WebGL renderer to automatically create textures using a linear filter mode).

Source: src/core/Config.js#L398


postBoot

postBoot: Phaser.Types.Core.BootCallback

Description:

A function to run at the end of the boot sequence. At this point, all the game systems have started and plugins have been loaded.

Source: src/core/Config.js#L473


powerPreference

powerPreference: string

Description:

"high-performance", "low-power" or "default". A hint to the browser on how much device power the game might use.

Source: src/core/Config.js#L435


preBoot

preBoot: Phaser.Types.Core.BootCallback

Description:

Called before Phaser boots. Useful for initializing anything not related to Phaser that Phaser may require while booting.

Source: src/core/Config.js#L468


premultipliedAlpha

premultipliedAlpha: boolean

Description:

In WebGL mode, sets the drawing buffer to contain colors with pre-multiplied alpha.

Source: src/core/Config.js#L425


preserveDrawingBuffer

preserveDrawingBuffer: boolean

Description:

If the value is true the WebGL buffers will not be cleared and will preserve their values until cleared or overwritten by the author.

Source: src/core/Config.js#L420


renderType

renderType: number

Description:

Force Phaser to use a specific renderer. Can be CONST.CANVAS, CONST.WEBGL, CONST.HEADLESS or CONST.AUTO (default)

Source: src/core/Config.js#L134


resizeInterval

resizeInterval: number

Description:

How many ms should elapse before checking if the browser size has changed?

Source: src/core/Config.js#L94


roundPixels

roundPixels: boolean

Description:

Draw texture-based Game Objects at only whole-integer positions. Game Objects without textures, like Graphics, ignore this property.

Source: src/core/Config.js#L393


scaleMode

scaleMode: Phaser.Scale.ScaleModeType

Description:

The scale mode as used by the Scale Manager. The default is zero, which is no scaling.

Source: src/core/Config.js#L74


sceneConfig

sceneConfig: object

Description:

The default Scene configuration object.

Source: src/core/Config.js#L159


seed

seed: Array.<string>

Description:

A seed which the Random Data Generator will use. If not given, a dynamic seed based on the time is used.

Source: src/core/Config.js#L164


snapHeight

snapHeight: number

Description:

The vertical amount to snap the canvas by when the Scale Manager is resizing. A value of zero means no snapping.

Source: src/core/Config.js#L129


snapWidth

snapWidth: number

Description:

The horizontal amount to snap the canvas by when the Scale Manager is resizing. A value of zero means no snapping.

Source: src/core/Config.js#L124


stableSort

stableSort: number, boolean

Description:

false or 0 = Use the built-in StableSort (needed for older browsers), true or 1 = Rely on ES2019 Array.sort being stable (modern browsers only), or -1 = Try and determine this automatically based on browser inspection (not guaranteed to work, errs on side of caution).

Source: src/core/Config.js#L191


transparent

transparent: boolean

Description:

Whether the game canvas will have a transparent background.

Source: src/core/Config.js#L410


whiteImage

whiteImage: string

Description:

A base64 encoded PNG that will be used as the default texture when a texture is assigned that is white or not loaded.

Source: src/core/Config.js#L638


width

width: number, string

Description:

The width of the underlying canvas, in pixels.

Source: src/core/Config.js#L54


zoom

zoom: Phaser.Scale.ZoomType, number

Description:

The zoom factor, as used by the Scale Manager.

Source: src/core/Config.js#L64


Updated on