AquariumAquarium

Setup Guide

Detailed guide on setting up Aquarium's language immersion system.

Setup Guide

This guide covers the different ways to set up Aquarium's language immersion system in your server.

Setup Options

Aquarium offers two ways to set up immersion channels:

Aquarium creates everything for you:

  1. A new category called "Language Immersion"
  2. Nine language channels (one for each supported language)
  3. Webhooks for each channel
  4. Proper channel permissions

To use automatic setup:

  1. Open your server in the dashboard
  2. Go to the Immersion tab
  3. Click "Set Up Immersion"
  4. Select "Create New Channels"
  5. Optionally choose an existing category to use
  6. Click "Complete Setup"

If you already have language channels:

  1. Open your server in the dashboard
  2. Go to the Immersion tab
  3. Click "Set Up Immersion"
  4. Select "Link Existing Channels"
  5. Map each language to one of your existing channels
  6. Click "Complete Setup"

When linking existing channels, Aquarium will create webhooks in those channels. Make sure the bot has "Manage Webhooks" permission.

Supported Languages

Aquarium supports 9 languages:

LanguageCodeChannel Name
EnglishEN#english
SpanishES#spanish
Portuguese (Brazilian)PT-BR#portuguese
FrenchFR#french
GermanDE#german
ItalianIT#italian
JapaneseJA#japanese
KoreanKO#korean
Chinese (Simplified)ZH#chinese

Enabling/Disabling Languages

You don't need all 9 languages. Enable only the ones your community needs:

  1. Go to the Channels tab in your server dashboard
  2. Find the Language Settings section
  3. Check/uncheck languages to enable/disable them
  4. Click "Save Changes"

When you disable a language, its channel is moved to a "Disabled Immersion" category. When re-enabled, it moves back. If the channel was deleted, it will be recreated.

Channel Permissions

For immersion to work correctly:

Bot needs:

  • View Channel
  • Send Messages
  • Manage Webhooks
  • Manage Messages (to delete messages from unverified users)

Users need:

  • View Channel
  • Send Messages

Troubleshooting Setup

Bot can't create channels

Make sure the bot has "Manage Channels" permission at the server level or in the target category.

Webhooks aren't working

  1. Check that the bot has "Manage Webhooks" permission
  2. Try using the "Recreate Webhook" button in the channel settings

Messages aren't being translated

  1. Verify the user is verified (posted and clicked the verification link)
  2. Check that the source channel is properly linked to a language
  3. Ensure the target languages are enabled

On this page