Excalibur

The theme of this release is developer experience and performance. We've removed a lot of paper cuts in the api with quick and easy ways to do what you want.

• Actors can now have a default graphic and/or material set in their constructor!
• Debug Draw has had a huge improvement, both in performance, and visual fidelity through the browser extension!
• Offscreen, Tilemaps, Realistic Collisions, and more all got big performance increases
• Realistic Physics Bodies now sleep consistently giving a huge perf boost to physics games
• Easing functions are now the good ol' 0 -> 1 style you see all over the internet, BYOF easily!

Did you know we have a playground now?

https://github.com/user-attachments/assets/4833c259-f1e7-42e4-bb9f-c9fbf63f1f6c

https://excaliburjs.com/playground

[Puyo Puyo Clone in Playground](https://excaliburjs.com/playground/?autoplay=true&code=FASwtgDg9gTgLgAgFQIIYGcEFMAeCBmMUYCA5LgMaoA2IARgK4ykDcwwFUAduogOIAlAJIARAPoB1UQBUAEggC8CAGxtOPfsPGyAokL6zpihAEYATGu68EAYR0AZe2IDKQgFo7jAFgAMljbYA8vaBAs7GANq4AHQ2UNSw0QJYACYANNg4sfGJAELUDFgZMXEJMNF8MFhYXMVZpYkAmljUCQDuALr+1gCyAILSNrJiNoEAqgByRkpebMAA9PMIAAoMAJ5QCBTUGOgcO+iYqxuZcDUpmDF9FHCwCADewAgIAOYwICkAGgBcCFwMYDoWBgbGebw+jV+-0BwNBCAg6ygDRgvxKORB7Ge6l4MAYN1gAAocFCAUCYBk1iSYeStujUfV0QBKB5PZ4IdAMCDAgmPNls6DoKFYNqZaIANSw+JgROQtgcTlcHgQAGo5Y4XO5PEszBTZXZ1YrPKr9QrNQhtYy0qy+W0PnAABa-E0apUAWgQXitfOe9qwIBe9rgTvlLs87s91rZnDKv2jsC9bIAvoy4c8HSB0NFwV9jDhUwh05ns41jGt84XogiNsjjHGMXyK29UBB7SAKJmGOgsASuMLRTYQDBtt3ed6YKgUiBO8GDWbtQh3TrI1i6bSygnnsmU6zE5iEJyUqgzssoOgQHAQNwCczR2nW5mBcZeyKYhKpQTlwX71n3jmUM7DRVNVTSVbUNzZRtfxLf8Q0A41YLnBAzEjbdN2AXcFiWAAxGhaC4F54VQQcECgfB4URPZtl2BAcNaEB8OWIiYBZZ4qygExfmOKA4TYsxOMROEiDgI9Ly4KkyWMPxzSWHxfk5DIOIQd4AzgDI+IQFIoDaWoEAAZl+agsHwOA92xOBcXfdAKBqLB6WiZxrN7G9IzMtdYBMYxRhCMIIh6I97WifAEkJPyHWiccuE0sBrz1YJQmcaJDPwh1GS6FyrEQOszE8uKfNCgKgqgEL-PC1BIuIGL-1yhKkpeFK0r5SMKzYjylGfFZEQJHUEB8DI6xMVCIO-Xinz7LiuoyV0TD69EzEG55IysmzognFICWaxEBvzJbexWlI1o2jY5rhDDnjAKAADcsBELSuGvX46CKwyypYoaM0rTafwhZVlXLYbETML6UkaH6-velrogPI8sBPM8Lyveav3BgHIYgQ9j1Pc9ROvfMqjgJguALXEsBOvdzqu+wjLgAls1+AkuIQAAfP4GFaRkIg6DnGQep6sBe29aQCZ9PlapGH0+7NPgXUx81c4XsqUQ6oEByXpZMfNIxAMie2FEWEAAPiUHwEAAMhNv5deyw2etN83P2eABCbMIiVkwgcaDoAH5ogiYWTA6W2EHthAnd-F3-qO92vZ9+WOmc70xY+jY3cl11XXzO9kcj1P08-V3UfRmHMfhu7Ecz8XI6hjG4exsulKwfGYEJ8zCnzXc+TxgmCBoLtSdZcmsAEf1Axp386YZ5n-jZjmuZ5+I+cJgW5d10X89V1V1fSoXLeMJWVd-KWN41vktYQHW2j1gAeBBBFESQZHkM2LYv7Lr9v8QpBEORA+D0OPnDrO7Eo7e19ivAOT9f7Oz3sAmOls46vQbBHIBktQZ5yQfvD4nxUEJ3zlXIuNcEYZ0TrxAu0NYZY0IZ+TuTciat0jO3Nk1DCb4B7iTHce4hLQ1Hh8ceiImYs2npzOOc9nqLy3tYFIeBFboKBlLd0a8D6ywyhpNYu8ZHFmlgoiEx82SLAQBMPsAoKGE1QMZYESkoDCRLmfAAnMbFIWA3jVEwNsKAFAADWtouyMnEYgZ8IgpELhSGWXxz8RCqKUJIpR28L5qMASnA+QF-F5lCc+Es0j4nuyScKcJOjnh6JsL6DxCBHoMEipgMqKQ1y0DPNwTW2thYGyNoHRpb8tD3y-o-c2aSmk2yfj0tpd9dD6EMIHP+KRQFtA9iA4W8CBblyTsrWRo0L5EOgRotqwpGhrJkXg8hJccZoPepw6xSh1rfhOaJICA0EAAFIPREKYbQthfIGHPCeSw6gvd2GsioFwHol1rq3W4SkXhJxJ6s2oOzIR3MSm835qkrZq8kEJIhNc6J1g0kK2ISjDRR9Iz1LPmkjy1t35iGGQYIwjNJ5bKtkoMlFLDDMg+aw-Mp8QWTMaP7EBWivgB2pa8MOWLo4AIrksyW8CWVfJeWySMTyW4ytOggBIHiQVgs2BCwRXMEEIHZbyks1sfDx29FAlFUdRWLNRXyuJYrN6vMJecwBGDga9KNTqsEYd1lQU5l6zBAcMliosPQ9hGE9F+Xoq8VAYAsDskclgfY1E+BRqwA5GypxziXCyKm3sr1aZnwngIqFM9-UIA5nCT5eEXiMUHL8Wilbq3MU1dQJ8kLy24WkOAYE4lzFGzba0ZwXJUjduYkoAArD4KSeiwB7GeBmZYRBrKHHoi8ERC9jCfO+c8KysBbIs2pJJOE26qjSFwEGUU9hUBAmoHMFcGgLK3GlMardnJuSI0jHooQXAsY0BAAALxjdmSM+A7gEkMogCJPUWAIFUYM7QehKVQbWD9J9b0ixhzWCW9qfQYDjjWASMln85CMkCiAVoPZIWIyVfkpYDkd0aQzBAHYawmrfiPVgE9OBECbJfFkC9V6eR51Pb8UgtGqi-B8KQcCrFTxCh4+KSUD6CQmF6jfdpjKjAwVnEqDeRqpMEG4Ge9qMQsIGZ5OyP9u6zAqbrHZZE0QJCtjOAgZM4Fkxg0zKtR1mY2McbgINJV3BP3ftoP+mKAsKzoAgKgbSBi2gNsOWhVkkXotcFi-FlDervzOx8JzMw-LmaQX-v7CIeWUPUZvsmkiV0YCflci8ZNgRqu+ZWeey9LQBMJzTEJsgfA+g9E8IEMUOgBCSeDgKWToo3yKYIw-PUCFQJIQyAy+DozNMgS1EhS0wdgNcEM32Yzpn7hB06xBU9fRaAvDEqKXz53-RcFiDUM45Jg5bos78XS3UbP9nRPZxzMbg4uc-G5

Added

• Added new ex.Camera.setStrategies() and ex.Camera.strategies for additional control of strategy order
• Fixed ex.Font measureText always using 10px sans-serif on the first call on some browsers
• Added a new ex.Sound({...}) option back constructor to set all the same props available on sound
• Added a new ex.SoundManager type for managing groups of audio/sound effects/music volume in an easier way

const soundManager = new ex.SoundManger({
  channels: ['fx', 'music', 'background'],
  sounds: {
    jumpSnd: { sound: jumpSnd, volume: 0.4, channels: ['fx'] },
    forestSnd: { sound: forestSnd, volume: 0.2, channels: ['music', 'background'] },
    challengeMusic: { sound: challengeMusic, volume: 0.2, channels: ['music'] },
    guitarLoop: { sound: guitarLoop, volume: 0.2, channels: ['music'] }
  }
});

// play a specific sound
soundManager.play('jumpSnd');

// mute a specific channel with all member sounds
soundManager.channel.mute('music');

// mute all sound
soundManager.mute();
// unmute all sound that was previously muted, and resume playing from the current location
soundManager.unmute();

// unmute a specific channel that was muted
soundManager.channel.unmute('music');

// play a specific channel
soundManager.channel.play('music');

// set the max volume of an entire channel
soundManager.channel.setVolume('music', 0.9);

• Added ex.Animation.data to store arbitrary meta data for an animation. Data can be directly added in the constructor as an option, by using the optional data argument in fromSpriteSheet(...) and as an option in fromSpriteSheetCoordinates({...})
• Added a new configuration option to ex.Engine({global: ...}) where you can provide a keyboard global to override if iframe detection fails for anyway.
• Added new way to output data from scenes onDeactivate(), returning data will be passed to the next SceneActivationContext in the previousSceneData property!
• Added new transitionstart and transitionend events to ex.Scenes
• Pipe navigation* events to ex.Engine
• Added ability to use ex.Vector to specify offset and margin in SpriteSheet.fromImageSource({..})
• New PostProcessor.onDraw() hook to handle uploading textures
• Adds contact solve bias to RealisticSolver, this allows customization on which direction contacts are solved first. By default there is no bias set to 'none'.
• Queries can now take additional options to filter in/out by components or tags.

const query = new Query({
  // all fields are optional
  components: {
    all: [ComponentA, ComponentB] as const, // important for type safety!
    any: [ComponentC, ComponentD] as const, // important for type safety!
    not: [ComponentE]
  },
  tags: {
    all: ['tagA', 'tagB'],
    any: ['tagC', 'tagD'],
    not: ['tagE']
  }
})

// previous constructor type still works and is shorthand for components.all
new Query([ComponentA, ComponentB] as const)

• Queries can now match all entities by specifying no filters

const query = new Query({})

• Adds maxVel attribute to MotionComponent, which clamps velocity on separated X and Y axes
• Add Clock.clearSchedule(id) and have Clock.schedule return an ID so you can clear a scheduled callback before it fires

Fixed

• Fixed issue where ParticleEmitter Particle did not receive z index value from emitter when in World space
• Fixed issue where an animation that was anim.reset() inside of an animation event handler like anim.once('end', () => anim.reset()) would not work correctly
• Fixed issue where GpuParticleEmitter did not rotate with their parents
• Fixed issue where Cpu ParticleEmitter did not respect ParticleTransform.Local
• Fixed issue where same origin iframes did not work properly with keyboard & pointer events
• Fixed is

Added

• Adds contact solve bias to RealisticSolver, this allows customization on which direction contacts are solved first. By default there is no bias set to 'none'.

Fixed

• Fixed false positive warning when adding timers
• Fixed issue where gamepad buttons wouldn't progress the default loader play button
• Add defense around middling Safari fullscreen support and update documentation
• Fixed issue where non-standard gamepad buttons would not be emitted by Excalibur
  • Added an additional param to the ex.GamepadButtonEvent indexto disabiguate between ex.Buttons.Unknown
• Fixed issue where Realistic solver would not sort contacts by distance causing some artifacts on seams
• Fixed issue with CompositeCollider where large TileMaps would sometimes causes odd collision behavior in the Realistic Solver when the body & collider components are far apart in a TileMap.

What's Changed

• [#3320] Fix details in Tutorial - Building Flappy Bird by @cosmicarrow in https://github.com/excaliburjs/Excalibur/pull/3321
• fix: CompositeCollider behavior affecting TileMap w/Realistic Solver by @eonarheim in https://github.com/excaliburjs/Excalibur/pull/3322
• Update site showcase RetroSki url, title & description by @mathieuher in https://github.com/excaliburjs/Excalibur/pull/3324
• fix: [#3317] gamepad support non standard buttons by @eonarheim in https://github.com/excaliburjs/Excalibur/pull/3325
• chore: Update dependency excalibur-jasmine to v0.3.8 by @renovate in https://github.com/excaliburjs/Excalibur/pull/3329
• chore: Update dependency @fortawesome/fontawesome-free to v6.7.2 by @renovate in https://github.com/excaliburjs/Excalibur/pull/3326
• chore: Update dependency @types/react-color to v3.0.13 by @renovate in https://github.com/excaliburjs/Excalibur/pull/3328
• chore: Update dependency prism-react-renderer to v2.4.1 by @renovate in https://github.com/excaliburjs/Excalibur/pull/3330

New Contributors

• @cosmicarrow made their first contribution in https://github.com/excaliburjs/Excalibur/pull/3321

Full Changelog: https://github.com/excaliburjs/Excalibur/compare/v0.30.2...v0.30.3

Added

• New PostProcessor.onDraw() hook to handle uploading textures

Fixed

• Fixed crash on Xiaomi Redmi Phones by lazy loading the GPU particle renderer, GPU particles still do not work on these phones
• Add warning if World.add() falls through! This is caused by multiple versions of Excalibur usually
• Fixed CollidePolygonPolygon crash with some defense against invalid separation
• Fixed issue with PostProcessor where it would not run correctly if no actors present

Full Changelog: https://github.com/excaliburjs/Excalibur/compare/v0.30.1...v0.30.2