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:
Option 1: Automatic Setup (Recommended)
Aquarium creates everything for you:
- A new category called "Language Immersion"
- Nine language channels (one for each supported language)
- Webhooks for each channel
- Proper channel permissions
To use automatic setup:
- Open your server in the dashboard
- Go to the Immersion tab
- Click "Set Up Immersion"
- Select "Create New Channels"
- Optionally choose an existing category to use
- Click "Complete Setup"
Option 2: Link Existing Channels
If you already have language channels:
- Open your server in the dashboard
- Go to the Immersion tab
- Click "Set Up Immersion"
- Select "Link Existing Channels"
- Map each language to one of your existing channels
- 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:
| Language | Code | Channel Name |
|---|---|---|
| English | EN | #english |
| Spanish | ES | #spanish |
| Portuguese (Brazilian) | PT-BR | #portuguese |
| French | FR | #french |
| German | DE | #german |
| Italian | IT | #italian |
| Japanese | JA | #japanese |
| Korean | KO | #korean |
| Chinese (Simplified) | ZH | #chinese |
Enabling/Disabling Languages
You don't need all 9 languages. Enable only the ones your community needs:
- Go to the Channels tab in your server dashboard
- Find the Language Settings section
- Check/uncheck languages to enable/disable them
- 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
- Check that the bot has "Manage Webhooks" permission
- Try using the "Recreate Webhook" button in the channel settings
Messages aren't being translated
- Verify the user is verified (posted and clicked the verification link)
- Check that the source channel is properly linked to a language
- Ensure the target languages are enabled