Install the bot

Use the invite link from the top of this page. Discord asks which server to add translAPE to; you need the Manage Server permission there.

Accept the permissions Discord lists. They are explained in the next section — translAPE asks for nothing it does not use.

After the invite the bot appears in your member list and is ready for setup. It does nothing until you run /setup.

Permissions

• Read messages — to see what needs translating
• Send messages and manage webhooks — translations are posted under the original author's name and avatar
• Manage roles — to hand out the language roles it creates
• Manage channels — only needed for language channels, to create categories and set descriptions
• Add reactions — for flag translation

Run /setup

/setup

The bot checks its own permissions first. If something is missing it says so in plain language and stops — nothing half-finished is left behind.

If everything is in place it creates a #languages channel, posts the language picker there, and reports back. That is the entire configuration. There is no list of language codes to fill in and no channel to prepare.

From this point on, every channel translAPE can see is translated inline: the translation appears directly under the original message.

Members pick languages

In #languages your members answer two questions.

Which language do you write?

One choice, required. This tells the bot what to translate from when you post.

Which do you also understand?

Several choices, optional — and the more useful of the two. If everyone who speaks German also understands English, an English message needs no German line. Every member who fills this in makes the channel quieter for everyone.

Anyone can change their own selection at any time with /language.

Translation modes

Inline — the default

Everyone stays in one channel. The translation is appended under the original message as a compact block. Nothing to create, ready in under a minute.

Up to three translations are shown directly. Beyond that, the most needed languages appear and the rest sit behind a button — click it and the remaining translations appear for you alone.

Not everything gets translated. ok, gg, emoji and player names are left alone, because a translation would add nothing.

Language channels

For larger alliances. Each language gets its own category, and members only see the one matching their language. Their server looks monolingual to them.

translAPE suggests the switch when your server passes about five languages. It never rearranges your server on its own.

Language channels

/channels add #general

The bot detects which language the channel is in, shows you what it will create, and waits for confirmation:

• one category per language — 🇬🇧 ENGLISH, 🇫🇷 FRANÇAIS, …
• inside each, a channel with the same name as the original
• category visibility tied to the language roles, so each member sees only their own

Adding a second source channel later puts a matching channel into every existing category. The structure grows with you instead of piling up names like #general-fr.

Use /channels list to see all pairs and /channels remove to stop mirroring. Removing archives the channels rather than deleting them — conversations are never lost.

Glossary

Every community has words an outsider gets wrong. R4 is a rank, not a car. Your alliance name is not a sentence. The glossary teaches translAPE those words once, and the rule applies to every language at once.

Adding a term

The quickest way is from the message where the mistake showed up: right-click it, choose Apps → translAPE · Add term to glossary, then pick a rule.

Or add it directly:

/glossary add R4

Three kinds of rules

• Never translate — player names, ranks, server nicknames. The term stays exactly as written.
• Fixed wording — your own translation for a term, used consistently instead of whatever fits the sentence.
• Explain the meaning — a short note like “rank in the alliance hierarchy, not a vehicle”. The model understands the note and applies it in context. A conventional translation service cannot do this at all.

The glossary holds up to 100 terms on the Alliance plan. That is not an arbitrary cap: the glossary travels with every translation request, and beyond a few hundred entries a model starts overlooking some. Fewer, well-chosen terms work better than a long list.

Members with server management permissions can edit it. Everyone can read it with /glossary list.

Sharing glossaries

The terms your alliance needs are mostly the terms every alliance in the same game needs. So you can publish your glossary and pick up someone else's.

/glossary share topwar
/glossary import topwar

Publishing makes your list available under a name of your choosing. Importing copies the entries into your own glossary — you can then edit or remove any of them, because it is your copy, not a subscription.

When a shared glossary you imported gains new terms, translAPE tells you and asks whether to take them over. Nothing is added behind your back.

This is how the game glossaries get built — by the servers that actually play the game, not by us guessing at vocabulary.

Flag translation

React to any message with a country flag and translAPE replies with that translation. It works in every channel, on every plan, and needs no setup at all.

Useful for one-off cases: a message in a channel that is not translated, or a language nobody in the server has registered.

To keep certain channels free of it, use /blacklist add.

All commands

Plus one right-click action: Apps → translAPE · Add term to glossary on any message.

Plans and allowance

The free plan covers roughly 340 messages per month, which is 20,000 characters. There is no limit on languages and no feature is held back — the only thing that runs out is the message allowance.

Every translation counts on its own. A message translated into three languages uses three translations' worth, so more languages consume the allowance faster. Repeated phrases are cached and cost nothing the second time.

The Alliance plan removes the counting entirely and adds the glossary, mirrored channels and priority support. It is bought and cancelled inside Discord — see Pricing.

When the allowance runs out

Automatic translation pauses until the next month. Flag translation keeps working, the bot stays in your server, and your configuration is untouched. Nothing is lost.

Check anytime with /usage.

Data and privacy

Message content is read to translate it and is not stored in readable form. The translation cache keeps a cryptographic fingerprint of the source text, not the text itself, so repeated phrases can be recognised without keeping what anyone wrote.

Stored are: server and channel IDs, the language each member selected, message IDs linking originals to translations, usage counters, and your plan.

Remove the bot from your server and the associated configuration is deleted. Full details in the privacy policy.

Frequently asked

Troubleshooting

Bot installieren

Nutze den Einladungslink oben auf dieser Seite. Discord fragt, auf welchen Server translAPE soll; dort brauchst du das Recht Server verwalten.

Bestätige die angefragten Rechte. Sie sind im nächsten Abschnitt erklärt — translAPE fragt nichts an, was es nicht auch nutzt.

Nach der Einladung erscheint der Bot in der Mitgliederliste. Er tut nichts, bis du /setup ausführst.

Berechtigungen

• Nachrichten lesen — um zu sehen, was zu übersetzen ist
• Nachrichten senden und Webhooks verwalten — Übersetzungen erscheinen unter Namen und Avatar des Absenders
• Rollen verwalten — um die selbst angelegten Sprachrollen zu vergeben
• Kanäle verwalten — nur für Sprachkanäle nötig, um Kategorien anzulegen und Beschreibungen zu setzen
• Reaktionen hinzufügen — für die Flaggen-Übersetzung

/setup ausführen

/setup

Der Bot prüft zuerst seine eigenen Rechte. Fehlt etwas, sagt er es im Klartext und bricht ab — es bleibt nichts halb Fertiges zurück.

Passt alles, legt er den Kanal #sprachen an, postet dort die Sprachauswahl und meldet Vollzug. Das ist die ganze Konfiguration. Es gibt keine Liste von Sprachcodes auszufüllen und keinen Kanal vorzubereiten.

Ab jetzt wird in jedem Kanal, den translAPE sieht, inline übersetzt: Die Übersetzung erscheint direkt unter der Originalnachricht.

Mitglieder wählen ihre Sprache

In #sprachen beantworten deine Leute zwei Fragen.

Welche Sprache schreibst du?

Eine Auswahl, Pflicht. Damit weiß der Bot, aus welcher Sprache er übersetzen muss, wenn du schreibst.

Welche verstehst du außerdem?

Mehrere Angaben möglich, freiwillig — und die nützlichere von beiden. Wenn alle Deutschsprachigen auch Englisch verstehen, braucht eine englische Nachricht keine deutsche Zeile. Jeder, der das ausfüllt, macht den Kanal für alle ruhiger.

Die eigene Auswahl lässt sich jederzeit mit /language ändern.

Betriebsarten

Inline — der Standard

Alle bleiben in einem Kanal. Die Übersetzung hängt als kompakter Block unter der Originalnachricht. Nichts anzulegen, in unter einer Minute startklar.

Bis zu drei Übersetzungen erscheinen direkt. Darüber hinaus werden die am meisten gebrauchten Sprachen angezeigt, der Rest liegt hinter einem Knopf — ein Klick zeigt die übrigen Übersetzungen nur dir.

Es wird nicht alles übersetzt. ok, gg, Emojis und Spielernamen bleiben stehen, weil eine Übersetzung nichts beitragen würde.

Sprachkanäle

Für größere Allianzen. Jede Sprache bekommt eine eigene Kategorie, und jedes Mitglied sieht nur die zu seiner Sprache. Der Server wirkt für jeden einsprachig.

translAPE schlägt den Wechsel vor, sobald der Server etwa fünf Sprachen überschreitet. Es ändert deine Struktur nie von selbst.

Sprachkanäle

/channels add #general

Der Bot erkennt, in welcher Sprache der Kanal geschrieben wird, zeigt dir, was er anlegen würde, und wartet auf Bestätigung:

• eine Kategorie je Sprache — 🇬🇧 ENGLISH, 🇫🇷 FRANÇAIS, …
• darin jeweils ein Kanal mit demselben Namen wie das Original
• Sichtbarkeit der Kategorien an die Sprachrollen gekoppelt, sodass jeder nur seine eigene sieht

Kommt später ein zweiter Quellkanal dazu, erscheint er in jeder bestehenden Kategorie. Die Struktur wächst mit, statt sich zu Namen wie #general-fr aufzutürmen.

Mit /channels list siehst du alle Paare, mit /channels remove beendest du die Spiegelung. Beim Entfernen werden die Kanäle archiviert statt gelöscht — Gespräche gehen nie verloren.

Glossar

Jede Community hat Begriffe, die ein Außenstehender falsch versteht. R4 ist ein Rang, kein Auto. Euer Allianzname ist kein Satz. Das Glossar bringt translAPE diese Wörter einmal bei — und die Regel gilt sofort für alle Sprachen.

Begriff hinzufügen

Am schnellsten aus der Nachricht heraus, in der der Fehler auffällt: Rechtsklick darauf, dann Apps → translAPE · Begriff ins Glossar, anschließend eine Regel wählen.

Oder direkt:

/glossary add R4

Drei Arten von Regeln

• Nie übersetzen — Spielernamen, Ränge, Servernamen. Der Begriff bleibt exakt so stehen.
• Feste Entsprechung — eure eigene Übersetzung für einen Begriff, durchgängig verwendet statt dem, was gerade in den Satz passt.
• Bedeutung erklären — eine kurze Notiz wie „Rang in der Allianz-Hierarchie, kein Fahrzeug". Das Modell versteht die Notiz und wendet sie im Zusammenhang an. Ein klassischer Übersetzungsdienst kann das gar nicht.

Im Alliance-Tarif fasst das Glossar bis zu 100 Begriffe. Das ist keine willkürliche Grenze: Das Glossar wird bei jeder Übersetzung mitgeschickt, und ab einigen Hundert Einträgen übersieht ein Modell zuverlässig welche. Wenige, gut gewählte Begriffe wirken besser als eine lange Liste.

Bearbeiten dürfen Mitglieder mit Serververwaltungsrechten. Ansehen kann es jeder mit /glossary list.

Glossare teilen

Die Begriffe, die eure Allianz braucht, sind größtenteils dieselben, die jede Allianz im selben Spiel braucht. Deshalb kannst du dein Glossar veröffentlichen und das von anderen übernehmen.

/glossary share topwar
/glossary import topwar

Beim Veröffentlichen wird deine Liste unter einem selbst gewählten Namen verfügbar. Beim Importieren werden die Einträge in dein eigenes Glossar kopiert — du kannst sie danach ändern oder löschen, denn es ist deine Kopie, kein Abonnement.

Bekommt ein importiertes Glossar neue Begriffe, meldet translAPE das und fragt, ob du sie übernehmen willst. Es wird nichts hinter deinem Rücken ergänzt.

So entstehen die Spiel-Glossare — durch die Server, die das Spiel tatsächlich spielen, statt durch unser Raten am Wortschatz.

Flaggen-Übersetzung

Reagiere auf eine beliebige Nachricht mit einer Länderflagge, und translAPE antwortet mit der Übersetzung. Das funktioniert in jedem Kanal, in jedem Tarif und ohne jede Einrichtung.

Praktisch für Einzelfälle: eine Nachricht in einem nicht übersetzten Kanal oder eine Sprache, die niemand im Server eingetragen hat.

Um einzelne Kanäle davon freizuhalten, nutze /blacklist add.

Alle Befehle

Dazu eine Aktion per Rechtsklick: Apps → translAPE · Begriff ins Glossar auf jeder Nachricht.

Tarife und Kontingent

Der Gratis-Tarif deckt rund 340 Nachrichten im Monat ab, das entspricht 20.000 Zeichen. Es gibt keine Begrenzung auf bestimmte Sprachen und keine zurückgehaltene Funktion — zu Ende geht allein das Nachrichten-Kontingent.

Jede Übersetzung zählt einzeln. Eine Nachricht in drei Sprachen verbraucht drei Übersetzungen, mehr Sprachen zehren also schneller am Kontingent. Wiederkehrende Formulierungen werden zwischengespeichert und kosten beim zweiten Mal nichts.

Der Alliance-Tarif hebt die Zählung ganz auf und ergänzt Glossar, gespiegelte Kanäle und bevorzugte Bearbeitung von Anfragen. Kauf und Kündigung laufen über Discord — siehe Preise.

Wenn das Kontingent aufgebraucht ist

Die automatische Übersetzung pausiert bis zum nächsten Monat. Die Flaggen-Übersetzung funktioniert weiter, der Bot bleibt auf dem Server, und deine Konfiguration bleibt unangetastet. Es geht nichts verloren.

Prüfen kannst du das jederzeit mit /usage.

Daten und Datenschutz

Nachrichteninhalte werden zum Übersetzen gelesen und nicht im Klartext gespeichert. Der Übersetzungsspeicher hält eine kryptografische Prüfsumme des Ausgangstextes, nicht den Text selbst — so lassen sich wiederkehrende Formulierungen erkennen, ohne aufzubewahren, was jemand geschrieben hat.

Gespeichert werden: Server- und Kanal-Kennungen, die von jedem Mitglied gewählte Sprache, Nachrichten-Kennungen zur Verknüpfung von Original und Übersetzung, Nutzungszähler und der gebuchte Tarif.

Wird der Bot vom Server entfernt, wird die zugehörige Konfiguration gelöscht. Einzelheiten in der Datenschutzerklärung.

Häufige Fragen

Fehlersuche