JDAService

Interfaced service to be implemented by the service which creates a JDA instance.

This has many advantages:

• Checking gateway intents, cache flags, and member cache requirements for event listeners and event waiters

• Conditionally enabling services based on gateway intents (@RequiredIntents), cache flags, and member cache

• Starting JDA when every other service is ready

Usage

Register your instance as a service with @BService or any annotation that enables your class for dependency injection.

Example:

@BService
class Bot(private val config: Config) : JDAService() {
    // Default intents + MESSAGE_CONTENT
    override val intents: Set<GatewayIntent> = defaultIntents(GatewayIntent.MESSAGE_CONTENT)

    override val cacheFlags: Set<CacheFlag> = enumSetOf()

    override fun createJDA(event: BReadyEvent, eventManager: IEventManager) {
        // Read the docs on what this does
        lightSharded(config.token, ...) {
            ...
        }
    }
}

Spring support

Spring users must set their gateway intents and cache flags using properties, named jda.intents and jda.cacheFlags respectively, also available in JDAConfiguration.

See also