Ollama Translator - Make your server speak in one language

Ollama Translator Plugin

If you want/need other Minecraft versions, please tell so in the discussion or on GitHub and I'll add those.

Description
This Spigot Minecraft plugin, built with Minecraft version 26.1.2, uses Ollama and Ollama4j to break language barriers on your Minecraft server. Whether players speak English, Spanish, or any other language, they can interact effortlessly, creating a better community and environment.

Features
- Real-time translation of all player messages (longer than five characters).
- Configurable settings.
- Easy integration with Ollama API.
- (ONLY) Support for local hosting of translation models (for now).
- Quick setup and minimal configuration.

Setup

Before proceeding with the setup, ensure you have the necessary knowledge and permissions to install and configure Ollama on your server. If you lack the know-how, don't have access to install Ollama, or lack the necessary permissions, you won't be able to utilize this plugin effectively. Ollama is a crucial component for the translation functionality provided by this plugin.

To set up the Ollama Translator plugin, follow these steps:
[*] Install Ollama: Ollama is required for translation functionality. Visit Ollama GitHub page to download and install Ollama on your server.
[*] Pull a Model: After installing Ollama, pull a translation model such as Mistral or LLAMA2/3. Make sure to follow the instructions provided with Ollama to download and configure the desired model.
[*] Start Ollama Application: Ensure that the Ollama application is running on your server. Check that the API is reachable under the address specified in the options.yml file configured for the plugin.
[*] Configure Plugin: Configure the options.yml file for the Ollama Translator plugin according to your preferences and server setup.
[*] Restart/Reload Server: Restart or reload your Spigot Minecraft server to apply the changes.
[*] Start Translating: Once the setup is complete, the plugin will automatically translate player messages as per the configured settings.

Plugin Configuration
Before deploying the plugin, ensure you configure the following parameters in the options.yml file:

donottouch:
  configexists: true

ollama:
  secondstimeout: 30
  modelname: granite4:1b-h-q8_0
  apiaddress: http://localhost:11434/

cooldown:
  enabled: true
  milliseconds: 2000
  message: §cPlease wait...

translation:
  canceloriginalmessage: true
  notify: true
  cancelmessage: §7Your message is being translated, please wait...
  targetlanguage: english
  broadcastmessage: '§r%PLAYER% §r: §r§b%TRANSLATION%'

Usage
0. Start ollama and download the model of choice
1. Install the plugin in your Spigot Minecraft server's plugins directory.
2. Configure the options.yml file according to your preferences.
3. Restart/Reload the server to apply the changes.
4. Players' messages will now be automatically translated as per the configured settings.

Note

• The bigger the model the better the outcome, Mistral showed to be very good but sometimes it is acting weird. LLAMA3:8b (instruct-fp16) was amazing.

• Please note that LLM/SLM require (a significant amount of) memory, with a minimum of 5-8 GB for small and 15-30 GB for middle-sized models or even more.

• You don't need a 30gb (file size) model if LLAMA3:8b, for example, produces a good outcome then it is alright, I tested Mistral and LLAMA3 so test it yourself.

Disclaimer
This plugin is provided as is without any warranty. The developer holds no responsibility for any issues or damages arising from its usage.

Enjoy breaking down language barriers and creating a more inclusive gaming environment with the Spigot Minecraft Ollama Translator plugin!

Icon provided by: https://uxwing.com