
Autolocalization
AutoLocalization is a game localization tool specifically designed for BepInEx mods. It exports descriptions and texts of configuration options for players to localize and translate, making it easy to localize all your mod settings!
Last updated | 2 weeks ago |
Total downloads | 123 |
Total rating | 0 |
Categories | Misc Tools Server-side Client-side Utility Ashlands Update Bog Witch Update |
Dependency string | HsgtLgt-Autolocalization-1.0.1 |
Dependants | 0 other packages depend on this package |
This mod requires the following mods to function

denikson-BepInExPack_Valheim
BepInEx pack for Valheim. Preconfigured and includes unstripped Unity DLLs.
Preferred version: 5.4.2202
ValheimModding-YamlDotNet
Shared version 16.3.0 of YamlDotNet from Antoine Aubry and contributors, net47 package for use in Valheim mods. Maintained by the ValheimModding team.
Preferred version: 16.3.1README
🚀 AutoLocalization Introduction
A game localization tool designed specifically for BepInEx mods, automatically exports configuration option text for player translation, making mod settings localization effortless!
✨ Core Features
- 🌍 One-Click Translation: Automatically detects and translates configuration option descriptions
- 🔄 Hot-Reload Compatible: No game restart needed after translation updates (takes effect in ~5 seconds)
- 📥 Smart Text Collection: Automatically collects untranslated text from new mods
- 🧠 Auto Detection: Recognizes configuration descriptions from all mods
- 📝 Simple Translation Format: Uses easy-to-edit YAML files
- 🌐 Multi-Language Support: Supports Chinese/Japanese/Korean and any other languages
📥 Installation Steps
- Download the mod file
- Extract to game root directory
- Place
Autolocalization.dll
in theBepInEx/plugins
folder - Start the game for automatic initialization
⚠️ Important Note: This mod MUST be the first loaded plugin! Plugins loaded before AutoLocalization cannot be translated
🛠️ User Guide
First Time Setup
- Start the game
- The mod will generate in
BepInEx/config/AutoLocalizationEngine
:AutolocalizationGlobalTranslations.yaml
(translation file)AutolocalizationUntranslatedTexts.yaml
(untranslated text)
🔧 Hot-Reload Process
- Edit
AutolocalizationGlobalTranslations.yaml
to add/update translations - Save the file
- Wait about 5 seconds
- Return to game to see updates
➕ Handling New Mods
- Install new mod and start the game
- New text will be automatically added to
AutolocalizationUntranslatedTexts.yaml
- Copy new entries to
AutolocalizationGlobalTranslations.yaml
- Add translations and save for automatic loading
📝 Example YAML Format
Offset relative to the upper right corner of the inventory (side elements included): Offset from the inventory's upper right corner (including side elements)
Enabled slot obtaining progression. If disabled - all enabled slots will be available from the start. [Synced with Server]: Enable slot unlocking progression. When disabled - all slots available from start. [Synced with Server]
Main menu button caption: Main Menu Button Text
'[ServerSync] Gain XP when interacting with Pickables': '[ServerSync] Gain XP when interacting with Pickable objects'
❓ FAQ
Q: What to do if translations aren't working?
A:
- Check text matching: Ensure text in translation file exactly matches untranslated text (including case/spaces/punctuation)
- Verify load order: AutoLocalization must be the first loaded plugin
- Check YAML syntax: Ensure no missing colons/correct indentation/valid characters
- Wait for reload: Wait about 5 seconds after saving file
- Confirm file location: Located in
BepInEx/config/AutoLocalizationEngine/
📜 Changelog
v1.0.0 (2025-07-23)
- First stable release
- Added debug mode
❤️ Support the Developer
If this mod has improved your gaming experience:
- Please share it with more players!
- Feedback channels:
QQ Group: 157845336
Discord: https://discord.gg/Rb5sMKUt
Developer's Note: Thank you for using AutoLocalization! Your support drives continuous improvement