{"id":21610766,"url":"https://github.com/liebki/ollama-translator","last_synced_at":"2025-04-11T05:22:28.306Z","repository":{"id":238663379,"uuid":"797162712","full_name":"liebki/ollama-translator","owner":"liebki","description":"A minecraft 1.21 spigot plugin allows to easily break language barriers by using ollama on the server to translate all messages into a specfic target language.","archived":false,"fork":false,"pushed_at":"2025-03-16T21:23:10.000Z","size":36,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-25T03:25:44.621Z","etag":null,"topics":["large-language-models","llama3","llm","minecraft-plugin","spigot-plugin","translation","translator-tool"],"latest_commit_sha":null,"homepage":"https://www.spigotmc.org/resources/ollama-translator.116666/","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/liebki.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-05-07T10:09:22.000Z","updated_at":"2025-03-16T21:19:48.000Z","dependencies_parsed_at":"2024-05-07T11:32:25.412Z","dependency_job_id":"1e4f24c8-4cc9-4cd5-bdec-3f22c0e0ceb9","html_url":"https://github.com/liebki/ollama-translator","commit_stats":null,"previous_names":["liebki/ollama-translator"],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/liebki%2Follama-translator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/liebki%2Follama-translator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/liebki%2Follama-translator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/liebki%2Follama-translator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/liebki","download_url":"https://codeload.github.com/liebki/ollama-translator/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248346363,"owners_count":21088445,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["large-language-models","llama3","llm","minecraft-plugin","spigot-plugin","translation","translator-tool"],"created_at":"2024-11-24T21:09:30.141Z","updated_at":"2025-04-11T05:22:28.293Z","avatar_url":"https://github.com/liebki.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Ollama Translator Plugin\n\n## Description\nThis Spigot Minecraft plugin, built with the currently newest Minecraft version 1.20.6, 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.\n\n\n## Java version\nFrom now on with minecraft 1.21 minecraft/spigot etc. use Java 21!\n\n\n## Features\n- \"Real-time\" translation of all player messages (all messages longer than five characters).\n- All translated messages show the original message when hovering over them.\n- Configurable settings.\n- Easy integration with Ollama API.\n- (ONLY) Support for local hosting of translation models (for now).\n- Quick setup and minimal configuration.\n\n\n## Setup\nTo set up the Ollama Translator plugin, follow these steps:\n\n1. **Install Ollama**: Ollama is required for translation functionality. Visit [Ollama GitHub page](https://github.com/ollama/ollama?tab=readme-ov-file#ollama) to download and install Ollama on your server.\n\n2. **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.\n\n3. **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.\n\n4. **Configure Plugin**: Configure the `options.yml` file for the Ollama Translator plugin according to your preferences and server setup.\n\n5. **Restart/Reload Server**: Restart or reload your Spigot Minecraft server to apply the changes.\n\n6. **Start Translating**: Once the setup is complete, the plugin will automatically translate player messages as per the configured settings.\n\n\n## Plugin Configuration\n\nBefore deploying the plugin, ensure you configure the following parameters in the `options.yml` file:\n\n```yaml\ndonottouch:\n  configexists: true\n\nollama:\n  secondstimeout: 20\n  modelname: llama3:8b-instruct-q6_K\n  apiaddress: http://localhost:11434/\n\ncooldown:\n  enabled: true\n  milliseconds: 1000\n  message: §cPlease wait...\n\ntranslation:\n  canceloriginalmessage: true\n  notify: true\n  cancelmessage: §7Your message is being translated, please wait...\n  targetlanguage: english\n  broadcastmessage: '§r%PLAYER% §r: §r§b%TRANSLATION%'\n```\n\n## Usage\n0. Start ollama and download the model of choice\n1. Install the plugin in your Spigot Minecraft server's plugins directory.\n2. Configure the `options.yml` file according to your preferences.\n3. Restart/Reload the server to apply the changes.\n4. Players' messages will now be automatically translated as per the configured settings.\n\n\n## Note\n- ALL messages (longer than five characters) are translated, also native ones, so this plugin is really only for servers with a mixed-language player-base.\n- The bigger the model the better the outcome, mistral showed to be very good but sometimes it is acting weird, llama3:8b-instruct-q6_K was very good but still not perfect.\n- 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.\n- You don't need a 30gb (file size) model if e.g. llama3:8b-instruct-q6_K produces a good outcome then it is alright, I tested mistral and llama3 so test it yourself.\n\n## Todo\n- Implement structured outputs for better translations!\n\n## Disclaimer\nThis plugin is provided as is without any warranty. The developer holds no responsibility for any issues or damages arising from its usage.\n\n#### Enjoy breaking down language barriers and creating a more inclusive gaming environment with the Spigot Minecraft Ollama Translator plugin!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fliebki%2Follama-translator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fliebki%2Follama-translator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fliebki%2Follama-translator/lists"}