ENPTESRU
Discord

Проверка конфликтов ID в carcols

Два аддон-авто с одинаковым ID модкита: из-за этого обычно пропадают детали тюнинга или на машине появляются детали от другой. Перетащите сюда файлы carcols.meta и carvariations.meta или всю папку resources, и страница покажет каждый ID, занятый дважды. Файлы читает ваш браузер, на сервер они не загружаются.

Перетащите сюда файлы или папку resources

Вставить XML

Как пользоваться

  1. Добавьте файлы

    Перетащите папку resources в поле, выберите файлы или вставьте XML. Из папки страница читает только файлы .meta и .xml, остальное пропускает.

  2. Посмотрите отчёт

    Для каждого ID, который встречается дважды, указаны имя кита или сирены и путь ко всем файлам, где он записан.

  3. Поменяйте номер у одной из записей

    Возьмите число из списка свободных ID и впишите его в id одной записи. Для сирен и фар то же число нужно поставить в sirenSettings или lightSettings в carvariations.meta.

  4. Проверьте ещё раз

    Перетащите папку снова. Когда отчёт будет чистым, перезапустите сервер и проверьте меню тюнинга и сирены в игре.

Что показывает проверка?

ПроверкаЧто это значит
ID модкита занят дваждыУ двух записей в Kits одинаковый id. Игра оставляет первую, а вторую переносит на другой свободный номер.
ID сирены или фар занят дваждыУ двух записей в Sirens или Lights одинаковый id. carvariations.meta ссылается на номер, поэтому одна из машин получает сирену или фары другой.
Слишком большой IDID кита больше 65535 либо ID сирены или фар больше 255. Игра сохраняет только младшие биты: сирена 300 читается как 44, кит 311286 как 49142. Машина работает, пока этот номер не занят другой записью, а поиск повторов сравнивает номера так, как их читает игра.
Зарезервированный ID65535 у китов и 255 у сирен и фар означают "без ID". Игра подставляет первый свободный номер, а он может поменяться при любом изменении списка ресурсов.
Кита нетТранспорт в carvariations.meta ссылается на кит, которого нет ни в одном из загруженных carcols.meta. Для китов из самой игры это нормально, для своих это ошибка.
Свободные IDНомера, которые не использует ни один загруженный файл.

Какие диапазоны ID допустимы?

id кита хранится в 16 битах. Использовать можно числа от 0 до 65534, а 65535 значит "нет". В оригинальной игре места хватает только на 1024 ID китов. FiveM заменяет эту таблицу на таблицу из 65536 ячеек (ModKitIdRelocation.cpp в исходниках клиента), поэтому на сервере FiveM работают ID китов в несколько тысяч.

ID сирен и фар занимают 8 бит. На все сирены сервера, включая сирены самой игры, остаются номера от 1 до 254. Запрос на увеличение лимита открыт в GitHub FiveM с 2024 года (issue #2612).

Слишком большое число игра не отбрасывает. Она берёт младшие биты: сирена 256 становится 0, сирена 300 становится 44, и если на этом номере уже стоит другая сирена, они конфликтуют.

Как исправить конфликт?

Замените id одной из двух записей на свободное число. Для кита этого достаточно, потому что carvariations.meta находит кит по имени. Для сирены или фар новое число нужно вписать ещё и в sirenSettings или lightSettings транспорта в carvariations.meta. После этого перезапустите ресурс.

Поля обоих файлов разобраны в гайде carvariations.meta и carcols.meta. Если ID уже разные, а детали всё равно пропадают, пройдите раздел про тюнинг в гайде по решению проблем с транспортом.

Частые вопросы

Почему на аддон-авто в FiveM пропадают детали тюнинга?
Чаще всего потому, что в двух carcols.meta есть кит с одинаковым id. Таблица ID китов в игре одна на весь сервер, и второй кит игра переносит на другой номер. В итоге машина теряет свои детали или показывает чужие. Дайте каждому киту свой id.
Какой максимальный ID модкита принимает FiveM?
65534. id кита хранится в 16 битах, а 65535 означает "без ID". В оригинальной игре 1024 ячейки под киты, FiveM расширяет таблицу до 65536. Число больше идёт по кругу: 70000 читается как 4464.
Может ли ID сирены быть больше 255?
Нет. ID сирен и фар хранятся в 8 битах, поэтому 300 читается как 44 и попадает на сирену, у которой уже этот номер. 255 означает "без ID", так что остаются номера от 1 до 254.
Знает ли проверка ID из самой игры?
Нет. Она видит только загруженные файлы, поэтому номер из списка свободных может принадлежать транспорту из игры. Для китов список начинается с 2000, потому что игра нумерует свои киты с нуля. Для сирен и фар он начинается с 254 и идёт вниз. Если с новым ID сирена всё ещё работает неправильно, возьмите следующий.
Мои файлы куда-то загружаются?
Нет. Страница разбирает их в вашем браузере на JavaScript и никуда не отправляет. Можно открыть страницу, отключить интернет, и она продолжит работать.

Гайды по теме

Другой инструмент