💡 Гайди Як переробити Open-Source C# лаунчер з нашого Загруз-Центру під свій проект: налаштування, бекенд оновлень та запуск

Андрій Хімік

Учасник
🔰 НОВАЧОК
👑 Гуру ZONA
🥉 🥈 🥇 🛠️ ❤️
Рейтинг
1220 pts
🚀 Покрокова інструкція: Адаптація та запуск відкритого C# / WPF лаунчера під ваш сервер

У нашому Загруз-Центрі доступний повноцінний відкритий сирцевий код ігрового лаунчера: OLD UKRAINE GTA Launcher • Повний вихідний код [C# / WPF / .NET], а також працює інтерактивний Онлайн Конструктор Лаунчерів.

У цьому гайді я розберу абсолютно все: як налаштувати солюшн, змінити дизайн, підключити свій сервер MTA, налаштувати систему швидкого завантаження файлів (FastDL / Патчер) та куди безкоштовно або недорого залити клієнтські файли для роздачі оновлень гравцям.


1. Що потрібно для збірки та редагування

  • Visual Studio 2022 (Community Edition — безкоштовна версія) з встановленим компонентом «Розробка класичних додатків .NET».
  • .NET 6.0 або 8.0 SDK (встановлюється разом зі студією).
  • Вихідний архів лаунчера з нашого Загруз-Центру: Завантажити сирці тут.


2. Зміна дизайну та брендингу проекту

Уся візуальна частина написана на чистому WPF з використанням XAML-розмітки:
  • Зміна логотипу та артів: перейдіть у папку проекту Assets/Images/. Замініть файл logo.png на ваш фірмовий логотип сервера та background.jpg (бажано роздільна здатність 1920x1080 або 2560x1440 у форматі WebP/PNG).
  • Колірна гама: відкрийте файл Styles/Colors.xaml. Там прописані глобальні пензлі кольорів:
XML:
<Color x:Key="PrimaryColor">#FF7A00</Color> <!-- Акцентний оранжевий колір -->
<Color x:Key="BackgroundColor">#0E1118</Color> <!-- Темний графітовий фон -->
<Color x:Key="SurfaceColor">#161B26</Color> <!-- Колір карток та меню -->


3. Налаштування IP сервера та аргументів запуску MTA

Відкрийте файл Services/GameLauncherService.cs (або AppConfig.cs).
Знайдіть конфігурацію підключення:
C#:
public static class ServerConfig
{
    public const string ServerName = "Мій Новий Проект MTA";
    public const string ServerIP = "185.220.101.45"; // IP вашого сервера
    public const int ServerPort = 22003;              // Порт сервера
    public const string UpdateManifestUrl = "https://update.my-server.ua/manifest.json";
}

Механізм безпосереднього запуску гри з автоматичним підключенням реалізовано через Process.Start:
C#:
var startInfo = new ProcessStartInfo
{
    FileName = Path.Combine(gameDirectory, "MTA.exe"),
    Arguments = $"mta://{ServerConfig.ServerIP}:{ServerConfig.ServerPort}",
    WorkingDirectory = gameDirectory,
    UseShellExecute = true
};
Process.Start(startInfo);


4. Куди залити файли і як налаштувати автооновлення (Патчер)

Щоб гравці не качали гігабайти вручну, лаунчер має систему валідації цілісності кешу за алгоритмом MD5.

Де безкоштовно або дешево розмістити файли гри:
  1. Звичайний віртуальний хостинг (Apache / Nginx): створюєте піддомен update.yoursite.ua, заливаєте файли в папку public_html/client/. Це найпростіший варіант.
  2. Хмарні сховища S3 / Cloudflare R2: Cloudflare R2 має безкоштовний рівень на 10 ГБ і 0$ за вихідний трафік, що ідеально для роздачі важких модпаків без лімітів!
  3. GitHub Releases: для невеликих бінарників лаунчера (до 2 ГБ на реліз).

Структура файлу manifest.json:
JSON:
{
  "version": "1.0.5",
  "files": [
    {
      "path": "mods/deathmatch/resources/my_pack.zip",
      "size": 15482910,
      "md5": "d41d8cd98f00b204e9800998ecf8427e",
      "url": "https://update.my-server.ua/client/mods/deathmatch/resources/my_pack.zip"
    }
  ]
}

Лаунчер при старті запитує manifest.json, порівнює хеш кожного локального файлу з маніфестом, показує гарний прогрес-бар ProgressBar зі швидкістю завантаження (MB/s) та залишковим часом, після чого кнопка «Грати» стає активною!


5. Збірка фінального .EXE релізу

Щоб видати гравцям один компактний виконуваний файл, який не вимагає попередньої інсталяції .NET:
У Visual Studio натисніть правою кнопкою на проект -> Опублікувати (Publish):
  • Конфігурація: Release | Any CPU
  • Цільова платформа: win-x64
  • Режим розгортання: Self-contained (Автономне розгортання)
  • Параметри файлу: позначте галочкою «Створити один файл» (Produce single file) та «Увімкнути стиснення ReadyToRun».
Натискаєте кнопку Опублікувати — і у вас готовий один красивий файл Launcher.exe розміром 30-40 МБ, готовий до роздачі гравцям!
 

Олексій Бульдаков

Учасник
🔰 НОВАЧОК
🌟 Знавець
🥉 🥈
Рейтинг
515 pts
Андрію, величезне спасибі за розбір! Якраз шукав, як позбутися помилки відсутності .NET у гравців на старих версіях Windows 10. Параметр Self-contained вирішив проблему на всі 100%!
 

Лео Київський

Учасник
🔰 НОВАЧОК
👑 Гуру ZONA
🥉 🥈 🥇 🏎️ ❤️
Рейтинг
1430 pts
До речі, у XAML ще дуже класно додавати фонове відео для головного меню замість статичної картинки через MediaElement з прапорцем UnloadedBehavior="Manual". Виглядає супер сучасно, як у великих AAA проектах.
 

Андрій Хімік

Учасник
🔰 НОВАЧОК
👑 Гуру ZONA
🥉 🥈 🥇 🛠️ ❤️
Рейтинг
1220 pts
Так, Лео, саме так! Головне оптимізувати фоновий ролик у MP4 кодеком H.264 з бітрейтом близько 2-3 Mbps, щоб він не жер ресурси процесора під час відкриття лаунчера.
 
Admin 🏆

Admin

Z O N A
Команда форуму
👑 МЕЦЕНАТ ZONA
Власник проєкту
🔰 НОВАЧОК
👑 Гуру ZONA
🥉 🥈 🥇 💎 👑 🛠️ 🏎️ 🗺️ ❤️ ⚡ 🏆
Рейтинг
50730 pts
Вітаю, Андрій Хімік! Дякую за активність на порталі URBAN MTA.

Цікавий реліз! Нагадуємо автору та користувачам, що всі ресурси у розділі зливів проходять обов'язкову перевірку на відсутність бекдорів, прихованого коду та шкідливих функцій.

Запитання до автора:
Підкажіть, чи це оригінальний вихідний код ресурсу, і під яку версію MTA він оптимізований? Чи потрібні додаткові SQL-дампи для запуску?
 
Зверху
\n\n