Localis is a desktop application for analyzing and translating Minecraft mods. It helps you inspect mod language files, edit translations, use AI providers for translation, and review localization coverage in an HTML report.
| Platform | Downloads |
|---|---|
| Windows |   |
| macOS |   |
| Linux |      |
- Scan Minecraft mod
.jarfiles and locate language resources. - Review and edit translations in the app, including its table and JSON editor.
- Translate text with an OpenAI-compatible API or a local Ollama model.
- Run AI translations across selected mods with progress information for strings, batches, and mods.
- Generate an HTML report with localization status and translation issues.
- Save edited language files back into JAR archives, with backup and restore support.
- Configure terminology rules and choose the interface language.
- Node.js and npm (for running from source)
- An OpenAI-compatible API endpoint, or Ollama with a model installed, for AI translation
You can also use a packaged Windows installer; Node.js is not needed to run an installed build.
git clone https://github.com/FoxSoul-dev/Localis
cd Localis
npm install
npm startTo build a Windows installer:
npm run dist:winTo build the release packages on their corresponding GitHub Actions runners:
npm run dist:mac # Intel and Apple Silicon DMG files (requires macOS)
npm run dist:linux # AppImage, DEB, RPM, and pacman packageWindows builds include x64 and ARM64 installers. All local build outputs are written to dist/. Pushing a v* tag starts the cross-platform workflow and publishes the generated packages as a GitHub Release. macOS packages are not code-signed or notarized, so macOS may require users to approve the first launch.
The Arch Linux localis-bin AUR recipe is in packaging/aur/PKGBUILD. It uses the AppImage attached to the matching GitHub Release.
- Open Localis and select the folder containing your Minecraft mods.
- Run the scan to find available localization files.
- Select a mod to review or edit its translations.
- To use AI translation, configure a provider in AI Settings and select the target language.
- Review the results, then save the changes to the mod archive.
- Export an HTML report when you need a shareable overview of localization status.
Localis creates backups before saving changes to JAR files. Use the app's backup controls to restore a previous version if needed.
In AI Settings, choose an OpenAI-compatible provider or Ollama and configure its endpoint and model. Add an API key when the selected provider requires one. For Ollama, make sure its server is running and the model has already been downloaded.
Translation quality and throughput depend on the selected model, API availability, and context limits. Review AI-generated text before distributing a mod or modpack.
When you use a hosted AI provider, the text selected for translation is sent to that provider. With Ollama, requests go to the configured Ollama server, which can be local to your computer. Keep API credentials private and review the provider's data handling terms.
main.js— Electron main process and file operations.renderer.js— application interface, localization, reporting, and translation workflow.index.htmlandstyle.css— interface markup and styles.assets/— application images and icons.logger.js— application logging.
Localis is distributed under the MIT License. See the license file for the full terms.