Voice

When someone joins a voice channel, the voiceJoin events run:

src/events/hello.ts

import { event } from 'chapterjs';

export default event({
  name: 'voiceJoin',
  async run({ voice: { member, channel } }) {
    // A voice channel has its own text chat: the bot writes there.
    await channel.send(`${member.displayName} joined ${channel.name}.`);
  },
});

That is all. Your function receives voice and the server, guild: voice.member is who joined, voice.channel the VoiceChannel (a stage channel is one too, with channel.isStage), and voice.state their VoiceState: muted, deafened, streaming, camera on…

The four voice events, with what they give, are in the reference. Your bot joining a voice channel itself, to play sound there, is in Playing in voice.

Four events

Discord sends one kind of change for voice; ChapterJS tells you what it was, by comparing with what the person was doing before:

Event	Runs when	Your function receives
`voiceJoin`	Someone joins a voice channel	`voice` (`member`, `channel`, `state`), `guild`
`voiceLeave`	Someone leaves, or is disconnected	`voice` (`member`, `channel` they left, `state` as it was), `guild`
`voiceMove`	Someone goes to another voice channel, or is moved	`voice` (`member`, `from`, `to`, `state`), `guild`
`voiceUpdate`	Someone in a channel changes: mute, deafen, stream, camera	`voice` (`member`, `channel`, `state` now, `before` as it was), `guild`

A move is only a voiceMove: not a voiceLeave followed by a voiceJoin. And voiceUpdate never runs for a join, a leave or a move.

src/events/live.ts

import { event } from 'chapterjs';

export default event({
  name: 'voiceUpdate',
  async run({ voice: { member, channel, state, before } }) {
    if (state.selfStream && !before.selfStream) {
      await channel.send(`${member.displayName} is live!`);
    }
  },
});

The channel someone left

voiceLeave always gives the channel, even when it was deleted with people in it: the bot keeps the channel of each person while they are in voice.

src/events/empty.ts

import { event } from 'chapterjs';

export default event({
  name: 'voiceLeave',
  run({ voice: { member, channel }, guild }) {
    console.log(`${member.displayName} left ${channel.name} of ${guild.name}`);
  },
});

What the bot remembers

To tell a join from a move or a mute, the bot remembers who is in a voice channel, and forgets them when they leave. It only does when a file listens to one of these events: without one, Discord does not send voice changes at all. It is little: one small entry per person in voice right now.

Intents

The four events need GUILD_VOICE_STATES, which is not privileged. They only happen in servers: there is no where option.

ℹ Intents computed from your files: GUILDS, GUILD_VOICE_STATES

Moderation and the server

Bans, the audit log, invites, emojis, scheduled events, threads.

Events reference

Every field of every event.

Get started

Commands

Messages

Events

Components

Tasks

Presence

Storage

Translations

Memory

Testing

Run your bot

Roadmap

Voice

Four events

The channel someone left

What the bot remembers

Intents

Moderation and the server

Events reference