Excalibur 0.31.0 

dotnet add package Excalibur --version 0.31.0
                    


                    

                
NuGet\Install-Package Excalibur -Version 0.31.0
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="Excalibur" Version="0.31.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="Excalibur" Version="0.31.0" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="Excalibur" />
                    


                            Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package. 
paket add Excalibur --version 0.31.0
                    


                    

                
#r "nuget: Excalibur, 0.31.0"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
#:package Excalibur@0.31.0
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package. 
#addin nuget:?package=Excalibur&version=0.31.0
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=Excalibur&version=0.31.0
                    


                            Install as a Cake Tool

excalibur logo

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 issue where the initial scene onPreLoad was not being run
  • Fixed unecessary coupling with ex.ColliderComponent/ex.BodyComponent that prevented collider tracking on entities that have ex.TransformComponent/ex.ColliderComponent, this influenced users doing Entity level ECS with pointer events.
  • Fixed issue where passing 0 to ex.Sound.play(0) would not set the volume to 0, instead the previous volume would play.
  • Fixed issue where the Actor.color did not respect being set
  • Fixed offscreen culling issue when using parallax on TileMaps
  • Fixed division by 0 when timescale is 0 in actions
  • Fixed onTransition on the initial scene transition
  • Fixed ex.TriggerOptions type to all optional parameters
  • Fixed issue where the ActorArgs type hint would not error when providing a color causing confusion when it didn't produce a default graphic.
  • 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.
  • 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
  • Removed warning in development for unadded entities
  • Fixed memory leaks from retained entities in Map<Entity>

Changed

  • Updated ex.Camera.addStrategy() to accept multiple strategies
  • Changed the behavior of fromSpriteSheet(...), fromSpriteSheetCoordinates({...}) and clone() of ex.Animation to return the subclass if called from there
  • Optimized BoundingBox.rayCast and BoundingBox.rayCastTime
  • Optimized BoundingBox.intersect(otherBoundingBox)
  • Change logging behavior for entities not in scenes, only log in dev builds

What's Changed

New Contributors

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

There are no supported framework assets in this package.

Learn more about Target Frameworks and .NET Standard.

This package has no dependencies.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
0.31.0 32 9/27/2025
0.30.3 224 1/2/2025
0.30.2 192 12/26/2024
0.30.1 227 12/13/2024
0.29.3 239 5/5/2024
0.29.2 272 4/7/2024
0.29.1 271 2/23/2024
0.29.0 290 2/20/2024
0.28.7 283 1/27/2024
0.28.6 264 1/13/2024
0.28.5 301 1/6/2024
0.28.4 285 12/22/2023
0.28.3 265 12/12/2023
0.28.2 307 12/2/2023
0.28.0 393 8/11/2023
0.25.3 768 2/6/2022
0.25.2 637 1/22/2022
0.25.1 714 11/6/2021
0.25.0 613 10/4/2021
0.24.5 940 9/7/2020
0.24.4 871 9/3/2020
0.24.3 881 5/10/2020
0.24.1 749 4/24/2020
0.24.0 808 4/24/2020
0.23.0 971 6/8/2019
0.22.0 949 4/6/2019
0.21.0 1,123 2/2/2019
0.20.0 1,117 12/23/2018
0.19.1 1,124 10/23/2018
0.19.0 1,201 10/13/2018
0.18.0 1,397 8/4/2018
0.17.0 1,586 6/16/2018
0.16.0 1,670 4/6/2018
0.15.0 1,310 2/17/2018
0.14.0 1,625 12/2/2017
0.13.0 1,567 10/7/2017
0.12.0 1,660 8/12/2017
0.11.0 1,743 6/10/2017
0.10.0 1,708 4/8/2017
0.9.0 1,730 2/10/2017
0.8.0 1,493 12/4/2016
0.7.1 2,009 10/4/2016
0.7.0 2,025 8/30/2016
0.6.0 2,275 1/20/2016
0.5.1 1,922 6/26/2015
0.5.0 1,883 6/4/2015
0.2.2 2,273 4/16/2014
0.2.1 2,114 4/16/2014
0.2.0 2,131 4/10/2014
0.1.1-alpha 1,750 12/19/2013
0.1.0-alpha 1,845 12/12/2013