ServerLocalizer

🌐 ServerLocalizer

Minecraft

Forge

Release

Sponsor

中文文档 (Chinese Readme)

> 🎮 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

- Style Preservation: Automatically translates item names and lores. - Style Preservation: 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

- Concurrent Processing: When enabled, translation results are displayed word by word, providing a smoother interactive experience without waiting. - Concurrent Processing: 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

1. Prerequisites: - Minecraft 1.8.9 - Forge `11.15.1.2318` or a later version

2. Installation Steps: 1. Download the latest `ServerLocalizer-x.x.jar` from the Installation Steps page. 2. Place the downloaded `.jar` file into your `.minecraft/mods` folder. 3. Launch the game to start using the mod.

🎮 How to Use

1. Chat: - From the main menu or pause menu, click Chat -> find Chat -> click the Chat button. - Alternatively, use the in-game command `/serverlocalizer config`. 2. Chat: - In the Chat and Chat 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. 3. Chat: - In the respective tabs, enable the features you need, such as "Item Translation" or "Chat Translation". 4. Chat: - Click the Chat button at the bottom left. All settings will take effect immediately. 5. Chat: - Chat: 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

```bash

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!

- Add New Features: Report any issues you find via Add New Features. - Add New Features: Fork the repository and optimize the translation cache files. - Add New Features: Feel free to contribute your code via Pull Requests.

📞 Contact

- Feedback & Issues: CedarXuesong - Feedback & Issues: Feedback & Issues - Feedback & Issues: %%MD1%%

🙏 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 ❤️.