LLM-Translator

English

本插件的开发灵感来源于 MCDR插件 SimpleTranslator - 插件仓库 - MCDReforged

PawTeam进行了修改： 现在无视聊天前缀t的要求，默认发消息会被翻译 以及修复 velocitymcdrcommand和velocity_chat 插件冲突的问题

使用大语言模型进行提供游戏内玩家对话翻译，木牌文字翻译，书籍翻译。

插件默认使用 deepseek-chat 大语言模型进行翻译工作。

介绍

当服务器内有不同语种玩家时，使用此插件可以良好改善沟通情况。玩家聊天信息支持多服同步转发。使用大语言模型翻译，精准度相较传统机器翻译准确率更高，适应性更强。

支持翻译游戏内：

• 玩家对话信息

• 木牌文字

• 讲台上的书籍信息

配置

1. 插件第一次加载成功后，将在 /config/llm-translator/ 文件夹下生成配置文件

2. 配置文件默认使用 deepseek-chat 模型进行中英翻译，若符合此需求，仅需在api_key处填写你的api密钥即可使用。否则请参考下方配置文件进行修改。

{
    "first_language": "zh_cn",
    "secondary_language": "en_us",
    "base_url": "https://api.deepseek.com",
    "model": "deepseek-chat",
    "api_key": "enter-your-api-key",
    "enable_system_prompt": true,
    "system_prompt": "将以下句子{first_language}和{secondary_language}互译，翻译准确达意。注意Minecraft这款游戏中特有名词翻译正确，只返回翻译结果，不需要任何解释",
    "is_proxy_to_other_servers": false,
    "proxy_servers": [
        {
            "address": "127.0.0.1",
            "port": 25575,
            "password": ""
        },
        {
            "address": "127.0.0.1",
            "port": 25576,
            "password": ""
        }
    ]
}

字段名	数据类型	默认值	说明
first_language	string	"zh_cn"	主要语言，通常设置为用户的母语或主要使用语言
secondary_language	string	"en_us"	次要语言，需要翻译成的目标语言
base_url	string	"https://api.deepseek.com"	基础请求地址
model	string	"deepseek-chat"	语言模型名称
api_key	string	无默认值	API 访问密钥
enable_system_prompt	boolean	true	是否启用系统提示词
system_prompt	string	"将以下句子{first_language}和{secondary_language}互译，翻译准确达意。注意Minecraft这款游戏中特有名词翻译正确，只返回翻译结果，不需要任何解释"	自定义系统提示词，支持{first_language}和{secondary_language}占位符
is_proxy_to_other_servers	boolean	false	是否转发聊天翻译信息至其他服务器
proxy_servers	list[dict]	[]	转发服务器配置列表。需要启用rcon

proxy_servers 的rcon服务器配置：

字段名	数据类型	默认值	说明
address	string	"127.0.0.1"	转发服务器地址
port	int	无默认值	转发服务器端口号
password	string	""	转发服务器认证密码（如需要）

配置说明

1. 基础需求：只需填写 api_key 即可使用默认的 DeepSeek 模型进行玩家对话中英翻译
2. 其他语言支持：通过修改 first_language 和 secondary_language 可支持其他语言对的翻译
3. 多模型支持：更换 base_url 和 model 可切换到其他 LLM 服务商
4. 系统提示词自定义：通过 enable_system_prompt 可控制是否使用系统提示词，system_prompt 可自定义翻译提示词，支持 {first_language} 和 {secondary_language} 占位符
5. 聊天翻译信息转发功能：玩家信息转发至其他服务器（通常适用于Velocity等代理端多子服且已经配置了聊天信息转发的服务器），请设置 is_proxy_to_other_servers 为 true 并配置 proxy_servers 列表

使用说明

玩家对话翻译

游戏内聊天信息添加前缀 t 和空格 发送即可翻译。

木牌信息及书籍信息翻译

书籍信息：书需要放在讲台上才能翻译

使用指令 !!tr <x> <y> <z> 即可翻译（ 参数为木牌或讲台上书籍坐标，参数可使用 ~ 来代指当前玩家坐标）

其他

初次开发插件有不熟练之处或不完善之处。若使用时有bug或其他建议，欢迎至Github插件源仓库处提交Issue。