Pillars of Eternity EZ Localization

This repository contains the working files and automation scripts for the ez localization of Pillars of Eternity.

The goal of this project is to produce a bilingual Chinese localization that keeps the original English visible where appropriate, while improving the overall Chinese text quality through an AI-assisted workflow. AI agents propose edits, and every change is reviewed by a human before it is kept. The original localization is already strong, so the number of changes is manageable enough for full human review.

Credits

This project is based on the original Nexus Mods release:

https://www.nexusmods.com/pillarsofeternity/mods/241?tab=description

Many thanks to the original author for the excellent groundwork. This repository builds on that work and continues it in a more collaborative, review-driven workflow.

Repository Layout

• data/, data_expansion1/, data_expansion2/, data_expansion4/: source game localization files and generated ez output
• Managed/: patched Assembly-CSharp.dll used to provide Chinese font support
• scripts/: automation for inspecting, generating, and syncing localization files
• docs/: workflow notes, glossary files, and review documentation

Requirements

• Python 3.11+
• uv
• A local Pillars of Eternity installation if you want to test in-game

Quick Start

From the repository root:

uv sync
uv run python scripts/status.py

Useful commands:

uv run python scripts/lookup.py conversations/00_dyrwood/00_bs_celby
uv run python scripts/create_ez.py game/abilities --force
uv run python scripts/batch_create_ez.py
uv run python scripts/sync_to_game.py --game-root "/path/to/PillarsOfEternity_Data"

You can also configure the game path with POE_GAME_DATA_DIR instead of passing --game-root every time.

Game Files and DLL Compatibility

The Managed folder contains Assembly-CSharp.dll. That DLL must be copied together with the localization files, because it enables the Chinese fonts required for the game to render the text correctly.

This DLL is the game's main managed assembly, so it is tightly coupled to the exact game version. If the DLL in this repository stops working after a game update, you may need to replace it with an updated version from the original Nexus Mods release.

The sync script copies:

• data/localized/ez/language.xml
• data_expansion4/localized/ez/
• Managed/Assembly-CSharp.dll

Contribution Notes

• Keep paths repository-relative in scripts and docs.
• Treat AI output as draft work, not final authority.
• Preserve the original English text where the EZ format requires it.
• Review all text changes manually before merging.

More detailed workflow guidance is available in docs/TRANSLATION_WORKFLOW.md.