? ServerLocalizer
? 一款强大的 Minecraft 服务器内容本地化 AI 翻译模组,让你轻松享受国际服乐趣!
? 简介
ServerLocalizer 是一款针对 Minecraft 1.8.9 的 Forge 模组,通过拦截服务器数据包并调用 AI 大语言模型 API,提供高质量、可定制的游戏内容翻译。它帮助你克服语言障碍,在国际服务器上获得无缝的游戏体验。
✨ 特性
核心翻译功能
- 物品翻译:自动翻译物品名称和描述(Lore)。
- 聊天翻译:点击聊天消息旁边的
[T] 按钮,即时翻译任何聊天内容。
- 样式保留:完整保留物品和聊天中的颜色代码及文本格式。
智能与高效
- 流式响应:启用后,翻译结果逐字显示,无需等待即可提供更流畅的交互体验。
- 智能缓存:自动缓存翻译结果,避免重复请求,节省资源。
- 并发处理:使用线程池处理多个翻译请求,确保游戏运行流畅。
用户体验
- 可视化配置 GUI:提供现代化的图形用户界面,方便用户轻松调整所有设置。
? 安装指南
-
前置要求:
- Minecraft 1.8.9
- Forge
11.15.1.2318 或更高版本
-
安装步骤:
- 从 Releases 页面下载最新的
ServerLocalizer-x.x.jar。
- 将下载的
.jar 文件放入你的 .minecraft/mods 文件夹中。
- 启动游戏以开始使用该模组。
? 使用方法
- 打开配置界面:
- 在主菜单或暂停菜单中,点击 "Mods" -> 找到 "ServerLocalizer" -> 点击 "Config" 按钮。
- 或者,使用游戏内命令
/serverlocalizer config。
- 配置 API:
- 在 "Item Translation"(物品翻译)和 "Chat Translation"(聊天翻译)选项卡中,输入你的 API 服务地址(Base URL)、API Key 和模型名称。
- 本模组兼容任何符合 OpenAI API 标准的模型服务。
- 启用功能:
- 在相应的选项卡中,启用你需要的功能,例如“物品翻译”或“聊天翻译”。
- 保存配置:
- 点击左下角的 "Save" 按钮。所有设置将立即生效。
- 开始翻译:
- 物品:鼠标悬停在物品上即可查看翻译。
- 聊天:点击聊天消息旁边的
[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 贡献你的代码。
? 联系方式
? 致谢
? ServerLocalizer
? A powerful Minecraft server content localization AI translation mod, allowing you to easily enjoy international servers!
? Introduction
ServerLocalizer is a Forge mod for Minecraft 1.8.9 that provides high-quality, customizable game content translation by intercepting server packets and calling AI large language model APIs. It helps you overcome language barriers and enjoy a seamless gaming experience on international servers.
✨ Features
Core Translation Functions
- Item Translation: Automatically translates item names and lores.
- Chat Translation: Instantly translates any chat message by clicking the
[T] button next to it.
- Style Preservation: Fully retains color codes and text formatting in both items and chat.
Intelligence & Efficiency
- Stream Response: When enabled, translation results are displayed word by word, providing a smoother interactive experience without waiting.
- Smart Caching: Automatically caches translation results to avoid redundant requests and save resources.
- Concurrent Processing: Uses a thread pool to handle multiple translation requests, ensuring smooth game performance.
User Experience
- Visual Configuration GUI: Provides a modern GUI for users to easily adjust all settings.
? Installation Guide
-
Prerequisites:
- Minecraft 1.8.9
- Forge
11.15.1.2318 or a later version
-
Installation Steps:
- Download the latest
ServerLocalizer-x.x.jar from the Releases page.
- Place the downloaded
.jar file into your .minecraft/mods folder.
- Launch the game to start using the mod.
? How to Use
- Open Configuration:
- From the main menu or pause menu, click "Mods" -> find "ServerLocalizer" -> click the "Config" button.
- Alternatively, use the in-game command
/serverlocalizer config.
- Configure API:
- In the "Item Translation" and "Chat Translation" tabs, enter your API service address (Base URL), API Key, and Model name.
- This mod is compatible with any model service that adheres to the OpenAI API standards.
- Enable Features:
- In the respective tabs, enable the features you need, such as "Item Translation" or "Chat Translation".
- Save Configuration:
- Click the "Save" button at the bottom left. All settings will take effect immediately.
- Start Translating:
- Items: Hover over an item to see the translation.
- Chat: Click the
[T] button next to a chat message to start the translation.
⌨️ Command List
The main command is /serverlocalizer.
/serverlocalizer config: Opens the mod's graphical configuration interface.
/serverlocalizer translate <messageId>: Translates a chat message with a specific ID (mainly used internally by clicks).
? Configuration Files
All configurations are stored in the .minecraft/config/serverlocalizer/ModConfig.json file. It is recommended to modify settings through the in-game GUI rather than editing this file manually.
? Development Guide
Setup Environment
# Clone the project
git clone https://github.com/CedarXuesong/ServerLocalizer.git
# Setup the development workspace
./gradlew setupDecompWorkspace
# Generate IDE configurations
./gradlew eclipse # For Eclipse
./gradlew idea # For IntelliJ IDEA
? Contributing
We welcome all forms of contributions!
- Submit Bug Reports: Report any issues you find via GitHub Issues.
- Improve Translations: Fork the repository and optimize the translation cache files.
- Add New Features: Feel free to contribute your code via Pull Requests.
? Contact
? Acknowledgements
- Minecraft Forge - The powerful mod loader.
- SpongePowered Mixin - The flexible code injection framework.
- All developers and users who have contributed to this project and provided feedback ❤️.
评论 0
登录后参与评分
还没有评论,来抢沙发吧