Ukrainify

Ukrainify is a game localization project that provides tools for creating and installing Ukrainian translations for popular video games. The project uses a modular architecture to support different gaming platforms and distributors.

🎮 Supported Games

The project includes localizations for the following games:

• A Short Hike
• Journey
• Postal / Postal Brain Damaged
• Reigns
• Ruiner
• Stick Fight: The Game
• The Room
• Thief Simulator / Thief Simulator 2
• Vampire Survivors

🏗️ Project Architecture

Core Components

Common - Shared Libraries

• Ukrainify.Installer - WPF application for installing localizations with modern interface
• Ukrainify.Localization - Core localization system that manages translation files
• Ukrainify.Unity - Specialized tools for Unity games
• Ukrainify.RegistryManager - Windows registry management
• Ukrainify.GameDetection - Core interface and model for game detection
• Ukrainify.GameDetection.Steam - Steam game detection via registry and VDF parsing
• Ukrainify.GameDetection.Gog - GOG game detection via registry
• Ukrainify.GameDetection.Epic - Epic Games Store detection via manifest JSON files

Installers - Game-specific Installers

Each game has its own installer with unique configuration:

• Game metadata and specific localization files
• Icons and branding
• Embedded translation resources

Tools - Development Tools

• InstallerCreator - Generator for new installers
• Packer - Resource packaging utility
• PatchCreator - Binary patch generation utility

Each tool has its own documentation in its respective directory.

🚀 Features

✨ Key Capabilities

• Automatic game detection on supported platforms
• Safe installation with rollback capability
• Modern WPF interface with dark theme support
• Modular architecture for easy addition of new games
• Multi-platform support (Steam, GOG, Epic Games Store)

🛠️ Technology Stack

• .NET Framework 4.7.2 (for game installers)
• .NET 8 (for development tools)
• WPF (Windows Presentation Foundation)
• C# 7.3 / C# 12 (for .NET 8 tools)
• MSBuild for build system
• XAML for interface development

📦 Installation & Usage

For Users

1. Download the installer for the desired game from releases
2. Run the .exe file
3. Select the installed game (automatic detection)
4. Click "Install Localization"
5. Enjoy the game in Ukrainian!

For Developers

System Requirements

• Visual Studio 2017+ (2022 recommended)
• .NET Framework 4.7.2 Development Pack
• .NET 8 SDK (for development tools)
• Windows 10/11

Building the Project

git clone https://github.com/Tudzer/Ukrainify.git
cd Ukrainify
# Run the build script
.\build.ps1

🏛️ File Structure

Ukrainify/
├── Common/                          # Shared libraries
│   ├── Ukrainify.Installer/        # Main installer
│   ├── Ukrainify.Localization/     # Localization core
│   ├── Ukrainify.Unity/            # Unity tools
│   ├── Ukrainify.RegistryManager/
│   ├── Ukrainify.GameDetection/    # Game detection interface
│   ├── Ukrainify.GameDetection.Steam/
│   ├── Ukrainify.GameDetection.Gog/
│   └── Ukrainify.GameDetection.Epic/
├── Installers/               # Game installers
│   ├── Ukrainify.A_Short_Hike/
│   ├── Ukrainify.Journey/
│   └── ... (other games)
├── Tools/                    # Development tools
│   ├── InstallerCreator/
│   ├── Packer/
│   └── PatchCreator/
├── Publish/                  # Build results

🛠️ Development Tools Documentation

• InstallerCreator - Generator for new installers
• Packer - Resource packaging utility
• PatchCreator - Binary patch generation utility

📄 License

The project is distributed under the MIT license. Details in the LICENSE file.

🙏 Acknowledgments

• Game developers for creating amazing games that we localize
• Ukrainian gaming community for support and feedback
• Translators for their tireless work

---

💙💛 Support Ukrainian language in the gaming world! 💙💛