Build games as easily as you play them — join the Phaser Beam waitlist for Early Access.
class Example extends Phaser.Scene { lockText; sprite; preload () { this.load.setBaseURL('https://cdn.phaserfiles.com/v385'); this.load.image('ship', 'assets/sprites/ship.png'); } create () { this.sprite = this.add.sprite(400, 300, 'ship'); // Pointer lock will only work after an 'engagement gesture', e.g. mousedown, keypress, etc. this.input.on('pointerdown', function (pointer) { this.input.mouse.requestPointerLock(); }, this); // When locked, you will have to use the movementX and movementY properties of the pointer // (since a locked cursor's xy position does not update) this.input.on('pointermove', function (pointer) { if (this.input.mouse.locked) { this.sprite.x += pointer.movementX; this.sprite.y += pointer.movementY; // Force the sprite to stay on screen this.sprite.x = Phaser.Math.Wrap(this.sprite.x, 0, game.renderer.width); this.sprite.y = Phaser.Math.Wrap(this.sprite.y, 0, game.renderer.height); if (pointer.movementX > 0) { this.sprite.setRotation(0.1); } else if (pointer.movementX < 0) { this.sprite.setRotation(-0.1); } else { this.sprite.setRotation(0); } this.updateLockText(true); } }, this); // Exit pointer lock when Q is pressed. Browsers will also exit pointer lock when escape is // pressed. this.input.keyboard.on('keydown-Q', function (event) { if (this.input.mouse.locked) { this.input.mouse.releasePointerLock(); } }, this); // Optionally, you can subscribe to the game's pointer lock change event to know when the player // enters/exits pointer lock. This is useful if you need to update the UI, change to a custom // mouse cursor, etc. this.input.manager.events.on('pointerlockchange', event => { this.updateLockText(event.isPointerLocked, this.sprite.x, this.sprite.y); }); this.lockText = this.add.text(16, 16, '', { fontSize: '20px', fill: '#ffffff' }); this.updateLockText(false); } updateLockText (isLocked) { this.lockText.setText([ isLocked ? 'The pointer is now locked!' : 'The pointer is now unlocked.', `Sprite is at: (${this.sprite.x},${this.sprite.y})`, 'Press Q to release pointer lock.' ]); } } const config = { type: Phaser.AUTO, parent: 'phaser-example', width: 800, height: 600, scene: Example }; const game = new Phaser.Game(config);
class Example extends Phaser.Scene
{
lockText;
sprite;
preload ()
{
this.load.setBaseURL('https://cdn.phaserfiles.com/v385');
this.load.image('ship', 'assets/sprites/ship.png');
}
create ()
{
this.sprite = this.add.sprite(400, 300, 'ship');
// Pointer lock will only work after an 'engagement gesture', e.g. mousedown, keypress, etc.
this.input.on('pointerdown', function (pointer)
{
this.input.mouse.requestPointerLock();
}, this);
// When locked, you will have to use the movementX and movementY properties of the pointer
// (since a locked cursor's xy position does not update)
this.input.on('pointermove', function (pointer)
{
if (this.input.mouse.locked)
{
this.sprite.x += pointer.movementX;
this.sprite.y += pointer.movementY;
// Force the sprite to stay on screen
this.sprite.x = Phaser.Math.Wrap(this.sprite.x, 0, game.renderer.width);
this.sprite.y = Phaser.Math.Wrap(this.sprite.y, 0, game.renderer.height);
if (pointer.movementX > 0) { this.sprite.setRotation(0.1); }
else if (pointer.movementX < 0) { this.sprite.setRotation(-0.1); }
else { this.sprite.setRotation(0); }
this.updateLockText(true);
}
}, this);
// Exit pointer lock when Q is pressed. Browsers will also exit pointer lock when escape is
// pressed.
this.input.keyboard.on('keydown-Q', function (event)
{
if (this.input.mouse.locked)
{
this.input.mouse.releasePointerLock();
}
}, this);
// Optionally, you can subscribe to the game's pointer lock change event to know when the player
// enters/exits pointer lock. This is useful if you need to update the UI, change to a custom
// mouse cursor, etc.
this.input.manager.events.on('pointerlockchange', event =>
{
this.updateLockText(event.isPointerLocked, this.sprite.x, this.sprite.y);
});
this.lockText = this.add.text(16, 16, '', {
fontSize: '20px',
fill: '#ffffff'
});
this.updateLockText(false);
}
updateLockText (isLocked)
{
this.lockText.setText([
isLocked ? 'The pointer is now locked!' : 'The pointer is now unlocked.',
`Sprite is at: (${this.sprite.x},${this.sprite.y})`,
'Press Q to release pointer lock.'
]);
}
}
const config = {
type: Phaser.AUTO,
parent: 'phaser-example',
width: 800,
height: 600,
scene: Example
};
const game = new Phaser.Game(config);