Configuration

Configure @robojs/discordjs through a plugin configuration file at config/plugins/robojs/discordjs.ts.

Plugin Configuration

import type { DiscordConfig } from '@robojs/discordjs'

export default {
	clientOptions: {
		intents: ['Guilds', 'GuildMessages', 'GuildMembers']
	},
	sage: {
		defer: true,
		deferBuffer: 250,
		ephemeral: false
	},
	testServers: ['123456789012345678']
} satisfies DiscordConfig

export default {
	clientOptions: {
		intents: ['Guilds', 'GuildMessages', 'GuildMembers']
	},
	sage: {
		defer: true,
		deferBuffer: 250,
		ephemeral: false
	},
	testServers: ['123456789012345678']
}

The satisfies DiscordConfig annotation gives you autocomplete and type checking without changing the inferred type of the export.

Client Options

The clientOptions field passes directly through to the Discord.js Client constructor. Intents are specified as PascalCase strings such as 'Guilds', 'GuildMessages', and 'MessageContent'.

Command Defaults

The defaults field sets default values for all commands. These can be overridden per command in individual command configs.

import type { DiscordConfig } from '@robojs/discordjs'

export default {
	defaults: {
		contexts: ['Guild', 'BotDM'],
		integrationTypes: ['GuildInstall']
	}
} satisfies DiscordConfig

export default {
	defaults: {
		contexts: ['Guild', 'BotDM'],
		integrationTypes: ['GuildInstall']
	}
}

Sage

Global Sage mode options control automatic deferrals, ephemeral replies, and error handling. Set to false to disable Sage entirely. See the Sage Mode page for details on each option.

Test Servers

The testServers array restricts command registration to specific server IDs during development. This speeds up iteration since guild commands update instantly, unlike global commands which can take up to an hour.

Auto Register Commands

The autoRegisterCommands field controls when Robo.js registers slash commands with Discord.

Timeouts

The timeouts field configures time limits for various operations.

Robo Configuration

Framework-level settings such as logger configuration, heartbeat intervals, and environment variables go in config/robo.ts. This page covers only the Discord plugin configuration. See the Robo.js core documentation for the full config/robo.ts reference.

Mode-Specific Configuration

Create mode-specific overrides by appending the mode name to the filename. These files merge with the base config when running in the corresponding mode. Mode-specific files override matching fields; unspecified fields keep their base values.

• Development — config/plugins/robojs/discordjs.development.ts
• Production — config/plugins/robojs/discordjs.production.ts

This is useful for setting testServers only in development or enabling autoRegisterCommands only in production.

Configuration Reference

Next Steps