Skip to main content
Version: v2.10.0

Interface: ManagerOptions

Represents a configuration object passed to the Manager constructor.
These options control core behavior such as node connections, autoplay logic, and plugin support.

Property Type Description Optional
autoPlaySearchPlatformsAutoPlayPlatform[]Search platforms to use for autoplay, in priority order. Defaults to [AutoPlayPlatform.YouTube].
clientIdstringDiscord application's client ID.
clientNamestringValue for the Client-Name header sent to Lavalink nodes. Defaults to "Magmastream". Leave empty for NodeLink.
clusterIdnumberIndex of the cluster this manager belongs to. Defaults to 0.
defaultSearchPlatformSearchPlatformDefault platform for searches. Defaults to SearchPlatform.YouTube.
enabledPluginsPlugin[]List of plugins to load.
enablePriorityModebooleanWhether to enable priority mode over least player count or load balancing. Defaults to false.
getGuildfunctionOptional guild cache getter (id: string) => AnyGuild | undefined. Used by the Discordeno wrapper and any library without built-in guild resolution.
getUserfunctionOptional user cache getter (id: string) => AnyUser | undefined. Used by the Discordeno wrapper and any library without built-in user resolution.
lastFmApiKeystringAPI key for Last.fm-based autoplay. Get one here.
listenToSIGEventsbooleanWhether to listen to SIGINT and SIGTERM for graceful shutdown. Defaults to true.
maxPreviousTracksnumberMaximum number of previous tracks to store per player. Defaults to 20.
nodesNodeOptions[]Lavalink nodes to connect to.
normalizeYouTubeTitlesbooleanReplace YouTube video titles when the author does not exactly match. Defaults to false.
playNextOnEndbooleanAutomatically play the next track when the current one ends. Defaults to true.
sendfunctionFunction used to send packets to Discord's WebSocket gateway. Required when not using a wrapper.
stateStorageStateStorageOptionsWhere queue and player state is persisted. Defaults to StateStorageType.Memory.
trackPartialTrackPartial[]Track properties to retain when building tracks. track is always included.
useNodeUseNodeOptionsNode selection strategy. Defaults to UseNodeOptions.LeastPlayers.