Settings

Rotation angle of camera in world space

Position of camera in world space

Scale of camera in world space

Color to clear the canvas to before render, does not clear if alpha is 0

Enable applying color to tiles when using canvas2d

• This is slower but should be the same as WebGL rendering

Fixed size of the canvas, if enabled canvas size never changes

• you may also need to set mainCanvasSize if using screen space coords in startup

Maximum aspect ratio of the canvas (width/height), unused if 0 Can be used with canvasMinAspect to limit aspect ratio

The max size of the canvas, centered if window is larger

Minimum aspect ratio of the canvas (width/height), unused if 0 Can be used with canvasMaxAspect to limit aspect ratio

Scale factor applied to the canvas backing store for native-resolution rendering. Pass 1 for no scaling, a number for an explicit ratio, or undefined to track devicePixelRatio each frame.

Use nearest canvas scaling for more pixelated look

• If enabled sets css image-rendering:pixelated

Enable physics solver for collisions between objects

Disables the automatic requestAnimationFrame loop so the engine only advances when engineStep is called, for tests and frame-stepping tools

Default font used for text rendering

If true, axes that do not rest near center are ignored on gamepads without standard mapping. Steering wheels and flight sticks report pedal and throttle axes that rest at full deflection, which otherwise reads as a stick held down.

If true, the dpad input is also routed to the left analog stick (for better accessibility)

Should gamepads be allowed

How many sided poly to use when drawing circles and ellipses with WebGL

Enable WebGL accelerated rendering

How much gravity to apply to objects, negative Y is down

Disables all rendering, audio, and input for servers

If true the WASD keys are also routed to the direction keys (for better accessibility)

Size of medal display

How quickly to slide on/off medals in seconds

How long to show medals for in seconds

Set to stop medals from being unlockable (like if cheats are enabled)

How much to slow angular velocity each frame (0-1)

How much to slow velocity by each frame (0-1)

How much to slow when touching (0-1)

Default object mass for collision calculations (how heavy objects are)

How much to bounce when a collision occurs (0-1)

Clamp max speed to avoid fast objects missing collisions

Scales emit rate of particles, useful for low graphics mode (0 disables particle emitters)

Enable to show the LittleJS splash screen on startup

Default range where sound no longer plays

Default range percent to start tapering off sound (0-1)

All audio code can be disabled and removed from build

Volume scale to apply to all sound, music and speech Use setSoundVolume to also update the audio master gain immediately

Default padding pixels around each frame packed by loadSprite

Width and height in pixels of texture sheets created by loadSprite

Default amount of pixels smaller to draw tiles to prevent neighbor bleeding

Default padding pixels around tiles

Default size of tiles in pixels

Disables texture filtering for crisper pixel art

• Leave true for pixel art so sprites stay sharp when scaled (uses NEAREST filtering)
• Set false for smooth/high-resolution art to enable bilinear filtering and mipmaps

Scale applied to engine time, can be used for slow motion or fast forward

• 1 is normal speed, 2 is double speed, 0.5 is half speed
• 0 freezes the simulation without setting the paused flag
• Should be >= 0; stacks multiplicatively with the debug +/- shortcut

Transparency of touch gamepad overlay

True if touch gamepad should be analog stick or false to use if 8 way dpad

Number of buttons on the right side of the touch gamepad (0-4), using gamepad buttons 0-3

• A count of 1 is a single large button (the size of a stick)
• Ignored when touchGamepadRightStick is set (the right side is a stick instead)

Size of center button if touch gamepad should have start button in the center

• Prevents activating when pressed near virtual stick or face buttons
• When the game is paused, any touch will press the button
• Measured in viewport CSS pixels

How long to display the touch gamepad on screen in seconds, set to 0 to always display

True if touch gamepad should appear on mobile devices

• Supports left analog stick, 4 face buttons and start button (button 9)
• setTouchGamepadButtonCount(1) to use face buttons as right analog stick
• Analog stick buttons 10 and 11 are also activated when virtual sticks are touched
• Rendered as a full-viewport HTML/SVG overlay, so controls may sit outside the game canvas

True if touch gamepad directional controls should float to where you press

• Only affects analog sticks and dpads, not face buttons
• Directional controls re-anchor to where you press within the bottom ~60% of their screen half; the top ~40% passes through to the game
• The right side floats only when it acts as the right analog stick (touchGamepadRightStick is set)
• A center button (touchGamepadCenterButtonSize) still works since it ignores touches near the sticks

Number of buttons on the left side of the touch gamepad (0-4), using gamepad buttons 4-7

• Only used when touchGamepadLeftStick is false (otherwise the left side is a stick)
• A count of 1 is a single large button (the size of a stick)

True if the touch gamepad should have a left analog stick (or dpad)

• When false, the left side is face buttons (touchGamepadLeftButtonCount) or nothing

True if touches outside the gamepad controls should still drive mouse/touch input

• When false (the default), enabling the touch gamepad suppresses touch-to-mouse input entirely
• Set true to also pass touches outside the controls through to the game as mouse/touch input
• Touches on the gamepad controls never drive the mouse regardless of this setting

True if the touch gamepad right side should be an analog stick (or dpad) instead of face buttons

• When set, touchGamepadButtonCount is ignored and the right side is a stick
• Uses an analog stick when touchGamepadAnalog is true, otherwise an 8 way dpad

Size of virtual gamepad for touch devices in viewport CSS pixels

Duration in ms to vibrate when a touch gamepad face button or start button is pressed

• Set to 0 to disable, also requires vibrateEnable and hardware support (ignored on iOS)

True if touch input is enabled for mobile devices

• Touch events will be routed to mouse events

Allow vibration hardware if it exists

Set angle of camera in world space

Set position of camera in world space

Set scale of camera in world space

Set color to clear the canvas to before render, does not clear if alpha is 0

Set if tiles should be colorized when using canvas2d This can be slower but results should look nearly identical to WebGL rendering It can be enabled/disabled at any time Optimized for performance, and will use faster method if color is white or untextured

Set fixed size of the canvas

Set maximum aspect ratio of the canvas (width/height), unused if 0

Set max size of the canvas

Set minimum aspect ratio of the canvas (width/height), unused if 0

Set the canvas pixel ratio. Pass a number for an explicit ratio, or call with no argument to track devicePixelRatio each frame.

Use nearest scaling algorithm for canvas for more pixelated look

Set if collisions between objects are enabled

Set if the engine only advances when engineStep is called Must be set before engineInit

Set default font used for text rendering

Set how many sided polygons to use when drawing circles and ellipses with WebGL

Set if WebGL rendering is enabled

Set if axes that do not rest near center are ignored on non-standard gamepads

Set if the dpad input is also routed to the left analog stick

Set if gamepads are enabled

Set how much gravity to apply to objects

Set to disable rendering, audio, and input for servers

Set if true the WASD keys are also routed to the direction keys

Set size of medal display

Set how quickly to slide on/off medals in seconds

Set how long to show medals for in seconds

Set to stop medals from being unlockable

Set how much to slow angular velocity each frame

Set how much to slow velocity by each frame

Set how much to slow when touching

Set default object mass for collision calculations

Set how much to bounce when a collision occurs

Set max speed to avoid fast objects missing collisions

Set to scales emit rate of particles

Set if the LittleJS splash screen should be shown on startup

Set default range where sound no longer plays

Set default range percent to start tapering off sound

Set to disable all audio code

Set volume scale to apply to all sound, music and speech

Set default padding pixels around each frame packed by loadSprite

Set width and height in pixels of texture sheets created by loadSprite

Default amount of pixels smaller to draw tiles to prevent neighbor bleeding

Default padding pixels around tiles

Set default size of tiles in pixels

Disables texture filtering for crisper pixel art

• Leave true for pixel art; set false for smooth/high-resolution art

Set scale applied to engine time

Set transparency of touch gamepad overlay

Set if touch gamepad should be analog stick or 8 way dpad

Set number of buttons on the right side of the touch gamepad (0-4, gamepad buttons 0-3)

Set if touch gamepad should have start button in the center

• Set size to enable the center button
• When the game is paused, any touch will press the button

Set how long to display the touch gamepad on screen in seconds, set to 0 to always display

Set if touch gamepad should appear on mobile devices

Set if touch gamepad directional controls should float to where you press

Set number of buttons on the left side of the touch gamepad (0-4, gamepad buttons 4-7)

• Only used when touchGamepadLeftStick is false

Set if the touch gamepad should have a left analog stick (or dpad)

Set if touches outside the gamepad controls should still drive mouse/touch input

Set if the touch gamepad right side is an analog stick (or dpad) instead of face buttons

Set size of virtual gamepad for touch devices in pixels

Set duration in ms to vibrate when a touch gamepad face or start button is pressed (0 disables)

Set if touch input is allowed

Set to allow vibration hardware if it exists