## 描述
这个 Spigot 插件，使用当前最新版本的 Minecraft 1.20.6 构建，利用 Ollama 和 Ollama4j 打破 Minecraft 服务器上的语言障碍。无论玩家使用英语、西班牙语还是任何其他语言，他们都可以轻松互动，从而创造更好的社区和环境。
## Java 版本
从现在起，对于 Minecraft 1.21、Minecraft/Spigot 等，请使用 Java 21！
## 功能
- 所有玩家消息的“实时”翻译（所有消息长度超过五个字符）。
- 所有翻译后的消息在悬停时会显示原始消息。
- 可配置设置。
- 与 Ollama API 轻松集成。
- (仅限) 支持本地托管翻译模型（目前仅限）。
- 快速设置和最小配置。
## 设置
要设置 Ollama Translator 插件，请按照以下步骤操作：
1. **安装 Ollama**: Ollama 用于翻译功能是必需的。请访问 [Ollama GitHub 页面](https://github.com/ollama/ollama?tab=readme-ov-file#ollama) 以在您的服务器上下载和安装 Ollama。
2. **拉取模型**: 安装 Ollama 后，拉取一个翻译模型，例如 Mistral 或 LLAMA2/3。请务必遵循 Ollama 提供的说明来下载和配置所需的模型。
3. **启动 Ollama 应用程序**: 确保 Ollama 应用程序在您的服务器上运行。检查 API 是否可以在插件配置的 `options.yml` 文件中指定的地址下访问。
4. **配置插件**: 根据您的喜好和服务器设置，配置 Ollama Translator 插件的 `options.yml` 文件。
5. **重启/重新加载服务器**: 重启或重新加载您的 Spigot Minecraft 服务器以应用更改。
6. **开始翻译**: 设置完成后，插件将根据配置的设置自动翻译玩家消息。
## 插件配置
在部署插件之前，请确保在 `options.yml` 文件中配置以下参数：
```yaml
donottouch:
configexists: true
ollama:
secondstimeout: 20
modelname: llama3:8b-instruct-q6_K
apiaddress: http://localhost:11434/
cooldown:
enabled: true
milliseconds: 1000
message: §c请等待...
translation:
canceloriginalmessage: true
notify: true
cancelmessage: §7您的消息正在翻译中，请等待...
targetlanguage: english
broadcastmessage: '§r%PLAYER% §r: §r§b%TRANSLATION%'
```
## 使用方法
0. 启动 ollama 并下载您选择的模型
1. 将插件安装到您的 Spigot Minecraft 服务器的 plugins 目录中。
2. 根据您的喜好配置 `options.yml` 文件。
3. 重启/重新加载服务器以应用更改。
4. 玩家的消息现在将根据配置的设置自动翻译。
## 注意事项
- 所有消息（长度超过五个字符）都会被翻译，包括母语消息，因此这个插件真正适用于拥有混合语言玩家群体的服务器。
- 模型越大，结果越好。Mistral 显示出非常好，但有时会表现出奇怪的行为。 llama3:8b-instruct-q6_K 效果很好，但仍然不完美。
- 请注意，LLM/SLM 需要（大量的）内存，对于小型模型至少需要 5-8 GB，对于中型模型则需要 15-30 GB，甚至更多。
- 如果例如 llama3:8b-instruct-q6_K 产生良好的结果，则您不需要 30gb（文件大小）的模型，没问题。我测试了 mistral 和 llama3，所以请您自己测试一下。
## 对其他加载器支持
- 未来将根据需要提供对其他加载器的支持