MiNT Multiplayer v0.6.0-dev

[DaVilka]

с версии 0.1.0 на версию 1.0 за 4 дня? эх мне бы так

зачем тебе ты если есть я

 

[Farko]

с версии 0.1.0 на версию 1.0 за 4 дня? эх мне бы так

 

[sonnyk]

по канону версионирования, нужно остановиться на 1.1-beta. Через 3 года выйти из беты, а на следующий год закрыть платформу

 

[DaVilka]

Обновление 0.3.0 — большое обновление C#, этап второй.

Добавлены короткий серверный API, поддержка асинхронных обработчиков, перехват урона, огня и взрывов. Расширено событие отключения игрока и управление отображением интерфейсов.

Добавлен класс Api — аналог Alt в alt:V по назначению.
Это короткая точка доступа к серверному C# SDK: создание и поиск сущностей, события, метаданные, ресурсы, RPC и другие операции.
В классе 215 публичных методов с учётом перегрузок, 49 событий и 11 свойств. Группированный API через Server также остаётся доступен.

using System.Threading;
using System.Threading.Tasks;
using Mint.Server;
using Mint.Server.Events;
using Mint.Server.Players;
using Mint.Server.Shared;

// Создание транспорта.
var vehicle = Api.CreateVehicle("sultan", new Vector3(100, 200, 30));

// Поиск игрока и отправка клиентского события.
var player = Api.GetPlayerById(1);
if (player is not null)
    Api.EmitClient(player, "notification", "Привет!");

// Событие всем игрокам.
Api.EmitAllClients("announcement", "Сервер обновлён!");

// Типизированные метаданные.
Api.SetMeta("weather", "CLEAR");
var weather = Api.GetMeta<string>("weather");

// Экспорт функции для других ресурсов.
Api.Export("sum", (int a, int b) => a + b);

Примеры подписок ниже размещаются в OnStart() ресурса.
Добавлена поддержка асинхронного выполнения в C#.
Она встроена в основной SDK: отдельная библиотека и классы вроде AsyncPlayer не требуются.
Обработчики могут возвращать Task или ValueTask, ожидать запрос к БД, HTTP или другую асинхронную операцию. После обычного await выполнение продолжается в контексте ресурса, где снова доступна работа с SDK.

Api.OnClientAsync("request", async (IPlayer player, string message) =>
{
    await Task.Delay(1000); // Например, ожидание запроса к БД.

    if (!player.Valid) return;
    Api.EmitClient(player, "response", $"Получено: {message}");
});

Для отмены ожидания при остановке ресурса можно добавить CancellationToken. Runtime передаёт его автоматически — отправлять токен с клиента не нужно.

Api.OnClientAsync("request", async (
    IPlayer player, string message, CancellationToken token) =>
{
    await Task.Delay(1000, token);

    if (!player.Valid) return;
    Api.EmitClient(player, "response", message);
});

Для запуска отдельной асинхронной операции доступен dispatcher:

_ = Api.Dispatcher.RunAsync(async token =>
{
    await Task.Delay(5000, token);
    Api.EmitAllClients("announcement", "Прошло пять секунд!");
});

Поддерживаются асинхронные серверные и клиентские события, одноразовые подписки, обработчики через атрибуты и RPC. Для обращения к SDK из стороннего потока используется Api.Dispatcher.InvokeAsync(...).
Ограничения:

• async void не поддерживается.
• OnStart, OnTick, OnStop и хуки IModule остаются синхронными.
• RunAsync не переносит вычисления в отдельный поток. Для тяжёлых вычислений используется Task.Run, внутри которого нельзя напрямую обращаться к живым сущностям.
• После await сущность могла быть удалена или игрок мог отключиться — проверяйте Valid.
• События, требующие немедленного решения, обрабатываются синхронно.
• Асинхронные результаты межресурсных exports пока не поддерживаются.

Добавлены серверные события fire, explosion и weaponDamage.
Они доступны в C# и JavaScript.
fire позволяет разрешить или запретить создание пожара. Обработчик получает отправителя запроса, позицию и сущность, к которой привязан огонь. Для огня на земле сущность равна null.
explosion позволяет разрешить или запретить взрыв. Передаются отправитель запроса, тип взрыва, позиция и множитель урона.
У обоих событий false запрещает эффект. Отправитель запроса не обязательно является виновником; для серверного источника он может быть null. Изменение урона через эти два события пока не поддерживается. Отмена fire не тушит уже существующий пожар.
Примеры на C#:

// Разрешить огонь на сущностях, запретить отдельные пожары на земле.
Api.OnFire += (reporter, position, entity) =>
{
    Api.Log($"Пожар: {position}, сущность: {entity?.Id}");
    return entity is not null;
};

// Запретить взрывы ракет.
Api.OnExplosion += (reporter, type, position, damageScale) =>
{
    Api.Log($"Взрыв: {type}, множитель урона: {damageScale}");
    return type != ExplosionType.Rocket;
};

Примеры на серверном JS:

import * as mint from 'mint-server';

mint.on('fire', (reporter, position, entity) => {
    return entity != null;
});

mint.on('explosion', (reporter, type, position, damageScale) => {
    return type !== 4; // 4 — взрыв ракеты.
});

Также можно поджечь колесо автомобиля или запустить таймер его взрыва. Создаваемые эффекты проходят соответствующие серверные проверки.

// vehicle и player — действующие сущности.
vehicle.Wheels.SetWheelOnFire((byte)0, true);
vehicle.Weapons.SetTimedExplosion(true, player, 3000);

vehicle.setWheelOnFire(0, true);
vehicle.setTimedExplosion(true, player, 3000);

weaponDamage позволяет отменить попадание или изменить величину урона.
Добавлена обработка обычных ударов ближнего боя, включая кулаки и холодное оружие.
Обработчик получает атакующего, цель, хеш оружия, урон, смещение точки попадания относительно цели и идентификатор кости GTA.
Пример на C#: запрет ударов кулаками и уменьшение остального поддерживаемого урона вдвое.

Api.OnWeaponDamage += (source, target, weapon, damage, offset, bone) =>
{
    if (weapon == Api.Hash("WEAPON_UNARMED"))
        return WeaponDamageResult.Cancel;

    return WeaponDamageResult.WithDamage(damage * 0.5f);
};

Для сохранения исходного урона возвращается WeaponDamageResult.Allow.
Аналогичный пример на серверном JS:

mint.on('weaponDamage', (source, target, weapon, damage, offset, bone) => {
    if (weapon === mint.hash('WEAPON_UNARMED'))
        return false;

    return damage * 0.5;
});

В JS false отменяет попадание, число заменяет урон, true или отсутствие возвращаемого значения сохраняет его.
Перехват охватывает поддерживаемые попадания из ручного огнестрельного оружия и обычные melee-удары по игрокам и динамическим серверным педам с назначенным владельцем. Транспорт и объекты как цели, урон взрывов и парные добивания пока не входят в это покрытие.
Величина damage передаётся в расчёт GTA: итоговая потеря HP также зависит от брони и других игровых модификаторов.
Все три события требуют синхронного решения — async и await в их обработчиках не поддерживаются.
В событие playerDisconnect добавлен снимок последних известных серверу данных игрока.
Теперь параметры события:

player, reason, snapshot

• player — уже недействительная сущность отключившегося игрока.
• reason — причина отключения.
• snapshot — неизменяемый снимок данных, сохранённый до очистки сессии.

Снимок можно читать после await, например при сохранении персонажа.
| C# | JS | Данные |
|---|---|---|
| Id | id | ID игрока |
| Name | name | Имя |
| Position | position | Позиция |
| Rotation | rotation | Поворот в радианах |
| Velocity | velocity | Скорость |
| Dimension | dimension | Измерение |
| Model | model | Хеш модели |
| Health, MaxHealth | health, maxHealth | Здоровье и его максимум |
| Armor, MaxArmor | armour, maxArmour | Броня и её максимум |
| CurrentWeapon | currentWeapon | Хеш текущего оружия |
| VehicleId | vehicleId | ID транспорта либо null |
| Seat | seat | Место в транспорте либо null; водитель — 1 |
| Interior | interior | Интерьер |
| IsDead | isDead | Состояние смерти |
Пример на C#:

Api.OnPlayerDisconnect += (player, reason, snapshot) =>
{
    Api.Log($"{snapshot.Name} отключился: {reason}");
    Api.Log($"Последняя позиция: {snapshot.Position}");
};

Пример на серверном JS:

mint.on('playerDisconnect', (player, reason, snapshot) => {
    mint.log(`${snapshot.name} отключился: ${reason}`);
    mint.log(`Последнее здоровье: ${snapshot.health}`);
});

Существующие C#-обработчики необходимо обновить с учётом третьего параметра.
Для CEF WebView, RmlDocument и TextLabel добавлено свойство showOnPauseMenu.
Оно определяет, продолжит ли объект отображаться при открытой игровой карте или меню паузы. По умолчанию — false.

webView.showOnPauseMenu = true;
rmlDocument.showOnPauseMenu = true;
textLabel.showOnPauseMenu = true;

Для серверного TextLabel в C#:

textLabel.ShowOnPauseMenu = true;

Исправления:

• Исправлен краш клиента при выполнении clear в консоли с большим количеством сообщений и появившейся полосой прокрутки.
• Исправлена ошибка времени жизни C#-сущностей, из-за которой действующий TextLabel мог ошибочно считаться удалённым.
• Исправлено нанесение урона и добивание обычными melee-ударами: цель больше не остаётся с 1 HP при достаточном разрешённом уроне.
• Увеличен лимит всплеска пакетов который генерируется при блокировке мейнпотока сложными задачами и защиты от флуда
• Увеличен размер максимального размера одного dlc.rpf до 5 гиг

MiNT Multiplayer v0.3.0-dev Git

 

[DaVilka]

Обновление 0.4.0

Переход на нативную синхронизацию.
Переход проводился точечно, что бы избежать переноса всей нативной сети. Основной акцент был сделан именно на синхронизации между игроками и игровыми сущностями.
Из-за технических ограничений максимальное количество игроков в зоне стрима было временно уменьшено до 64, а онлайна до 1000.
Старая система синхронизации была удалена, но ещё не полностью. В связи с этим после обновления могут встречаться отдельные баги и нестандартное поведение.

Исправления:

• Исправлены призрачные авто.
• Исправлен туман войны.
• Исправлена проблема с weaponDamage, из-за которой урон в некоторых случаях не проходил.

MiNT Multiplayer v0.4.0-dev Git

 

[Walter]

Исправлен туман войны.

это круто...

 

[syavaqq]

Обновление 0.4.0

Переход на нативную синхронизацию.
Переход проводился точечно, что бы избежать переноса всей нативной сети. Основной акцент был сделан именно на синхронизации между игроками и игровыми сущностями.
Из-за технических ограничений максимальное количество игроков в зоне стрима было временно уменьшено до 64, а онлайна до 1000.
Старая система синхронизации была удалена, но ещё не полностью. В связи с этим после обновления могут встречаться отдельные баги и нестандартное поведение.

Исправления:

• Исправлены призрачные авто.
• Исправлен туман войны.
• Исправлена проблема с weaponDamage, из-за которой урон в некоторых случаях не проходил.

MiNT Multiplayer v0.4.0-dev Git

не запускается launcher.exe

 

[DaVilka]

это круто...

был тикет, че могу поделать

 

[TTox421]

А че не сделаешь свой сайт, где можно будет выкачать клиент для игроков и сервер для разрабов, как у altv, глядишь возможно пойдет в гору дела)


правда потом придут тейк ту)

 

[Minotheo]

А че не сделаешь свой сайт, где можно будет выкачать клиент для игроков и сервер для разрабов, как у altv, глядишь возможно пойдет в гору дела)


правда потом придут тейк ту)

В сказки про T2 веришь, им поебать конкретно на СНГ.

 

[DaVilka]

А че не сделаешь свой сайт, где можно будет выкачать клиент для игроков и сервер для разрабов, как у altv, глядишь возможно пойдет в гору дела)


правда потом придут тейк ту)

я б уже выкатил, работы с мультом много, не успеваю делать все

 

[DaVilka]

Обновление 0.5.0

Параметр resourcesPath заменён на resources для явного указания загружаемых ресурсов. Ресурсы размещаются в постоянной папке resources рядом с серверным TOML.

resources = ["chat", "npc", "core"]

Отсутствующий или пустой список означает запуск без ресурсов.

Добавлен параметр dlcWhitelist, который задаётся в корне серверного TOML.
Пустой список или отсутствие настройки сохраняет штатный выбор DLC GTA. Непустой список разрешает только перечисленные штатные DLC; пользовательские DLC добавляются отдельно.
Указываются имена папок DLC без префикса dlc_, суффикса CRC и полного пути.

dlcWhitelist = ["mpheist", "mpapartment"]

Добавлена секция [pools] в клиентском client.toml — ограниченный аналог настройки пулов через gameconfig. Пока настраивается только на стороне клиента.
Значения задают количество элементов пула. Ниже приведён пример настройки, а не значения по умолчанию:

[pools]
# Записи метаданных игровых ресурсов
MetaDataStore = 7000

# Словари текстур
TxdStore = 110000

# Фрагментные модели, включая модели с разрушаемыми частями
FragmentStore = 62000

# Словари анимаций
AnimStore = 22000

# Ресурсы интерфейса Scaleform
ScaleformStore = 1200

# Данные подбираемых предметов
CPickupData = 1100

Изменять настройки нужно при закрытой GTA. Они применяются при следующем запуске игры; переподключения к серверу недостаточно.

Добавлен параметр cdnEnabled, включающий загрузку клиентских ресурсов с CDN. Для включения нужны корректный cdnUrl и заранее подготовленная публикация ресурсов. При cdnEnabled = false ресурсы собирает и раздаёт сервер.
Добавлен параметр encryptResources, управляющий шифрованием публикуемых клиентских ресурсов: stream/DLC, клиентских скриптов и UI.
Оба параметра задаются в корне серверного TOML и по умолчанию выключены:

cdnEnabled = false
encryptResources = false

При debug = true настройки CDN и шифрования игнорируются.
Добавлена секция [overrides] в stream-манифесте для замены файлов GTA по виртуальному пути. Формат: MOUNT_PATH = REPLACEMENT_PATH.

[overrides]
"commoncrc:/data/levels/gta5/water.xml" = "replaces/water.xml"
"dlc_mpApartmentCRC:/content.xml" = "replaces/mpapartment/content.xml"
"dlcMPHeistCRC:/content.xml" = "replaces/mpheist/content.xml"

Путь к файлу замены указывается относительно корня ресурса. Файл должен входить в client-files, например:

client-files = ["replaces/**"]

Поддерживаются XML, META, DAT, YTD, YDR, YFT, YDD и YMT. Расширения исходного и заменяемого файлов должны совпадать.
Один и тот же файл замены нельзя одновременно объявлять в [meta]: он уже обслуживается через boot override.
Overrides пока несовместимы с включённым шифрованием ресурсов: при encryptResources = true и debug = false сервер отклоняет такую публикацию.
Изменение dlcWhitelist или [overrides] требует перезапуска GTA.
Поддержка [pools], dlcWhitelist и [overrides] реализована для GTA 3889.

Добавлены консольные команды:

• quit — закрывает GTA/клиент.
• disconnect — отключается от сервера или отменяет текущее подключение.

Оптимизировано появление сущностей в зоне стриминга: создание распределяется по кадрам, устранена повторная переустановка хуков при появлении и удалении сущностей.

MiNT Multiplayer v0.5.0-dev

 

[Zver1o7]

Харош

 

[E8ZYZE]

Братишь дай исходники)))

 

[Walter]

Братишь дай исходники)))

это вряд ли

 

[DaVilka]

Братишь дай исходники)))

нит

 

[E8ZYZE]

нит

Нуууу братишь

 

[DaVilka]

Обновление 0.6.0

Браузер лаунчера был вынесен из ядра клиента в угоду более удобного расширения функционала клиента игры.

Добавлен API лаунчеру для пользовательских приложений.
Обмен данными происходит через stdin/stdout в формате JSON, а активация использования апи происходит передачей параметра лаунчеру Launcher.exe --api,
после чего лаунчер запустится скрытно и будет ждать команд.

После запуска лаунчер сообщает о готовности:
{"event":"ready","commands":["settings.get","settings.set","servers.list","update","prepare","launch","cancel","trust.confirm","shutdown"]}

Каждый запрос содержит:
id - положительное целое число, уникальное для запроса;
command - название команды;
остальные поля - параметры команды.

Команды:
settings.get - получить настройки client.toml.
{"id":1,"command":"settings.get"}

settings.set - изменить переданные настройки.
Доступные поля: playerName, gameDirectory, voiceVolume, microphoneVolume, microphoneEnabled, discordEnabled.
Громкость задаётся целым числом от 0 до 100.
{"id":2,"command":"settings.set","settings":{"playerName":"Player","voiceVolume":80}}

servers.list - получить список серверов в result.servers.
{"id":3,"command":"servers.list"}

update - проверить и установить обновления MiNT без запуска GTA.
{"id":4,"command":"update"}

prepare - проверить и загрузить ресурсы выбранного сервера.
Не обновляет MiNT, не требует установленной GTA и не запускает игру.
{"id":5,"command":"prepare","server":"127.0.0.1:22005"}

launch - обновить MiNT, подготовить ресурсы сервера и запустить GTA.
Предварительный prepare необязателен. Если ресурсы уже подготовлены, используется подходящий кеш.
{"id":6,"command":"launch","server":"127.0.0.1:22005"}

Дополнительные поля launch:
--gameDirectory - папка игры. Без неё используется сохранённый путь и автопоиск. Если GTA не найдена, возвращается ошибка без диалога выбора папки.
--offline - пропустить обновление MiNT. Проверка ресурсов сервера выполняется.
{"id":7,"command":"launch","server":"127.0.0.1:22005","gameDirectory":"D:\\Games\\GTA V","offline":true}

cancel - запросить отмену активной операции по id.
{"id":8,"command":"cancel","targetId":7}

trust.confirm - ответить на запрос подтверждения изменения ключа сервера.
targetId - id операции, requestId - строка из события trust.required.
{"id":9,"command":"trust.confirm","targetId":7,"requestId":"1","accepted":true}

shutdown - отменить активную операцию, дождаться очистки и завершить API.
{"id":10,"command":"shutdown"}

Ответы и события:

Каждый запрос получает один итоговый ответ с тем же id.
Успешный ответ:
{"id":5,"ok":true,"result":{"status":"ready"}}

Ошибка:
{"id":5,"ok":false,"error":{"code":"PREPARATION_FAILED","message":"Описание ошибки"}}

error.code предназначен для обработки в программе, error.message - сообщение.

Основные результаты:
update - status: ready либо skipped при offline: true;
prepare - status: ready;
launch - status: handedOff после первого успешного подключения;
cancel - status: cancelling; итог отменяемой операции приходит отдельно после очистки;
trust.confirm - status: accepted, решение принято в обработку;
shutdown - status: stopped, затем процесс завершается.

Промежуточные события содержат event и id соответствующего запроса.

progress - прогресс обновления, подготовки ресурсов или запуска.
stage: update, prepare или launch.
phase уточняет текущую работу.
completedBytes и totalBytes показывают прогресс текущей фазы, totalBytes: null - неизвестный объём.
События запуска могут содержать message вместо счётчиков.
{"id":5,"event":"progress","stage":"prepare","phase":"resources","completedBytes":5000,"totalBytes":10000}

trust.required - требуется решение пользователя о смене ключа сервера.
Содержит requestId, server, previousKey и candidateKey.
Покажите пользователю сервер и оба ключа, затем отправьте trust.confirm с accepted: true или false.

Одновременно выполняется одна операция. Пока она активна, обычные команды получают BUSY, cancel, trust.confirm и shutdown остаются доступны.
После итогового ответа API продолжает принимать команды. Результат операции определяется её JSON-ответом, а не кодом выхода процесса.

Спойлер: Пример

import itertools
import json
import subprocess


LAUNCHER = r"D:\MiNT\Launcher.exe"


def main():
    with subprocess.Popen(
        [LAUNCHER, "--api"],
        stdin=subprocess.PIPE,
        stdout=subprocess.PIPE,
        creationflags=subprocess.CREATE_NO_WINDOW,
    ) as process:
        ids = itertools.count(1)

        def send(command, **arguments):
            request_id = next(ids)
            payload = {"id": request_id, "command": command, **arguments}
            process.stdin.write((json.dumps(payload, ensure_ascii=False) + "\n").encode("utf-8"))
            process.stdin.flush()
            return request_id

        def receive():
            line = process.stdout.readline()
            if not line:
                raise RuntimeError("MiNT API закрыл соединение до получения ответа")
            return json.loads(line.decode("utf-8"))

        def request(command, **arguments):
            request_id = send(command, **arguments)
            while True:
                message = receive()
                if "ok" in message:
                    if not message["ok"]:
                        error = message["error"]
                        raise RuntimeError(f"{error['code']}: {error['message']}")
                    if message["id"] == request_id:
                        return message["result"]
                    # Ответ trust.confirm тоже проходит через этот цикл.
                elif message.get("event") == "progress":
                    stage = message.get("stage", "")
                    if "message" in message:
                        print(stage, message["message"])
                    else:
                        done = message.get("completedBytes", 0)
                        total = message.get("totalBytes")
                        print(stage, message.get("phase", ""), f"{done}/{total or '?'} байт")
                elif message.get("event") == "trust.required":
                    print("Изменился ключ сервера:", message["server"])
                    print("Предыдущий:", message["previousKey"])
                    print("Новый:", message["candidateKey"])
                    accepted = input("Принять новый ключ? [да/нет]: ").strip().lower() == "да"
                    send("trust.confirm", targetId=message["id"],
                         requestId=message["requestId"], accepted=accepted)

        try:
            ready = receive()
            if ready.get("event") != "ready":
                raise RuntimeError(f"API не готов: {ready}")

            try:
                for server in request("servers.list")["servers"]:
                    host = server["host"]
                    address = f"[{host}]" if ":" in host else host
                    print(f"{server['name']} — {address}:{server['port']}")
            except RuntimeError as error:
                print("Список серверов недоступен:", error)

            endpoint = input("Адрес сервера (host:port): ").strip()
            request("prepare", server=endpoint)
            print("Ресурсы готовы. Запускаю GTA...")
            result = request("launch", server=endpoint)
            print("Результат запуска:", result["status"])
            request("shutdown")
        finally:
            try:
                process.stdin.close()
            except BrokenPipeError:
                pass
            for _ in process.stdout:
                pass
            process.wait()


if __name__ == "__main__":
    try:
        main()
    except KeyboardInterrupt:
        print("Операция остановлена.")
    except (OSError, RuntimeError) as error:
        print("Ошибка:", error)

Добавлены консольные команды:
mic-volume - громкость микрофона
voice-volume - громкость микрофона окружающих
netgraph - отображает фпс, пинг и вермя кадра

Расширен [pools](gameConfig) из 6 до 21 свойств и вынесен на сервеную сторону

Добавлена outline система:

Спойлер: АПИ

export interface IOutlineOptions {
    /** Стиль. По умолчанию: 'contour'. */
    style?: 'contour' | 'glow' | 'fill';

    /** Режим видимости. По умолчанию: 'xray'. */
    mode?: 'visible' | 'xray';

    /** RGBA: целые значения 0–255. По умолчанию: (0, 255, 255, 230). */
    color?: IRGBA;

    /** Толщина/радиус 1–8 пикселей. По умолчанию: 2. Для fill игнорируется. */
    width?: number;
}

export class Outline {
    constructor(options?: IOutlineOptions);

    readonly valid: boolean;
    readonly size: number;

    /** Присваивание заменяет настройки; пропущенные поля получают defaults. */
    options: IOutlineOptions;

    /** Entity или GTA scriptID, не сетевой ID. */
    add(target: Entity | number): boolean;
    remove(target: Entity | number): boolean;
    has(target: Entity | number): boolean;

    /** Убирает все цели, сохраняя группу и настройки. */
    clear(): void;

    /** Удаляет группу и освобождает слот. */
    destroy(): void;
}

/** Упрощённая подсветка одной цели. Следующий вызов заменяет предыдущую. */
export function setOutline(
    target: Entity | number,
    options?: IOutlineOptions,
): boolean;

/** Очищает одиночную подсветку текущего ресурса. */
export function clearOutline(): void;

На данный момент имеет несколько стилей(style), "contour" - чёткий внешний контур, "glow" - мягкое внешнее свечение и "fill" - заливка силуэта цветом,
mode, "visible" - учитывает глубину и "xray" - рисуется по верх всего
color { r, g, b, a } - цвет, включая прозрачность
width - число от 1–8, толщина контура или радиус свечения в пикселях

Спойлер: Пример

import * as mint from 'mint-client';

const selected = new mint.Outline({
    style: 'glow',
    mode: 'visible',
    width: 6,
    color: new mint.RGBA(0, 255, 180, 220),
});

mint.on('keyup', key => {
    if (key === mint.KeyCode.F6) {
        selected.clear();

        if (!selected.add(mint.Player.local)) {
            mint.logWarning('Не удалось добавить игрока в подсветку.');
        }
        const vehicle = mint.Player.local.vehicle;

        if (vehicle && !selected.add(vehicle)) {
            mint.logWarning('Не удалось добавить машину в подсветку.');
        }
    } else if (key === mint.KeyCode.F9) {
        selected.clear();
    }
});

Настройки можно менять:

selected.options = {
    ...selected.options,
    mode: 'xray',
};

Добавлен функционал в UI3D:
добавлено отображение авто
и добавлена функция snapshot которая возвращает gta - текстуру,

Спойлер: Пример 1

import * as mint from 'mint-client';

const scene = new mint.Utils.UI3DScene('PAUSE_SINGLE_RIGHT', {
    overlay: true,
});

scene.setPed(0, mint.Player.local, {
    pos: { x: 0, y: 0.1, z: 0 },
    rot: { x: 0, y: 0, z: 15 },
    lightIntensity: 0.8,
});

const tick = mint.everyTick(() => scene.render());

mint.on('resourceStop', name => {
    if (name !== mint.resourceName) return;

    mint.clearEveryTick(tick);
    scene.destroy();
});

Спойлер: Пример 2

import * as mint from 'mint-client';
import * as native from 'natives';

const scene = new mint.Utils.UI3DScene('PAUSE_SINGLE_RIGHT');

scene.setPed(0, mint.Player.local, {
    rot: { x: 0, y: 0, z: 15 },
    lightIntensity: 0.8,
});

const screen = mint.getScreenResolution();
const scale = Math.min(1, 2048 / Math.max(screen.x, screen.y));

let image;

try {
    image = await scene.snapshot({
        size: {
            x: Math.max(1, Math.round(screen.x * scale)),
            y: Math.max(1, Math.round(screen.y * scale)),
        },
        timeout: 5000,
    });
} finally {
    scene.destroy(); // Готовый снимок продолжает существовать.
}

const tick = mint.everyTick(() => {
    if (!image.valid) return;

    native.drawSprite(
        image.textureDict, image.textureName,
        0.5, 0.5, 1, 1,
        0, 255, 255, 255, 255,
        false, false,
    );
});

mint.on('resourceStop', name => {
    if (name !== mint.resourceName) return;

    mint.clearEveryTick(tick);
    image.destroy();
});

Добавлены и доработаны некоторые апи:
Добавлены события метки на карте персонажа

waypointCreated: (position: Vector3) => void; - создана
waypointRemoved: (position: Vector3) => void; - удалена
waypointReached: (position: Vector3) => void; - игрок достиг точки

Прикрипление сущностей транспорта:

entityAttached: (
    parent: Entity,
    child: Entity,
    kind: shared.AttachmentKind
) => void;

entityDetached: (
    parent: Entity,
    child: Entity,
    kind: shared.AttachmentKind
) => void;
export enum AttachmentKind {
    GenericPhysical = 0, // Обычное физическое прикрепление
    TrailerHitch = 1,    // Прицеп
    TowArm = 2,          // Эвакуатор
    CargobobHook = 3,    // Крюк Cargobob
    CargobobMagnet = 4,  // Магнит Cargobob
}

Добавлены TS-декларации vehicleAttach: (target: Vehicle, child: Vehicle) => void; и vehicleDetach: (target: Vehicle, child: Vehicle) => void;
Добавлен клиент-сервер ивент смены модели (игрока/педа/предмета/авто?)

entityModelChange: (
    entity: Entity,
    oldModel: number,
    newModel: number
) => void;

Добавлен клиентский ивент weaponDamage:

weaponDamage: (
    target: Entity,
    weaponHash: number,
    damage: number,
    offset: Vector3,
    bodyPart: BodyPart,
    sourceEntity: Entity
) => boolean | number | void;

Обновлен серверный ивент weaponDamage:

weaponDamage: (
    source: Player,
    target: Entity,
    weaponHash: number,
    damage: number,
    shotOffset: shared.IVector3,
    bodyPart: shared.BodyPart,
    sourceEntity: Entity
) => boolean | number | void;

source - Игрок, отправивший серверу запрос попадания
target - Сущность, получающая попадание
weaponHash - Хеш оружия
damage - Входная величина урона; окончательная потеря HP зависит от расчёта GTA
offset / shotOffset - Точка попадания в локальных координатах цели
bodyPart - Область тела из BodyPart, например Head = 20, Unknown = -1
sourceEntity - источник попадани
Изменен серверный контракт: вместо прежнего boneId передаётся BodyPart, также добавлен sourceEntity.
Добавлены серверные ивенты о фактическом нанесении урона:

playerDamage: (
    victim: Player,
    attacker: Entity | null,
    healthDamage: number,
    armourDamage: number,
    weaponHash: number
) => void;

pedDamage: (
    ped: Ped,
    attacker: Entity | null,
    healthDamage: number,
    armourDamage: number,
    weapon: number
) => void | boolean;

vehicleDamage: (
    vehicle: Vehicle,
    attacker: Entity | null,
    bodyHealthDamage: number,
    additionalBodyHealthDamage: number,
    engineHealthDamage: number,
    petrolTankDamage: number,
    weaponHash: number
) => void;

Добавлена функция вызова нативок по хешу:

export function invoke(
    hash: string | bigint,
    ...args: unknown[]
): unknown;

import * as native from 'natives';
const gameTimer = native.invoke('0x9CD27B0045628463');

Добавлен нативный метод statSetInt:

export function statSetInt(
    statName: number,
    value: number,
    save: boolean
): boolean;

Доработана сборка ресурсов:
самостоятельные streaming-ассеты теперь собираются без фиктивной metadata
фикс маленького размера ресурса
Добавлен и интегрирован game-data.json который содержит информацию о штатных машинах, персонажах, оружии, одежды, скелетах моделей, палитру и категории колёс

Оптимизация клиента и исправления синхронихации:
Убраны лишние чтения состояний сущностей и часть работы на каждом кадре что увеличило фпс
Исправлена причина причина фризов связанная с аудио.
Исправлено зависание при запуске клиента
Исправлен разрыв соединения спавне авто с неверным хешем
Подняты лимиты контроллеров до количества сущностей в зоне стрима
убрана команда disconnect
MiNT Multiplayer v0.6.0-dev

 

[E8ZYZE]

Сделай чтобы можно было отключать карту гта 5 и поставить свою

 

[DaVilka]

Сделай чтобы можно было отключать карту гта 5 и поставить свою

отключать можно и ставить свою тоже