- Рейтинг
- 1220 pts
🚀 Покрокова інструкція: Адаптація та запуск відкритого C# / WPF лаунчера під ваш сервер
У нашому Загруз-Центрі доступний повноцінний відкритий сирцевий код ігрового лаунчера: OLD UKRAINE GTA Launcher • Повний вихідний код [C# / WPF / .NET], а також працює інтерактивний Онлайн Конструктор Лаунчерів.
У цьому гайді я розберу абсолютно все: як налаштувати солюшн, змінити дизайн, підключити свій сервер MTA, налаштувати систему швидкого завантаження файлів (FastDL / Патчер) та куди безкоштовно або недорого залити клієнтські файли для роздачі оновлень гравцям.
1. Що потрібно для збірки та редагування
2. Зміна дизайну та брендингу проекту
Уся візуальна частина написана на чистому WPF з використанням XAML-розмітки:
3. Налаштування IP сервера та аргументів запуску MTA
Відкрийте файл
Знайдіть конфігурацію підключення:
Механізм безпосереднього запуску гри з автоматичним підключенням реалізовано через
4. Куди залити файли і як налаштувати автооновлення (Патчер)
Щоб гравці не качали гігабайти вручну, лаунчер має систему валідації цілісності кешу за алгоритмом MD5.
Де безкоштовно або дешево розмістити файли гри:
Структура файлу manifest.json:
Лаунчер при старті запитує
5. Збірка фінального .EXE релізу
Щоб видати гравцям один компактний виконуваний файл, який не вимагає попередньої інсталяції .NET:
У Visual Studio натисніть правою кнопкою на проект -> Опублікувати (Publish):
У нашому Загруз-Центрі доступний повноцінний відкритий сирцевий код ігрового лаунчера: 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.
Де безкоштовно або дешево розмістити файли гри:
- Звичайний віртуальний хостинг (Apache / Nginx): створюєте піддомен
update.yoursite.ua, заливаєте файли в папкуpublic_html/client/. Це найпростіший варіант. - Хмарні сховища S3 / Cloudflare R2: Cloudflare R2 має безкоштовний рівень на 10 ГБ і 0$ за вихідний трафік, що ідеально для роздачі важких модпаків без лімітів!
- 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 МБ, готовий до роздачі гравцям!
Behavior="Manual". Виглядає супер сучасно, як у великих AAA проектах.