LLM-Translator

English

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

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

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

介绍

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

支持翻译游戏内：

玩家对话信息
木牌文字
讲台上的书籍信息

配置

插件第一次加载成功后，将在 /config/llm-translator/ 文件夹下生成配置文件
配置文件默认使用 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,
    "look_translate_max_distance": 6.0,
    "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/生电术语 SOP 提示词
look_translate_max_distance	float	`6.0`	准星翻译的最大射线检测距离（格），需要开启 RCON
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	`""`	转发服务器认证密码（如需要）

配置说明

基础需求：只需填写 api_key 即可使用默认的 DeepSeek 模型进行玩家对话中英翻译
其他语言支持：通过修改 first_language 和 secondary_language 可支持其他语言对的翻译
多模型支持：更换 base_url 和 model 可切换到其他 LLM 服务商
系统提示词自定义：通过 enable_system_prompt 可控制是否使用系统提示词，system_prompt 可自定义翻译提示词，支持 {first_language} 和 {secondary_language} 占位符，占位符会展开为可读语言名加语言代码（例如 Chinese (Simplified) (zh_cn)）。内置提示词已精简并明确翻译方向；首次加载新版本时，若检测到未修改过的旧版内置提示词，插件会自动替换为新版，自定义提示词不受影响。
聊天翻译信息转发功能：玩家信息转发至其他服务器（通常适用于Velocity等代理端多子服且已经配置了聊天信息转发的服务器），请设置 is_proxy_to_other_servers 为 true 并配置 proxy_servers 列表

使用说明

游戏内操作提示使用英文；!!help 中的帮助条目为中英双语。

玩家对话翻译

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

木牌信息及书籍信息翻译

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

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

也可以直接光标直接指向木牌或讲台上的书，输入不带参数的 !!tr，插件会沿视线方向检测光标指向的目标并翻译。该方式需要在 MCDR 配置中开启 RCON（与服务器 server.properties 中的 enable-rcon、rcon.port、rcon.password 保持一致），最大检测距离由 look_translate_max_distance 控制。

其他

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