Repository files navigation

An automatic translation plugin for Dalamud with support for multiple translation services.

• Auto Traslate Chat

  

  • Select between multiple translation services:
    • LibreTranslate Free Open Source, Translation Engine
      • Mirrors listed on the LibreTranslate Repo added by default.
      • Support to connect to a custom url for self hosted instance.
      • It's possible a node will be setup specifically for this project.
    • DeepL Supports Free Translation of 500,000 characters/month with signup.
    • Planned Support forMicrosoft Translator Supports Free Translation of 2,000,000 characters/month with signup.

• Translation Command to translate messages before you send them.

• Langauge support for all officially supported languages by FFXIV.

• Ability to select which channels of chat will be automatically translated.

  • Does not support System, Battle, or Event channels.

• Planned support for all languages supported by the language engine.

As of now, this plugin is not officially supported by the Dalamud project and will require 3rd-party plugin respository to be added.

Link to Plugin Usage Documentation

This plugin requires Dalamud in order to work.

Dalamud is a plugin development framework for Final Fantasy XIV that can be installed withXIVLauncher.

This step if only if you'd like to modify or build the code yourself. Skip to Activating in-game if you just want to install.

1. Open upWhatchaSay.sln in your C# editor of choice (likelyVisual Studio 2022 orJetBrains Rider).
2. Build the solution. By default, this will build aDebug build, but you can switch toRelease in your IDE.
3. The resulting plugin can be found atWhatchaSay/bin/x64/Debug/WhatchaSay.dll (orRelease if appropriate.)

1. Launch the game and use/xlsettings in chat orxlsettings in the Dalamud Console to open up the Dalamud settings.

   • In here, go toExperimental, and add the 3rd-party repository.
   • Repository:https://raw.githubusercontent.com/Deccentric/Dalamud-Depot/main/repo.json

   

2. Next, use/xlplugins (chat) orxlplugins (console) to open up the Plugin Installer.

   • Search forWhatchaSay and Install!

3. You should now be able to use/whatchasay (chat)

Using/whatchasay or opening the plugin's settings will open the config window.

The config allows you to choose a translation service. If you use DeepL you will need to enter your API Key. If you do not have an API Key you can make an account and use itfor up to 500,000 characters for free every month.

Your DeepL account will need a credit card to sign up. I hope an API Key will not be necessary in the future.

This Configuration allows you to choose a language (Supports the officially supported langauges by FFXIV).I will add all languages available in the langauge translation engines in a future update.

Using/translate will bring up a basic translation window.

Once you clickTranslate whatever in the `Text to Translate`` will be translated and copied to your clipboard up to 256 characters.

This is only required if you'd like to use the DeepL API option.

Step 1: Start Creating Your Account

Step 2: Select the Free Plan

Step 3: Go to Your Account

Step 4: Select the 'Account' Tab

Step 5: Copy your API Key

If any bugs related strictly to the plugin are found, please open an issue on the project. Please do not create an issue related to an inaccurate translation as that is related to the selected translation engine. If you'd like to contribute code to this repository, please create a new branch and create a pull request when completed. I will review as soon as I have time.

During the development of this project I usedDalamud.DiscordBridge as an example for how to handle messages in a concurrent way.

SimplePlugin was used as a base, and theDalamudAPI was referenced.