Skip to content

Releases: excaliburjs/Excalibur

Excalibur v0.31.0 Release

26 Sep 14:52
@eonarheim eonarheim
v0.31.0
aa3cfbb

Choose a tag to compare

View all tags
Excalibur v0.31.0 Release Latest
Latest

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

Read more

Contributors

BaconSoap, chrisalley, and 12 other contributors
Assets 2
Loading
0 Join discussion

Excalibur v0.30.3 Release

02 Jan 01:41
@eonarheim eonarheim
v0.30.3
210acc5

Choose a tag to compare

View all tags
Excalibur v0.30.3 Release

excalibur logo

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

New Contributors

Full Changelog: v0.30.2...v0.30.3

Contributors

eonarheim, renovate, and 2 other contributors
Loading

Excalibur v0.30.2 Release

26 Dec 02:49
@eonarheim eonarheim
v0.30.2
8e968c9

Choose a tag to compare

View all tags
Excalibur v0.30.2 Release

excalibur logo

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: v0.30.1...v0.30.2

Loading

Excalibur v0.30.1 Release

13 Dec 05:32
@eonarheim eonarheim
v0.30.1
194a506

Choose a tag to compare

View all tags
Excalibur v0.30.1 Release

excalibur logo

  • fix graphics tint issue

Read https://github.com/excaliburjs/Excalibur/releases/tag/v0.30.0 for more!

Full Changelog: v0.30.0...v0.30.1

Loading

Excalibur v0.30.0 Release

13 Dec 03:49
@eonarheim eonarheim
v0.30.0
71dc0c8

Choose a tag to compare

View all tags
Excalibur v0.30.0 Release

excalibur logo

This is one of the biggest releases of Excalibur yet! Huge thanks to all the new contributors and everyone that assisted in the discord.

Special thanks @jyoung4242, @mattjennings, @cdelstad, @kamranayub, Drew Conley, and @jedeen for being constant support and help for the project and the entire community!

New Contributors

Features

  • Added ex.SpriteSheet.getTiledSprite(...) to help pulling tiling sprites out of a sprite sheet
  • Alias the engine.screen.drawWidth/drawHeight with engine.screen.width/height;
  • Added convenience types ex.TiledSprite and ex.TiledAnimation for Tiling Sprites and Animations 
    const tiledGroundSprite = new ex.TiledSprite({
  image: groundImage,
  width: game.screen.width,
  height: 200,
  wrapping: {
    x: ex.ImageWrapping.Repeat,
    y: ex.ImageWrapping.Clamp
  }
});

const tilingAnimation = new ex.TiledAnimation({
  animation: cardAnimation,
  sourceView: {x: 20, y: 20},
  width: 200,
  height: 200,
  wrapping: ex.ImageWrapping.Repeat
});
  • Added new static builder for making images from canvases ex.ImageSource.fromHtmlCanvasElement(image: HTMLCanvasElement, options?: ImageSourceOptions)
  • Added GPU particle implementation for MANY MANY particles in the simulation, similar to the existing CPU particle implementation. Note maxParticles is new for GPU particles. 
    var particles = new ex.GpuParticleEmitter({
  pos: ex.vec(300, 500),
  maxParticles: 10_000,
  emitRate: 1000,
  radius: 100,
  emitterType: ex.EmitterType.Circle,
  particle: {
    beginColor: ex.Color.Orange,
    endColor: ex.Color.Purple,
    focus: ex.vec(0, -400),
    focusAccel: 1000,
    startSize: 100,
    endSize: 0,
    life: 3000,
    minSpeed: -100,
    maxSpeed: 100,
    angularVelocity: 2,
    randomRotation: true,
    transform: ex.ParticleTransform.Local
  }
});
  • Added ex.assert() that can be used to throw in development builds
  • Added easing option to moveTo(...)
  • Added new option bag style input to actions with durations in milliseconds instead of speed 
    player.actions.rotateTo({angleRadians: angle, duration: 1000, rotationType});
player.actions.moveTo({pos: ex.vec(100, 100), duration: 1000});
player.actions.scaleTo({scale: ex.vec(2, 2), duration: 1000});
player.actions.repeatForever(ctx => {
  ctx.curveTo({
    controlPoints: [cp1, cp2, dest],
    duration: 5000,
    mode: 'uniform'
  });
  ctx.curveTo({
    controlPoints: [cp2, cp1, start1],
    duration: 5000,
    mode: 'uniform'
  });
});
  • Added ex.lerpAngle(startAngleRadians: number, endAngleRadians: number, rotationType: RotationType, time: number): number in order to lerp angles between each other
  • Added pointerenter and pointerleave events to ex.TileMap tiles!
  • Added pointerenter and pointerleave events to ex.IsometricMap tiles!
  • Added new ex.BezierCurve type for drawing cubic bezier curves
  • Added 2 new actions actor.actions.curveTo(...) and actor.actions.curveBy(...)
  • Added new ex.lerp(...), ex.inverseLerp(...), and ex.remap(...) for numbers
  • Added new ex.lerpVector(...), ex.inverseLerpVector(...), and ex.remapVector(...) for ex.Vector
  • Added new actor.actions.flash(...) Action to flash a color for a period of time
  • Added a new ex.NineSlice Graphic for creating arbitrarily resizable rectangular regions, useful for creating UI, backgrounds, and other resizable elements. 
    var nineSlice = new ex.NineSlice({
  width: 300,
  height: 100,
  source: inputTile,
  sourceConfig: {
    width: 64,
    height: 64,
    topMargin: 5,
    leftMargin: 7,
    bottomMargin: 5,
    rightMargin: 7
  },
  destinationConfig: {
    drawCenter: true,
    horizontalStretch: ex.NineSliceStretch.Stretch,
    verticalStretch: ex.NineSliceStretch.Stretch
  }
});

actor.graphics.add(nineSlice);
  • Added a method to force graphics on screen ex.GraphicsComponent.forceOnScreen
  • Added new ex.Slide scene transition, which can slide a screen shot of the current screen: up, down, left, or right. Optionally you can add an ex.EasingFunction, by default ex.EasingFunctions.Linear 
    game.goToScene('otherScene', {
  destinationIn: new ex.Slide({
    duration: 1000,
    easingFunction: ex.EasingFunctions.EaseInOutCubic,
    slideDirection: 'up'
  })
});
  • Added inline SVG image support ex.ImageSource.fromSvgString('<svg>...</svg>'), note images produced this way still must be loaded.
  • Added ability to optionally specify sprite options in the .toSprite(options:? SpriteOptions)
  • The ex.Engine constructor had a new enableCanvasContextMenu arg that can be used to enable the right click context menu, by default the context menu is disabled which is what most games seem to want.
  • Child ex.Actor inherits opacity of parents
  • ex.Engine.timeScale values of 0 are now supported
  • ex.Trigger now supports all valid actor constructor parameters from ex.ActorArgs in addition to ex.TriggerOptions
  • ex.Gif can now handle default embedded GIF frame timings
  • New ex.Screen.worldToPagePixelRatio API that will return the ratio between excalibur pixels and the HTML pixels.
    • Additionally excalibur will now decorate the document root with this same value as a CSS variable --ex-pixel-ratio
    • Useful for scaling HTML UIs to match your game 
      .ui-container {
  pointer-events: none;
  position: absolute;
  transform-origin: 0 0;
  transform: scale(
    calc(var(--pixel-conversion)),
    calc(var(--pixel-conversion)));
}
  • New updates to ex.coroutine(...)
    • New ex.CoroutineInstance is returned (still awaitable)
    • Control coroutine autostart with ex.coroutine(function*(){...}, {autostart: false})
    • .start() and .cancel() coroutines
    • Nested coroutines!
  • Excalibur will now clean up WebGL textures that have not been drawn in a while, which improves stability for long game sessions
    • If a graphic is drawn again it will be reloaded into the GPU seamlessly
  • You can now query for colliders on the physics world 
      const scene = ...;
  const colliders = scene.physics.query(ex.BoundingBox.fromDimensions(...));
  • actor.oldGlobalPos returns the globalPosition from the previous frame
  • create development builds of excalibur that bundlers can use in dev mode
  • show warning in development when Entity hasn't been added to a scene after a few seconds
  • New RentalPool type for sparse object pooling
  • New ex.SparseHashGridCollisionProcessor which is a simpler (and faster) implementation for broadphase pair generation. This works by bucketing colliders into uniform sized square buckets and using that to generate pairs.
  • CollisionContact can be biased toward a collider by using contact.bias(collider). This adjusts the contact so that the given collider is colliderA, and is helpful if you
    are doing mtv adjustments during precollision.
  • angleBetween medhod added to Vector class, to find the angle for which a vector needs to be rotated to match some given angle: 
      const point = vec(100, 100)
  const destinationDirection = Math.PI / 4
  const angleToRotate = point.angleBetween(destinationDirection, RotationType.ShortestPath)
  expect(point.rotate(angleToRotate).toAngle()).toEqual(destinationDirection)

Fixed

  • Fixed issue where ex.ParticleEmitter.clearParticles() did not work
  • Fixed issue where the pointer lastWorldPos was not updated when the current Camera moved
  • Fixed issue where cancel()'d events still bubbled to the top level input handlers
  • Fixed issue where unexpected html HTML content from an image would silently hang the loader
  • Fixed issue where Collision events ahd inconsistent targets, sometimes they were Colliders and sometimes they were Entities
  • Fixed issue where ex.Engine.screenshot() images may not yet be loaded in time for use in ex.Transitions
  • Fixed issue where there would be an incorrect background color for 1 frame when transitioning to a new scene
  • Fixed issue where blockInput: true on scene transition only blocked input events, not accessors like wasHeld(...) etc.
  • Fixed issue where users could not easily define a custom RendererPlugin because the type was not exposed
  • Fixed issue where ex.Fade sometimes would not complete depending on the elapsed time
  • Fixed issue where `ex.PolygonColliders...
Read more

Contributors

gavriguy, kamranayub, and 21 other contributors
Loading
0 Join discussion

Excalibur v0.29.3 Release

05 May 16:53
@eonarheim eonarheim
v0.29.3
f2ea323

Choose a tag to compare

View all tags
Excalibur v0.29.3 Release

excalibur logo

This is a maintenance release with only bug fixes!

Fixes

  • fix: ex.Vector.toAngle() returns angles between [0, 2PI)
  • fix: Make Entity Constructor's components option optional by @muhajirdev in #3027
  • fix: getSceneName use scenes #3022 by @aruru-weed in #3023
  • fix: Loader suppressPlayButton is now respected (0f9e77d)
  • fix: [#3047] Animation glitch cause by uninitialized state by @eonarheim in #3048

New Contributors

  • @muhajirdev made their first contribution in #3026
  • @aruru-weed made their first contribution in #3023
  • Special thanks to @djdenuyl for spotting a critical bug in image rendering! And a very thorough bug report!

Full Changelog: v0.29.2...v0.29.3

Contributors

eonarheim, muhajirdev, and 2 other contributors
Loading
0 Join discussion

Excalibur v0.29.2 Release

07 Apr 21:17
@eonarheim eonarheim
v0.29.2
7fd4f2c

Choose a tag to compare

View all tags
Excalibur v0.29.2 Release

excalibur logo

This is a medium-ish release, with a ton of community contributions especially in the bugfix realm!

Features

  • Added ability to configure image wrapping on ex.ImageSource with the new ex.ImageWrapping.Clamp (default), ex.ImageWrapping.Repeat, and ex.ImageWrapping.Mirror. 
    const image = new ex.ImageSource('path/to/image.png', {
  filtering: ex.ImageFiltering.Pixel,
  wrapping: {
    x: ex.ImageWrapping.Repeat,
    y: ex.ImageWrapping.Repeat,
  }
});
  • Added pointer event support to ex.TileMap's and individual ex.Tile's
  • Added pointer event support to ex.IsometricMap's and individual ex.IsometricTile's
  • Added useAnchor parameter to ex.GraphicsGroup to allow users to opt out of anchor based positioning, if set to false all graphics members
    will be positioned with the top left of the graphic at the actor's position. 
    const graphicGroup = new ex.GraphicsGroup({
  useAnchor: false,
  members: [
    {
      graphic: heartImage.toSprite(),
      offset: ex.vec(0, 0),
    },
    {
      graphic: heartImage.toSprite(),
      offset: ex.vec(0, 16),
    },
    {
      graphic: heartImage.toSprite(),
      offset: ex.vec(16, 16),
    },
    {
      graphic: heartImage.toSprite(),
      offset: ex.vec(16, 0),
    },
  ],
});
  • Added simplified ex.coroutine overloads, you need not pass engine as long as you are in an Excalibur lifecycle 
    const result = ex.coroutine(function* () {...});
  • Added way to bind 'this' to ex.coroutine overloads, you need not pass engine as long as you are in an Excalibur lifecycle 
    const result = ex.coroutine({myThis: 'cool'}, function* () {...});
  • Added optional ex.coroutine timing parameter to schedule when they are updated 
    const result = ex.coroutine(engine, function * () {...}, { timing: 'postupdate' })
  • Added GraphicsComponent.bounds which will report the world bounds of the graphic if applicable!
  • Added ex.Vector.EQUALS_EPSILON to configure the ex.Vector.equals(v) threshold
  • Added way to add custom WebGL context lost/recovered handlers for your game 
    const game = new ex.Engine({
  handleContextLost: (e) => {...},
  handleContextRestored: (e) => {...}
})

Fixed

  • Fixed issue where ex.TileMap culling did not work properly when using fixed updates lower than refresh rate
  • Fixed incomplete types for font options in ex.FontSource().toFont(options)
  • Fixed issue with ex.Loader start button position when using CSS transforms
  • Fixed issue where adding scenes with the same name did not work when it was previously removed
  • Fixed issue when WebGL context lost occurs where there was no friendly output to the user
  • Fixed issue where HiDPI scaling could accidentally scale past the 4k mobile limit, if the context would scale too large it will now attempt to recover by backing off.
  • Fixed issue where logo was sometimes not loaded during ex.Loader
  • Fixed issue where unbounded containers would grow infinitely when using the following display modes:
    • DisplayMode.FillContainer
    • DisplayMode.FitContainer
    • DisplayMode.FitContainerAndFill
    • DisplayMode.FitContainerAndZoom
  • Fixed issue where ex.ParticleEmitter z-index did not propagate to particles
  • Fixed incongruent behavior as small scales when setting transform.scale = v and transform.scale.setTo(x, y)
  • Fixed ex.coroutine TypeScript type to include yielding undefined
  • Fixed issue where Firefox on Linux would throw an error when using custom Materials due to unused attributes caused by glsl compiler optimization.
  • Fixed issue where start transition did not work properly if deferred
  • Fixed issue where transitions did not cover the whole screen if camera was zoomed
  • Fixed issue where Color.toHex() produced invalid strings if the channel values are negative or fractional, or if the alpha channel was different than 1

Changed

  • Significant 2x performance improvement to image drawing in Excalibur
  • Simplified ex.Loader viewport/resolution internal configuration
Raw Changes

What's Changed

Read more

Contributors

eonarheim, renovate, and 7 other contributors
Loading
0 Join discussion

Excalibur v0.29.1 Release

23 Feb 14:49
@eonarheim eonarheim
v0.29.1
2acaeb2

Choose a tag to compare

View all tags
Excalibur v0.29.1 Release

excalibur logo

Small release to fix transition bug!

What's Changed

Full Changelog: v0.29.0...v0.29.1

Contributors

eonarheim
Loading

Excalibur v0.29.0 Release

20 Feb 14:28
@eonarheim eonarheim
v0.29.0
1b8475c
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Choose a tag to compare

View all tags
Excalibur v0.29.0 Release

excalibur logo

This is a huge release v0.29.0, we have a lot of big features that bring us closer to v1!

Join the community on discord!

There are breaking changes in this release, please review the migration guide from v0.28.x to v0.29.0

Features

  • Added new ex.Tilemap.getOnScreenTiles() method to help users access onscreen tiles for logic or other concerns.

  • Added ex.FontSource resource type

    const fontSource = new ex.FontSource('/my-font.ttf', 'My Font')
loader.addResource(fontSource)

game.start(loader).then(() => {
  const font = fontSource.toFont() // returns ex.Font
})

    Font options can be defined either at the source or at the toFont() call. If defined in both, toFont(options) will
    override the options in the FontSource.

    const fontSource = new ex.FontSource('/my-font.ttf', 'My Font', { 
  filtering: ex.ImageFiltering.Pixel,
  size: 16, // set a default size
})
const font = fontSource.toFont({
  // override just the size
  size: 20,
})

  • Added fullscreen after load feature! You can optionally provide a fullscreenContainer with a string id or an instance of the HTMLElement

    new ex.Loader({
  fullscreenAfterLoad: true,
  fullscreenContainer: document.getElementById('container')
});

  • Added new ex.Debug static for more convenient debug drawing where you might not have a graphics context accessible to you. This works by batching up all the debug draw requests and flushing them during the debug draw step.

    • ex.Debug.drawRay(ray: Ray, options?: { distance?: number, color?: Color })
    • ex.Debug.drawBounds(boundingBox: BoundingBox, options?: { color?: Color })
    • ex.Debug.drawCircle(center: Vector, radius: number, options?: ...)
    • ex.Debug.drawPolygon(points: Vector[], options?: { color?: Color })
    • ex.Debug.drawText(text: string, pos: Vector)
    • ex.Debug.drawLine(start: Vector, end: Vector, options?: LineGraphicsOptions)
    • ex.Debug.drawLines(points: Vector[], options?: LineGraphicsOptions)
    • drawPoint(point: Vector, options?: PointGraphicsOptions)

  • Experimental ex.coroutine for running code that changes over time, useful for modeling complex animation code. Coroutines return a promise when they are complete. You can think of each yield as a frame.

    • The result of a yield is the current elapsed time
    • You can yield a number in milliseconds and it will wait that long before resuming
    • You can yield a promise and it will wait until it resolves before resuming
      const completePromise = coroutine(engine, function * () {
    let elapsed = 0;
    elapsed = yield 200; // frame 1 wait 200 ms before resuming
    elapsed = yield fetch('./some/data.json'); // frame 2
    elapsed = yield; // frame 3
  });

  • Added additional options in rayCast options

    • ignoreCollisionGroupAll: boolean will ignore testing against anything with the CollisionGroup.All which is the default for all
    • filter: (hit: RayCastHit) => boolean will allow people to do arbitrary filtering on raycast results, this runs very last after all other collision group/collision mask decisions have been made

  • Added additional data side and lastContact to onCollisionEnd and collisionend events

  • Added configuration option to ex.PhysicsConfig to configure composite collider onCollisionStart/End behavior

  • Added configuration option to ex.TileMap({ meshingLookBehind: Infinity }) which allows users to configure how far the TileMap looks behind for matching colliders (default is 10).

  • Added Arcade Collision Solver bias to help mitigate seams in geometry that can cause problems for certain games.

    • ex.ContactSolveBias.None No bias, current default behavior collisions are solved in the default distance order
    • ex.ContactSolveBias.VerticalFirst Vertical collisions are solved first (useful for platformers with up/down gravity)
    • ex.ContactSolveBias.HorizontalFirst Horizontal collisions are solved first (useful for games with left/right predominant forces) 
      const engine = new ex.Engine({
  ...
  physics: {
    solver: ex.SolverStrategy.Realistic,
    arcade: {
      contactSolveBias: ex.ContactSolveBias.VerticalFirst
    },
  }
})

  • Added Graphics opacity on the Actor constructor new ex.Actor({opacity: .5})

  • Added Graphics pixel offset on the Actor constructor new ex.Actor({offset: ex.vec(-15, -15)})

  • Added new new ex.Engine({uvPadding: .25}) option to allow users using texture atlases in their sprite sheets to configure this to avoid texture bleed. This can happen if you're sampling from images meant for pixel art

  • Added new antialias settings for pixel art! This allows for smooth subpixel rendering of pixel art without shimmer/fat-pixel artifacts.

    • Use new ex.Engine({pixelArt: true}) to opt in to all the right defaults to make this work!

  • Added new antialias configuration options to deeply configure how Excalibur does any antialiasing, or you can provide antialiasing: true/antialiasing: false to use the old defaults.

    • Example;
    const game = new ex.Engine({
   antialiasing: {
       pixelArtSampler: false,
       filtering: ex.ImageFiltering.Pixel,
       nativeContextAntialiasing: false,
       canvasImageRendering: 'pixelated'
   }
})

  • Added new lineHeight property on SpriteFont and Font to manually adjust the line height when rendering text.

  • Added missing dual of ex.GraphicsComponent.add(), you can now ex.GraphicsComponent.remove(name);

  • Added additional options to ex.Animation.fromSpriteSheetCoordinates() you can now pass any valid ex.GraphicOptions to influence the sprite per frame

    const anim = ex.Animation.fromSpriteSheetCoordinates({
  spriteSheet: ss,
  frameCoordinates: [
    {x: 0, y: 0, duration: 100, options: { flipHorizontal: true }},
    {x: 1, y: 0, duration: 100, options: { flipVertical: true }},
    {x: 2, y: 0, duration: 100},
    {x: 3, y: 0, duration: 100}
  ],
  strategy: ex.AnimationStrategy.Freeze
});

  • Added additional options to ex.SpriteSheet.getSprite(..., options). You can pass any valid ex.GraphicOptions to modify a copy of the sprite from the spritesheet.

    const sprite = ss.getSprite(0, 0, {
  flipHorizontal: true,
  flipVertical: true,
  width: 200,
  height: 201,
  opacity: .5,
  scale: ex.vec(2, 2),
  origin: ex.vec(0, 1),
  tint: ex.Color.Red,
  rotation: 4
});

  • New simplified way to query entities ex.World.query([MyComponentA, MyComponentB])

  • New way to query for tags on entities ex.World.queryTags(['A', 'B'])

  • Systems can be added as a constructor to a world, if they are the world will construct and pass a world instance to them

    world.add(MySystem);
...

class MySystem extends System {
  query: Query;
  constructor(world: World) {
    super()
    this.query = world.query([MyComponent]);
  }

  update
}

  • Added RayCastHitas part of every raycast not just the physics world query!

    • Additionally added the ray distance and the contact normal for the surface

  • Added the ability to log a message once to all log levels

    • debugOnce
    • infoOnce
    • warnOnce
    • errorOnce
    • fatalOnce

  • Added ability to load additional images into ex.Materials!

    const noise = new ex.ImageSource('./noise.avif');
loader.addResource(noise);

var waterMaterial = game.graphicsContext.createMaterial({
  name: 'water',
  fragmentSource: waterFrag,
  color: ex.Color.fromRGB(55, 0, 200, .6),
  images: {
    u_noise: noise
  }
});

  • Scene Transition & Loader API, this gives you the ability to have first class support for individual scene resource loading and scene transitions.

    • Add or remove scenes by constructor

    • Add loaders by constructor

    • New ex.DefaultLoader type that allows for easier custom loader creation

    • New ex.Transition type for building custom transitions

    • New scene lifecycle to allow scene specific resource loading

      • onTransition(direction: "in" | "out") {...}
      • onPreLoad(loader: DefaultLoader) {...}

    • New async goToScene() API that allows overriding loaders/transitions between scenes

    • Scenes now can have async onInitialize and async onActivate!

    • New scenes director API that allows upfront definition of scenes/transitions/loaders

    • Example:
      Defining scenes upfront

      const game = new ex.Engine({
  scenes: {
    scene1: {
      scene: scene1,
      transitions: {
        out: new ex.FadeInOut({duration: 1000, direction: 'out', color: ex.Color.Black}),
        in: new ex.FadeInOut({duration: 1000, direction: 'in'})
      }
    },
    scene2: {
      scene: scene2,
      loader: ex.DefaultLoader, // Constructor only option!
      transitions: {
        out: new ex.FadeInOut({duration: 1000, direction: 'out'}),
        in: new ex.FadeInOut({duration: 1000, direction: 'in', color: ex.Color.Black })
      }
    },
  scene3: ex.Scene // Constructor only option!
  } 
})

// Specify the boot loader & first scene transition from loader
game.start('scene1',
{
  inTransition: new ex.FadeInOut({duration: 500, direction: 'in', color: ex.Color.ExcaliburBlue})
  loader: boot,
});
    • Scene specific input API so that you can add input handlers that only fire whe...
Read more

Contributors

kamranayub, eonarheim, and 8 other contributors
Loading
0 Join discussion

Excalibur v0.28.7 Release

27 Jan 00:47
@eonarheim eonarheim
v0.28.7
66114d5

Choose a tag to compare

View all tags
Excalibur v0.28.7 Release

excalibur logo

Bugfix release! This release is slightly different cut from the branch release/v0.28.x instead of main, this is because features that are not ready to ship are in the mainline currently and will be shipped as part of v0.29.0

  • fix: Add friendly error if canvasElementId missing(#2885)
  • fix: ex.Material no longer does lazy init, requires graphics context
  • fix: Issue with pointer events on screen elements (#2902)

Also big thanks to @jyoung4242! This was his first contribution to Excalibur!

Full Changelog: v0.28.6...v0.28.7

Contributors

jyoung4242
Loading
0 Join discussion