Empowering Persian Gamers | Open-Source Localization & Reverse Engineering Tools
FarsiForge is an open-source, community-driven initiative dedicated to bringing video games to Persian-speaking audiences. We build high-quality, robust tools that handle the heavy lifting of game localization—from text extraction and injection to RTL (Right-to-Left) rendering and installer generation.
The ultimate professional toolkit for video game localization. It automatically detects game engines, extracts translatable text, applies RTL processing and Arabic shaping for Persian fonts, and builds ready-to-use patch installers.
Engine-specific utilities and generic CLI tools for advanced text manipulation and archiving. Features support for Unreal Engine (.locres), Godot (.pck), Unity, and various other custom engine formats.
We maintain forks of essential reverse engineering and localization tools to ensure they stay available, stable, and can be extended with RTL/Persian-specific features. Here is a map of the tools available in our organization:
- AssetRipper: Comprehensive asset extraction (models, textures, text).
- UABEA / AssetsTools.NET: Reading, extracting, and modifying Unity asset bundles.
- Il2CppDumper / Cpp2IL: Decompiling and analyzing Unity IL2CPP games.
- BepInEx / HarmonyX / Il2CppInterop: The standard modding frameworks and hooks for injecting custom DLLs into Unity games.
- XUnity.AutoTranslator: On-the-fly text translation plugin.
- UnityPy: Python library for scripting Unity asset modifications.
- FModel: Exploring and extracting Unreal Engine
.pak,.utoc, and.ucasarchives. - UnrealLocres: Extracting and packing Unreal Engine localization (
.locres) files. - repak / retoc: CLI utilities for packing and unpacking Unreal Engine archives.
- UAssetGUI: Low-level editor for Unreal Engine
.uassetand.uexpfiles.
- Godot RE Tools (gdsdecomp): Full decompilation and asset extraction for Godot
.pckfiles. - UndertaleModTool: The ultimate tool for reverse engineering and localizing GameMaker Studio games.
- Ghidra: NSA's powerful reverse engineering framework.
- x64dbg: The standard open-source x64/x32 debugger for Windows.
- dnSpy / ILSpy: .NET decompilers and assembly editors.
- ImHex: Advanced hex editor for data analysis.
- QuickBMS: Universal script-based archive extractor and reimporter.
- Steamless: DRM remover for Steam stub executables.
- Detect-It-Easy: Identifying engine, compiler, and packer signatures.
- fonttools / fontforge: Creating, editing, and patching fonts to support Persian glyphs.
- python-arabic-reshaper & python-bidi: Essential Python libraries for correcting RTL (Right-to-Left) and isolated Arabic/Persian letters in games without native support.
- vazirmatn: The standard open-source Persian font.
- ImageMagick: CLI tool for texture/image manipulation.
- jq: Swiss-army knife for parsing JSON localization data.
We believe language shouldn't be a barrier to enjoying great stories. By providing automated, scriptable, and easy-to-use tools, we help translators and modders focus on what they do best: translating.
- Automated Workflows: Say goodbye to hex-editing strings manually.
- Seamless RTL Support: Overcoming the hardest challenge in Persian localization with built-in text reshaping and font fixes.
- Open & Collaborative: Built transparently on GitHub, for the community.
Whether you're a translator, reverse engineer, or developer (C#, Python, C++), we welcome your contributions!
- Check out our Repositories and start contributing.
- Found a bug or have a feature request? Feel free to open an issue in the respective repository.
Made with ❤️ for the Persian gaming community.
توانمندسازی گیمرهای ایرانی | ابزارهای متنباز برای بومیسازی و مهندسی معکوس
پروژه FarsiForge یک ابتکار متنباز و جامعهمحور است که با هدف فارسیسازی بازیهای ویدیویی فعالیت میکند. ما ابزارهای حرفهای و قدرتمندی میسازیم که بخشهای سخت و پیچیدهی بومیسازی بازیها—از استخراج و تزریق متن گرفته تا رندر راستچین (RTL) و ساخت نصبکنندهها—را بر عهده میگیرند.
کاملترین ابزار حرفهای برای بومیسازی بازیهای ویدیویی. این برنامه بهطور خودکار موتور بازی را تشخیص میدهد، متنهای قابل ترجمه را استخراج میکند، پردازشهای مربوط به راستچینسازی (RTL) و چسباندن حروف فارسی را اعمال کرده، و در نهایت نصبکنندهی پچ (پچساز) را تولید میکند.
مجموعهای از ابزارهای خطفرمان (CLI) و پردازشگرهای تخصصی برای دستکاری متنها در موتورهای مختلف. پشتیبانی از آنریل انجین (.locres)، گودو (.pck)، یونیتی و فرمتهای اختصاصی دیگر.
ما نسخههای فورکشدهی ابزارهای ضروری مهندسی معکوس و بومیسازی را نگهداری میکنیم تا همواره در دسترس و پایدار باشند و بتوانیم ویژگیهای مخصوص زبان فارسی/راستچین را به آنها اضافه کنیم. در اینجا نقشهی ابزارهای موجود در سازمان ما را میبینید:
- AssetRipper: استخراج جامع فایلها (مدلها، تکسچرها، متون).
- UABEA / AssetsTools.NET: خواندن، استخراج و ویرایش فایلهای Asset Bundle در یونیتی.
- Il2CppDumper / Cpp2IL: دیکامپایل و تحلیل بازیهای IL2CPP.
- BepInEx / HarmonyX / Il2CppInterop: فریمورکهای استاندارد مادسازی و هوک برای تزریق فایلهای DLL کاستوم به بازیهای یونیتی.
- XUnity.AutoTranslator: پلاگین ترجمه لحظهای (On-the-fly) متن بازی.
- UnityPy: کتابخانه پایتون برای اسکریپتنویسی و دستکاری اسِتهای یونیتی.
- FModel: بررسی و استخراج فایلهای
.pak،.utocو.ucasدر آنریل انجین. - UnrealLocres: استخراج و بستهبندی فایلهای متنی (
.locres) آنریل. - repak / retoc: ابزارهای خطفرمان برای پکینگ و آنپکینگ فایلهای بازی.
- UAssetGUI: ویرایشگر سطح پایین برای فایلهای
.uassetو.uexp.
- Godot RE Tools (gdsdecomp): دیکامپایل کامل و استخراج فایلهای
.pckبازیهای گودو. - UndertaleModTool: ابزار نهایی برای مهندسی معکوس و بومیسازی بازیهای ساخته شده با GameMaker Studio.
- Ghidra: فریمورک قدرتمند مهندسی معکوس متعلق به NSA.
- x64dbg: دیباگر استاندارد و متنباز x64/x32 برای ویندوز.
- dnSpy / ILSpy: دیکامپایلر و ویرایشگر اسمبلی برای برنامههای داتنت (.NET).
- ImHex: ویرایشگر Hex پیشرفته برای تحلیل دادهها.
- QuickBMS: ابزار همهکاره مبتنی بر اسکریپت برای استخراج و بازگردانی فایلهای فشردهی بازیها.
- Steamless: ابزاری برای حذف DRM استیم از فایلهای اجرایی (exe).
- Detect-It-Easy: تشخیص انجین، کامپایلر و پروتکتور (پکر) بازی.
- fonttools / fontforge: ساخت، ویرایش و پچ کردن فونتها جهت اضافه کردن کاراکترهای فارسی.
- python-arabic-reshaper و python-bidi: کتابخانههای ضروری پایتون برای اصلاح متون راستچین (RTL) و رفع مشکل جداجدا نوشته شدن حروف فارسی در بازیهایی که پشتیبانی بومی ندارند.
- vazirmatn: فونت استاندارد و متنباز فارسی (وزیرمتن).
- ImageMagick: ابزار خطفرمان برای دستکاری و تغییر فرمت تکسچرها و عکسها.
- jq: ابزاری همهکاره برای پردازش دادههای متنی با فرمت JSON.
ما معتقدیم زبان نباید مانعی برای لذت بردن از داستانهای فوقالعاده باشد. با فراهم کردن ابزارهای خودکار، قابل اسکریپتنویسی و کاربرپسند، به مترجمها و مادسازها کمک میکنیم روی کاری تمرکز کنند که در آن بهترین هستند: ترجمه.
- روندهای کاری خودکار: با ویرایش هگز (Hex-editing) دستی رشتهها خداحافظی کنید.
- پشتیبانی بینقص از RTL: غلبه بر سختترین چالش در فارسیسازی با راهکارهای داخلی برای اصلاح فونت و فرم حروف.
- باز و مشارکتی: ساخته شده به صورت شفاف در گیتهاب، توسط کاربران و برای کاربران.
چه مترجم باشید، چه مهندس معکوس و چه برنامهنویس (C#، Python، C++)، ما از مشارکت شما استقبال میکنیم!
- ریپازیتوریهای ما را ببینید و شروع به مشارکت کنید.
- باگی پیدا کردید یا ایدهای دارید؟ کافیست در ریپازیتوری مربوطه یک Issue ثبت کنید.