Getting Started

Add Alyngz to a Discord server and configure the first translation flow.

Alyngz is designed as a hosted Discord product. Server admins configure it from inside Discord, without running infrastructure or managing bot tokens.

Alyngz is a hosted Discord bot. You do not need to install software, run a server, or create your own Discord application.

1. Add Alyngz to Discord

Add Alyngz to Discord

  1. Click Add Alyngz to Discord.
  2. Choose the Discord server you manage.
  3. Review and approve the requested permissions.
  4. Return to Discord.

2. Open Alyngz Settings

In Discord, run:

/alyngz admin settings

From the admin hub you can open:

  • Translation Settings for flag translation behavior.
  • Channels/Mirror Settings for multilingual channel groups.

Admin settings are private to the admin who opened them.

3. Configure Translation

Open Translation Settings, then choose Flag Translation.

Available modes:

  • Off - flag reactions are ignored.
  • Standard - a flag reaction posts a compact public translation in the channel.
  • Clean Chat - a flag reaction creates a short confirmation prompt, then sends the translation privately when the requester confirms.

You can also configure:

  • Flag Translation Timing - how long temporary prompts or results remain visible.
  • Flag Reaction Cleanup - optionally remove only the triggering flag reaction after Alyngz handles it, where permissions allow.
  • Clean Chat Completion - keep completion messages, delete them after TTL, or delete them immediately for cleaner announcement channels.
  • Flag Translation Status - review safe troubleshooting information without exposing message content or translated text.

4. Configure Channel Mirroring

For multilingual channel groups, open Channels/Mirror Settings.

Use mirror groups when a community keeps separate language channels and wants messages translated across them. Each channel in a group gets a configured language, and Alyngz keeps supported messages aligned across configured languages.

At a high level:

  1. Create a mirror group.
  2. Add equivalent language channels.
  3. Assign each channel’s language.
  4. Let Alyngz keep supported messages aligned across the configured channels.

See Commands and Use Cases for more examples.

5. Check Permissions

Run:

/alyngz mirror permissioncheck

Ready means Alyngz has the required channel permissions for core translation and mirroring behavior. Optional notices do not mean installation failed.

Optional: Automatic Reaction Cleanup

Alyngz can translate normally without Manage Messages.

If you want Alyngz to automatically remove the flag reaction that triggered a translation, grant Manage Messages in the relevant channel.

If this permission is missing:

  • translation still works;
  • Standard mode still works;
  • Clean Chat still works;
  • Channel Mirroring remains available;
  • only automatic triggering-reaction cleanup is unavailable.

Use External Emojis is also optional. Without it, standard Unicode flags and normal supported translation flows still work, but cross-server custom emoji mirroring may be limited.

6. Test Flag Translation

Post a normal message in a server channel where Alyngz can read and send messages. React to that message with a supported country flag, such as German or Romanian.

In Standard mode, Alyngz posts a compact public translation. In Clean Chat mode, Alyngz posts a short prompt such as “Translate to German?” and sends the translation privately after the requester confirms.

7. Need Help?

Open Flag Translation Status from Translation Settings when flag reactions do not behave as expected. For configured mirror groups, use /alyngz mirror permissioncheck to see which channels are ready and which permissions need attention.

For command details, continue to the Commands page.