Skip to main content
Version: v2.10.0

Changes in 2.10.0​

danger

🛑 This is a major release with breaking changes. Please update your code accordingly.

tip

✅ A significant release focused on reliability, cleaner internals, and broader library support.

Here you will find everything that changed in v2.10.0 and what you need to update when upgrading.

How to update​

npm update magmastream

New Features​

isAutoplay flag on tracks​

Tracks now carry an explicit isAutoplay boolean — no more internal user comparisons to determine whether a track was added by autoplay.

destroy() on all queue backends​

All queue backends (MemoryQueue, RedisQueue, JsonQueue) now implement a destroy() method for proper resource cleanup.

pauseOnDisconnect player option​

New pauseOnDisconnect option in PlayerOptions — when enabled, the player pauses instead of stopping when the bot is disconnected from a voice channel. Defaults to true.

Discordeno wrapper​

First-class support for @discordeno/bot via the new Discordeno wrapper.

resolveGuild() on all wrappers​

All wrappers now implement resolveGuild() for consistent guild resolution across libraries.

getUser / getGuild cache callbacks in ManagerOptions​

New optional getUser and getGuild callbacks in ManagerOptions, allowing you to plug in your library's cache for user and guild resolution without a wrapper.

Structured error for missing GuildVoiceStates intent​

All wrappers now throw a MagmaStreamError with code MS_INTENT_MISSING if the GuildVoiceStates gateway intent is not enabled.

Breaking Changes​

Detritus wrapper removed​

The Detritus wrapper has been removed. Migrate to the new Discordeno wrapper.

deleteInactivePlayers renamed to deleteDestroyedPlayers​

Update any references in your StateStorageOptions config.

MemoryQueue methods are now synchronous​

MemoryQueue methods no longer return Promise. If you were awaiting them, remove the await. Other backends (Redis, JSON) remain asynchronous.

Minimum Node.js version bumped to >=20.19.0​

Ensure your runtime meets the new minimum version requirement.

Peer dependency bumps​

  • seyfert bumped to 4.x
  • oceanic.js bumped to 1.13.x

Update these in your package.json if you use either wrapper.

Fixes & Improvements​

play({ startTime }) no longer silently dropped​

Passing startTime or other play options to player.play() now correctly forwards them to Lavalink.

Session ID storage refactored​

Session IDs are now stored per-node (individual files and a Redis hash) instead of a single shared JSON file, preventing cross-node conflicts on restart.

requester.id consistently cast to string​

Fixes BigInt Map key mismatches that could cause track requester lookups to silently fail.

channelId included in voice state updates​

channelId is now correctly included in voice state payloads sent to Lavalink, fixing voice connection issues after channel moves.

REST 4xx responses returned as structured errors​

REST 4xx responses from Lavalink are now returned as structured MagmaStreamError objects instead of thrown exceptions, making error handling consistent.

Player serialization null-safe​

PlayerUtils.serializePlayer() is now fully typed, null-safe, and returns null on failure instead of throwing.

Questions?​

Join our Discord — we're happy to help.