Skip to Content
Haven Documentation is the shared home for product guides, plugin setup, and release docs.
PluginsVoiceSupportTroubleshooting

Troubleshooting

The Plugin Disables Itself Or Voice Features Fail

Athena should install plugin dependencies automatically. If voice features fail or the console reports missing voice packages, stop the bot and run:

npm install @discordjs/voice opusscript ffmpeg-static

Then restart AthenaBot.

No Case Appears When A User Joins The Waiting Room

Check:

  • enabled is true.
  • /voicesupport status says support is open.
  • waitingRoomChannelId is the real voice channel ID.
  • caseChannelId is a real text channel ID.
  • The bot can view the waiting room and send messages in the case channel.
  • The joining account is not a bot account.

Staff Cannot Take Over A Case

Check:

  • The staff member has one of the roles in staffRoles.
  • The bot can Move Members.
  • The waiting user is still in the waiting room.
  • If using move_to_supporter, the staff member is already in a voice channel.
  • If using create_temp_channel, supportCategoryId is valid and the bot can Manage Channels.

Temporary Channels Do Not Delete Or Cases Do Not Auto-Close

Check:

  • autoCloseTimeout is greater than 0.
  • The temporary channel was created by the plugin.
  • The channel is actually empty.
  • The bot still has Manage Channels.

Support Open Or Closed State Looks Wrong After Restart

Voice Support stores open/closed state in MongoDB. Use:

/voicesupport status
/voicesupport open
/voicesupport close

to confirm and correct the current state.

Waiting Room Music Does Not Play

Check:

  • waitingRoomMusic.enabled or closedMusic.enabled is true.
  • The file path points to a real audio file.
  • The bot can Connect and Speak in the waiting room.
  • The voice dependencies installed correctly.
  • volume is above 0.

Case Logs Are Missing

Check:

  • logChannelId is a valid text channel.
  • The bot can send messages and embeds in the log channel.
  • The case reached a closed, cancelled, timed-out, or completed state.

Multiple Users Are Not Being Moved Together

Check:

  • combinedCases.enabled is true.
  • Users are in the waiting room before staff take over, or combinedCases.autoAddLatecomers is true for late joiners.
  • The selected voice handling mode supports moving all users into the target channel.
ScreenshotsOverview