- Change
Matter.log
to return nothing as expected. - Exported Matter object is now read only, which prevents invalid mutations to it.
- Improve documentation for
Matter.useEvent
.
- Debugger no longer interferes with
queryChanged
in order to display it in the debugger view. Previously, this caused the storage to get reset. This feature may return in the future.
- Added
Matter.log
, and a logs viewer per-system to the Matter debugger. - Added error logging and inspection to the Matter debugger.
- Added Query inspection to the Matter debugger.
- Fixed bug with server-side debugger when game was in deferred events mode
- The first time you call
queryChanged
, all existing entities in the world that match the component are now returned as "new" change records. Previously, nothing was returned. - Improved Debugger with highlight selections and tooltips.
Matter.useEvent
now supports events that have aConnect
,connect
, or anon
method. Additionally, it also supports custom connection objects (returned by custom events), which have aDestroy
or aDisconnect
method, or are just a cleanup function.
- Debugger: Fixed bug with profiling when disabling a system and then closing the debugger
- Debugger: Fixed bug with system list automatic sizing
- Added performance information to debugger
- Add World inspector to debugger
- Fix confusing error when a system yields inside a plasma context
- Fixed debugger panel not scrolling.
- In the debugger panel, the module name is now used when function is not named.
- Fix custom debugger widgets not using the Plasma instance the user passed in.
- Added Matter debugger.
- Middleware now receive event name as a second parameter
- Modifying the World while inside
World:query
can no longer cause iterator invalidation. All operations to World while inside a query are now safe. 🎉- If you aren't using
Loop
, you must callWorld:optimizeQueries
periodically (e.g., every frame)
- If you aren't using
- If a system stops calling
queryChanged
, its internal storage will now be cleaned up. It is no longer a requirement that a system callsqueryChanged
forever. Matter.merge
(an undocumented function) now only accepts two parameters.
replaceSystem
now correctly works when other systems reference a system being reloaded in theirafter
table- If
spawnAt
is called with an entity ID that already exists, it now errors as expected.
- Added
World:spawnAt
to spawn a new entity with a specified ID. - Added
World:__iter
to allow iteration over all entities in the world the world from a for loop. - Added
Loop:evictSystem(system)
, which removes a previously-scheduled system from the Loop. Evicting a system also cleans up any storage from hooks. This is intended to be used for hot reloading. Dynamically loading and unloading systems for gameplay logic is not recommended. - Added
Loop:replaceSystem(before, after)
, which replaces an older version of a system with a newer version of the system. Internal system storage (which is used by hooks) will be moved to be associated with the new system. This is intended to be used for hot reloading. - The Matter example game has been updated and adds support for both replication and hot reloading.
- The first entity ID is now
1
instead of0
- Events that have no systems scheduled to run on them are no longer skipped upon calling
Loop:begin
.
- Old event listeners created by
useEvent
were not properly disconnected when the passed event changed after having been already created. The event parameter passed to useEvent is not intended to be dynamically changed, so an warning has been added when this happens.
- Added a second parameter to
Matter.component
, which allows specifying default component data. - Add
QueryResult:snapshot
to convert aQueryResult
into an immutable list
queryChanged
behavior has changed slightly: If an entity's storage was changed multiple times since your system last observed it, theold
field in theChangeRecord
will be the last value your system observed the entity as having for that component, rather than what it was most recently changed from.- World and Loop types are now exported (#9)
- Matter now uses both
__iter
and__call
for iteration overQueryResult
. - Improved many error messages from World methods, including passing nil values or passing a Component instead of a Component instance.
- Removed dependency on Llama
- System error stack traces are now displayed properly (#12)
World:clear()
now correctly resets internal changed storage used byqueryChanged
(#13)
- Additional query parameters to
queryChanged
have been removed.queryChanged
now only takes one argument. If your code used these additional parameters, you can useWorld:get(entityId, ComponentName)
to get a component, and usecontinue
to skip iteration if it is not present.
- Fix Loop sort by priority to sort properly
- Fix accidental system yield error message in Loop
- Accidentally yielding or erroring in a system does not prevent other systems from running.
- Initial release