Skip to content

alex-serbet/Minecraft-Mods-Localizer

Repository files navigation

About the Program

Minecraft Localizer is a tool for localizing Minecraft mods.
The application allows automatic translation of mods for free using GPT4Free or with higher translation quality via DeepSeek API (paid mode), as well as managing translation, saving results, and tracking operation status through a convenient GUI.

Features

  • Automatic Translation
    Supports translation to any game language using:

    • GPT4Free — no API key required; limitations depend on the provider;
    • DeepSeek API — requires API key for maximum accuracy and stability.
  • Multiple Modes: Ability to choose different translation modes (Single File, Mods, Resource Pack, FTB Quests, Patchouli, Better Questing).

  • Flexible GPT4Free Settings: Select provider and model, plus additional parameters (temperature, batch size).

  • Flexible DeepSeek Settings: Quality/speed parameters and API key usage.

  • Convenient Saving: After translation, results are automatically saved; manual saving is also possible.

  • Interactive Interface: Manage translation via a user-friendly interface.

  • Settings and Directories: Easy settings management and quick access to directories.

  • Logs and Status: Separate window showing GPT4Free installation/start progress and logs.

Usage

Important

To use GPT4Free, install:

Component Required Version Download
Python 3.10 or higher www.python.org
Git Any latest www.git-scm.com
  1. Go to Settings and select the desired language and game directory, then save changes.
  2. Select Translation Mode in the main window.
  3. Load Data:
    • for Mods / FTB Quests / Patchouli / Better Questing — select the desired mod from the list;
    • for Single File or Resource Pack — use File → Open File or File → Open Resource Pack.
  4. Click "Start Translation".
    • For GPT4Free, a window for installation/start will open.
    • For DeepSeek, just enter the API key in settings.
  5. Wait for Translation Completion. You can cancel and save already translated strings if necessary.
  6. Check the "resourcepacks" folder in the game directory or the save path from the notification. If no result, click "Save Translation".

Warning

In some regions (e.g., Russia), access to most GPT4Free providers may be restricted. Use a VPN for stable operation.
Availability and limits may also depend on the provider.

Tip

If a mod or file is read incorrectly, switch reading mode from "Table" to "Text".
In this mode, the AI translates the entire content, preserving all special characters, formatting, and file structure instead of selectively processing elements.

Important

For the best translation quality, use DeepSeek.
It delivers significantly more accurate meaning, correctly accounts for context, and rarely makes mistakes.
Achieving the same stability with GPT4Free is usually not possible.

Contacts

If you have questions or suggestions, create an Issue on GitHub or contact me via Telegram.

License

This project is licensed under the MIT License.

About

The program automatically translates Minecraft mods using GPT4Free or DeepSeek API, lets you manage the translation process, save results, and monitor progress through a graphical interface.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages