2026-10-23 11:02:43 +03:00
2026-10-18 18:49:03 +03:00
2026-10-23 11:02:43 +03:00
2026-10-18 18:49:03 +03:00
2026-10-23 11:02:43 +03:00
2026-10-18 18:49:03 +03:00
2026-10-23 11:02:43 +03:00
2026-10-23 11:02:43 +03:00
2026-10-18 18:49:03 +03:00
2026-10-23 11:02:43 +03:00

Pony Island — український патчер локалізації

Патчер, який додає українську мову до гри Pony Island (Unity 2017.4, Mono) на Windows, Linux та macOS.

Він не розповсюджує змінену копію гри. Патчер працює на вашому власному Assembly-CSharp.dll: робить резервну копію, вносить мінімальні зміни та додає український переклад і шрифти.

Підтримати автора

Paypal Patreon Monobank

Що він робить

  • додає мову Українська до меню вибору мови;
  • підхоплює українську як мову за замовчуванням, якщо вона є системною;
  • завантажує переклад із файлу localization.csv (ви можете змінити у будь який час);
  • підміняє шрифти на ті, що містять кирилицю.

Встановлення

  1. Закрийте гру.
  2. Розпакуйте архів pl-patcher.zip у папку гри: туди, де лежить PonyIsland_Data (на macOS — поруч із .app). У Steam: ПКМ по грі → Керування → Переглянути локальні файли.
  3. Запустіть файл для вашої системи:
    Система Файл
    Windows pl-patcher-win-x64.exe
    Linux / Steam Deck ./pl-patcher-linux-x64
    macOS (Apple Silicon) ./pl-patcher-macos.command

macOS: перший раз натисніть правою кнопкою на pl-patcher-macos.command -> Відкрити.

  1. Запустіть гру, відкрийте меню паузи → вибір мови → Українська.

Підказки за системами

  • Windows: під час патчингу гра має бути закрита, інакше файл буде заблоковано.
  • Linux / Steam Deck: запускайте з термінала. Якщо файл не виконується, дайте йому права: chmod +x pl-patcher-linux-x64. На Steam Deck відкрийте термінал у режимі робочого столу.
  • macOS: завантажені програми блокуються Gatekeeper. Зніміть карантин і дайте права на запуск:
    xattr -d com.apple.quarantine ./pl-patcher-osx-arm64
    chmod +x ./pl-patcher-osx-arm64
    

Видалення

Запустіть той самий файл з аргументом restore:

./pl-patcher-linux-x64 restore
pl-patcher-win-x64.exe restore

Патчер поверне оригінальний Assembly-CSharp.dll і видалить LocMod.dll та папку loc. Альтернатива: у Steam Властивості → Встановлені файли → Перевірити цілісність файлів.

Оновлення гри

Якщо Steam оновив або перевірив файли гри, патч зникне. Просто запустіть патчер ще раз. Він сам визначить, що Assembly-CSharp.dll знову оригінальний, і створить нову резервну копію.

Якщо ви редагували Assembly-CSharp.dll вручну (dnSpy тощо), патчер відмовиться працювати і попросить відновити оригінал, щоб нічого не зіпсувати.

Як це працює

patcher (Mono.Cecil)
  ├─ Assembly-CSharp.dll  →  Assembly-CSharp.dll.orig   (резервна копія)
  ├─ патчить копію з .orig та записує результат у Assembly-CSharp.dll
  ├─ копіює LocMod.dll у Managed/
  └─ розпаковує loc/ (переклад і шрифти) у Managed/loc/

Усю нову логіку написано звичайним C# у LocMod.dll. Cecil лише вставляє короткі виклики в оригінальні методи гри:

Місце в грі Що змінюється
Localization.Language додається значення Ukrainian = 15
Localization.ParseLocalizationFile замінюється на LocHooks.ParseLocalization() (читає loc/localization.csv, а якщо його немає — вбудований ресурс гри)
Localization.TryLoadSystemLanguage замінюється на LocHooks.TryLoadSystemLanguage()
LocalizeText.Awake / UpdateLocalization у кінець додається LocHooks.ApplyFont(this)
PauseMenu.Awake у кінець додається LocHooks.AddUkrainianButton(this)

Файли гри в самому патчері не розповсюджуються, він змінює лише копію у вас на диску. Нічого, окрім Assembly-CSharp.dll, не змінюється, а LocMod.dll та loc/ лише додаються поруч.

Структура репозиторію

├─ LocMod/            код, що виконується в грі (net35): LocHooks.cs
├─ Patcher/           консольний патчер на Mono.Cecil (net8.0)
├─ loc/
│  ├─ localization.csv     переклад
│  └─ Bundles/{win,linux,mac}/fonts   AssetBundle зі шрифтами для кожної ОС
├─ ttf_fonts/         вихідні TTF із кирилицею (для збирання бандлів)
├─ pack.sh            збірка та пакування в один zip
└─ dist/              результат збірки (в git не потрапляє)

loc/ вбудовується в LocMod.dll як ресурси, а патчер розпаковує його у Managed/loc/. Це дає змогу будь-кому відредагувати localization.csv після встановлення.

Збірка

Потрібно:

  • .NET SDK 8 або новіший;
  • zip;
  • оригінальний Assembly-CSharp.dll та UnityEngine*.dll із вашої копії гри. Вони потрібні лише компілятору і до репозиторію не входять. Якщо гру вже пропатчено, оригінал лежить поруч як Assembly-CSharp.dll.orig, або скористайтеся перевіркою цілісності у Steam.

Збірка:

MANAGED="/шлях/до/PonyIsland_Data/Managed" ./pack.sh

Якщо гра стоїть у стандартному місці Steam на Linux, змінну MANAGED можна не вказувати. За замовчуванням використовується ~/.local/share/Steam/steamapps/common/Pony Island/PonyIsland_Data/Managed.

Результат: dist/pl-patcher.zip з виконуваними файлами для win-x64, linux-x64, osx-x64 і osx-arm64 та спільним LocMod.dll. Скрипт спершу збирає LocMod, а потім публікує патчер для кожної ОС (self-contained, single-file, trimmed), тож .NET на машині користувача не потрібен.

Для швидкого запуску без пакування:

dotnet build LocMod -c Release -p:ManagedDir="/шлях/до/Managed"
dotnet run --project Patcher -c Release -- "/шлях/до/папки/гри"

Шрифти

Оригінальні шрифти гри не містять кирилиці, тому їх замінено версіями з доданими гліфами. Вони зібрані в AssetBundle для кожної ОС (бандли залежать від платформи) і завантажуються один раз під час запуску. Заміна відбувається за назвою оригінального шрифту:

Шрифт у грі Файл у бандлі
BoBoSans Bold BoBoSansBold.ttf
BoutiqueBitmap9x9_1.9_R BoutiqueBitmap9x9_1.9_R.ttf
BoutiqueBitmap9x9_1.9_B BoutiqueBitmap9x9_1.9_B.ttf
04B_30__ 04b-30.ttf
dpcomic DPComic.ttf
Crumbled-Pixels CrumbledPixels.ttf

Як перезібрати бандли

  1. Встановіть Unity 2017.4.40f1 (саме ту версію, що й гра) з модулями збірки для Windows, Linux та macOS.
  2. Створіть порожній проєкт, покладіть TTF із ttf_fonts/ у Assets/fonts/.
  3. Для кожного шрифту: Character = Dynamic. Для піксельних шрифтів рекомендовано Rendering Mode = Hinted Raster, а розмір краще збігати з оригінальним.
  4. Призначте всім шрифтам AssetBundle з назвою fonts.
  5. Зберіть бандл для StandaloneWindows64, StandaloneLinux64 та StandaloneOSX (через BuildPipeline.BuildAssetBundles).
  6. Покладіть результат у loc/Bundles/{win,linux,mac}/fonts.

Шляхи на кшталт assets/fonts/bobosansbold.ttf прописано в LocMod/LocHooks.cs (словник Map). Якщо ви змінюєте назви файлів, змініть їх і там.

Відомі обмеження

  • Не запускайте патчер на Assembly-CSharp.dll, відредагованому вручну. Для цього є перевірка, див. «Оновлення гри».

Ліцензії та подяки

  • Pony Island належить її авторам. Цей проєкт не містить файлів гри.
  • Шрифти належать своїм авторам. Перед поширенням перевірте ліцензію кожного з них: у ttf_fonts/ лежать версії з доданою кирилицею.
  • Українська локалізація: deadYokai.
S
Description
No description provided
Readme
19 MiB
0 Stars 1 Watchers 0 Forks
2026-10-23 08:01:05 +00:00
Languages
Rust 53.3%
C# 37.4%
Shell 9.3%