服务器本地化器

服务器本地化器

一个强大的Minecraft服务器内容本地化AI翻译模组,让你轻松畅享国际服务器!

社交

Logo

🌐 ServerLocalizer

Minecraft Forge Release Sponsor 中文文档 (Chinese Readme)

🎮 一款强大的 Minecraft 服务器内容本地化 AI 翻译模组,让你轻松畅玩国际服务器!

📖 简介

ServerLocalizer 是一款适用于 Minecraft 1.8.9 的 Forge 模组,通过拦截服务器数据包并调用 AI 大语言模型 API,提供高质量、可自定义的游戏内容翻译。它帮助你克服语言障碍,在国际服务器上享受无缝的游戏体验。

✨ 功能特性

核心翻译功能

  • 物品翻译:自动翻译物品名称和描述。
  • 聊天翻译:点击聊天消息旁的 [T] 按钮即可即时翻译任意聊天消息。
  • 样式保留:完整保留物品和聊天中的颜色代码与文本格式。

智能与效率

  • 流式响应:启用后,翻译结果将逐字显示,提供更流畅的交互体验,无需等待。
  • 智能缓存:自动缓存翻译结果,避免重复请求,节省资源。
  • 并发处理:使用线程池处理多个翻译请求,确保游戏性能流畅。

用户体验

  • 可视化配置 GUI:提供现代化的图形界面,方便用户轻松调整所有设置。

📥 安装指南

  1. 前置条件:

    • Minecraft 1.8.9
    • Forge 11.15.1.2318 或更高版本
  2. 安装步骤:

    1. 从 Releases 页面下载最新的 ServerLocalizer-x.x.jar。
    2. 将下载的 .jar 文件放入你的 .minecraft/mods 文件夹。
    3. 启动游戏即可开始使用该模组。

🎮 使用方法

  1. 打开配置:
    • 在主菜单或暂停菜单中,点击 "Mods" -> 找到 "ServerLocalizer" -> 点击 "Config" 按钮。
    • 或者,使用游戏内命令 /serverlocalizer config。
  2. 配置 API:
    • 在 "Item Translation" 和 "Chat Translation" 标签页中,输入你的 API 服务地址(Base URL)、API Key 和模型名称。
    • 本模组兼容任何遵循 OpenAI API 标准的模型服务。
  3. 启用功能:
    • 在相应的标签页中,启用你需要的功能,例如"物品翻译"或"聊天翻译"。
  4. 保存配置:
    • 点击左下角的 "Save" 按钮。所有设置将立即生效。
  5. 开始翻译:
    • 物品:将鼠标悬停在物品上即可看到翻译。
    • 聊天:点击聊天消息旁的 [T] 按钮开始翻译。

⌨️ 命令列表

主命令为 /serverlocalizer。

  • /serverlocalizer config:打开模组的图形化配置界面。
  • /serverlocalizer translate <messageId>:翻译指定 ID 的聊天消息(主要供点击操作内部使用)。

📂 配置文件

所有配置均存储在 .minecraft/config/serverlocalizer/ModConfig.json 文件中。建议通过游戏内 GUI 修改设置,而非手动编辑此文件。

🔧 开发指南

搭建环境

# 克隆项目
git clone https://github.com/CedarXuesong/ServerLocalizer.git

# 搭建开发工作区
./gradlew setupDecompWorkspace

# 生成 IDE 配置
./gradlew eclipse    # 适用于 Eclipse
./gradlew idea       # 适用于 IntelliJ IDEA

🤝 贡献

我们欢迎各种形式的贡献!

  • 提交 Bug 报告:通过 GitHub Issues 报告你发现的问题。
  • 改进翻译:Fork 仓库并优化翻译缓存文件。
  • 添加新功能:欢迎通过 Pull Requests 贡献你的代码。

📞 联系方式

🙏 致谢

  • Minecraft Forge - 强大的模组加载器。
  • SpongePowered Mixin - 灵活的代码注入框架。
  • 所有为本项目做出贡献并提供反馈的开发者与用户 ❤️。