ValheimLoading...Autolocalization1.0.1

You are viewing a potentially older version of this package. View Latest Version

Install

Date Uploaded

last year

Downloads

3.3K

Size

122KB

Dependency string

HsgtLgt-Autolocalization-1.0.1

Download

Details Required (2)Versions

🚀 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 the BepInEx/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

✨ 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

🛠️ 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/